Skip to content

Releases: wbb316/dsh-comfyui-image

v0.1.1

Choose a tag to compare

@github-actions github-actions released this 04 Oct 12:54

Full Changelog: v0.1.0...v0.1.1

v0.1.0 — 首个可用版本

Choose a tag to compare

@wbb316 wbb316 released this 03 Oct 07:27

首个可用版本(需求书里的「实用版 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。