SuperAPI AI 工具集

blendertorcp-setup

设计与创作

查看项目

更新于 10-16 06:42

技能介绍

用途:配置 BlenderToRCP CLI,使智能体可从终端导出场景、烘焙纹理、校验材质并管理设置。

前置条件:已安装 Blender 5.0+;已在 Blender 偏好设置中安装并启用 BlenderToRCP 插件;Python 3 可通过 python3 调用。手动安装时在 Blender 的 Edit > Preferences > Extensions > Add-ons > Install from Disk... 安装 BlenderToRCP.zip,然后启用 BlenderToRCP;开发安装则将 <repo>/Plugin 软链接到 Blender 的 extensions/user_default/BlenderToRCP 路径。

可选输入 blender-path:显式指定 Blender 二进制文件路径。

主要步骤:1) 定位 Blender 二进制,若用户提供路径则验证其存在,否则探测常见位置(macOS 检查 /Applications/Blender.app/Contents/MacOS/Blender,Linux 使用 command -v blender 或 which blender),未找到则先询问路径。2) 定位扩展根目录,检查 cli/main.py 与 api/runner.py 是否存在,并验证安装。3) 测试连接:设置 BLENDERTORCP_BLENDER 后运行 version、preferences get、settings list 等命令确认 Blender 启动及插件注册正常;开发检出可用 --blender <path>。失败时可按错误代码排查:Blender not found(2)、No output from Blender(1)、Failed to import command registry(3)等。使用 --json 可获得结构化错误输出;支持采集可用 support-bundle。4) 配置 shell,在 ~/.zshrc 或 ~/.bashrc 中添加 export BLENDERTORCP_BLENDER 与 alias blendertorcp,并验证别名可用。5) 报告解析出的 Blender 路径、扩展根或 repo Plugin 路径、别名配置情况及验证输出。

限制:资料未提供收费、价格、平台覆盖范围及具体导出效果等额外信息。