夜雨聆风学习资料网

ARTICLE · 1095875

用 blender 插件给 DeepSeek Harness 接上建模、渲染与导出

发布时间：2026-09-29 09:01:33 最近访问：2026-09-29 09:01:34
用 blender 插件给 DeepSeek Harness 接上建模、渲染与导出

不必再把 GLB 人肉丢回工程

在本机把建模、渲染、导出收成一条流水线

社区插件 blender · npm 包 dsh-blender

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 官方说明核对后整理。

01

PART

这是什么

WHAT · LOCAL BACKEND

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 颗星，以仓库页面为准。

02

PART

核心功能

FEATURES · PIPELINE

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

13 个工具

检查、改场景、渲染、导出

30 个 Skill

编排 + 分域加载

26 个 Helper

参考图与验收

13 个运行时工具

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

工具
作用
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

推荐顺序写在集成文档里：

1

先blender_status

2

已有.blend先检查，其它格式先blender_import

3

小步执行blender_python

4

用预览 / 渲染加read_image验收

5

导出后再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。完全不做参考图、线框、多视图、贴图或动画分析时，才建议跳过这一步。

🛠 环境要求 · 开工前先对齐

✓ DeepSeek Harness 0.1.0-rc.6

✓ Node.js 20+

✓ Blender 4.3+ 在 PATH 中名为 blender，或在配置里写绝对路径

✓ 当前实现已面向 Blender 5.x API 做适配；运行时版本应以进程内 bpy.app.version 为准，不要只看本机安装包名

03

PART

安装与启用

INSTALL · SETUP

STEP 01

社区目录安装

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

bash

dsh plugin add github:CheshireJCat/blender

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

TERMINAL

$ dsh plugin add github:CheshireJCat/blender#commit

# 把 #commit 换成实际哈希

✦ 安装前先看源码

插件以当前 dsh 进程的权限运行，安装时可能执行代码，装之前应检查源码和许可证。

STEP 02

写入 web profile 的 npm 安装

仓库 README 另外给出了写入web profile 的 npm 安装方式，并带上分析环境初始化：

...bash

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 Releasev0.2.1：

bash

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

STEP 03

从源码开发

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

04

PART

典型用法

USAGE · WORKFLOW

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

text

使用 create-3d-model 创建一个低多边形台灯。

先调用 blender_status，粗模和最终版本分别保存并渲染验收，

最后导出 GLB，同时保留版本化 .blend 源文件。

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

TERMINAL

$ 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 里：

...bash

pnpm install

pnpm setup:analysis

pnpm validate

pnpm test

pnpm test:blender

OUTPUTtest:blender 会真实启动 Blender

覆盖创建与导入 .blend、对象检查、场景审计、预览与正式渲染、导出 GLB，以及干净进程回读

05

PART

配置项

CONFIG · SWITCHES

默认配置在cordis.patch.yml：

...yaml

config:

　blenderExecutable: blender

　analysisPythonExecutable: ''

　timeoutMs: 180000

　helperTimeoutMs: 120000

　maxOutputChars: 20000

　restrictToWorkspace: true

　enablePython: true

　enableHelpers: true

　enableMaintenanceHelpers: false

　registerSkill: true

　registerModuleSkills: true

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

开关
设为 false 时
restrictToWorkspace: true
输入输出都限制在当前会话 workspace，并检查符号链接的真实目标（此项默认 true）
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。

06

PART

适用场景与注意事项

NOTES · CAVEATS

适合这些情况：本机已经装了 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 标签。

///

LAST

写在最后

SUMMARY · TAKEAWAY

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

我是夜雨飘零，关注 AI 编程工具与开源插件。

既然看到这里了，如果觉得有用，随手点个赞、在看、转发三连吧。

点赞
在看
转发

THANKS FOR READING

相关学习资料