Files
chenlin c32df70326
Checks / Layout, translation and Colab checks (push) Has been cancelled
Checks / Ruff (push) Has been cancelled
Checks / Framework tests (native backend, CPU) (push) Has been cancelled
Checks / Portable Rust controller (push) Has been cancelled
release: v0.1 generic robot training and application platform
2026-11-05 11:05:01 +08:00

4.1 KiB

导出、验收与机器人应用打包

确定性流程从规范化模型和明确的控制契约开始。Agent 技能负责选择路线并提取元数据;CLI 命令负责转换、数值检查和发布。

实现消费端时请阅读 BUNDLE.md,资产接入流程见主教程。

原生 MuJoCo 应用

python scripts/onboard.py inspect assets/my_robot
python scripts/onboard.py build-mjcf assets/my_robot --output out/my_robot/model.xml
python scripts/onboard.py setup-tier2 --model out/my_robot/model.xml \
  --config assets/my_robot/controller.json --output out/my_robot/control
python scripts/onboard.py verify --model out/my_robot/control/robot.xml \
  --config out/my_robot/verify-input.json --report out/my_robot/verification.json
python scripts/deploy.py --robot my_robot --model out/my_robot/control/robot.xml \
  --control out/my_robot/control/controller.json --controls out/my_robot/control/controls.yaml \
  --verification out/my_robot/verification.json --bundle out/apps
python scripts/play.py --app out/apps/my_robot.app --headless --steps 100
python scripts/deploy.py --check-reference out/apps/my_robot.app

IK、关节滑块、轨迹、轮速混控、CPG 和策略适配的配置示例见 CONTROLLER_SETUP.md。验收必须明确规定预期的物理响应。生成配置或成功编译 ONNX 图,均不能证明机器人能跟踪命令。

仅几何资产可以省略 --control 与 --verification,发布 model_viewer 应用。这类包不声明物理或控制验收通过。受控应用的验收记录必须与模型依赖、控制器参数、操作绑定、策略和轨迹文件完全匹配,否则拒绝打包。

ONNX 应用还须提供 --policy <export> 及经过验收的控制器 JSON。原生应用包含规范化模型、网格、契约、参考记录和便携 Python 运行时;主机需要安装 Python 及列出的第三方依赖。控制模式支持按版本明确声明;不能将原生混合动作契约交给旧版板端读取器。

使用可重复的 --license PATH 参数加入导入资产的许可证及来源说明。应用会保留这些文件及其摘要;平台许可证不能替代第三方条款。

训练导出

python scripts/export.py --task my_robot --checkpoint logs/my_robot/my_robot/run/model_N.pt

导出器校验可测量的观测项,以及与检查点之间的数值一致性。保留输出中的关节顺序、动作变换、增益、频率、命令范围和来源记录。使用训练检查点时的代码版本及机器人规格。训练后改变环境配置,并不等于完成旧策略的适配。

旧版板端与网页构建

Rust FSM 继续作为其支持的旧版策略契约的公共控制器。manifests.json 不再预置机器人。请为目标机器明确填写导出路径、模式切换及级联配置,或使用:

python scripts/deploy.py --mode walk=<export-directory> --bundle out/legacy

完整的旧版构建会将 ONNX 转为 RKNN,交叉编译板端控制器和 Python 扩展,构建 WebAssembly,在每个包含的主机端校验契约,写入参考记录并打包成一个应用。它需要文档中列出的工具链。--allow-incomplete 会省略不可用的板端组件并记录缺失项;该选项用于开发主机,不代表可以上板发布。

不要推测板端地址或机械兼容性。部署前,使用明确的主机地址执行 deploy 技能的只读板端预检。先用 --dry-run 打开应用,再运行 --check-reference;这些检查不会驱动总线。实际硬件操作需要目标机器配置及操作者的明确指令。

操作手册

每次构建都包含 manual.en.json。构建后使用 bundle-manual 技能生成中文译本,通过以下校验入口加入:

python scripts/deploy.py --translate out/apps/my_robot --language zh --manual /tmp/manual.zh.json

标识符必须保持不变。命令会更新文件摘要并重新打包应用。