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	总入口：体检、提交工作流、取图、六域路由（含 scripts/comfy_client.py 与示例 workflow）
comfyui-env	服务连不上、模型不显示、显存不够、MPS 问题

标准与流程

技能	用途
comfyui-sop	标准实务：控制层真存在性、工具名表、反编造红线（单一真相源）
comfyui-workflow-design	从零设计工作流：节点选型、接线纪律、格式校验
comfyui-workflow-upgrade	改造：高清修复、局部重绘、denoise 取值、常见接错线
comfyui-param-tuning	参数实测矩阵：CFG / 步数 / 分辨率 / 采样器耗时
comfyui-prompt-structure	提示词结构：句子优于关键词、四种失效模式
comfyui-batch-consistency	构图一致 vs 身份一致、批量队列、seed 不是身份锁
comfyui-failure-tree	崩图排查树：黑图/花图/主体重复/彩边/OOM → 层 → 动作
comfyui-production-sop	生产 SOP：六层故障模型、SD1.5 安全区间
comfyui-generation-exec	提交队列、跟进度、取回真实结果
comfyui-mcp-bridge	MCP 桥接、工具名对齐、启动排障
comfyui-model-management	模型/LoRA 清单、版本核对
comfyui-handoff	资产交接：交付文档 + 缺口清单
comfyui-hardware-audit	硬件审计：探针 → 动态能力卡 → 量化降级

五条产线

技能	用途
comfyui-video-pipeline	T2V / I2V / 动作迁移 / 多镜头 / 补帧
comfyui-audio-pipeline	配乐 / 音效 / 剪辑节点 / 音视频合流
comfyui-3d-pipeline	图生 3D / 贴图 / 网格清理 / GLB 出货
comfyui-training-lora	LoRA 训练、数据集、角色一致性
comfyui-vision-utils	去背景 / 修复 / 放大 / 分割 / 打标

设计边界

• 只连本地 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