案例文件与 Git LFS
案例文件
以下公开成果已通过 Git LFS 提供。点击文件名打开 GitHub 文件页面下载，或按下方说明克隆仓库。
| 文件 | 大小 | 用途 |
|---|---|---|
| reconstruction_native.blend | 252 MB | 原生空间工程，包含独立几何、材质、打包贴图和默认隐藏的扫描参考 |
| reconstruction_roaming.blend | 252 MB | 保留相机路线与关键帧的漫游工程 |
| reconstruction_roaming.mp4 | 44 MB | 85 秒、24 fps、1280×720 的空间漫游 |
| reconstruction_physics_v1.usdz | 560 MB | 带刚体、碰撞和材质设置的交换文件首版 |
| reconstruction_web.glb | 17.2 MB | 从公开 USDZ 生成的轻量网页预览，隐藏顶面，压缩几何与贴图 |
网页首页可直接浏览原始实景、旋转三维模型并播放漫游视频。GLB 只用于浏览展示；编辑组件请使用 Blender 工程，物理数据保留在完整 USDZ 中。
合计约 1.13 GB。文件大小和 SHA256 见 manifest.json 与 SHA256SUMS。
下载模型与视频
安装 Git LFS 并克隆仓库，然后在仓库根目录运行：
git lfs install --local
git lfs pull
完成后直接用 Blender 打开 artifacts/reconstruction_native.blend。继续加工时，把新版本保存到本地 output/。USDZ 的动力学需要支持 USD Physics 的软件，普通模型查看器主要用于看模型。
如果下载 ZIP 后模型只有几行文本，那是 LFS 指针。请改用 Git 克隆并运行上述命令，或在 GitHub 文件页面下载实际文件。GitHub 源码压缩包是否包含 LFS 实体由仓库设置决定，见官方说明。
公开模型已去除现场二维码：纸张和包装保留几何，相关材质改为纯色；包含二维码的部分扫描贴图也已移除，隐藏扫描参考保留几何。视频使用局部遮罩处理对应区域。
公开模型包含其余随工程打包的现场纹理及隐藏扫描参考；原始 data/ 中的整套点云、全景、RAW 和其他下载资料不随仓库提供。素材范围见数据与许可。
维护者更新文件
.gitattributes 已为 artifacts/ 下的 .blend、.usdz、.mp4 和 .glb 配置 LFS。.gitignore 只放行已审查的文件名；新增成果时同步更新这份清单和校验信息。
更新时，将经过审查的公开副本放入 artifacts/，同步更新 manifest.json 与 SHA256SUMS，再暂存并检查：
git add .gitattributes artifacts/
git lfs ls-files
python3 tools/check_public_tree.py
检查器会确认暂存区保存的是 LFS 指针，并核对工作区实体的大小与 SHA256。源码检查支持只检出指针；网站构建只拉取网页 GLB 与 MP4，不下载大型 Blender 工程和 USDZ。确认后再自行提交和推送；Git LFS 的 pre-push hook 会上传相应的大文件。配置方式见 GitHub 官方指南。