dsh-tool-comfyui：让 DeepSeek Harness 在对话里直接调用 ComfyUI 机队出图

它是做什么的？

ComfyUI 机队工具是 DeepSeek Harness（DSH）的图片生成插件，把本机或局域网里的 ComfyUI 出图能力接进对话。它解决的是「提交任务后要等 GPU 跑完」这件事——ComfyUI 采用两段式协议，先提交拿任务号再轮询历史记录，普通抓取做不到等待，所以必须由插件承担轮询。装好后你只要在对话里说人话，Agent 就会调用对应工具探测机队、出图或管理队列，不用切窗口、不用手搓请求。插件由 yuehancn 维护，采用 MIT 协议，仅访问你在配置里指定的地址，不需要任何 API key。

核心功能

• 机队状态探测：一次调用即可看到哪些机器在线、ComfyUI 版本、显卡型号与显存、队列深度，并顺带列出可用的工作流模板。
• 按模板出图：指定命名工作流模板提交 prompt，插件负责等待 GPU 跑完并把成图下载到本地，返回文件路径。
• 队列管理：查询某台机器的运行与排队情况，也可一键中断并清空目标机器队列。
• 多机机队配置：在配置里追加 workers 条目即可接入新机器，支持为每台机器单独设置超时。
• 本地化与隐私：prompt 只发给你的 ComfyUI，成图写入指定输出目录，无遥测、无凭据读取、安装时不执行任何生命周期脚本。

怎么使用这个插件？

在 DSH 中启用后，直接在对话里用自然语言提需求即可，例如「帮我出一张白底咖啡杯的电商图」会触发出图工具并带上对应的英文 prompt，「先看看素材机活着没」会触发状态探测，「把某台机器上排队的任务清掉」会触发队列清理。出图前需要先在配置里登记机队：为每台机器填写标识、地址和备注，并指定工作流模板目录、输出目录、默认模板、批量上限与超时时间；加机器就是往机队列表追加一项。素材机上可手动双击启动脚本运行 ComfyUI，需要跨机调用时让它监听局域网地址；该脚本会先停掉挖矿进程，避免 GPU 满载拖慢出图。注意清空队列属于破坏性操作，只在你明确要求时使用。

报错怎么排查？

出图极慢时，先确认素材机上是否有挖矿类进程占满 GPU，官方启动脚本会在启动前主动结束这类进程。若工具没有出现在对话中，检查插件是否已列入 profile 的 bundles 列表——只写进依赖项并不算启用，按官方说明修复后重启对应 profile 即可。若行为异常，请对照你所用 DSH 版本核对插件规范，该插件是针对预览版构建并测试的。