ディレクトリに戻る

dsh-scene-skeleton-pipeline

キュレーションリスト掲載メンテナンス: 活発

lestertown/dsh-scene-skeleton-pipeline

テキストの説明から、エンジンに依存しないグレーボックスのシーン骨組みとレイアウトファイルをDSHのセッション内で生成します。

GitHub で見る
$ dsh plugin --profile web add /absolute/path/to/dsh-scene-skeleton-pipeline

15

スター

1

フォーク

JavaScript

言語

MIT

ライセンス

2026-11-11

作成日

2026-11-11

最終プッシュ

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` は自分で用意したファイルを指し、欠けている場合は単色またはプロシージャル図形にフォールバックします

インストール手順

  1. 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

  2. 02

    YAML の編集は不要: profile の `package.json` に依存が追加され、`dsh.profile.bundles` に `dsh-scene-skeleton-pipeline` が入り、`dsh.bundle.patch` がマウントします

  3. 03

    「設定 → シーン・スケルトン・パイプライン」で中核経路に必要な 3 項目を設定: `comfyUrl`(既定 `http://127.0.0.1:8188`)、`blenderExe`(空なら自動検出)、`outputDir`(空なら `$DSH_HOME/scene-skeleton-pipeline/outputs`)

  4. 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"`

  5. 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 バンドル型プラグイン —— `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 を減らせても無くせません。
2026-11-112026-11-11作者は未記載

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` を設定しない場合は単色マテリアルとプロシージャル図形にフォールバックし、それでもシーンは最後まで実行されます。

08データと出典

  • 作者による申告github.coma1da7959ce69…

    **DSH 编排插件:一段文字 → ComfyUI 出概念图 → Blender 生成引擎无关的场景骨架(`scene.blend` / `.fbx` / `.glb` + `layout.json`),可选 Unity 装配适配器。**

  • 作者による申告github.coma1da7959ce69…

    [dsh-scene-skeleton-pipeline] tool registered: check_environment

  • 作者による申告github.coma1da7959ce69…

    安装后 profile 的 `package.json` 会多出依赖,`dsh.profile.bundles` 里出现 `dsh-scene-skeleton-pipeline`,

このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-16。誤りを見つけた場合は、修正を送信してください。

🏆

dsh プラグイン おすすめ

最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。