贡献指南

贡献前先确认变更属于 Reader：读取、校验、导出或 CLI/文档改进是合适范围；编译、缓存写入、渲染和编辑不是。保持边界比增加表面功能更重要。

每个提交应包含：清晰的行为描述、针对正常与异常输入的测试、面向使用者的文档变更，以及 ai-docs 中的记录。改变异常消息、返回字段或 CLI 输出时也应视为兼容性变化并写明影响。

提交前执行：

git diff --check
PYTHONPATH=src python3 -m unittest discover -s tests -v

不要提交凭据、真实客户文件、二进制大样本或与任务无关的格式化变动。评审时优先检查二进制边界、长度校验、错误路径与向后兼容，而不是仅看 happy path。