仓库卫生

DispatchAtlas 的版本控制包含手写的源代码、测试、配置、文档，以及可复现的元数据。本地执行产物保持在 Git 之外，除非某项策略明确将其提升为源。

🧹 生成输出策略

生成的实验数据、检查点、结果包、覆盖率报告、文档构建输出、包产物，以及发布候选默认被忽略。当后续关卡将其提升时，它们由源再生并通过来源记录。

受跟踪的生成文件需要：

来自 Python、Ruff、mypy、pytest、覆盖率、文档构建，以及虚拟环境的本地缓存被忽略。CI 可缓存依赖，但缓存键必须从 lockfile 与工作流输入派生。

本地实验运行写入实验工作区被忽略的输出层——运行结果、日志、检查点，以及证据包，按工作区自身 README 中的布局——与其他被忽略的临时位置（如 outputs/ 或 artifacts/）并列。最终研究证据在任何公开使用之前，通过经验证的活动与分析命令产出。

产物类别	默认位置	Git 状态	保留
包构建	`dist/`	忽略	按需重建。
文档构建	`site/out/`	忽略	按需重建。
覆盖率	`htmlcov/`、`.coverage*`	忽略	在质量检查期间重建。
烟雾输出	`outputs/`	忽略	仅在调试时本地保留。
活动结果	实验工作区的结果与检查点层	忽略	仅通过来源-门控的导出提升。
发布证据	`artifacts/`	批准前忽略	按发布候选策略保留。