dsh-blender

English

一个可安装到 DeepSeek Harness 的完整 Blender 3D 生产插件。它以 create-3d-model-skill 为蓝本，注册 1 个总编排 Skill、29 个可直接加载的领域 Skill、26 个受控分析/验证 Helper，以及 13 个可实际执行的 Blender 工具。

提供的能力

• 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：不依赖已有相机，以等距/前后左右/顶底视角生成临时灯光预览，不修改源文件。
• blender_render / blender_render_frames：生成单帧或动画代表帧的 PNG/JPEG 视觉证据。
• blender_export：导出 GLB/glTF、FBX、OBJ、STL、USD 或 PLY。
• blender_validate_scene / blender_validate_export：按通用、Web、3D 打印或动画目标审计场景，并通过干净进程回读导出物。
• blender_helper_catalog / blender_helper_run：发现并执行全部 26 个参考图、线框、轮廓、多视图、UV、贴图、外观、修复与动画 QA Helper。
• 30 个 Skill：create-3d-model 负责总编排，其余模块（例如 blender-modeling、reference-to-3d、wireframe-to-3d、blender-animation）可由 DSH 直接加载。

插件直接启动 Blender 后台进程，不要求安装 BlenderMCP 插件，也不会开放控制端口。

环境要求

• DeepSeek Harness 0.1.0-rc.6
• Node.js 20+
• Blender 4.3+；当前实现已面向 Blender 5.x API 适配
• blender 在 PATH 中，或在 cordis.patch.yml 中配置绝对路径

参考图、线框和视觉度量 Helper 还需要 Python 3.10+。本仓库提供一次性安装命令：

pnpm setup:analysis

它只会在插件目录创建被 Git 忽略的 .venv，并安装 OpenCV、NumPy、Pillow 和 SciPy。也可以把 analysisPythonExecutable 指向已有环境。

从 npm 安装

npx @deepseek-ai/dsh plugin --profile web add dsh-blender
npx @deepseek-ai/dsh plugin --profile web exec dsh-blender-setup
npx @deepseek-ai/dsh --profile web --dump-config
npx @deepseek-ai/dsh web

dsh-blender-setup 会在已安装的插件目录创建私有 .venv，并安装 OpenCV、NumPy、Pillow 和 SciPy。只有在完全不需要参考图、线框、多视图、贴图或动画分析 Helper 时才建议跳过。