digital-drosophila/docs/30-reproducibility/main-restore.md

从 main 恢复代码和已发布数据

这是新的统一入口。已封存 registry/publication-20261001/ 和 registry/acceleration-20261001/ 文档保持原字节，其中旧分支名称是历史记录；当前应 clone main，或使用 archive/2026-10-01/* 精确标签。

先获取轻量代码

GIT_LFS_SKIP_SMUDGE=1 git clone --branch main \
  ssh://git@192.168.10.31:2222/qishizhe/digital-drosophila.git digital-drosophila-restore
cd digital-drosophila-restore
git lfs install --local

不要 clone 到已存在的 /data/digital-drosophila，不要运行封存阶段的生成脚本。首次 clone 跳过 LFS，避免意外下载约 9.9 GB 的全部发布对象。

按需获取

CPU/GPU 回放约 76.4 MB：

git lfs pull --include='artifacts/acceleration-20261001/**' --exclude=''
python3 -B tools/acceleration-publication/archive_results.py verify

官方/参考数据：

git lfs pull --include='artifacts/public-resources-20261001/**' --exclude=''
python3 -B tools/lfs-publication/publish_archives.py verify \
  --group-dir artifacts/public-resources-20261001/malecns-swc

对需要的每组分别 verify。8 组原数据的来源、许可、组名和原始验证记录见 registry/publication-20261001/README.md。仅获取一个组时，可将 include 缩小到该组路径。

main 保留 181 个 artifacts Git 路径、171 个 LFS pointer 路径，其中包含成员/排除清单等 LFS 文件，不是 171 个模型。原始/参考资源含 226,859 个内部文件；两份性能回放归档含 1,680 个内部文件。没有重打包、修改 OID 或重新上传原数据。

重要边界

• Git 指针不是数据本体；只有下载并验证过的对象才能当作已恢复。
• CPU/GPU 回放包不是完整 Phase 4AR 训练现场备份；全 E/AQ 与脑回放仍依赖外部原始 checkpoint、请求、静态 bundle 和固定科学源码。完整依赖由保存的 source pins 描述。
• 旧目录级 manifest 可能包含有意未公开的编译缓存。性能归档应使用 publication-catalog.json 验证；不能把缓存缺失说成科学数据损坏。
• 不要求内网专用 transfer adapter 才能读取标准 LFS 对象。服务器上已有的 LAN adapter 只解决特定网络路径，不应复制其本机绝对路径到别的电脑。
• 不覆盖 raw、Phase 1–4AQ 及独立性能封存文件；不自动恢复训练、升级模型或启动后续实验。