MIT の JavaScript 製 DSH プラグイン。テキスト → コンセプト画像 → Blender グレーボックスという流れを自動化し、AABB 検証付きのレイアウト plan、エンジン非依存の `.blend` / `.fbx` / `.glb` + `layout.json`、任意の Unity バッチモード組み立てを提供します。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-11-16
ライセンス
MIT
01どんなタスクに使えるのか?
DeepSeek Harness のセッション内で、一文のテキストから編集可能なグレーボックス・シーンの骨組みを作る(コンセプト画像 → ライティング・カメラ・オブジェクトを持つ Blender シーン)
編集可能なグレーボックス・シーン(階層 + ライティング + カメラ + パラメータ化されたオブジェクト)を `scene.blend` / `scene.fbx` / `scene.glb` と `layout.json` として `<outputDir>/jobs/<jobId>/` に出力。そのまま編集を続けられるブロックアウトで、遊べるレベルではありません
アート資産が揃う前にレイアウトのブロックアウトが欲しく、いま作業しているセッションでプロンプトから作りたい個人・オフラインゲーム開発者
固定の庭園構図ではなく、書いた説明どおりに配置する(東側に噴水、四隅に石柱を 1 本ずつ)
オブジェクトごとに一意な `id`、`type`、`position`、`size` を持つ plan JSON。`position` はオブジェクト底面の中心、`size` はメートル単位の実寸で、座標系は Unity Y-up 固定。Blender はその座標とサイズどおりに単純プリミティブを組み立てます
自動構図ではなく正確な座標が欲しいレベルデザイナー/テクニカルアーティスト。plan をファイルに保存して組み立て前に目視確認できます
生成したシーンを自分のエンジンに渡す。または任意の Unity アダプタに組み立てさせる
同じ FBX/GLB と `layout.json`(`groups[].objects[]` に `instanceName`・位置・回転・スケール)を Unreal や Godot へ。`enableUnityAdapter` を有効にすると、ライティング・カメラ・任意のプレハブ込みで組み立て済みの `Assets/Scenes/SceneSkeleton.unity` が得られます
batchmode でシーンを自動組み立てしたい Unity チームと、モデルを自分でインポートして layout ファイルどおりに配置する Unreal/Godot 利用者
02DeepSeek Harness への導入方法
前提条件
- Node.js 20 以上——ESM と `AbortSignal.timeout` を使うため。DSH 同梱のランタイムでも可
- バンドルに対応した DSH(`dsh.bundle.patch` + `dsh.client`)。README の動作確認は 0.2.1-rc.5
- 自分で起動し `http://127.0.0.1:8188` で待ち受けている ComfyUI と、読み込める checkpoint が 1 つ以上——プラグインは ComfyUI のインストールも起動も停止も行いません
- Blender 4.x を `--background --factory-startup --python` で駆動。既定の `scenic` モードでは Blender 内蔵 Python に `scenic-bpy` も必要
- ディスク約 25 GB(ComfyUI + checkpoint + Blender + 任意の Unity プロジェクト)。PBR テクスチャを有効にすると約 6.4 GB 追加。VRAM 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
「設定 → シーン・スケルトン・パイプライン」で中核経路に必要な 3 項目を設定: `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
任意の拡張: Unity 組み立てには `unityProjectPath` と `enableUnityAdapter`、PBR テクスチャには ComfyUI-SuperPBR の clone と 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 バンドル型プラグイン —— `dsh plugin --profile web add /absolute/path/to/dsh-scene-skeleton-pipeline` で profile に導入し、`dsh.bundle.patch` + `dsh.client` で自動マウントされます。`scenePipeline` サービス、`check_environment` / `run_scene_pipeline` / `plan_scene_layout` の 3 つのモデルツール、`/plugins/dsh-scene-skeleton-pipeline/*` の設定画面を登録し、設定は `$DSH_HOME/scene-skeleton-pipeline/config.json` に保存されます
環境検出
引数なし——マシンを調べるだけ→`{ checkedAt, environment: { blender, comfy, unity } }`。各項目は `ok` / `missing` / `error` と詳細、任意でパスを返します
検出のみ: ソフトウェアのインストールも起動も停止も行いません3 つの依存は個別に報告されるため、失敗した 1 つだけを直せますComfyUI によるコンセプト画像生成
プロンプトに加え、任意で **API 形式**のワークフロー JSON(`comfyWorkflowPath`)、checkpoint 名(`comfyCheckpoint`)、ネガティブプロンプト(`comfyNegativePrompt`)→生成されたコンセプト画像をジョブフォルダの `comfy/` に保存
実実行では ComfyUI(約 1〜1.5 分)と Blender ヘッドレス(約 2〜5 秒)が起動します受け付けるのは API 形式のワークフロー JSON のみで、ComfyUI の UI 形式ワークフローには対応しませんBlender ヘッドレスによるグレーボックス骨組み
`blenderSceneMode`: `scenic`(既定。`scenicWidth` / `scenicDepth` / `scenicWallHeight` を指定)または `legacy`→地形・柱・壁・アーチ・木・ベンチ・街灯をパラメータ化した庭園を Terrain / Buildings / Props にグルーピング。`legacy` は固定ブロックと参考画像プレーンを生成
`scenic` モードは Blender 内蔵 Python への `scenic-bpy` 導入が必要で、`legacy` モードでは不要出力はあくまでグレーボックスで、実際のアート資産への差し替えは利用者の作業ですモデルが書くレイアウト plan と AABB 検証
`plan_scene_layout` に `sceneDescription` を渡し、任意で `width` / `depth` と plan を書き出す `savePath` を指定→`{ ok, plan, errors, model, savedPath? }`。オブジェクトはアセットライブラリの 18 種類の type ホワイトリストから選ばれ、違反はルール・メッセージ・対象オブジェクトとして一度に列挙されます
構造・シーン境界・地面の突き抜け・浮遊・衝突・支持をすべて AABB レベルで判定Blender は組み立て前に plan を再検証し、不正な 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 推論が 1 回走るため `all` は遅く、1 ジョブでテクスチャを付けるのは最大 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 追加。VRAM 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 追加。VRAM 8 GB でも動作しますが遅く、12 GB 以上を推奨します。
- ジオメトリはプロシージャル図形か宣言的 spec なので、コンセプト画像の建築形状は再現されません。またモデルのレイアウトは多くの場合で妥当なだけで、JSON 抽出・構造/物理検証・3 回の再試行は不正な plan を減らせても無くせません。
MIT · リリース未公開 · パッケージ版 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.bundle.patch` がマウントするので YAML の編集は不要です。読み込み時に `scenePipeline` サービス、`check_environment` / `run_scene_pipeline` / `plan_scene_layout` の 3 つのモデルツール、設定ページのルートを登録し、README には照合できる起動ログが載っています。
セッション内では具体的に何をしますか? ComfyUI や Blender を起動せずに試すには?
`run_scene_pipeline({ prompt, dryRun: true })` を呼ぶか、パネルの「运行 dry-run」ボタンを押します。dry-run は依存チェックとノード編成だけで、環境が満たされない場合はそのノードが `blocked`、後続が `skipped` になり成果物はプレースホルダです。`dryRun: false` にすると ComfyUI(約 1〜1.5 分)と Blender ヘッドレス(約 2〜5 秒)が実際に起動し、`comfy/`、`blender/`(任意で `textures/`、`unity/`)を `<outputDir>/jobs/<jobId>/` に書き出します。戻り値の `artifacts` に各成果物の絶対パスが入ります。
マシン側に何が必要で、プラグインは何に触りますか?
Node 20 以上、バンドル対応の DSH(動作確認は 0.2.1-rc.5)、自分で起動して `http://127.0.0.1:8188` で待ち受けかつ読み込める checkpoint が 1 つ以上ある 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
by ebony-vinyl
ログインやAPIキーなしでDeepSeek V4.1 FlashやKimi K3などを利用できるとし、無料・無制限をうたうDeepSeek Harness向けプラグインです。
dsh-routing-suite
by yjh051108
DeepSeek Harness(dsh)向けのルーティング套件。まずランタイムインジェクターを導入し、続いてタスク認識型の推論モードルーター(P1〜P23 を計測済み)を組み込めます。
dsh-ops
by t-auto
Bash と PowerShell コマンドを実行し、ローカルファイルを検索および編集し、DSH から長期にわたるバックグラウンドジョブを管理します.
dsh-connect-workbuddy
by 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。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。
