本机出图的边界:qwen-paint 凭什么不用 API Key
装视觉插件,第一个该问的不是「画得好不好」,而是「提示词去了哪」。dsh-qwen-paint 说:出图数据只发往本机 127.0.0.1 的 ComfyUI,不需要 API Key,也不产生调用费用。这话只写在 README 里价值有限;它能当结论,是因为边界写进了代码——地址配错时拒绝启动,而不是「尽力而为」地发出去。
装视觉插件,第一个该问的不是「画得好不好」,而是「提示词去了哪」。dsh-qwen-paint 说:出图数据只发往本机 127.0.0.1 的 ComfyUI,不需要 API Key,也不产生调用费用。这话只写在 README 里价值有限;它能当结论,是因为边界写进了代码——地址配错时拒绝启动,而不是「尽力而为」地发出去。
出口有三类,前两类默认不出网
出图数据流(提示词、参考图)只发往 comfyUrl 与 hipfireUrl,两者默认只允许回环,任一被配成本机以外时拒绝启动,出站请求还强制 redirect: 'error',不跟随重定向。
联网参考图检索默认拒绝:referenceSearchEndpoint 出厂是占位符,没替换时请求被同意门挡回;替换后仍要每次单独同意,没有「记住同意」的常开开关。
第一层:安装期不执行任何脚本
manifest 里没有 preinstall / install / postinstall / prepare 任何一个;本体是纯 Node ESM,不 import 第三方包。所以 dsh plugin add 装下的那一刻,没有代码因为你「装了它」而执行——依赖树与安装期行为都是空的。
第二层:回环检查是代码,不是文档
边界不在文档里,在 lib/net-guard.js 里。出站统一走 guardedFetch:先校验回环,再禁掉重定向——「回环地址 302 到外部域名」是绕过白名单的经典路径。
开关只有一个 allowRemoteComfy,默认 false,同时管住两个端点;setAllowRemote() 启动时设一次全局状态,各守卫自动继承,显式传参仍可覆盖且收紧优先。原因:fetchWithTimeout 在 config.js 里有 8 处调用,逐处传参漏一处就是未受控出口。回归用例 62 项断言。
第三层:子进程拿不到你的代理和密钥
出图要起子进程:启动 ComfyUI、探测显卡。子进程默认继承整个环境变量表,包括各类代理变量,也包括 TOKEN / KEY / SECRET / PASSWORD / CREDENTIAL 这类凭据。filteredEnv 把这两类剔除,只留 PATH / HOME / TEMP 等运行必需项——子进程带着代理变量,网络去向就和声明不一致了。
6.8 GB 与 4.3 GB:档位是拿速度换空间
完整档(默认)qwen_image_2.1_turbo_int8_convrot.safetensors,6.8 GB,显存 ≥ 8 GB,对应官方 8 / 9 步工作点;轻量档 qwen-image-2.1-UC-Q4_K_M.gguf,4.3 GB,适合 8 GB 及以下。CLIP 与 VAE 两档共用。
真实占用更大:三个模型约 14 GB,首次出图要加载 7.26 GB UNET 加 6.31 GB 文本编码器,所以第一次特别慢,本机实测 25 步 1MP 约 62–124 秒。省显存两个旋钮:--lowvram 能跑但明显变慢(README 明说是设计取舍不是 bug),降 megapixels 到 0.5 立竿见影。
四个绕不过去的边界
坑一 · 轻量档主模型要先补 ComfyUI-GGUF 节点
现象:选轻量档后 ComfyUI 报 value not in list,或直接拒收任务。
原因:GGUF 要 ComfyUI-GGUF 自定义节点才认,插件不装第三方节点。Qwen-Image 2.1 的 GGUF 只有 abenzerps 一家在 HuggingFace 提供,hf-mirror 对 LFS 只回 308,国内很可能下不动。
解决:git clone https://github.com/city96/ComfyUI-GGUF "<你的ComfyUI>/custom_nodes/ComfyUI-GGUF" 后重启 ComfyUI;下不动就自备 .gguf 放进 models/unet。这类 GGUF 属 Uncensored 系。
坑二 · accelAutoInstall 默认开着,装包会出网
现象:装完插件,机器上多了几个 pip 包。
原因:accelAutoInstall 默认 true,加载后检测缺哪个厂商加速包就自动 pip install --upgrade 或 git clone。这会改动环境、访问外网,但不发提示词与图片。
解决:设 accelAutoInstall: false,出图功能不受影响,只是少了厂商加速;需要时手动 check_acceleration(action:'install')。
坑三 · 显存不够时 6.8 GB 主模型直接拒跑
现象:8 GB 以下的卡选完整档,跑不起来或慢到不可用。
原因:主模型 6.8 GB,加编码器与 VAE 后远超单卡容量;--lowvram 是拿速度换空间,不是免费加速。
解决:换轻量档,配合降 megapixels 到 0.5,必要时再叠 --lowvram。
坑四 · 许可从 MIT 换到 BUSL-1.1,0.33.0 是分界线
现象:老教程说 MIT,仓库写 BSL 1.1,不知按哪个用。
原因:0.33.0 起改 BUSL-1.1,不是 OSI 核准的开源许可。附加授权为除两类「竞争性使用」外可免费生产使用——把作品作为托管或代管服务给第三方,或嵌进与授权方直接竞争的商业产品。2030-11-15 转 Apache-2.0。
解决:0.32.1 及更早按 MIT 授权,永久不可撤销、不追溯;自己出图碰不到限制,做对外托管服务得先谈商业许可。
总结
它不用 API Key,不是因为把密钥藏了,而是链路里没有需要密钥的地方:装的时候不跑脚本,出站只认回环,子进程拿不到代理。想看同类插件的星标与周下载,精选插件 Top 榜 有现成排序;参数与配置项在 dsh-qwen-paint 详情页可逐条对照。
代价明确:自备 ComfyUI 与 4.3 / 6.8 GB 权重,macOS 不在支持列表,作者只在自己那张 AMD RX 7900 XT 20 GB 上实测过。本站实装验证为 L5 运行时冒烟(dsh 0.2.2-rc.1,数据截至 2026-11-13),静态扫描 v2.7.0 记录 88 处证据,站点未做风险分级。
适合与不适合
适合:有台跑着 ComfyUI 的 Windows / Linux 机器;在意提示词不出本机;要重绘扩图放大但不想开 WebUI。
不适合:只有 macOS;想装完即用、不愿准备权重;做对外托管绘图服务(属竞争性使用);不能接受默认配置下执行 pip install。
标签:dsh-qwen-paint、DeepSeek Harness、ComfyUI、本机出图、BUSL-1.1
本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。