Add v2.6.0 changelog entries (node rename, supported scope, route fix)

This commit is contained in:
ussoewwin
2026-08-28 20:26:24 +09:00
parent 327ef94db4
commit c548397d5f
2 changed files with 20 additions and 2 deletions
+10 -1
View File
@@ -5,7 +5,16 @@
</tr>
</table>
### v2.5.9 (latest)
### v2.6.0 (latest)
- **Changed**: ControlNet node renamed from `NunchakuQI&ZITDiffsynthControlnet` to **`Nunchaku ZI Diffsynth Controlnet&Krea2 LoRA ControlNet`** (internal class name unchanged: `NunchakuQwenImageDiffsynthControlnet`, so existing workflows load without modification).
- **Clarified supported model scope**:
- **Z-Image-Turbo (ZI) route**: supports **Nunchaku** (quantized) and all non-quantized / quantized Z-Image models.
- **Qwen Image (QI) route**: supports all **non-Nunchaku** Qwen Image models (both non-quantized and quantized, e.g. HSWQ ConvRot INT8). **Nunchaku Qwen Image is NOT supported** by the DiffSynth route - the quantized hidden-state scale mismatch produces broken output. Use a standard bf16 Qwen Image model for the QI route, or Nunchaku Z-Image-Turbo for the ZI route.
- **Fixed**: Route classification now recognizes the standard (non-Nunchaku) `QwenImageTransformer2DModel` and routes it to the `qwenimage_standard` path, so DiffSynth ControlNet works correctly with standard bf16 Qwen Image models.
- **Docs**: README (EN + ZH) updated - node image, accurate supported-scope notation, and usage notes.
- **Technical Details**: See [v2.6.0 Release Notes](https://github.com/ussoewwin/ComfyUI-QwenImageLoraLoader/releases/tag/v2.6.0) for complete explanation
### v2.5.9
- **Fixed**: ComfyUI startup `[ERROR]` noise from Hugging Face `transformers` `@auto_docstring` - 13 "but not documented" lines for `DeepseekVLHybridImageProcessorKwargs` (`high_res_size`), `Kimi_K25ImageProcessorKwargs` (`merge_size`) and `PaddleOCRVLImageProcessorKwargs` (`min_pixels` / `max_pixels`). Upstream TypedDict docstrings fail validation: a stray leading space hides `high_res_size`, the kimi docstring documents `merge_kernel_size` instead of `merge_size`, and paddleocr never documents `min_pixels` / `max_pixels`.
- **Non-invasive fix**: No `site-packages` edits. `prestartup_script.py` wraps `get_args_doc_from_source` in-process (same design as the v2.4.7 CausalLM docstring patch) so the four fields resolve through the fallback source dict.
- **Upstream auto-disable (fully automatic)**: On every ComfyUI start the patch probes upstream; once `transformers` fixes the docstrings, the patch skips itself. No environment variables or user toggles.
+10 -1
View File
@@ -5,7 +5,16 @@
</tr>
</table>
### v2.5.9 (最新)
### v2.6.0 (最新)
- **已更改**: ControlNet 节点名称由 `NunchakuQI&ZITDiffsynthControlnet` 改为 **`Nunchaku ZI Diffsynth Controlnet&Krea2 LoRA ControlNet`**(内部类名不变:`NunchakuQwenImageDiffsynthControlnet`,已有工作流无需修改即可加载)。
- **明确支持范围**:
- **Z-Image-Turbo(ZI 路由)**:支持 **Nunchaku**(量化)以及所有非量化 / 量化 Z-Image 模型。
- **Qwen Image(QI 路由)**:支持所有**非 Nunchaku** 的 Qwen Image 模型(非量化与量化均支持,如 HSWQ ConvRot INT8)。**Nunchaku Qwen Image 不受支持**(量化后的 hidden-state 尺度不匹配会导致输出损坏)。QI 路由请使用标准 bf16 Qwen Image 模型,ZI 路由请使用 Nunchaku Z-Image-Turbo。
- **已修复**: 路由分类现在能识别标准(非 Nunchaku)`QwenImageTransformer2DModel` 并路由到 `qwenimage_standard` 路径,DiffSynth ControlNet 可在标准 bf16 Qwen Image 模型上正常工作。
- **文档**: 更新 README(EN + ZH)— 节点图片、精确的支持范围说明与用法说明。
- **技术详情**: 参见 [v2.6.0 发布说明](https://github.com/ussoewwin/ComfyUI-QwenImageLoraLoader/releases/tag/v2.6.0) 获取完整说明
### v2.5.9
- **已修复**: ComfyUI 启动时来自 Hugging Face `transformers` `@auto_docstring` 的 `[ERROR]` 日志噪音 —— `DeepseekVLHybridImageProcessorKwargs`(`high_res_size`)、`Kimi_K25ImageProcessorKwargs`(`merge_size`)、`PaddleOCRVLImageProcessorKwargs`(`min_pixels` / `max_pixels`)共 13 行 "but not documented" 报错。上游 TypedDict docstring 无法通过校验:`high_res_size` 行多了一个前导空格导致解析器匹配不到;kimi 的 docstring 写的是 `merge_kernel_size` 而注解为 `merge_size`;paddleocr 完全未记录 `min_pixels` / `max_pixels`。
- **非侵入式修复**: 不修改 `site-packages`。`prestartup_script.py` 在进程内包装 `get_args_doc_from_source`(与 v2.4.7 CausalLM docstring 补丁同一设计),使这四个字段通过回退源字典被解析。
- **上游自动禁用(全自动)**: 每次 ComfyUI 启动都会探测上游;一旦 `transformers` 修复了 docstring,补丁会自动跳过自身。无需环境变量或用户开关。