本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

blender

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-blender

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• blender_status：检查 Blender、图像分析 Python、30 个 Skill、Helper 和当前 workspace。
• blender_scene_info / blender_object_info：只读检查场景及对象级世界包围盒、求值后拓扑、UV、材质、约束、形态键和动画。
• blender_import：把 GLB/glTF、FBX、OBJ、STL、USD、PLY 或 DAE 导入干净场景并保存版本化 .blend。
• blender_python：执行小段 bpy/bmesh 建模代码并保存版本化 .blend。
• blender_preview：不依赖已有相机，以等距/前后左右/顶底视角生成临时灯光预览，不修改源文件。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后还需要做什么才能用？

需要在系统 PATH 中能调用 blender（Blender 4.3+），或通过 cordis.patch.yml 把 blenderExecutable 指向绝对路径；想用参考图/线框/动画分析 Helper 还需执行 dsh-blender-setup 安装 Python 依赖。

是不是要装 BlenderMCP 或开端口？

不需要。插件直接以 --background 启动本地 Blender 子进程，每次调用都是独立进程，并通过 --disable-autoexec 禁止 .blend 内嵌脚本自动执行，不开任何控制端口。

blender_python 安全吗？

它等价于在 Blender 内运行本地 Python，等同代码级权限。可以通过把 enablePython 设为 false 关闭它，只保留检查、渲染、导出工具；默认还限制所有输入输出路径必须在 dsh 会话 workspace 内。

默认会覆盖我已有的 .blend 文件吗？

不会。所有写操作默认拒绝覆盖已有文件，需要明确传 allow_overwrite=true 才会替换；建议按版本号命名（如 model.v1.blend / model.v2.blend）保持工程源文件可追溯。

支持哪些导入导出格式？

导入支持 GLB/glTF、FBX、OBJ、STL、USD、PLY、Collada(DAE)；导出支持 GLB/glTF、FBX、OBJ、STL、USD/USDA/USDC、PLY；推荐默认输出 .glb 作为通用交付物。

怎么卸载？

从宿主 DSH 的 cordis.patch.yml 中删除 blender-modeling 那一段 insert，再重启 dsh 即可；本地安装还会残留 .venv 与可能下载的 Blender 工程文件，可手动清理。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+
• Node: >=20

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则