[bug]: “Unknown Qwen3 variant” Error when generating offline using Anima.

快速结论：该报错发生在 InvokeAI 断网状态下使用 Anima Base V1 或微调模型进行文生图时，因为 Qwen3 文本编码器的配置文件（config）未持久化缓存，启动时需要联网从 Hugging Face 下载配置。优先排查 InvokeAI 模型缓存目录中是否存在已下载的 Qwen3 config 文件，并确认网络断开前配置是否成功缓存。

适用环境：InvokeAI v6.13.5（Invoke’s Launcher 安装）、Linux Mint 22.1（x86_64）、NVIDIA GeForce RTX 3060 LHR（12GB VRAM）、CUDA。

最快修复方案：暂无确认的一步修复方案。Issue 讨论中指出，只要有网络连接成功加载过一次模型配置，后续离线生成即可正常工作；但配置缓存未能永久保存，重启 InvokeAI 后若处于断网状态，问题会复现。可优先尝试：确保模型首次加载时处于联网状态，随后在不重启 InvokeAI 的情况下直接断网测试，看是否仍能生成。

注意事项：该问题可能与 InvokeAI 的配置缓存机制缺陷有关，开发者尚未给出明确修复补丁。目前讨论仅确认“联网时配置下载后即可用、断网重启后失效”这一现象，关于缓存为何不持久化仍属推测，需等待官方修复或进一步排查。

问题场景

用户通过 InvokeAI（v6.13.5，Launcher 安装方式）在 Linux（Mint 22.1）上使用 NVIDIA RTX 3060 LHR 显卡进行离线图像生成。选择 Anima Base V1 及微调 checkpoint 模型时，InvokeAI 在加载 anima_text_encoder 节点阶段报错，阻止生成流程启动。报错首先提示 Qwen3EncoderCheckpointLoader 无法识别 Qwen3 变体（仅打印警告并尝试从权重探测配置，探测成功），随后出现 [Errno -2] Name or service not known 的 DNS 解析失败异常，表明 Invoke 在尝试联网请求某个地址。用户联网时同一报错不会阻断生成，只有完全断网时才失败。

报错原文

[2026-07-04 20:29:30,645]::[Qwen3EncoderCheckpointLoader]::WARNING --> Unknown Qwen3 variant: embed_hidden_size=1024, layers=28. Attempting to detect configuration from weights...
[2026-07-04 20:29:30,645]::[Qwen3EncoderCheckpointLoader]::INFO --> Qwen3 config: hidden_size=1024, layers=28, heads=16, kv_heads=8, intermediate=3072
[2026-07-04 20:29:31,174]::[InvokeAI]::ERROR --> Error while invoking session 2e62fec8-dd49-412f-820d-ead7e948eebd, invocation ddecaa32-cce6-4b99-b2c2-bcbf9f965321 (anima_text_encoder): [Errno -2] Name or service not known

原因分析

可能原因：Anima 模型的 Qwen3 文本编码器以 safetensors 格式分发，文件内不包含完整的模型配置（config.json）字段。InvokeAI 的 Qwen3EncoderCheckpointLoader 需要从外部获取配置参数（hidden_size、layers、heads 等）。当本地没有缓存配置时，InvokeAI 会尝试联网（huggingface.co）下载配置，断网时便抛出 DNS 解析错误 [Errno -2] Name or service not known。

根据 Issue 讨论，用户重装编码器并执行修复安装均无效；联网时生成可正常完成，且 InvokeAI 能够输出完整的模型加载日志（Qwen3ForCausalLM、AnimaTransformer 均成功加载到 CUDA），说明模型权重文件本身没有损坏，问题集中在运行期对配置文件的外部网络请求上。

讨论中还提到：配置下载一次后理论上会写入缓存以支持离线使用，但用户发现“每次重启 InvokeAI 且断网时又会遇到同样的错误”，说明配置文件可能没有持久化保存，或者缓存未命中问题在重启后重新出现，此为可能原因而非已确认的根因。

环境排查

InvokeAI 版本：确认是否为 v6.13.5 或更高版本（问题是否仍可复现）。
安装方式：Invoke’s Launcher 创建的虚拟环境路径为 ~/InvokeAI/.venv，Python 3.12。
模型来源：确认 Anima 编码器模型是否来自 Invoke 内置 Starter Models 下载（Hugging Face 源：circlestone-labs/Anima，文件 qwen_3_06b_base.safetensors）。
网络状态：分别记录“完全断网”“有网络但 Hugging Face 不可达”“有网络”三种场景下是否报错。
配置文件缓存：检查 InvokeAI 模型缓存/配置目录中是否存在 Anima Qwen3 encoder 对应的 config 文件（具体路径可搜索 qwen3、anima 关键词）。

解决步骤

确认报错场景：在断网状态下启动 InvokeAI，选择 Anima Base V1 或微调 checkpoint 发起生成，观察是否出现相同报错。若报错则继续后续排查。
联网预热配置（可优先尝试）：保持网络连接，启动 InvokeAI，先加载一次 Anima 模型并完成一次生成。这一操作会触发配置下载，确认生成成功后不要立即重启，直接断开网络再发起一次生成，验证离线是否可用。
验证配置缓存是否持久化：完成步骤 2 后重启 InvokeAI（仍保持断网），再次选择同一模型生成。若再次出现 Unknown Qwen3 variant 和网络错误，说明配置文件缓存未持久保存。
检查本地配置文件：在 InvokeAI 配置或缓存目录中搜索是否生成了 *.json（如 config.json）格式的 Qwen3 配置文件，确认保存位置及文件时间戳是否在步骤 2 后被更新。
尝试重新下载并固定缓存：联网状态下删除（或备份后移除）现有的 Anima 文本编码器模型，通过 InvokeAI Model Manager 重新下载模型，触发全新的配置获取流程，下载完成后保持机器不休眠、不重启，并尽快测试断网使用。
持续跟进官方修复：本问题在 Issue 讨论中尚未给出可用的代码级修复方案，30 天无后续活动后被标记为 Inactive。若上述步骤均无法解决，建议在原始 Issue 中回复确认问题仍然存在，或提交新的 Issue 并附带本环境信息。

验证方法

在完全断开网络连接（建议直接拔掉网线或关闭 Wi-Fi）的情况下重启 InvokeAI，并选用 Anima Base V1 发起图像生成。若底部控制台不再出现 [Errno -2] Name or service not known 及 Unknown Qwen3 variant 相关报错，且能够输出类似 [MODEL CACHE] Loaded model ... (Qwen3ForCausalLM) 的加载日志并正常进入采样进度条，即表示离线场景已恢复正常。另外，将断网重启前后的 InvokeAI 日志对比：修复成功后应不再出现向外部请求配置的 HTTP 连接记录。