# Python Coding Style

## 基本原则

- 函数边界清楚，输入输出明确，不依赖隐式全局状态。
- 数据结构优先简单可读，复杂魔法和元编程要有充分理由。
- 脚本和库代码分层，避免执行副作用夹在导入阶段。

## 可维护性

- 命名表达业务意图，避免单字母和模糊缩写。
- 对外部输入、文件 IO、网络 IO 和模型输出都做显式边界处理。