前言¶
在 DeepSeek Harness（DSH）里接图像生成，常见做法是写一段脚本调 API，或把 ComfyUI 当黑盒让模型「猜」工作流怎么改。前者缺环境体检、参数区间和崩图排查的成套知识；后者容易连不上、模型名不对、OOM 或花图却说不清原因。社区插件 dsh-comfyui（维护者 JOJO-Adam）定位是 ComfyUI 的「生产包」：不是教你怎么点界面，而是让 agent 能提交工作流、取图，并在坏图时按文档和技能排查。下面介绍它是什么、装在哪、怎么用，以及设计边界。
这是什么¶
dsh-comfyui 是发布在 npm 的包 @jojonadam/dsh-comfyui（当前版本 0.1.2，MIT 许可证），仓库 JOJO-Adam/dsh-comfyui。在 SkillHub 目录 中归类为「联网工具」；就插件自身设计而言，只连接本机已启动的 ComfyUI（默认 127.0.0.1:8188），不经过云端，也不代装 ComfyUI 或下载模型。
一句话：环境体检、零依赖 API 客户端、工作流改造指引、实测参数矩阵、崩图排查，以及一致性与批量相关技能，打包给 DSH 使用。
核心功能¶
插件通过多个 skill 分工，总入口是 comfyui-studio（含 comfy_client.py 与示例工作流）。
| 技能 | 用途 |
|---|---|
comfyui-studio |
体检、提交、取图、路由（客户端脚本与示例工作流） |
comfyui-env |
连不上、模型缺失、节点缺失、OOM、MPS 等问题 |
comfyui-production-sop |
六层故障模型与生产流程 |
comfyui-prompt-engineering |
提示词结构、失效模式、权重相关坑 |
comfyui-workflow-architecture |
高清修复、局部重绘、管线改造 |
comfyui-parameter-tuning |
CFG、步数、分辨率、采样器实测矩阵 |
comfyui-troubleshooting |
黑图、花图、主体重复、彩边、OOM 排查树 |
comfyui-consistency-batch |
角色一致、固定前缀、队列批量 |
客户端为 Python 标准库实现，兼容 Python 3.8+，无额外 pip 依赖。参数矩阵基于 SD1.5 + Apple M5 实测；README 写明 SDXL / Flux 需自行重新划定区间。
运行环境要求（来自 package.json）：dsh >=0.2.0-rc.2，Node >=20；peer 依赖 @deepseek-ai/cordis ~4.0.5。
安装与启用¶
DSH 生态是「一切皆插件」；SkillHub 为社区独立目录站，与 DeepSeek / 幻方无官方从属关系。安装前建议阅读仓库源码与 MIT 许可证——插件以当前 dsh 进程权限运行，会访问本机 ComfyUI 与本地模型路径。
官方安装方式如下（摘自 README，勿用未在文档中出现的 github:owner/repo 拼接命令）：
# 本地开发
dsh plugin --profile desktop add link:/absolute/path/to/dsh-comfyui
# 从 npm
dsh plugin --profile web add @jojonadam/dsh-comfyui # Web 版
dsh plugin --profile desktop add @jojonadam/dsh-comfyui # 桌面版
典型用法¶
前置：本机 ComfyUI 已启动（默认 127.0.0.1:8188）。
1、环境体检
确认 ComfyUI 可达、依赖与模型是否就绪：
python3 skills/comfyui-studio/scripts/comfy_client.py doctor
2、提交示例工作流并等待出图
示例为标准 SD1.5 txt2img API 工作流；第一次跑前需把 JSON 里的 ckpt_name 换成你本地 models/checkpoints/ 下的文件名。可用下列命令列出可用 checkpoint：
python3 skills/comfyui-studio/scripts/comfy_client.py models
提交并输出到指定目录：
python3 skills/comfyui-studio/scripts/comfy_client.py submit \
--workflow skills/comfyui-studio/examples/sd15_txt2img_api.json \
--wait --outdir outputs/comfyui/demo
3、自检插件与客户端
node test/provider.test.mjs
python3 skills/comfyui-studio/scripts/comfy_client.py --help
README 记载的实机验证环境：ComfyUI 0.41.0，Apple M5 16GB · MPS，SD1.5 512×512 / 20 步 / cfg 7 / euler，三次中位数 11.7s（10.4–15.1s，2026-10-19）。你的硬件与模型不同，耗时会不一样。
适用场景与注意¶
适合谁
- 已在本机跑 ComfyUI，希望 DSH agent 用统一脚本提交 API 工作流、拉结果图。
- 需要成套技能处理连不上、缺节点、OOM、崩图类型，而不是单次临时脚本。
- 做 SD1.5 参数调优时，可参考插件内实测矩阵；换管线需自行验证区间。
设计边界（README 原文要点）
- 只连本地 ComfyUI，不经过云端。
- 不代装 ComfyUI、不代下模型。
- 参数矩阵基于 SD1.5 + Apple M5；其他模型需重新给区间。
安全与合规
安装插件等于信任维护者代码与技能内容。联网分类来自目录站标签，实际数据面以本地 ComfyUI 为主；仍应在可控环境中启用，并核对 cordis.patch.yml 与 bundle 行为是否符合你的策略。
结尾¶
dsh-comfyui 把 ComfyUI 从「能点开网页」推进到「agent 能体检、提交、取图并按技能查坏图」，适合把本地出图纳入 DSH 工作流的生产向场景。目录页：SkillHub · dsh-comfyui；源码与文档：GitHub · JOJO-Adam/dsh-comfyui。品牌主页：jojo-adam.com。
