GuaDa 的三方插件：把 Blender 3D 建模、场景检查、预览、渲染与导出接进 GuaDa。
参考
CheshireJCat/blender（dsh-blender）的能力形态，当前实现 13 个工具 + 30 个技能（1 编排 + 29 领域模块）+ 17 个确定性 helper（Phase 5）。 不依赖 BlenderMCP、不开放控制端口：每次操作启动独立的blender --background进程。
| 工具 | 用途 |
|---|---|
blender_status |
检查 Blender 路径/版本、workspace、配置 |
blender_scene_info |
只读检查 .blend（可指定对象） |
blender_run_script |
运行 workspace 内的 .py（等价 --python） |
blender_import |
GLB/GLTF、FBX、OBJ、STL、USD、PLY、DAE → .blend |
blender_python |
执行小段 bpy/bmesh 并保存新 .blend |
blender_preview |
临时相机+灯光预览（不改源文件） |
blender_render |
场景相机渲染单帧 |
blender_render_frames |
按帧号批量渲染（"1,3,5-7"，最多 120 帧） |
blender_export |
导出 GLB/GLTF、FBX、OBJ、STL、USD、PLY |
blender_validate_scene |
结构审计（general / web / 3d-print / animation） |
blender_validate_export |
干净进程回读导出物并审计 |
blender_helper_catalog |
列出确定性 helper 与依赖/可用性 |
blender_helper_run |
执行白名单 helper（参考图分析/渲染对比/动画 QA） |
技能：create-3d-model（编排流程 + 质量门）+ 29 个领域模块技能（建模/材质/灯光/相机/渲染/动画/UV/导出/参考图重建/修复/QA）。
模块技能在 skills/create-3d-model/references/modules/<name>/SKILL.md，通过 skill_learn 按需加载；路由表见 references/capability-map.md，工具映射见 references/guada-integration.md。
参考图分析、渲染对比、动画 QA：
animation-contact-sheet、reference-manifest-compiler、render-overlay-validator、silhouette-validator、template-analyzer、segment-source-parts、seeded-part-masks、atlas-region-detector、atlas-region-mapper、contour-correspondence-report、look-fit-report、multiview-fit-report、register-orthographic-views、view-constraint-report、wireframe-analyzer、mask-to-mesh-recipe、source-locked-skin-recipe
未收录（catalog 标 maintenance）：skill-graph-audit、release-readiness-check、sanitize-skill-contributions。
blender_render / blender_render_frames / blender_helper_run 支持 run_in_background: true：
返回 jobId 与 logFilePath，用宿主的 job_read / job_list / job_stop 轮询与取消。
（宿主的 PluginApi.startJob 按 shell 语义登记：字节日志 + 默认完成通知。）
manifest.configSchema 声明字段后，宿主插件页会出现「配置」按钮，自动渲染表单并写回
plugin:<id> 数据；不需要插件自带前端组件。本插件同时保留自带设置页（含「测试连接」这类动作）。
node scripts/e2e-character.mjs跑完输出 tmp/e2e-character/e2e-report.json 与图片；记录见 docs/E2E.md。
开发期（本地目录）：
local:D:/AI/work/guada-blender
发布后：
github:donggua-zen/guada-blender#main
安装后在插件页启用；设置页（设置 → GuaDa Blender）可配置 Blender 路径。
- GuaDa（PluginApi v2）
- Blender 4.x/5.x（本机验证 4.5）
- 可选：Python 3.10+（numpy / opencv / Pillow）用于 helper；不安装则 helper 标记 unavailable，不影响建模/渲染工具。
| Key | 默认 | 说明 |
|---|---|---|
blenderExecutable |
自动探测 | 绝对路径或 PATH 命令名 |
timeoutMs |
180000 | 单次 Blender 调用超时 |
maxOutputChars |
20000 | 返回日志上限 |
restrictToWorkspace |
true | 工具参数限制在会话 workspace 内 |
enablePython |
true | 允许 blender_python / blender_run_script |
analysisPythonExecutable |
自动探测 | helper 使用的 Python（需 numpy/opencv/Pillow） |
enableHelpers |
true | 允许 blender_helper_catalog / blender_helper_run |
helperTimeoutMs |
120000 | 单次 helper 超时 |
enableMaintenanceHelpers |
false | 允许 maintenance helper |
- 所有
*_path参数在插件侧做 workspace 守卫（realpath、防越界、默认不覆盖）。 blender_python/blender_run_script拥有与本机 Python 相同的权限；只应运行可信代码。blender_run_script只校验脚本路径；脚本内部的读写由脚本自己决定。- 每次调用使用独立临时目录，结束后清理。
npm run check
npm test
npm run build # 生成 frontend/dist/SettingsPage.jsMIT。Blender 侧 driver 移植自 CheshireJCat/blender（MIT），见 NOTICE。