dsh-comfyui-workbench

dsh-comfyui-workbench

中文 · [English](README.en.md)

给 [DSH](https://github.com/deepseek-ai) 的 ComfyUI 工作台：把本机的 ComfyUI 工作流交给模型调用，并管理"哪些工作流对模型可用"。

面向用户的界面是六块：资产库、工作流管理、标签库、姿势库、衣装库、ComfyUI 终端 —— 都由 ComfyUI 原生能力支撑，不新增一套平行的状态。不内置生图前端 —— 想手工出图直接开 ComfyUI 就行。

> 本插件是 [dsh-comfyui-album](https://github.com/YuChenLiao/dsh-comfyui-album) 的继任者，资产浏览能力从相册继承（源码同源）。两者同时启用会出现两套入口与两套删除按钮，建议卸载相册。scripts/migrate-album.mjs 只在仓库里有 —— 装了包的人要迁移得先 clone 仓库，在仓库目录里跑。

九个组件

装载在 profile 的 cordis.patch.yml 里，每一条都是独立的 loader entry —— 在宿主「设置 → 插件」里能看到、能单独开关。

| entry | 形态 | 职责 |

| --- | --- | --- |

| comfyui-workbench:core | 服务端 | 初始化共享运行时（ComfyUI 客户端 / 进程托管 / 资产索引 / 产物目录）；承载浏览器端。name 必须是包根，宿主只给包根装配 exports["./client"] |

| comfyui-workbench:gallery | 面板 | 资产库：列表、筛选、缩略图、删除、批量导出工作流 ZIP |

| comfyui-workbench:workflow | 面板 | 工作流管理：列表、enabled 开关、用途备注，外加 /run、/rerun、/config、服务托管接口 |

| comfyui-workbench:tags | 面板 | 标签库：搜索四类标签、按语义大类筛、一键复制 tag；浏览只读，「更新标签」按钮会从上游刷新数据 |

| comfyui-workbench:poses | 面板 + 工具 | 姿势库：288 组人体姿势 / 1439 个角度，搜索与体系、分类筛选，取线稿存进 uploads 当工作流输入图；另出 comfyui_pose_search、comfyui_pose_fetch 两个工具 |

| comfyui-workbench:costumes | 面板 + 工具 | 衣装库：1407 套现实衣装（图中无人物），搜索与分类筛选，每条都带英文关键词，取图存进 uploads 当参考图；另出 comfyui_costume_search、comfyui_costume_fetch |

| comfyui-workbench:generate | 工具 | comfyui_workflow_list、comfyui_workflow_inspect、comfyui_run、comfyui_run_batch、comfyui_rerun、comfyui_runs、comfyui_node_search、comfyui_compose |

| comfyui-workbench:edit | 工具 | comfyui_workflow_edit |

| comfyui-workbench:danbooru | 工具 | danbooru_lookup、danbooru_lookup_batch、danbooru_sync：角色 / 画师 / 作品 / 通用标签库（含中文名，四类共 99372 条）。不碰 ComfyUI 运行时，可单独关 |

| comfyui-workbench:terminal | 面板 | ComfyUI 终端：展示子进程输出或 user/comfyui.log，可在面板上直接拉起服务 |

关掉某一条只影响它自己：例如关掉 gallery，资产库路由随之 404，工作流管理与工具照常（两个例外：批量导出工作流 ZIP 要读图与 sidecar，依赖相册；关掉 core 等于关掉整个插件——HTTP API 与浏览器端都会消失）。

安装

# 发布态
dsh plugin --profile desktop add github:YuChenLiao/dsh-comfyui-workbench

# 本地开发
dsh plugin --profile desktop add link:D:/dsh/dsh-comfyui-workbench

装完重启 DSH。cordis.patch.yml 里会插入十条 entry（包根 core + 九个组件），配置用 YAML 锚点共享，只写一次：

- insert:
    - id: comfyui-workbench:core
      name: dsh-comfyui-workbench
      config: &cwf
        baseUrl: http://127.0.0.1:8188
        autoStart: true
        disabledComponents: []
    - id: comfyui-workbench:gallery
      name: dsh-comfyui-workbench/gallery
      config: *cwf
    # :workflow / :tags / :poses / :costumes / :generate / :edit / :danbooru / :terminal 同理

配置

| 字段 | 说明 |

| --- | --- |

| baseUrl | ComfyUI 地址，默认 http://127.0.0.1:8188 |

| outputDir | 产物目录。留空则落在 <当前工作区>/comfyui-output；探测不到工作区时回退到 <插件数据目录>/outputs（GET /config 的 outputSource 会显示 data，workspaceProbe 给出探测过程：cwd 是否被判为宿主内部目录、workspaceRegistry 服务取到几个路径）。要钉死位置就显式配置这一项 |

| workflowsDir | 工作流仓库，默认 ~/.dsh-comfyui-workbench/workflows |

| autoStart | 探测到本机安装时是否自动拉起 ComfyUI。提交任务、列工作流、看工作流详情都会触发这一步（等到 /system_stats 通为止，上限 readyTimeoutMs），所以不用先手动启动；只停自己拉起的进程 |

| idleShutdownMs | 空闲多久后停止「自己拉起的」进程。默认 0（不回收）——/queue 只能看到 prompt 队列、看不到模型下载，回收容易在你拉大模型时把进程打断；想省显存再设成 300000。开着时回收前会先问 /queue，有任务在跑或在排队就顺延；外部实例永不被停 |

| disabledComponents | 关掉的组件，如 ['panel.gallery']。空数组即全开 |

| timeoutMs | 单次 HTTP 请求超时。/run、/rerun 的 timeoutMs 另外用来放宽后台盯守时长（下限 30 分钟，传更小的值会被抬高，实际预算写在返回的 notes 里） |

| pollIntervalMs | 执行状态轮询间隔 |

| progressStream | 用 /ws 读精确进度（默认 false）。可以在「工作流管理」面板上直接开关，不用改这个文件 —— 这里的值只是"默认值"，面板上的开关写的是插件数据目录的 settings.json，改完下一次提交就生效。也可用 COMFYUI_PROGRESS_WS=1。开了之后面板提交的记录会带 progress: {value, max}；只影响 /run、/rerun，工具侧没有 |

| roots | 额外纳入资产库的目录（默认已含当前工作区、dsh-comfyui-image 的 outputDir、产物目录） |

| assetRoots | 额外的可写根。assertWritable 取的是全部授权根的合集（roots / 工作区 / cwd / 产物目录 / uploads / assetRoots），只有落在合集之外才拒绝写入 |

模型工具

| 工具 | 作用 |

| --- | --- |

| comfyui_workflow_list | 列出可用的工作流：id、标题、用途备注、底模、输入种类、输出形状。被停用的不列出（hiddenCount 告知藏了几条）。拿不到 /object_info 时不标缺模型，避免把"离线"说成"缺模型" |