前言¶

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