协作规则
这个仓库同时保存已验证代码、失败实验和研究假设。提交代码前先读 STATUS.md、EXPERIMENTS.md 和对应协议。
每个实验必须留下
- 一个不可事后修改的 protocol JSON 或 Markdown;
- 数据来源、版本、split、标签开放时点和本地 hash;
- 精确命令、环境、seed、测试退出码和代码 hash;
- 原始逐样本记录与汇总脚本;
- 可声称与不可声称的边界;
- 若修复了旧结果,写清楚 supersedes、correction reason,并保留旧 artifact。
不要做的事
- 不要提交数据集、权重、缓存、checkpoint、
.venv或大日志。 - 不要把 development、oracle 或 geometry diagnostic 数字写成官方 benchmark。
- 不要在看过 validation 后继续调参,再把它叫独立测试。
- 不要把 RGB MSE 下降自动解释成语义对应提升。
- 不要删除失败记录;用
STOPPED或SUPERSEDED标记。
提交前检查
uv run pytest -q
uv run ruff check .
git diff --stat
git status --short