前言¶
在 DSH 里做图像生成，常见做法是手写 HTTP 调用 ComfyUI，或把整份 workflow JSON 塞进上下文。前者维护成本高，后者节点一多就占 token，模型还难以判断「哪些工作流当前可用、缺什么模型」。若还需要浏览历史出图、按 sidecar 复跑参数，往往还要再挂一套脚本或相册类插件。
下面介绍社区插件 dsh-comfyui-workbench（维护者 YuChenLiao，GitHub 仓库 YuChenLiao/dsh-comfyui-workbench，目录页 skillhub.cn）。它在 DSH 侧提供资产库、工作流管理与 ComfyUI 终端三块界面，并通过一组模型工具把「列出 / 检查 / 运行 / 编辑」工作流接到对话里；不内置独立生图前端，手工出图仍可直接打开 ComfyUI。本插件是 dsh-comfyui-album 的继任者，资产浏览能力与相册同源——两者同时启用会出现两套入口，建议只保留工作台。
这是什么¶
一句话：DSH ComfyUI workbench —— 资产库 + 任意 API 格式工作流执行器（仓库简介：asset library + arbitrary workflow runner）。
面向用户的界面只有三块：资产库、工作流管理、ComfyUI 终端，均由 ComfyUI 原生能力支撑，不另建一套平行状态。工作流对用户只暴露输入与输出；节点级细节通过 comfyui_workflow_inspect、comfyui_node_search 等工具按需查看。哪些工作流对模型「可用」由工作流目录里 <id>.meta.json 的 enabled 控制（缺省为 true），面板与 comfyui_workflow_edit 写同一份文件。
六个可独立开关的组件¶
安装后会在 profile 的 cordis.patch.yml 里插入多条 loader entry，在宿主「设置 → 插件」中可单独开关。关掉某一条只影响它自己；关掉 comfyui-workbench:core 等于关掉整个插件（HTTP API 与浏览器端都会消失）。关掉 gallery 时资产库路由 404，工作流管理与工具仍可用（批量导出工作流 ZIP 依赖相册读图与 sidecar，需保留 gallery）。
| entry | 形态 | 职责 |
|---|---|---|
comfyui-workbench:core |
服务端 | 共享运行时（ComfyUI 客户端 / 进程托管 / 资产索引 / 产物目录）与浏览器端 |
comfyui-workbench:gallery |
面板 | 资产库：列表、筛选、缩略图、删除、批量导出工作流 ZIP |
comfyui-workbench:workflow |
面板 | 工作流列表、enabled 开关、用途备注，以及 /run、/config 等 |
comfyui-workbench:generate |
工具 | comfyui_workflow_list、comfyui_run、comfyui_run_batch 等运行类工具 |
comfyui-workbench:edit |
工具 | comfyui_workflow_edit |
comfyui-workbench:danbooru |
工具 | danbooru_lookup 等标签库工具，不依赖 ComfyUI 运行时，可单独关闭 |
comfyui-workbench:terminal |
面板 | 展示 ComfyUI 子进程输出或 user/comfyui.log，可在面板上拉起服务 |
模型侧能做什么¶
工作流执行默认 异步：comfyui_run 提交后返回 promptId，后台盯守并在出图后通知对话；也可用 wait: true 同步等待。停用（enabled: false）的工作流会被拒绝执行。comfyui_rerun 从产物旁 sidecar 读取当时的参数再跑，不必手抄 seed。comfyui_run_batch 一次提交多组任务，单条失败不影响其它条。
辅助能力包括：comfyui_workflow_list 只列出可用工作流并摘要底模与 IO 形状；comfyui_workflow_inspect 查看整图 IO 或单节点配置，并报告缺节点、缺模型；comfyui_workflow_edit 改标题、说明或单节点参数（变量绑定项需经 comfyui_run 的 vars 传入）；comfyui_runs 查排队与完成状态（进度字段仅在开启 progressStream 且经面板 /run 提交时才有）。写提示词前可用 danbooru_lookup 把中文名对齐 Danbooru tag，插件内聚中文标签数据（来源 danbooru-tags-data-zh），本地未命中时会走在线接口。
安装与启用¶
DeepSeek Harness 采用「一切皆插件」的扩展方式；社区目录 skillhub.cn 与 DeepSeek / 幻方无官方从属关系，安装前请自行查看仓库源码与许可证。插件以当前 DSH 进程权限运行，会访问本机 ComfyUI 地址、工作区与配置的目录。
发布态安装命令如下（来自仓库 README）：
dsh plugin --profile desktop add github:YuChenLiao/dsh-comfyui-workbench
本地开发可改用 link: 指向仓库路径。装完后 重启 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
常用配置项：
| 字段 | 说明 |
|---|---|
baseUrl |
ComfyUI 地址，默认 http://127.0.0.1:8188 |
outputDir |
产物目录；留空时优先 <当前工作区>/comfyui-output |
workflowsDir |
工作流仓库，默认 ~/.dsh-comfyui-workbench/workflows |
autoStart |
探测到本机安装时是否自动拉起 ComfyUI |
disabledComponents |
要关闭的组件，如 ['panel.gallery'] |
progressStream |
是否经 /ws 读精确进度；也可在工作流管理面板上开关，或设环境变量 COMFYUI_PROGRESS_WS=1 |
典型用法¶
1、先让模型看见可用工作流
对话中模型调用 comfyui_workflow_list，得到 id、标题、用途备注、底模与输入种类；被停用的工作流不会出现在列表里（返回里的 hiddenCount 表示藏了几条）。
2、检查再运行
对选定 id 调用 comfyui_workflow_inspect 确认缺模型或缺节点；再通过 comfyui_run 传入工作流 id 与变量。默认异步，返回 promptId 后用 comfyui_runs 查状态，或下次回合等待插件主动通知。
3、面板侧手工试跑
在 DSH 里打开「工作流管理」面板，对已启用条目使用 /run；需要精确进度时在面板上打开 progressStream（写入插件数据目录的 settings.json）。
4、提示词 tag 对齐（可选）
{ "ok": true, "tags": ["ganyu_(genshin_impact)"], "source": "local" }
上例为 danbooru_lookup 的典型返回形态：只返回 tag，便于模型写 prompt 时不跑偏。需要更新本地中文库时，在 package.json 所在目录（安装后多为 node_modules/dsh-comfyui-workbench/）执行：
npm run danbooru:zh
数据写入 ~/.dsh-comfyui-workbench/danbooru/，不会改动随包分发的 data/danbooru/ 快照。
适用场景与注意¶
适合：已在本地或局域网跑 ComfyUI、希望 DSH 智能体按「可用工作流清单」自动出图并管理产物；需要资产库统一浏览工作区与产物目录；希望模型用工具改参数、批量跑图或从 sidecar 复跑。
注意：
- 与
dsh-comfyui-album不要长期并存；从相册迁移需使用仓库内的scripts/migrate-album.mjs（须在有该脚本的仓库目录执行，README 说明仅发布包内不含该脚本的完整迁移路径时需 clone 仓库再跑——按你实际安装方式阅读 README 对应段落）。 danbooru_sync全量同步请求量极大，仅在明确需要时调用；日常可依赖随包数据或npm run danbooru:zh。- 当前 package 版本为 0.5.1（以仓库
package.json为准）；GitHub 星标约 7（以目录页/仓库为准，会随时间变化）。
结尾¶
dsh-comfyui-workbench 把 ComfyUI 的 workflow API、产物索引和 Danbooru 标签查询收进同一套 DSH 插件：人看三块面板，模型用一组工具完成 list → inspect → run → rerun。进一步了解请阅 GitHub README 与 SkillHub 目录页。
