From ed78766b83b2ffd1e4d83f7ee17cadab8f018a2b Mon Sep 17 00:00:00 2001 From: ussoewwin <136552381+ussoewwin@users.noreply.github.com> Date: Thu, 13 Aug 2026 16:08:05 +0900 Subject: [PATCH] docs: add v2.5.6 changelog entry (AMD/ROCm compatibility) with release note link --- RELEASE_NOTES/changelog.md | 9 ++++++++- zhmd/changelogzh.md | 9 ++++++++- 2 files changed, 16 insertions(+), 2 deletions(-) diff --git a/RELEASE_NOTES/changelog.md b/RELEASE_NOTES/changelog.md index 2886dbd..05aba78 100644 --- a/RELEASE_NOTES/changelog.md +++ b/RELEASE_NOTES/changelog.md @@ -5,7 +5,14 @@ -### v2.5.5 (latest) +### v2.5.6 (latest) +- **Added**: AMD/ROCm compatibility - nunchaku requires NVIDIA CUDA and is unavailable on AMD/ROCm systems. The package now probes nunchaku availability at startup (`_NUNCHAKU_AVAILABLE`) and automatically disables every nunchaku-dependent node (`NunchakuQwenImageLoraLoader/Stack`, `V1`/`V2`/`V3`, `NunchakuZImageTurboLoraStackV1`/`V4`) on such systems; they are no longer registered. +- **Still available on AMD/ROCm**: The nunchaku-independent Krea2 ControlNet nodes remain fully functional - `Krea2ControlNetLoraLoader` and the Krea2 route of `NunchakuQI&ZITDiffsynthControlnet`. +- **Clear errors**: Runtime nunchaku imports are guarded, so legacy workflows get a clear `RuntimeError` ("nunchaku is required...") instead of an obscure `ImportError`. Startup logs a `[ROCm/AMD] nunchaku is not available...` warning when the dependency is missing. +- **Docs**: README (EN + ZH) updated with an AMD / ROCm compatibility section. +- **Technical Details**: See [v2.5.6 Release Notes](v2.5.6.md) for complete explanation + +### v2.5.5 - **Added**: Krea2 **openpose** ControlNet LoRA support (`krea2_turbo_openpose_controlnet.safetensors`) in `NunchakuQI&ZITDiffsynthControlnet`. - **Exclusive routing**: The Krea2 route now auto-detects the control sub-type from the LoRA file - **depth** (`first.weight` expansion) vs **openpose** (pure block LoRA). The openpose branch is fully isolated from the existing depth / Qwen Image / Z-Image / Nunchaku routes; no existing behavior is changed. - **Native reference-latent conditioning**: The pose image is VAE-encoded and injected as a native Krea2 reference latent (`index_timestep_zero`) - the conditioning pathway the openpose control LoRA was trained against (256 block patches, rank 32, on all 28 DiT blocks + txtfusion layerwise/refiner blocks). diff --git a/zhmd/changelogzh.md b/zhmd/changelogzh.md index 679121d..ea7ccba 100644 --- a/zhmd/changelogzh.md +++ b/zhmd/changelogzh.md @@ -5,7 +5,14 @@ -### v2.5.5 (最新) +### v2.5.6 (最新) +- **已添加**: AMD/ROCm 兼容性 — nunchaku 仅支持 NVIDIA CUDA，在 AMD/ROCm 系统上不可用。本包现在会在启动时探测 nunchaku 可用性（`_NUNCHAKU_AVAILABLE`），并在这类系统上自动禁用所有依赖 nunchaku 的节点（`NunchakuQwenImageLoraLoader/Stack`、`V1`/`V2`/`V3`、`NunchakuZImageTurboLoraStackV1`/`V4`）；它们将不再注册。 +- **AMD/ROCm 上仍可使用**: 不依赖 nunchaku 的 Krea2 ControlNet 节点保持完整功能 — `Krea2ControlNetLoraLoader` 以及 `NunchakuQI&ZITDiffsynthControlnet` 的 Krea2 路由。 +- **清晰的错误**: 运行时 nunchaku 导入已加防护，旧工作流会收到清晰的 `RuntimeError`（"nunchaku is required..."），而非曲折的 `ImportError`。缺少依赖时，启动时会输出 `[ROCm/AMD] nunchaku is not available...` 警告日志。 +- **文档**: README（EN + ZH）已更新，新增 AMD / ROCm 兼容性章节。 +- **技术详情**: 参见 [v2.5.6 发行说明](v2.5.6.md) 获取完整说明 + +### v2.5.5 - **已添加**: 在 `NunchakuQI&ZITDiffsynthControlnet` 中新增 Krea2 **openpose** ControlNet LoRA 支持（`krea2_turbo_openpose_controlnet.safetensors`）。 - **互斥路由**: Krea2 路由现在会根据 LoRA 文件自动检测控制子类型 —— **depth**（`first.weight` 扩展投影）与 **openpose**（纯块 LoRA）。openpose 分支与既有的 depth / Qwen Image / Z-Image / Nunchaku 路由完全隔离；现有行为不受任何影响。 - **原生参考潜变量条件**: 姿态图经 VAE 编码后，以原生 Krea2 参考潜变量（`index_timestep_zero`）注入 —— 这正是该 openpose 控制 LoRA 训练时所采用的条件通路（256 个块补丁，rank 32，作用于全部 28 个 DiT 块及 txtfusion 的 layerwise/refiner 块）。