d-robotics 32344684b1 docs+test: 板端推理四机评测——方法/结论文档与基准脚本
- 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>
2026-10-13 13:58:16 +08:00

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 内存异常等待办)。

Description
No description provided
Readme 32 MiB
Languages
Python 94.7%
Shell 1.9%
HTML 1.7%
C++ 1.6%