# Python开发指南

## 命令
- `uv add`：安装依赖项
- `uv run pytest tests/unit/test_handlers.py::test_create -v`：运行指定的单个测试用例
- `uv run ruff check --fix .`：使用 Ruff 进行代码检查并自动修复

## 规则
- 所有函数均须添加类型提示（Type Hints）。
- 保留原有的轻量调试入口（if __name__ == "__main__":里面的代码），不用删除。
- 功能变化，需要在`RELEASE.md`中的`## [TO BE RELEASED]`记录，没有这个小标题就创建，便于记录新版本发布时的功能变化，只记录与docs，config，src目录有改动的变化。

## 代码风格与规范 (Code Style)

- 格式化: 遵循Black默认风格 (行长度 80)
- 命名规范: 遵循 PEP 8
- 类型注解: 所有公共函数和类必须包含类型注解 (Type Hints)
- 文档字符串: 使用Google风格的 docstring；

## 模块docstring设置

每个模块文件的开头要给出docstring，包含以下内容：

```
"""
=========================================================
一句话说明模块主要功能
=========================================================

模块基本描述

快速上手
--------
如有请给出示例，如果是简单的类，则不需要给出该部分内容


基础概念
--------
如有请给出说明，特别简单的情况下，可以不给出该部分内容


修改历史
--------
日期（格式：yyyy-MM-dd）: 修改说明，每一次修改一行
"""
```
