godot-imagegen

LIMITATIONS

Known limitations

- **没有浮窗**：`dsh-better-sidebar` 从 v0.19.0 起删掉了 `floatWindows`，所以内嵌画布只能在侧边栏里用 （见第 2 节）。插件按**能力**判断而不是版本号：侧边栏若重新报出 `floats`，浮窗与全屏按钮会自己回来。 详见第 2 节。 - **后端调用不使用全局 `fetch`**：undici 有 300s 的 `headersTimeout`/`bodyTimeout` 且无法在无 undici 包时调高， 真实 SDXL 出图（7GB 换模型 + 采样）会超过它并抛 `UND_ERR_HEADERS_TIMEOUT`。插件改用 `node:http`， 超时只受自身的 `requestTimeoutMs` 控制。 - **ComfyUI 通道只实现文生图 / 图生图**。它能看到 SD WebUI 共享来的 ControlNet / 放大权重， 但通过工作流 JSON 驱动 ControlNet、UltimateSDUpscale、WD14 尚未接线；这些能力请走 SD WebUI。 - `transparent_method: generative`（ComfyUI layerdiffuse 直出）已实现工作流接线， 但需要先把 layerdiffuse 权重放进 `ComfyUI/models/layerdiffuse`（`extra_model_paths` 没有映射它）。 - `image_cutout` 的 `rembg` 首次运行会下载约 176 MB 的 u2net 模型（本机已缓存则瞬间完成）。 - 桥接扩展有 `.js` 改动就**必须重启 ComfyUI**（`WEB_DIRECTORY` 只在启动时读），不是热重载的。 - 画布通道**经过面板**（postMessage），所以面板必须开着；用系统浏览器「外部打开」的 ComfyUI 不在通道里。这不是偷懒：DSH 会给"frame origin 不是载体 origin"的请求一律 403， iframe 自己发不出任何请求，父窗口是唯一通路。 - 面板不做九宫格切片、图集打包、调色板量化等"后期"加工——那些更适合放在 Godot 导入侧或技能里。 - RTX 5060 Laptop 上 SDXL 出图偏慢，建议先用 SD1.5 试参数再放大。