SuperAPI AI 工具集

ovphysx-host-runtime-boundary

智能体与模型

查看项目

更新于 10-16 02:34

技能介绍

用途:该技能用于 Hermes 在 OpenShell 沙箱内运行、而可见 Blender、OVPhysX 原生扩展与 ovphysx_grpc_server 位于宿主的分离部署场景。当任务要求运行配置好的原生 OVPhysX 演示时,应优先选用本技能,配合官方 ovphysx-drop-contact-acceptance 技能使用;当前打开的 Blender 场景不是固定装置,无需包含楼梯或刚体。

主要能力:已安装宿主助手位于 ~/.local/share/nemoclaw-blender/ovphysx_host_helper.py,支持 run_configured_demo、preflight、prepare、preview、simulate、replay、status 等动作。run_configured_demo 一次完成完整演示并返回紧凑的原生模拟与 GIF 回执;其余动作可依序单独调用,每次返回紧凑 JSON 回执。助手为每个固定装置维护专用 Blender 场景,重复 preview 与 replay 会复用该场景并恢复导入变换。simulate 运行时间线适配器,写入 pose-timeline.json、ovphysx-report.json 与 status.json;replay 只接受标记为 native-ovphysx-readback 的时间线,渲染结果标记为 blender-replay。

使用方式:只能通过 Blender MCP 工具 mcp_blender_execute_blender_code 调用,将助手脚本作为 code 参数传入,例如以 runpy.run_path 加载助手并传入 OVPHYSX_REQUEST 字典。配置演示请求用 action 为 run_configured_demo 且不加覆盖;其他任务只在请求中放入必要覆盖项,如 fixture、body_prims、output_dir、steps、sample_every、fps、device、可选 body_map 和渲染设置。自定义固定装置须是宿主可见的 USD 文件。

限制:沙箱终端与文件工具看不到 Blender 宿主文件系统,标准工作流不把 OV 检出或原生运行时复制进沙箱;原生二进制与扩展不在 /sandbox 下是正常现象,不应据此判断 OVPhysX 不可用,也不要让用户复制原生库进沙箱。不要用沙箱 Python 直接运行原生探测,不要在 /home/... 路径上使用沙箱 read_file、terminal、write_file,也不要让 Blender 打开 /sandbox/... 路径。宿主 preflight 只有在 Blender 报告其已安装运行时不存、不健康或不兼容时才算受阻。若助手缺失,应报告该设置阻碍而非临时重建。Blender Python 属性、枚举、算子与动画 API 应先通过 blender-python-api-verification 技能并借助 Blender MCP 检查运行中的 API。不得用 Blender 刚体、关键帧或推断运动替代失败的原生运行,GIF 只能来自权威 OVPhysX 姿态回读并准确标注渲染路径。