前言¶

DeepSeek Harness（命令名 dsh）把编码智能体跑在本地。文本、代码和文件读写它很熟，但一到三维资产，常见做法就变成：人在 Blender 里建好模型，再把 GLB 丢回工程。智能体既看不到场景拓扑，也不能按参考图校正轮廓，更没法在导出前做一次干净进程回读。

DeepSeek 官方把 Harness 的设计写成「一切皆插件」：模型、工具、技能、会话、沙箱、循环和 UI 都是可替换插件，不必改 Harness 源码。社区目录 deepseek-harness-plugin.com 收录了不少第三方扩展，它是独立站点，与 DeepSeek / 幻方没有官方从属关系，不能当成官方应用商店。

blender 就是这个目录里「工具与能力」分类下的一款插件。它不给 DSH 再接一套远程 MCP 或 Blender 插件端口，而是在本机拉起 Blender 后台进程，把建模、参考图重建、渲染验收、校验和导出收成同一条流水线。本文按目录详情页、仓库 README.md / README.zh-CN.md、package.json、CHANGELOG.md、NOTICE 以及 DeepSeek Harness 官方说明核对后整理。

这是什么¶

blender 由 CheshireJCat 维护，npm 包名是 dsh-blender，当前仓库版本 0.2.1（2026-08-14），许可证 MIT。社区目录页把它标成主要语言 Python；仓库本体是 Node.js 插件，真正改场景的是随每次调用拉起的 Blender 后台进程，参考图和视觉度量 Helper 再用 Python 3.10+ 跑 OpenCV、NumPy、Pillow、SciPy。

它解决的不是「在对话里描述一个模型」，而是这类任务：

• 按文本或参考图做低模 / 产品级建模
• 把线框、正交视图、贴图图集重建成可导出网格
• 给场景上材质、灯光、相机，并产出可给 read_image 看的渲染证据
• 按 Web、3D 打印或动画目标做场景审计，再导出 GLB / FBX 等格式
• 在现有 .blend 或可移植资产上继续改，而不是每次从空白场景推倒重来

插件说明写得很明确：它不是 DeepSeek AI 或 Blender Foundation 的官方产品。建模 Skill 改编自 create-3d-model-skill，模块配方和 Helper 脚本保留了上游 RobLe3/cc-blender-skill 的 MIT 许可内容，细节在仓库 NOTICE 与 skills/create-3d-model/references/upstream.md。

核对仓库页面时 GitHub 显示 16 颗星，社区目录页收录时标注 8 颗星，以仓库页面为准。

核心功能¶

插件注册 1 个总编排 Skill（create-3d-model）、29 个可直接加载的领域 Skill、26 个受控 Helper，以及 13 个工作区作用域的 Blender 工具。不要求安装 BlenderMCP，也不会开放控制端口；每次工具调用使用独立的 Blender 后台进程，临时脚本和 JSON 在结束后清理。

13 个运行时工具¶

按仓库 README.zh-CN.md 和 references/dsh-integration.md，模型侧能直接调用的工具如下。

推荐顺序写在集成文档里：先 blender_status；已有 .blend 先检查，其它格式先 blender_import；小步执行 blender_python；用预览/渲染加 read_image 验收；导出后再 blender_validate_export。用户没指定格式时，默认交付 .glb，.blend 当作可继续改的工程源文件。

30 个 Skill 怎么分工¶

总编排入口是 create-3d-model。其余 29 个模块按 capability-map.md 分成几组，需要时再用 DSH 的 skill 工具按 kebab-case 名称加载，不要把全部文档一次塞进上下文。

• 生产控制：blender-pro-workflow、blender-skill-harmonizer、quality-refinement-autoloop、mascot-logo-reconstruction
• Blender 领域：blender-modeling、blender-materials、blender-lighting、blender-cameras、blender-rendering、blender-animation、blender-export、blender-uv-texturing、wireframe-to-3d
• 参考图锁定重建：reference-to-3d、reference-analysis-validator、source-part-segmentation、contour-to-mesh、orthographic-registration、multiview-constraint-solver、atlas-uv-fitting 等
• 动画 QA：texture-state-animation、orbital-hud-motion、animation-quality-gate

文本或单图出模型，文档建议的路径是：blender-pro-workflow → 建模 → 相机 / 灯光 / 材质 → 渲染 → 需要时再导出。参考图要对齐轮廓时，才加载重建类模块，不要把「看起来像」和「按源图 1:1 拟合」混在同一次任务里。

分析 Helper 与 Blender 版本¶

26 个 Helper 通过目录和 runner 暴露。CHANGELOG 写明：其中 23 个建模相关 Helper 默认可用，3 个维护类 Helper 需要把 enableMaintenanceHelpers 打开才会执行。pnpm setup:analysis 或 dsh-blender-setup 会在插件目录建被 Git 忽略的私有 .venv，装上 OpenCV、NumPy、Pillow、SciPy。完全不做参考图、线框、多视图、贴图或动画分析时，才建议跳过这一步。

环境要求来自 README：

