ComfyUI 给的是一张画布,自由,但每次开工都得重新决定:用哪个流程、挂哪个模型、参数调到哪一档。dsh-comfyui 换了个入口 —— 不给画布,给对话。装完之后 Agent 手上多出四个工具,出图这件事从"我去连线"变成"我说要什么,它去库里挑"。
版本 0.5.5,MIT 许可,仓库 fandc520/dsh-comfyui,141 星;npm 周下载 1,252,这个数字含 CI 与镜像流量,不等于真实装机量。安装一条命令 dsh plugin --profile web add dsh-comfyui,重启应用后侧边栏出现面板入口,设置页多出 ComfyUI 分区。
但工具装上只是开始。真正决定这套东西好不好用的,是你怎么管那个工作流库 —— 这也是下面想说的部分。
一句话之后,Agent 到底做了什么
"用 ComfyUI 画一张红猫的图"。这句话背后至少三步。
第一步是 comfyui_workflow 的 list。它返回的不只是工作流名字:服务器地址、本机 ComfyUI 目录、加载区里放了什么素材、每个工作流有哪些参数,都在这一份清单里。所以 Agent 挑工作流不是瞎猜,它有依据。
第二步是 run,按 id 运行,可以覆盖参数。这里有个细节值得留意:键名写错会被直接拒绝,而不是静默忽略。对一个要跑几分钟的任务来说,早失败比晚失败好得多。
第三步是把结果贴回来。生成完的 Markdown 媒体引用由 Agent 塞进回复,视频和音频链接下方会自动出现内嵌播放器。
sync 与 async:别让一轮对话替一台机器干等
mode: "sync" 会等结果,"async" 是后台任务。图片用 sync 通常还行,视频和音频强烈建议 async —— 提交后 Agent 直接结束本轮,跑完了由宿主通知唤醒。
区别不只是"等不等"。sync 模式下那张卡住的对话什么也做不了;async 模式下你可以接着聊别的,机器在后台出图。跑长任务的人都懂这个差别有多实际。
加载区省掉的是"猜文件名"
工作流页顶部那块媒体加载器,仿的是 ComfyUI 的 LoadImage:图片、视频、音频可视化选择,可以就地试听,支持粘贴上传,还有多个加载位。放进去的素材会按顺序自动填进工作流里没有显式指定的加载参数,Agent 不需要猜文件名。
这里有个顺手但容易误会的行为:没传 width / height 时,尺寸自动跟随源图分辨率。想让输出变成 1024,就必须显式传参,否则你会得到"设了 1024 却出原图尺寸"的结果。它不是缺陷,是把"保持原样"当成了默认值。
上传按内容哈希去重改名,同一张图反复丢进去不会在目录里堆出一串副本。
工作流库的整理逻辑
面板的工作流页签支持新建、编辑、运行、删除、导入 .json,顶上是一排标签和下拉筛选。标签不是装饰品,工作流超过十来个之后,筛选是唯一还能找到东西的方式。建议按用途分,比如"人像""风格迁移""短视频",而不是按模型名 —— 模型半年换一轮,用途不换。
预设包:把一套东西整体搬走
选中工作流(默认全选,带技能包的行会有标注),连同参数和技能包打包成 .zip。导出完成的回执会给三样东西:实际打包的工作流名单、文件名和体积,还有警告。
导入是把 zip 拖进对话框,它会整包分析,再按需导入。两个细节值得说:技能包会原样完整还原,上千文件的模板大包也吃得下;导入始终创建为新工作流,不覆盖现有库,所以同名不会互相踩。
对多机的人来说这就是同步手段:公司机器导出,家里机器拖进去,参数和说明一起过去,不用重新回忆当时调了哪几个数。
图工作流要"提取"才能跑
你在 ComfyUI 界面里保存的那个东西叫图工作流,它带着画布坐标、节点位置这些界面信息,不能直接当 API 调用跑。面板会自动检测 ComfyUI 端保存的图工作流,并提供提取,转成可运行的工作流。
一个画布里塞了好几条互不相干的流程时,提取会让你选:整体、按分量、还是只取主流程。选项看着琐碎,但如果你习惯在一个画布里堆实验,这个选择决定了提取出来的是不是一团乱麻。
技能包:把踩过的坑留给下一个会话
参数清单只能告诉 Agent"有哪些旋钮",说不出"这个工作流适合什么、哪一步会翻车"。复杂工作流可以挂一个技能包,目录长这样:
<数据目录>/skills/<工作流>/
SKILL.md
references/
assets/
主文档写适用场景、关键参数、注意事项;references/ 放风格合集和排错记录;assets/ 放参考图,面板里能直接预览。
三级披露,平时只占一行
list 里只有一行摘要;选中工作流后用 action: skill 取正文;正文点名某份参考文档,才去读那一篇。这是刻意设计的:几十个工作流各带整套文档,如果全塞进上下文,一次对话的成本会难看得没法用。
Agent 自己会往里写
comfyui_skill 支持 list、read、write、append、mkdir、rename、delete、enable、require。关键在于 append —— 踩到坑就追加进 SKILL.md,换个会话再来,经验还在。这是整套东西里最像"积累"的部分:你的库会越用越懂你的环境。
运行前必读是一道闸
工作流卡片上可以勾"运行前必读"。勾上之后,本会话如果没读过这个技能包就调 run,会被拒绝,并提示先读。第一次遇到容易以为是权限问题或加载失败,其实只是闸门没开。
我的建议是:参数多、步骤长、错一步要重跑几分钟的工作流,统统勾上;一条直线的小流程就别勾,省一轮读取。
资产与队列:别让磁盘替你犹豫
资产页签列出所有生成结果,卡片上带工作流名和文件名,能预览、能下载、悬停可删除。删除动作会同步清理 ComfyUI 输出目录里的文件 —— 这点比看起来重要,多数人最后是被 output 目录里几千张废图拖垮的。
队列页签是实时队列加历史任务,五种状态都展示,支持删除、中断、重跑、清空、释放内存。插件提交的任务带进度条和预览,所以你能看出它卡在哪一步,而不是干等。"释放内存"这一项在长期跑图时会被反复用到,值得当成常规操作而不是救火手段。
装之前该知道的两件事
安全扫描那一栏得如实念:含敏感能力、尚无人工评估。它要读本地文件、要联网、要驱动一个外部服务,这些都是工作原理,不是额外风险;但"尚无人工评估"也是字面意思 —— 没人逐行看过它,能不能接受要你自己判断。
另一件是版本配对。0.5.x 要求宿主 ≥ 0.1.2、同时低于 0.3;版本还是 0.1.1 的老机器请走 0.3.x 线,也就是 @beta。装反了会看到风险提示,那不是插件坏了。
总结
它真正改变的不是"能不能出图",而是工作流从一次性操作变成了可积累的资产 —— 库有标签、包能搬走、坑能写回;想对照同类插件的中文清单见 DeepSeek Harness Hub 插件清单。
适合与不适合
适合:已经有一台在跑的 ComfyUI、工作流攒到十几个的人;需要把同一套流程在多台机器之间搬来搬去的;常跑视频或音频、受够了一轮对话被一个任务占死的;愿意花时间写技能包、让 Agent 越用越顺的。
不适合:没有 ComfyUI 服务、以为装上就能出图的 —— 它只负责驱动,不提供算力;只想找个托管出图服务的;全程纯文本、不碰画面的工作流用不上它;宿主仍是 0.1.1 又不愿升级的,只能留在 0.3.x 线,新特性拿不到。
标签:dsh-comfyui、DeepSeek Harness、Agent 工作流
本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。