34 lines
3.3 KiB
Markdown
34 lines
3.3 KiB
Markdown
# 路径配置与部署迁移
|
||
|
||
完整 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` 复用开发者的其他环境来完成部署。
|