• DeepSeek Harness 0.1.0-rc.6
• Node.js 20+
• Blender 4.3+ 在 PATH 中名为 blender，或在配置里写绝对路径
• 当前实现已面向 Blender 5.x API 做适配；运行时版本应以进程内 bpy.app.version 为准，不要只看本机安装包名

安装与启用¶

社区目录页给出的安装命令是：

dsh plugin add github:CheshireJCat/blender

目录页同时提醒：如需可复现安装，应固定 commit 哈希：

dsh plugin add github:CheshireJCat/blender#commit

把 #commit 换成实际哈希。插件以当前 dsh 进程的权限运行，安装时可能执行代码，装之前应检查源码和许可证。

仓库 README 另外给出了写入 web profile 的 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

也可以固定 GitHub Release v0.2.1：

npx @deepseek-ai/dsh plugin --profile web add github:CheshireJCat/blender#v0.2.1

从源码开发时，在仓库根目录执行 dsh plugin --profile web add .，然后 dsh --profile web --dump-config 确认 bundle 层已经挂上，再重启 Web UI。界面默认地址是 http://127.0.0.1:3080。新建会话时，把 workspace 指到建模目录，而不是随便一个空文件夹。

典型用法¶

仓库中文 README 给的会话示例是：打开 Web UI，把 workspace 设为建模目录，然后对 dsh 说：

使用 create-3d-model 创建一个低多边形台灯。
先调用 blender_status，粗模和最终版本分别保存并渲染验收，
最后导出 GLB，同时保留版本化 .blend 源文件。

一次性 headless 验证可以这样写（在插件仓库根目录）：

npx @deepseek-ai/dsh plugin --profile headless add .
npx @deepseek-ai/dsh --profile headless \
  "使用 create-3d-model 在 artifacts 下创建一个低多边形蓝色立方体，渲染预览并导出 GLB。"

集成文档还规定了路径约定：持久产物放在 artifacts/<任务名>/ 这类目录；每个大阶段用新的版本化 .blend，例如 lamp-blockout-v001.blend、lamp-final-v002.blend；不要把交付物写到 /tmp；默认拒绝覆盖已有文件，除非明确允许。

开发侧自检命令也在 README 里：

pnpm install
pnpm setup:analysis
pnpm validate
pnpm test
pnpm test:blender

test:blender 会真实启动 Blender，覆盖创建与导入 .blend、对象检查、场景审计、预览与正式渲染、导出 GLB，以及干净进程回读。

配置项¶

默认配置在 cordis.patch.yml：

config:
  blenderExecutable: blender
  analysisPythonExecutable: ''
  timeoutMs: 180000
  helperTimeoutMs: 120000
  maxOutputChars: 20000
  restrictToWorkspace: true
  enablePython: true
  enableHelpers: true
  enableMaintenanceHelpers: false
  registerSkill: true
  registerModuleSkills: true

几个开关的含义以中文 README 为准：

• restrictToWorkspace: true：输入输出都限制在当前会话 workspace，并检查符号链接的真实目标
• enablePython: false：关掉能力最强、风险也最高的 blender_python，仍可检查、渲染和导出
• enableHelpers: false：关掉 Helper 目录和执行工具，基础生产工具不受影响
• enableMaintenanceHelpers: false：默认禁止 Skill 发布/清理类维护脚本
• registerModuleSkills: false：只注册总编排 Skill，不注册 29 个领域 Skill
• registerSkill: false：只注册工具，不向 DSH Skill 目录贡献任何 Blender Skill

Blender 不在 PATH 时，把 blenderExecutable 改成绝对路径。分析环境也可以把 analysisPythonExecutable 指到已有的 Python。

适用场景与注意事项¶

适合这些情况：本机已经装了 Blender 4.3+，希望 dsh 在会话 workspace 里直接出可导出的 3D 资产；需要从文本、参考图、线框或已有模型继续改，并且要用渲染图和场景审计当验收，而不是只看文件体积。

不适合的预期也要说清楚。它不会替代交互式 Blender 视口里的精细雕刻手感；默认关闭 Poly Haven、Sketchfab、Hyper3D、Hunyuan3D 这类联网资产或生成服务，除非用户明确要求。quality-refinement-autoloop 在普通建模任务里不应去改 Skill、文档或 Git 状态。

安全边界以仓库 README 为准：blender_python 的权限和在 Blender 里跑本地 Python 相同，只应处理可信的建模代码，不要用它下载资源、读凭据、装包、拉起无关进程或改 Blender 全局偏好。插件默认会禁用 .blend 内嵌脚本自动执行、把路径限制在 workspace、拒绝覆盖已有文件、每次调用使用独立后台进程。即便如此，插件仍以当前 dsh 进程权限运行，安装前应阅读源码和 MIT 许可证，生产环境优先固定 commit 或 Release 标签。

小结¶

blender（npm 包 dsh-blender）把 Blender 当成 DSH 的本地生产后端：13 个工具负责检查、改场景、渲染和导出，30 个 Skill 负责编排和分域，26 个 Helper 负责参考图与验收。对已经在用 DeepSeek Harness、又需要把三维资产留在工作区里的人，这条流水线比「模型口头描述、人再去 Blender 里做一遍」要完整得多。

目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/blender/

GitHub：https://github.com/CheshireJCat/blender