Files
digital-drosophila/docs/30-reproducibility/main-restore.md
2026-10-01 16:54:47 +08:00

44 lines
2.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 从 main 恢复代码和已发布数据
这是新的统一入口。已封存 `registry/publication-20261001/` 和 `registry/acceleration-20261001/` 文档保持原字节,其中旧分支名称是历史记录;当前应 clone main,或使用 `archive/2026-10-01/*` 精确标签。
## 先获取轻量代码
```sh
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:
```sh
git lfs pull --include='artifacts/acceleration-20261001/**' --exclude=''
python3 -B tools/acceleration-publication/archive_results.py verify
```
官方/参考数据:
```sh
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 及独立性能封存文件;不自动恢复训练、升级模型或启动后续实验。