返回目录

dsh-scene-skeleton-pipeline

精选清单收录维护状态: 活跃

lestertown/dsh-scene-skeleton-pipeline

基于 DSH 的开源插件,提供 3D 场景解析与骨骼管线的自动化工作流,支持 TS 扩展与深度集成。 | An open-source DSH plugin for automating 3D scene and skeleton pipelines. Supports TypeScript extensions and deep integration.

前往 GitHub
$ dsh plugin --profile web add /absolute/path/to/dsh-scene-skeleton-pipeline

15

星标

1

Fork

JavaScript

语言

MIT

许可证

2026-11-11

创建于

2026-11-11

最近推送

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` 指向你自己准备的文件,缺文件时回退纯色或程序化图元

安装步骤

  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

    在「设置 → 场景骨架流水线」里填核心链路需要的三项:`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

    可选增强:填 `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 适配原生运行时

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。
2026-11-112026-11-11作者未说明

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` 时会回退纯色材质与程序化图元,场景仍可跑通。

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。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。