Unitree Hermes Colab 笔记本

要解决什么问题

在 Unitree 机器人项目中，开发者经常需要快速搭建一个可复现的 AI Agent 测试环境，但 Colab 并不是安全的机器人控制宿主。直接在 Colab 中执行机器人控制指令、发布 DDS/ROS 话题或扫描机器人局域网地址，既违反平台限制，也可能带来安全风险。这个技能帮助开发者创建或审查一个结构化的 Colab 笔记本，让 Hermes Agent 在 Unitree 工作流中真正可用——同时不越界。

它做了什么

技能的核心逻辑围绕一个原则：Colab 只负责安装、准备和审查，不负责控制。

笔记本或 runner 顶部保留一个统一的配置块，包含 INSTALL_HERMES、RUN_HERMES_AGENT、CLONE_UNITREE_REPOS、PROVIDER、MODEL 和输出目录等参数。运行时会记录 Python、平台、GPU/CUDA 状态、Hermes CLI 状态以及克隆仓库的 commit SHA，保证可追溯。

默认情况下，技能只克隆三个关键仓库：unitreerobotics/xr_teleoperate、unitree_sdk2_python 和 unitree_mujoco。在执行可选的 Hermes 操作之前，会先生成一份本地 AGENTS.md 安全文件。

至少覆盖以下用例：

• 仿真运行手册
• 遥操作飞行前检查清单
• 日志分诊
• 贡献机会探索
• IK 证据审查

输出以报告形式呈现：卡片、仓库地图、流程可视化、审查门和引用。最终保存 unitree-hermes-report.md、unitree-hermes-review.json、AGENTS.md 和流程可视化图。

报告面向用户使用"审查门"、"运行时"、"用例"、"引用"等标签，不泄露元指令。同时给出一个关键有用性评分——在设置审查和日志分诊场景中价值高，在实时机器人控制场景中价值低。

边界与注意点

绝不从 Colab 执行机器人控制指令。 不发布 DDS、ROS、电机、运动模式或底层命令。不通过 SSH、SCP、隧道或扫描 192.168.123.0/24 等 Unitree 局域网地址。除非用户提供了外部证据，否则不声称已验证物理硬件。

需要本地主机执行的高风险命令会放入带引号的运行手册中，由人工审查并在正确机器上运行。Hermes 的一次性执行必须显式开启（RUN_HERMES_AGENT）；默认只安装 Hermes 和准备提示词是可以接受的。

子代理审查仅在用户明确要求并行/子代理审查时启用，且保持只读为主，分为安全审查员、笔记本审查员和贡献审查员三类。主代理等待总结后整合发现，避免并行写操作。