MIT 的 JavaScript DSH 外掛,把「一句文字 → 概念圖 → Blender 灰盒場景」這條流程自動化:帶 AABB 驗證的布局 plan、引擎無關的 `.blend` / `.fbx` / `.glb` + `layout.json`,以及選用的 Unity batchmode 組裝。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-16
授權條款
MIT
01它能幫你完成什麼?
在 DeepSeek Harness 工作階段裡把一句話變成可繼續編輯的灰盒場景骨架:先產生概念圖,再由 Blender 產生含光照、相機與物件的場景
可繼續編輯的灰盒場景(層級 + 光照 + 相機 + 參數化物件),匯出為 `scene.blend` / `scene.fbx` / `scene.glb` 與 `layout.json`,放在 `<outputDir>/jobs/<jobId>/` 下——是可以接著改的灰盒,不是可玩關卡
在美術資產出現之前就想要一份布局草模的單機/離線遊戲開發者,希望在同一個工作階段裡用一句提示詞直接取得它
讓布局照文字描述走,而不是用固定的庭院構圖——東側一座噴泉、四角各一根石柱
一份 plan JSON:每個物件有唯一的 `id`、`type`、`position` 與 `size`,`position` 是物件底面中心、`size` 是完整尺寸(公尺),座標慣例固定為 Unity Y-up;Blender 依這些座標與尺寸組裝簡單圖元
需要精確座標(而不是自動構圖)的關卡與技術美術設計者,並且可以先把 plan 存檔人工看過再組裝
把產生的場景交給自己的引擎,或讓選用的 Unity 轉接器替你組裝
同一份 FBX/GLB 加 `layout.json`(`groups[].objects[]` 裡帶 `instanceName`、位置、旋轉與縮放)交給 Unreal 或 Godot;開啟 `enableUnityAdapter` 時則直接得到組裝好的 `Assets/Scenes/SceneSkeleton.unity`(含光照、相機與選用 prefab)
希望用 batchmode 自動組裝的 Unity 團隊,以及自己匯入模型、再依 layout 檔案擺位的 Unreal/Godot 使用者
02如何將外掛接入 DeepSeek Harness?
先決條件
- Node.js 20 以上——外掛使用 ESM 與 `AbortSignal.timeout`,DSH 內建的執行環境也可以
- 支援 bundle 的 DSH(`dsh.bundle.patch` + `dsh.client`),README 實測版本為 0.2.1-rc.5
- 自行啟動並監聽 `http://127.0.0.1:8188` 的 ComfyUI,且至少有一個可載入的 checkpoint——外掛不負責安裝、啟動或停止它
- Blender 4.x,以 `--background --factory-startup --python` 方式驅動;預設的 `scenic` 模式還要在 Blender 內建 Python 裡安裝 `scenic-bpy`
- 約 25 GB 磁碟(ComfyUI + checkpoint + Blender + 選用 Unity 專案);開啟 PBR 貼圖再加約 6.4 GB,8 GB 顯示記憶體夠用但較慢,建議 12 GB 以上
- 只有啟用選用 Unity 轉接器時才需要:Unity 2022.3 LTS 以上,batchmode 可用且授權已啟用
- 貼圖與模型都不隨外掛附帶——`assetLibraryPath` 與 `assetModelPath` 指向你自己準備的檔案,缺檔時回退純色或程序化圖元
安裝步驟
- 01
在本地資料夾執行 `dsh plugin --profile web add /absolute/path/to/dsh-scene-skeleton-pipeline`,再用 `dsh web` 啟動
$ dsh plugin --profile web add /absolute/path/to/dsh-scene-skeleton-pipeline
- 02
不需要手改 YAML:profile 的 `package.json` 會多出這條相依,`dsh.profile.bundles` 裡出現 `dsh-scene-skeleton-pipeline`,由 `dsh.bundle.patch` 自動掛載
- 03
在「設定 → 場景骨架管線」填入核心路徑需要的三個欄位:`comfyUrl`(預設 `http://127.0.0.1:8188`)、`blenderExe`(留空自動偵測)、`outputDir`(留空用 `$DSH_HOME/scene-skeleton-pipeline/outputs`)
- 04
預設的 `scenic` 模式需要把 scenic-bpy 裝進 Blender 內建 Python:`"/Applications/Blender.app/Contents/Resources/4.5/python/bin/python3.11" -m pip install --user "scenic-bpy>=1.19.0"`
- 05
選用增強:填 `unityProjectPath` 並開啟 `enableUnityAdapter` 做 Unity 組裝;複製 ComfyUI-SuperPBR 並放好 SuperMat/MoGe/VAE 模型後,再開啟 `enableTextureGeneration`
驗證整合成功
- 看載入日誌:`[dsh-scene-skeleton-pipeline] loaded`、`service registered: scenePipeline`、`tool registered: check_environment`、`settings routes registered`、`pipeline engine ready: comfy -> blender`、`pipeline tool registered: run_scene_pipeline`、`plan tool registered: plan_scene_layout`
- 先跑 dry-run:面板上的「執行 dry-run」按鈕,或呼叫 `run_scene_pipeline({ prompt: "一座带台阶的日式庭院,四角有石柱", dryRun: true })`;它只做相依檢查與節點編排,環境不符時該節點 `blocked`、後續 `skipped`
- 不想啟動 ComfyUI 與 Blender 時用 `bash scripts/verify/all.sh --skip-real`,只驗宿主接線、布局與匯出
03DSH 整合程度與能力邊界
DSH bundle 外掛 —— 用 `dsh plugin --profile web add /absolute/path/to/dsh-scene-skeleton-pipeline` 裝進 profile,由 `dsh.bundle.patch` + `dsh.client` 自動掛載;註冊 `scenePipeline` service、`check_environment` / `run_scene_pipeline` / `plan_scene_layout` 三個模型工具,以及 `/plugins/dsh-scene-skeleton-pipeline/*` 下的設定頁面,設定值存放在 `$DSH_HOME/scene-skeleton-pipeline/config.json`
環境偵測
不需要參數——只偵測本機→`{ checkedAt, environment: { blender, comfy, unity } }`,每一項回報 `ok` / `missing` / `error` 狀態、說明與選用路徑
只偵測:不安裝、不啟動、不停止任何軟體三項分開回報,哪一項失敗就只修那一項ComfyUI 產生概念圖
提示詞,另可選 **API 格式**工作流 JSON(`comfyWorkflowPath`)、checkpoint 名稱(`comfyCheckpoint`)與負向提示詞(`comfyNegativePrompt`)→一張概念圖,寫進工作目錄下的 `comfy/`
實際執行會啟動 ComfyUI(約 1–1.5 分鐘)與 Blender headless(約 2–5 秒)只接受 API 格式的工作流 JSON,ComfyUI 的 UI 格式工作流不支援Blender headless 灰盒骨架
`blenderSceneMode`:`scenic`(預設,配 `scenicWidth` / `scenicDepth` / `scenicWallHeight`)或 `legacy`→參數化庭院——地形、柱、牆、拱門、樹、長椅、燈柱,語意分組為 Terrain / Buildings / Props;`legacy` 模式則產生固定體塊加參考圖平面
`scenic` 模式需要把 `scenic-bpy` 裝進 Blender 內建 Python,`legacy` 模式不需要產物一律是灰盒,替換成真實美術資產是使用者自己的事模型產生布局 plan + AABB 驗證
用 `plan_scene_layout` 傳入 `sceneDescription`,可選 `width` / `depth` 與把 plan 寫入檔案的 `savePath`→`{ ok, plan, errors, model, savedPath? }`——物件從資產庫 18 種 type 白名單裡挑,違規項目一次列出規則、說明與涉及物件
結構、場景邊界、地面穿透、懸浮、碰撞與支撐都按 AABB 級判定Blender 在組裝前會再驗一次:不合法 plan 直接報錯,不會被默默接受引擎無關匯出與 `layout.json` 契約
`layoutAxis` = `z-up`(預設,Blender 原生)或 `y-up`(Unity 轉換後的值)→`scene.blend` + `scene.fbx` + `scene.glb` + `layout.json`,內含層級、環境光與方向光、相機以及每個物件的變換
下游解析 layout.json 時要先讀 `axis`,缺少該欄位的歷史檔案按 `y-up` 處理layout 裡的 `scale` 是實例額外縮放,Blender 產生時恆為 `[1,1,1]`;手改它仍可縮放該實例選用 PBR 貼圖與自動 lite 回退
`enableTextureGeneration`、`textureResolution`(256–2048)與 `textureObjects` = `main`(地面 + 建築類物件)或 `all`→每個物件的 `_albedo` / `_normal` / `_roughness` / `_metallic` / `_ao` / `_height` 貼圖寫到 `textures/`,並新建覆蓋純色材質的 `LLM_<id>_pbr` 材質
每個選中的物件要跑一次 ComfyUI 推論,所以 `all` 很慢,單次 job 最多替 12 個物件產生貼圖缺 SuperPBR/MoGe 節點或模型時整段跳過,主流程照樣完成
04適合誰?何時不該用?
適合
- 在美術資產出現之前就想要一份布局草模的單機/離線遊戲開發者,希望在同一個工作階段裡用一句提示詞直接取得它
- 需要精確座標(而不是自動構圖)的關卡與技術美術設計者,並且可以先把 plan 存檔人工看過再組裝
- 希望用 batchmode 自動組裝的 Unity 團隊,以及自己匯入模型、再依 layout 檔案擺位的 Unreal/Godot 使用者
不適合
- 管線不接管 ComfyUI、Blender、Unity 的生命週期:不安裝也不停止它們,也不做 MCP 橋接;ComfyUI 只支援 API 格式工作流,且只對單機 `127.0.0.1` 端點運作(`comfyUrl` 可改)。
- 不做碰撞體、不做剛體物理、不做導航,也不保證白盒可走——驗證只有 AABB 級靜態規則(邊界、穿透、懸浮、碰撞、支撐)。
- 磁碟要給 ComfyUI、checkpoint、Blender 與選用 Unity 專案留約 25 GB,開啟 PBR 貼圖再加約 6.4 GB;8 GB 顯示記憶體能跑但慢,建議 12 GB 以上。
05相容性、維護與安全提醒
- 管線不接管 ComfyUI、Blender、Unity 的生命週期:不安裝也不停止它們,也不做 MCP 橋接;ComfyUI 只支援 API 格式工作流,且只對單機 `127.0.0.1` 端點運作(`comfyUrl` 可改)。
- 不做碰撞體、不做剛體物理、不做導航,也不保證白盒可走——驗證只有 AABB 級靜態規則(邊界、穿透、懸浮、碰撞、支撐)。
- 磁碟要給 ComfyUI、checkpoint、Blender 與選用 Unity 專案留約 25 GB,開啟 PBR 貼圖再加約 6.4 GB;8 GB 顯示記憶體能跑但慢,建議 12 GB 以上。
- 幾何是程序化圖元或宣告式 spec,不會複刻概念圖的建築形體;模型給的布局也只是大多數合理——JSON 萃取、結構/物理驗證與 3 次重試能減少但不能消除不合法 plan。
MIT · 尚無 release · 套件版本 0.1.0,已用專案內 `scripts/verify` 套件驗證
06常見問題
dsh-scene-skeleton-pipeline 怎麼裝進 DeepSeek Harness,裝完註冊了什麼?
從本地資料夾安裝:`dsh plugin --profile web add /absolute/path/to/dsh-scene-skeleton-pipeline`,再用 `dsh web` 啟動。profile 的 `package.json` 會多出這條相依,`dsh.profile.bundles` 裡出現這個套件,DSH 依 `dsh.bundle.patch` 自動掛載,不需要手改 YAML。載入後它註冊 `scenePipeline` service、`check_environment` / `run_scene_pipeline` / `plan_scene_layout` 三個模型工具與設定頁路由,README 列出了可以直接對照的啟動日誌。
在工作階段裡實際怎麼用?想先不啟動 ComfyUI 和 Blender 怎麼辦?
讓模型呼叫 `run_scene_pipeline({ prompt, dryRun: true })`,面板上也有「執行 dry-run」按鈕:dry-run 只做相依檢查與節點編排,環境不符時節點 `blocked`、後續 `skipped`,產物是佔位。只有 `dryRun: false` 才會實際啟動 ComfyUI(約 1–1.5 分鐘)與 Blender headless(約 2–5 秒),把 `comfy/`、`blender/`(選用 `textures/`、`unity/`)寫到 `<outputDir>/jobs/<jobId>/` 下,回傳值裡的 `artifacts` 是每個產物的絕對路徑。
機器上要裝什麼?外掛會動到哪些東西?
Node 20+、支援 bundle 的 DSH(實測 0.2.1-rc.5)、你自己先啟動並監聽 `http://127.0.0.1:8188` 且至少有一個可載入 checkpoint 的 ComfyUI、Blender 4.x(預設 `scenic` 模式還要在 Blender 內建 Python 裡裝 `scenic-bpy`)、約 25 GB 磁碟;只有在 `enableUnityAdapter` 開啟時才需要 Unity 2022.3 LTS+(batchmode 可用、授權已啟用)。README 明確寫出不接管軟體生命週期:不安裝、也不停止 ComfyUI/Blender/Unity,且不接 MCP 橋接。
產生的場景有哪些做不到的事?
它是灰盒,不是可玩關卡:README 列明不做碰撞體/剛體物理(只有 AABB 級靜態合理性驗證)、不做導航/觸發器/互動邏輯、不從概念圖反推幾何,圖生 3D 還在路線圖上。貼圖與 GLB 模型也不隨外掛附帶——沒設定 `assetLibraryPath` / `assetModelPath` 時會回退純色材質與程序化圖元,場景仍可跑通。
07相關的 DSH 工作流程
dsh-our-free-model
作者 ebony-vinyl
在 dsh 裡裝上這個外掛即可,無需登入、註冊或填 API Key,就能使用包括 DeepSeek V4.1 Flash、Kimi K3 在內的前沿模型——完全免費,不限量。 All you do is install this plugin in dsh: no login, no sign-up, no API key — the frontier models are just there, DeepSeek V4.1 Flash and Kimi K3 among them. Completely free, with no usage cap.
dsh-routing-suite
作者 yjh051108
DeepSeek Harness(dsh)路由套件:先裝執行時注入器,再載入任務感知的推理模式路由預設(已實測 P1-P23)。
dsh-ops
作者 t-auto
A toolkit for low-level operations in DSH, designed to reduce token usage and task execution time / DSH 底層操作工具外掛,旨在減少 Token 消耗與任務耗時
dsh-connect-workbuddy
作者 dingminhua
將本地登入的 WorkBuddy 模型接入 DeepSeek Harness,並提供只讀額度概覽與模型管理。
08資料與來源
**DSH 编排插件:一段文字 → ComfyUI 出概念图 → Blender 生成引擎无关的场景骨架(`scene.blend` / `.fbx` / `.glb` + `layout.json`),可选 Unity 装配适配器。**
[dsh-scene-skeleton-pipeline] tool registered: check_environment
安装后 profile 的 `package.json` 会多出依赖,`dsh.profile.bundles` 里出现 `dsh-scene-skeleton-pipeline`,
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-16。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
