SuperAPI AI 工具集

blender-host-sandbox-boundary

设计与创作

查看项目

更新于 10-16 02:34

技能介绍

用途:当 Hermes 终端与文件工具运行在 OpenShell 沙箱、而 Blender MCP 运行在宿主 Blender 进程内时,本技能用于对 Blender、USD、OVRTX、OVPhysX 相关操作按执行进程分类,避免在错误的执行面上探测文件或软件。

主要能力:区分三类执行面:Hermes 终端与文件工具(可见 /sandbox/... 与沙箱 /tmp/...);Blender MCP(可见活动场景、bpy、插件、渲染引擎及宿主产物);外部操作者(通过 nemohermes sandbox upload/download 跨边界复制文件)。任务分类为 MCP-only、Sandbox-only、Hybrid 三类;在混合边界处应停止并返回 TRANSFER_REQUIRED。

使用方式:先阅读本技能再探测文件或软件。按执行面探测能力:bpy、活动 .blend、插件、OVRTX、OVPhysX 及宿主文件存在性走 Blender MCP;沙箱路径与命令只用沙箱工具。每次只执行一个面内里程碑并在同一面验证。当 blender-workflow MCP 服务器可用时,优先使用类型化工具(capability_probe、scene_inventory、usd_export、usd_inspect、artifact_receipts);通过 tool_search 发现类型化工具后,首次调用前先调用 tool_describe,不得猜测或改名参数字段。路径契约:scene_inventory 可选 output_path;usd_export 必填 output_path、可选 selected_objects_only;usd_inspect 必填 input_path、可选 output_path;artifact_receipts 必填 paths 数组。若返回 invalid_arguments,先 tool_describe 修正参数再重试一次。

限制:Hermes 无法在沙箱内运行宿主侧 nemohermes 传输命令;有界交接配置不能运行任意参考或检查代码。工具结果保持精简,将详细清单写入宿主 JSON,只在对话中返回计数、路径、大小、哈希与阻塞项。类型化工具不模拟 SimReady,若无启用的受支持 SimReady 插件,应将相关里程碑报告为阻塞。工具返回 BLOCKED 或用户拒绝命令时停止,不重试或换写法。禁止使用 find /、从沙箱检查受限宿主目录、或安装第二个 Blender。缺少沙箱内 blender、bpy 或宿主文件不代表宿主能力缺失。仅当 artifact_receipts 返回 present 且大小非零并带 SHA-256 时,才报告宿主输出。