前言¶
在 DeepSeek Harness（DSH）里做 3D 相关任务时，常见做法是让 agent 生成一段 bpy 脚本，再靠人工打开 Blender 执行、渲染、导出。这条链路断在「人要点界面、环境要对、5.x API 还会变」上，很难复现成可交付的资产。
@jojonadam/dsh-blender（仓库 JOJO-Adam/dsh-blender）面向的是另一类目标：在 Harness 里用 headless 方式跑 bpy、渲染、导出 glTF，并附带建模技法、Blender 5.x 踩坑说明和程序化资产管线说明。维护者为 JOJO-Adam，社区目录分类为「模型推理」；npm 包版本 0.1.2，许可证 MIT。
下面介绍它是什么、包含哪些技能、如何安装与做最小验证。
这是什么¶
一句话：dsh-blender 是 Blender 在 DeepSeek Harness 里的生产包——headless bpy runner、渲染与导出辅助、建模 cookbook、5.x pitfalls 与程序化资产管线。
README 明确写：不是教你怎么点 Blender，而是让 agent 能把场景建出来、渲染出来、导出成游戏资产。设计边界上默认 headless，确定性任务（建模、材质、渲染、导出）可复现；雕刻、手动绑定、视觉微调交给 MCP 或人；不代装 Blender、不代下资产；只在本机执行，不经过云端。
核心功能：技能模块¶
插件通过多份技能分工，总入口是 blender-studio。
| 技能 | 用途 |
|---|---|
blender-studio |
总入口：体检、headless 执行、渲染、导出（含客户端与示例） |
blender-env |
找不到 Blender、版本、METAL、黑图、权限、bpy 报错 |
blender-sop |
5.2 基线、Cycles/EEVEE 抉择、CC0 红线、导出纪律 |
blender-modeling-cookbook |
参数化建模、BMesh、修改器栈、拓扑、UV、选择性 Bevel |
blender-5x-pitfalls |
5.x 的 API 变更与已知坑 |
blender-asset-pipeline |
程序化资产、批量、LOD、glTF 导出、连续网格反模式 |
blender-mcp-bridge |
需要实时操控打开着的 Blender 时接 MCP |
需要 DSH 引擎 >=0.2.0-rc.2、Node >=20；peer 依赖 @deepseek-ai/cordis ~4.0.5。
安装与启用¶
安装命令以 README 为准，不要自行拼接 GitHub 类安装串。
# 从 npm
dsh plugin --profile web add @jojonadam/dsh-blender # Web 版
dsh plugin --profile desktop add @jojonadam/dsh-blender # 桌面版
# 本地开发
dsh plugin --profile desktop add link:/absolute/path/to/dsh-blender
前置：本机需已安装 Blender。README 以 Blender 5.2 LTS 为基线（macOS 默认路径示例为 /Applications/Blender.app）。插件不代装 Blender。
安装插件前，建议自行查看仓库源码与 MIT 许可证；插件以当前 dsh 进程权限在本机执行，与社区目录站点无官方从属关系，DSH 生态理念是「一切皆插件」。
典型用法：30 秒上手¶
先做环境体检，再做冒烟渲染，最后跑完整示例（参数化地砖 → 渲染 → 保存 .blend → 导出 .glb）。
# 1. 体检
python3 skills/blender-studio/scripts/blender_client.py doctor
# 2. 冒烟渲染（默认立方体，256×256）
python3 skills/blender-studio/scripts/blender_client.py smoke --res 256
# 3. 跑示例：参数化地砖 → 渲染 → 保存 .blend → 导出 .glb
python3 skills/blender-studio/scripts/blender_client.py run \
--script skills/blender-studio/examples/make_tiles.py \
--outdir outputs/blender/tiles
经过上面的步骤，可以确认本机 Blender 可被客户端调用，并产出渲染与 glTF 等输出目录。
验证¶
仓库提供的自动化与实机检查方式如下。
node test/provider.test.mjs
python3 skills/blender-studio/scripts/blender_client.py doctor
README 记载的实机验证环境为 Blender 5.2.1 LTS · macOS · METAL：EEVEE 256×256 冒烟约 3.5s；参数化地砖（9 块 + 选择性 Bevel + glTF）约 3.6s；Cycles 256×256 / 16 采样 CPU 约 1.3s、Metal 首次约 4–5 分钟（kernel 编译，记录日期 2026-10-19）。你的机器与渲染器不同，耗时不必对齐，以 doctor 与冒烟是否通过为准。
适用场景与注意¶
适合：已在 DSH 里编排 agent，需要可脚本化的建模、渲染、glTF 导出，并希望有 5.2 基线 SOP 与 5.x API 坑位参考的团队或个人。
不适合或需另接方案：依赖 GUI 雕刻与手工绑定的流程（可用 blender-mcp-bridge 接已打开的 Blender）；期望云端渲染或插件自动下载第三方资产（CC0 规则见 blender-sop）。
再次强调：执行发生在本机、当前 dsh 权限下；安装前请核对 GitHub 仓库 源码与许可证。
结尾¶
dsh-blender 把 Blender 从「只能给人用的桌面软件」收成 Harness 里可 headless 复现的生产包：体检、冒烟、示例管线到多份技能分工，边界也写清楚（headless 确定性任务 vs MCP/人工微调）。
