Files

34 lines
3.3 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.
# 路径配置与部署迁移
完整 RGB-D 流程以 [SETUP_AND_WEIGHTS.md](SETUP_AND_WEIGHTS.md) 为安装入口。项目根目录由脚本位置计算,不要求开发者的主目录、下载目录或共享 Python 环境存在。
## 本机路径如何替换
| 项目 | 当前行为 | 目标机器操作 |
|---|---|---|
| 项目根目录 | `Path(__file__)` 或 Bash 脚本位置定位 | 可以放在任意目录,命令从项目根目录执行 |
| MANO | 默认 `third_party/hamer/_DATA/data/mano/`,Dyn-HaMR 相对链接共用 | 自行取得模型并放入共享目录 |
| CUDA toolkit | 已设 `CUDA_HOME` → 项目内 toolkit → `PATH` 的 nvcc | 安装匹配的 toolkit;必要时显式设置 `CUDA_HOME` |
| NVIDIA 包头文件 | 从主 Python 环境查找 | 安装到自己的主环境,不复制开发者环境 |
| 编译 GPU 架构 | 默认由 PyTorch 检测;保留调用者配置 | 无可见 GPU 编译时按自己的目标设置 `TORCH_CUDA_ARCH_LIST` |
| 历史视频入口 | `run_handflow_15886123.py`、`export_camera_delivery.py` 使用必填 `--input` | 显式传入自己的原视频 |
| 嵌套示例录制 | 资源检查命令建立缺失的相对链接 | 拉取 LFS 后执行 `--prepare-example --recording-only` |
`MANO_ROOT`、`HAMER_CKPT`、`DETECTOR_CKPT`、`VIPE_PYTHON` 的自定义值在加载环境模板时保留。支持环境变量的入口可采用覆盖值,Dyn-HaMR 等上游固定资源目录仍需放置资源或正确链接。
## 示例参数与上游路径
消除个人主目录依赖不等于任意视频自动适配。当前双盒主流程仍有固定序列名、帧数、颜色阈值和 CAD 映射,见 [更换视频](PIPELINE_LATEST.md#3-换一段新视频要改什么)。两个旧视频入口仍对应各自历史数据的输出和验收约定,仅输入路径已参数化。
第三方源码保留了上游示例默认值,例如 Dyn-HaMR 的 `video_vipe.yaml`、可选 METRO 入口 `HMP/fitting_utils.py::run_metro`、HaMeR 评测数据目录,以及 FoundationPose 的调试目录。集成 RGB-D 启动脚本显式传入数据与相机路径,物体跟踪脚本显式传入调试目录。这些可选上游入口需要另行配置,不应直接当成可移植的完整入口。
`PORTABILITY_REPORT.json`、`UPSTREAM_SOURCES.json`、`SHA256SUMS` 是原源码快照的审计与来源记录,可能包含后来已修改的行号、标识或历史路径;当前内容以 Git 提交为准。它们不会要求上传记录中提到的个人文件夹。当前分片权重校验使用 `configs/large_files.json`。
## 验证范围
`scripts/check_pipeline_resources.py` 仅使用 Python 标准库,检查录制布局、模型文件存在性、未拉取的 LFS 指针和部分权重大小;不反序列化 MANO,不加载网络,不验证位姿精度或物理抓取。`large_files.py assemble` 另行校验分片权重 SHA-256。GPU 扩展、网络前向和物理冒烟检查分别按安装文档执行,完整抓取按每段实验结果验收。
## 2026-10-29 资源策略与验证范围
预训练权重和统计数据改为 [外部获取](EXTERNAL_RESOURCES.md),不能再靠 LFS/assemble 恢复所有模型。独立源码与依赖副本的组件验证见 [记录](VALIDATION_20261029.md);不是干净安装或完整串联通过的声明。不要通过 `.pth` 复用开发者的其他环境来完成部署。