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
标识符必须保持不变。命令会更新文件摘要并重新打包应用。