- docs/BENCH_INFER.md: 统一评测方法(部署只用交付项目内产物; micro 裸模型 + soak 真实 service 50Hz 假机体压测; 生产同构配置 钉2核+ORT_THREADS=2) 与 S600/S100/S100P/X5 四机结果表及选型结论; 记录未修缺陷: service 无 有效遥测时收 TO_DANCE 崩溃(待批) - tests/bench_infer_board.py: 上述基准脚本(布局自适应仓库/板端, 支持基准 与 service 分核消除工具竞争) - README: docs 目录树补 BENCH_INFER Co-Authored-By: Claude Code <noreply@anthropic.com>
HoloMotion_S600HIL
基于 HorizonRobotics/HoloMotion(G1 29DoF 全身运动基础模型,Unitree G1)开发的下游控制台:网页遥控器 + 仿真机体 + 跨网链路层 (SPINE)+ 板端部署,一套代码两种推理位置(本机 / 板端)。
上游以 git subtree 方式内嵌于 upstream/(钉在 v1.4.1,即 cf2018a),官方更新经
docs/UPSTREAM_MIGRATION.md 的 SOP 合入;自研代码与官方代码物理隔离,永不冲突。
HoloMotion_S600HIL/
├── upstream/ 官方 HoloMotion(subtree;代码全在 git)
├── console/ 自研代码正本
│ ├── robot_service/ 大脑:service.py(双模型推理) + web_remote(网页) + net_harness_body(仿真机体)
│ ├── spine_v2/ UDP 抗丢包链路层(A/B 分离部署)
│ ├── holo_driver/ MuJoCo 键盘驾驶 demo
│ └── net_probe/ 网络诊断工具
├── clips/ 运行时动作 npz(9 个,已在 git)
├── scenes/ 自建场景(多物体/斜坡;默认行走用官方平地场景)
├── checkpoints/ 模型(★git 外,见"需要下载的内容")
├── scripts/ verify_stack.sh(验收门)/ pack_board.sh(板端打包)
├── tests/ 对拍 / 冒烟 / 资产 / 可移植性四件套
├── board_runtime/ 板端最小 payload + MANIFEST(装配产物)
└── docs/ INTERFACE / UPSTREAM_MIGRATION / DEPLOY_BOARD / BENCH_INFER
快速开始(新机器从零到验收绿)
0. 环境
- A 机(本机,仿真+开发):conda 环境
holomotion_train,依赖清单与装法见upstream/docs/environment_setup.md(mujoco / onnxruntime / zmq / aiohttp / loguru / omegaconf…)。 - 板端:conda 环境
holomotion;离线轮子(aarch64 cp311)不在 git,用bash scripts/fetch_wheels.sh下载(内嵌权威 URL+MD5 表,见docs/DEPLOY_BOARD.md)。 - 启动脚本可用
CONSOLE_PY=<python路径>覆盖解释器,默认$HOME/miniconda3/envs/holomotion_train/bin/python。
1. 需要下载的内容(git 之外的仅此三样)
| # | 内容 | 体积 | 官方来源 | 放置位置 |
|---|---|---|---|---|
| 1 | 动作跟踪模型 v1.4.1 | 1.6G | huggingface.co/HorizonRobotics/HoloMotion_models 的 HoloMotion_motion_tracking_model_v1.4.1/ |
<repo>/checkpoints/HoloMotion_motion_tracking_model_v1.4.1/ |
| 2 | 速度跟踪模型 | 3.7M | 同仓库的 HoloMotion_velocity_tracking_model/ |
<repo>/checkpoints/HoloMotion_velocity_tracking_model/ |
| 3 | 机器人资产(G1 meshes) | ~100M | huggingface.co/datasets/HorizonRobotics/HoloMotion_assets 的 assets/ |
<repo>/upstream/thirdparties/HoloMotion_assets/assets/ |
在仓库根目录执行(huggingface_hub≥0.34,命令为 hf;国内可加镜像):
pip install -U "huggingface_hub[cli]"
export HF_ENDPOINT=https://hf-mirror.com # 国内镜像,海外可省
# ①② 模型 —— 运行时精简集(.pt/safetensors 训练权重不下载,省 ~100M)
# 注意 hf>=2.x 用「仓库名后接文件名列表」的写法(--include 多值会被吞,实测)
hf download HorizonRobotics/HoloMotion_models \
"HoloMotion_motion_tracking_model_v1.4.1/config.yaml" \
"HoloMotion_motion_tracking_model_v1.4.1/SHA256SUMS" \
"HoloMotion_motion_tracking_model_v1.4.1/exported/model_16200.onnx" \
"HoloMotion_velocity_tracking_model/config.yaml" \
"HoloMotion_velocity_tracking_model/exported/velocity_model.onnx" \
--local-dir checkpoints
# 要完整版(含训练权重/官方 sim2sim 输出)去掉文件名列表整目录下载即可
# ③ G1 meshes(HF dataset)
hf download HorizonRobotics/HoloMotion_assets --repo-type dataset \
--local-dir /tmp/hm_assets
mkdir -p upstream/thirdparties/HoloMotion_assets
mv /tmp/hm_assets/assets upstream/thirdparties/HoloMotion_assets/
rm -rf /tmp/hm_assets
# 备选(git 方式,镜像前缀可换 hf-mirror.com):
# git clone https://hf-mirror.com/datasets/HorizonRobotics/HoloMotion_assets \
# upstream/thirdparties/HoloMotion_assets
校验(官方清单,含 onnx):
cd checkpoints/HoloMotion_motion_tracking_model_v1.4.1 && sha256sum -c SHA256SUMS; cd -
可选:console/holo_driver(键盘驾驶 demo)需要 meshes 的本地副本:
cp -aL upstream/assets/robots/unitree/G1/meshes console/holo_driver/meshes # ~89M
路径都可不走软链直接放实体文件;
RS_CKPT_DIR/RS_UPSTREAM环境变量可整体重定向 (板端即此用法,见docs/INTERFACE.md)。不放浏览器下载的话,两个 HF 页面: HoloMotion_models · HoloMotion_assets。
2. 验收(一条命令,四门全绿即环境完整)
bash scripts/verify_stack.sh
# portability / clips / obs-parity / smoke(本机全栈:行走+青海摇+急停,含不摔判定)
两种运行模式(同一套代码,环境变量切换)
模式 1 · 推理在本机:console/robot_service/run_all.sh
(service + 仿真机体 GUI + 键盘 keyop;web_remote.py 起网页 :8877 可选)
模式 2 · 推理在板端:见 docs/DEPLOY_BOARD.md
(A 机跑机体:console/robot_service/run_body_A.sh;板端跑大脑+网页+SPINE-B:
run_split_B.sh,含 UDP 抗丢包链路。板端交接保持手动 scp 纪律)
上游升级
上游发新版时按 docs/UPSTREAM_MIGRATION.md 执行(探测 → 接口面核对 → subtree pull →
恢复下载件 → 验收门 → 打 tag → 打包板端)。九项文件依赖契约与环境变量契约见
docs/INTERFACE.md——那是"升级不翻车"的锚点。
已知问题
见 docs/INTERFACE.md §4(含模式 1 WALK→DANCE 间歇性摔倒的实测统计、板端
spine.py 内存异常等待办)。