Cursor Python 开发规则

代码风格

• 遵循 PEP 8
• 使用 4 空格缩进
• 行最大长度 88（Black 默认）
• 使用蛇形命名法

类型提示

• 所有函数参数和返回值必须标注类型
• 使用 typing 模块
• 复杂类型使用 TypeAlias

项目管理

• 使用 pyproject.toml
• 依赖分组管理（dev/prod）
• 测试使用 pytest

文档

• 公共函数必须写 docstring
• 使用 Google 风格的 docstring
• README 包含安装和使用说明