前言¶

在 DeepSeek Harness（DSH）裏做 3D，常見做法是反覆調用零散腳本或外部工具：場景狀態不連續、改完難以對照渲染結果、從參考圖重建時缺少獨立驗收環節。智能體很難在同一任務裏「建模 → 觀察 → 修正 → 沉澱可複用代碼」。

dsh-3d 是維護者 OOOHS 發佈的 DSH 工作流類插件，基於 CheshireJCat/blender（dsh-blender）擴展工具、技能與分析能力，把 Blender 變成智能體可長期編輯的 3D 創作環境，覆蓋產品建模、場景組裝、材質與燈光、動畫、資產編輯以及從圖像重建等任務。

這是什麼¶

一句話定位：面向 DSH 的 Blender 插件，用於基於 Blender 的 3D 建模與圖像重建（倉庫描述與 SkillHub 簡介一致）。

它在 dsh-blender 之上增加共享編輯狀態、原生筆刷與視覺反饋、獨立視覺評審，以及可在任務中改寫與重放的項目工具。社區目錄頁：ooohs/dsh-3d；源碼與文檔：GitHub OOOHS/dsh-3d。

設計思路與工作區能力¶

下面分三塊說明 README 中強調的機制，以及工作區具體提供什麼。

持續改進：評審與可複用代碼¶

資產本身和「怎麼做」都可以迭代。圖像重建場景下，獨立的生成式視覺評審（GRM）會把渲染結果與參考圖對比、描述差異並給出是否接受的判斷；建模智能體可據此修改並再次提交。每次評審基於當前證據，並保存觀察與結論。

智能體還可在任務中編寫、調用、修改自己的工具，把有效操作保留爲代碼，供後續任務複用參數或重組流程。幾何構建、網格編輯、筆刷、觀察與交付可組合成可重放的程序。

工具擴展與技能裁剪¶

Python、網格編輯與原生筆刷共用同一 Blender 場景；工具反饋包括視圖、局部前後對比圖與度量變化，便於評估單次操作效果。主 skill 說明目標、能力、調用約定與完成標準， specialist 參考按需加載，減少固定流程對探索空間的佔用。快照與檢查點支持「試一種做法 → 觀察 → 保留或回滾再試」。

工作區清單（README 原文歸納）¶

• 持久編輯：代碼、網格操作與筆刷作用於同一資產；選擇、編輯模式與工具設置在多次調用間保持；快照與檢查點用於保存、恢復與對比候選方案。
• 廣覆蓋 Blender 能力：Python 可觸及幾何、曲線、修飾器、Geometry Nodes、材質、燈光、綁定與動畫；原生控件支持網格選擇、比例編輯、擠出與雕刻。
• 視覺動作反饋：視圖控制、組件隔離、相機渲染、裁切與局部前後對比，支撐觀察與糾錯。
• 可複用項目工具：執行過程中編寫與修訂工具，下次調用加載最新源碼；會話筆記保留使用條件與觀察結果。
• 評審與交付：圖像重建可走獨立視覺評審；資產工具涵蓋導入導出、結構檢查、導出往返校驗與動畫幀採樣。

倉庫 package.json 當前版本爲 0.2.3-dev.20；README「Made with DSH 3D」示例註明由兩個獨立 dsh 會話使用 dsh-3d dev.20 設計、建模並渲染（如 MERIDIAN 陶瓷杯、AURA 桌面風扇），提示與任務說明見 examples/dev20-showcase/。

安裝與啓用¶

環境要求（README Getting started）：Node.js 22.12+、pnpm、Blender 在 PATH 中或通過絕對路徑配置、Python 3.10+（圖像分析輔助腳本）。

在本地按倉庫 README 取得源碼並安裝依賴後，使用下列命令註冊插件並啓動 Web 配置（命令與版本號來自 README，勿自行拼接 dsh plugin add github:owner/repo）：

