Repository navigation
Releases: wbb316/dsh-comfyui-image
Releases · wbb316/dsh-comfyui-image
Release list
v0.1.1
Full Changelog: v0.1.0...v0.1.1
v0.1.0 — 首个可用版本
首个可用版本(需求书里的「实用版 V1」):装好本地 ComfyUI、启用插件,DSH 的 Agent 就能直接出图。
一个工具,四种模式
对外只暴露 generate_image —— text2img / img2img / inpaint / remove_background。
不传 mode 时按 input_image / mask_image 推断;参数冲突不猜,直接报错并告诉你该怎么改。
亮点
- 参数统一 + 智能默认值:尺寸按底模自适应(SDXL 1024 / SD1.5 512)、seed 自动随机、输出文件名带时间戳且绝不覆盖已有文件。
- 零第三方运行时依赖:只用 Node 内置的
fetch/FormData直连本地 ComfyUI(/upload/image、/prompt、/history、/view等)。 npm run doctor自检:打印生效配置、ComfyUI 版本、设备、底模与采样器真实可选值,并逐模式判定能不能跑(退出码 0 全部可用 / 1 连不上 / 2 有模式不可用)。- 88 项测试,自带 mock ComfyUI(真 PNG 编解码、真上传、真轮询、真报错路径)——没装 ComfyUI 的机器也能跑。
- 可读的报错:连不上服务、输入文件不存在、工作流失败、超时、缺去背节点……每条都带「下一步怎么办」。
- 中英双语文档:README + 安装 / 配置 / 参数 / 用法 / FAQ / 路线图。
- 扩展逃生舱:
extra_options.workflow_path指向任意 API 格式工作流,用{{prompt}}/{{seed}}/{{input_image}}等占位符接管本次生成(扩图、超分、批量、特殊节点都能自己接)。
真机验证
ComfyUI 0.38.0 + Intel Arc(XPU 后端,torch 2.14.0+xpu):四种模式全部端到端跑通,
512×768 单张约 15 秒。真机顶出并修复的问题:
- 默认尺寸的「按底模自适应」在最常见路径(没传
model、靠自动挑选)上不生效; img2img/inpaint报告的尺寸与实际产出图不符(现在以产出文件字节为准);- 去背方案
ComfyUI_essentials被当成单节点使用,实际rembg_session是必填输入,真机上会以 HTTP 400 失败。
已知限制
- 背景移除依赖第三方自定义节点(四套方案已按真实仓库与节点类名择优,并给安装指引)。
upscale/outpaint/ 批量多图不在 V1 内置范围,走extra_options.workflow_path。style_reference/character_reference目前只记录进元数据,不参与生成。- 尚未发布到 npm:从 GitHub 克隆后用
link:挂进 DSH profile,详见docs/INSTALL.md。
完整变更见 CHANGELOG.md。