# Python 约束

> 本文件为公司统一配置（L1）的语言约束部分。
> 按需动态加载：当任务涉及 Python 代码编写时加载本文件。

---

## 一、风格要求

1. **遵循 PEP 8**：使用 ruff 或 black 格式化
2. **类型注解**：函数签名必须有类型提示（Python >= 3.10 支持 `X | None` 语法）
3. **路径处理**：使用 `pathlib.Path`，禁止字符串拼接路径
4. **脚本入口**：`if __name__ == '__main__':` 保护
5. **依赖管理**：必须在 `requirements.txt` / `pyproject.toml` 中声明，禁止 `pip install xxx` 不记录

---

*最后更新：2026-04-18*
*版本：4.0.0（3层架构版）*