cd dsh-3d
pnpm install --frozen-lockfile
npx @deepseek-ai/dsh@0.2.1-alpha.2 plugin --profile web add .
npx @deepseek-ai/dsh@0.2.1-alpha.2 plugin --profile web exec dsh-3d-setup
npx @deepseek-ai/dsh@0.2.1-alpha.2 web

（完整克隆與進入目錄步驟見 GitHub README。）

Web 配置裏插件顯示爲 DSH 3D (Development)。若在本插件與原版 dsh-blender 之間切換，README 要求同一時間只啓用一個版本：先關閉當前版本，再開啓另一個。

自定義 Blender 可執行文件時，在 web profile 的 cordis.patch.yml 中增加（路徑替換爲實際絕對路徑）：

- id: dsh-3d
  config:
    blenderExecutable: /absolute/path/to/blender

模型提供商憑據應放在 dsh 環境或配置中；API 密鑰與本地 .env 不要納入版本控制。

典型用法：建模預設與會話¶

創建會話時可選擇建模預設（README）：

• DSH 3D 建模（dsh-3d-modeler）：直接使用 Python、原生編輯、筆刷與觀察工具。
• DSH 3D 代碼建模（dsh-3d-code-modeler）：在 run_code 內通過 await tools.name(...) 組合授權工具，適合維護可重放程序；需要宿主支持程序化工具運行時。
• DSH 3D 原生建模實驗（dsh-3d-native-modeler）：基元、原生網格編輯與筆刷，用於動作空間對比實驗。

README 示例任務表述：「Create a ceramic mug with a small whale relief. Save the editable project, a GLB and renders from several viewpoints.」智能體自行選擇方法、觀察渲染並修訂資產。

建模與評審分別在 agents/modeler.json 與 agents/reviewer.json 中配置，可通過 modelerAgent、reviewerAgent 覆蓋。默認使用 deepseek-official / deepseek-flash，建模爲高 reasoning effort、評審爲低；會話裏顯式指定的模型仍生效。

連續編輯與工具入口¶

blender_execute 在當前場景中運行 Python；blender_scene 用於創建、打開、檢查與保存場景。項目工具可定義 run(params)，經 tool_path 反覆調用，每次加載最新源碼。Python 可繼續編輯經原生筆刷塑形的網格；代碼建模預設還可把筆刷步驟記入完整程序並重放。Blender Python 內提供 dsh.edit、dsh.sculpt、dsh.project、dsh.emit 等編輯、雕刻、投影與出圖能力。

原生筆刷支持體量塑形、輪廓變化、彎曲、褶皺與表面細節；雕刻模式下可連續筆觸、切換視圖、撤銷重做，提交保留編輯、丟棄則回到進入時狀態。更細的共享場景、代碼重放契約與編輯反饋說明見倉庫內 skills/create-3d-model/references/ 與 docs/editing-feedback.md。

適用場景與注意¶

適合誰：已在用 DSH、希望智能體在 Blender 裏自主完成建模/場景/動畫/圖像重建，並需要持久場景、視覺反饋與可選獨立評審閉環的開發者。

生態說明：DSH 採用「一切皆插件」思路；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，本文不作「官方應用商店」表述。

安全與權限：插件以當前 dsh 進程權限運行，會調用本機 Blender 與 Python 輔助環境。安裝前請閱讀倉庫源碼、LICENSE 與 NOTICE，確認許可證與本地安全策略後再啓用。

SkillHub 頁面顯示該倉庫星標爲 0（以目錄頁爲準）；功能與命令以 GitHub README 與隨包文檔爲準。

結尾¶

dsh-3d 把 Blender 綁進 DSH 工作流，讓智能體在同一持久工作區裏構造資產、觀察渲染、接受獨立評審，並把常用操作沉澱爲可修訂、可重放的項目工具。若要查看分類與簡介，可打開 SkillHub 目錄頁；安裝、預設與示例以 GitHub 倉庫 README 爲準。