前言¶
DSH 插件生态强调「一切皆插件」。这里的社区目录是独立站点,不与 DeepSeek / 幻方存在官方从属关系,本文只按插件事实介绍。
对要在 DeepSeek Harness(DSH)里接入 ComfyUI 的开发者来说,常见难点有几个:Agent 需要知道当前服务器支持哪些节点、工作流有哪些参数;生成结果需要在面板里预览和下载;远程 ComfyUI 的 API Key 不应直接下发到浏览器;复杂工作流的注意事项也容易被 Agent 漏掉。
dsh-comfyui 把这些事情收进一个插件:Agent 工具、UI 面板、工作流技能包、同源媒体代理,都由插件提供。
这是什么¶
dsh-comfyui 是 fandc520 维护的 DSH 插件,MIT 许可。
它让 DeepSeek Harness 的 Agent 智能驱动本地或远程 ComfyUI 生成任何内容,附带工作流、资产管理面板与技能包管理挂载。
下面介绍它的核心能力、安装方式、典型用法和注意事项。
版本、依赖与安装¶
先确认版本配对,再执行安装。已核实事实给出的版本要求如下:
dsh-comfyui 0.4.0
DeepSeek Harness >= 0.1.2
dsh-comfyui 0.3.x beta 线
DeepSeek Harness 0.1.1
如果版本不配对,dshmarket 会报风险提示。
安装命令:
dsh plugin --profile web add dsh-comfyui
运行环境要求包括:
DeepSeek Harness web/desktop profile
运行中的 ComfyUI 服务器
默认服务器地址 http://127.0.0.1:8188
Node >=22.19
@deepseek-ai/cordis ^4.0.1
@deepseek-ai/dsh-settings ^0.1.2-alpha.4
如果要使用 video 模板,还需要:
ComfyUI-WanVideoWrapper
Wan 2.1 模型
Agent 工具¶
插件给 Agent 提供四个工具。
comfyui_run¶
comfyui_run 用于提交生成任务。
它可以提交 API 格式工作流,也可以使用内置模板:
txt2img
img2img
video
它支持两种执行方式:
同步等待
异步后台任务
comfyui_object_info¶
comfyui_object_info 用于列出服务器支持的节点定义。
Agent 可以基于节点定义现场构造合法工作流,而不是凭空猜测节点名和参数名。
comfyui_workflow¶
comfyui_workflow 用于管理工作流库。
它支持以下操作:
list
run
skill
refresh
comfyui_skill¶
comfyui_skill 用于读写工作流技能包。
它支持以下操作:
list
read
write
append
mkdir
rename
delete
enable
require
UI 面板¶
插件提供 UI 面板,包含三个页签:
工作流
资产
队列
各页签承担的职责如下:
- 工作流:工作流管理。
- 资产:生成结果预览下载。
- 队列:队列操作。
加载区¶
加载区提供媒体加载器,可可视化选择:
图片
视频
音频
已放入的素材会按顺序自动填入工作流中未显式指定的加载参数。
这样 Agent 不需要猜文件名,也可以按加载区素材完成对应任务。
工作流技能包¶
工作流技能包用于沉淀某个工作流的使用说明。
它支持以下能力:
按需三级披露文档
面板编辑
Agent 编写
运行前必读校验
参数清单只能说明工作流有哪些参数,而技能包可以继续补充适用场景、关键参数和注意事项。Agent 也可以通过 comfyui_skill 工具读写技能包。
媒体代理与设置¶
生成文件会经过同源路由转发:
/comfyui/media
它按文件名转发,不依赖 ComfyUI 内存态历史。
设置页新增 ComfyUI 分区,可配置:
服务器地址
API Key 环境变量名
本机 ComfyUI 目录
媒体访问地址
远程 ComfyUI 若位于需鉴权的代理之后,可以通过凭据存储或 apiKeyEnv 指定的环境变量提供密钥。密钥绝不发给浏览器。
API Key 不下发到浏览器;浏览器不直接接触 ComfyUI,避免 CORS 与混合内容问题。
典型用法¶
可以直接告诉 Agent 下面这些需求:
用 ComfyUI 画一张红猫的图
把这幅图转成赛博朋克风格
把加载区这张动漫图转成真人照片,分辨率跟原图一致
生成一段 5 秒的短视频:日落下的城市
用我之前在 ComfyUI 里保存的 Krea-Afterlight 跑一下
这些例子对应的是插件已核实的使用示例,不额外假设额外操作。
适用场景与注意¶
适合以下场景:
已有 DeepSeek Harness web/desktop profile
有本地或远程 ComfyUI 服务器
希望 Agent 直接提交 txt2img / img2img / video 任务
需要在面板中管理工作流、查看资产、操作队列
需要注意:
- 先确认 dsh-comfyui 与 DeepSeek Harness 的版本配对。
video模板依赖ComfyUI-WanVideoWrapper与Wan 2.1模型。- 运行环境需要满足
Node >=22.19。 - 插件以当前 dsh 进程权限运行,安装前应检查源码与许可证;当前许可证为
MIT。 - 如果使用远程鉴权,密钥只放在服务端、凭据存储或环境变量中,不下发到浏览器。
结尾¶
dsh-comfyui 的价值在于把 ComfyUI 从手动画布操作变成 DSH Agent 可调用的生成后端:Agent 能提交任务、查看节点、管理工作流和技能包;面板能查看工作流、资产和队列;媒体经同源路由访问,API Key 不下发到浏览器。
链接:
GitHub: https://github.com/fandc520/dsh-comfyui
目录页: https://www.skillhub.cn/plugins/fandc520/dsh-comfyui
目录页地址来自插件线索;本次已抓取资料未直接出现该 URL。