dsh-comfyui · JOJO&Adam
ComfyUI 在 DeepSeek Harness 里的生产包：环境体检、零依赖 API 客户端、工作流改造、实测参数矩阵、崩图排查、一致性与批量。
不是“教你怎么点 ComfyUI”，是让 agent 真的能把图跑出来、把坏图查明白。
安装
# 本地开发
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 # 桌面版
30 秒上手
前置：本机 ComfyUI 已启动（默认 127.0.0.1:8188）。
# 1. 体检
python3 skills/comfyui-studio/scripts/comfy_client.py doctor
# 2. 跑一张（示例工作流是标准 SD1.5 txt2img）
python3 skills/comfyui-studio/scripts/comfy_client.py submit \
--workflow skills/comfyui-studio/examples/sd15_txt2img_api.json \
--wait --outdir outputs/comfyui/demo
第一次跑之前把示例里的 ckpt_name 换成你本地 models/checkpoints/ 里的文件名（comfy_client.py models 可以列）。
包含
| 技能 | 用途 |
|---|
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 | 角色一致、固定前缀、队列批量 |
设计边界
- 只连本地 ComfyUI，不经过云端；
- 不代装 ComfyUI、不代下模型；
- 参数矩阵基于 SD1.5 + Apple M5 实测，SDXL / Flux 需重新给区间；
- 客户端零依赖（Python 标准库），兼容 Python 3.8+。
验证
node test/provider.test.mjs
python3 skills/comfyui-studio/scripts/comfy_client.py --help
实机验证：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）。
品牌
JOJO & Adam · https://jojo-adam.com
License
MIT
