痒局长

Manager 装好了，打开是空的

2026-11-08T16:15:00+00:00

ComfyUI-Manager 已安装 ✓
点开 Model Manager
→ 一片空白
→ 控制台：Failed to get external model list

它默认去 raw.githubusercontent.com 拿节点清单。那个域名，在很多网络里是连不上的。

不是 Manager 写错了，是这个默认值对一部分人不成立。

我一开始写了个「一键修复」脚本

四个步骤，跑完就重启，能用。

然后我意识到一个问题：Manager 一升级，它就被顶掉了。

用户不知道要重跑一次，于是列表又空了，然后他会觉得「这工具坏了」。

所以换了个形态：诊断器优先

--check     只诊断：Manager 哪一版、哪些地址没走镜像、镜像通不通
--fix       改（幂等，可反复跑）
--verify    只验：真去把清单拉一遍

--check 是主角，--fix 是配角。

为什么？因为「改官方源码」这件事一定会随版本失效。但即使失效，--check 也应该准确地告诉你「我修不了」，而不是静默失败。

一个会说「我修不了」的工具有用；一个假装修好了的工具有害。

它到底改什么（四处，都列出来）

#	改哪	改成什么
1	`user\__manager\channels.list`	6 个频道地址加镜像前缀
2	`user\__manager\config.ini`	`channel_url` 指向镜像
3	`custom_nodes\ComfyUI-Manager` 里 `.py` / `.template` 中写死的地址	加镜像前缀
4	`glob\manager_downloader.py`	模型下载默认走 hf-mirror

每个改动的文件旁边留一份 .bak_managerfix，原样可回滚。

两个技术上的坑

① 幂等不能靠「跑两次结果一样」，要靠正则

镜像地址里包含原始地址：

https://ghfast.top/https://raw.githubusercontent.com/...
                 ↑ 这一段会被下次替换再包一层

不处理的话，第二次跑就变成 ghfast.top/ghfast.top/https://...。

解决办法是负向后视断言，只在「还没被包过」的位置替换，再加一条折叠正则兜底。

② 自动找 ComfyUI 目录比想象中难

桌面版把实例放在 installPath\ComfyUI\——往下还有一层。

第一版只查了一层，结果在真机上「找不到 ComfyUI」。

修法是：拿到候选目录后，自己也查一次，再查它的 ComfyUI 子目录。

一句话

会碎不是不发的理由，是要发出一个碎的时候会说实话的版本。

下了模型，然后站在目录前面发呆

2026-11-08T16:12:00+00:00

迅雷把文件拽到桌面了。moss_image_edit.safetensors，5 GB。

然后呢？

checkpoints？vae？loras？diffusion_models？

放错了，ComfyUI 里就看不到它；更糟的是，看到了但加载报错。

网上的答案：看文件名

带 vae 的放 vae
带 lora 的放 loras
带 clip 的放 text_encoders

新模型根本不在文件名里写这些。

krea2_turbo_fp8_scaled.safetensors     ← 名字里没有任何结构线索
moss_image_edit.safetensors            ← 看着像主干，其实是 LoRA
z_image_turbo_bf16.safetensors         ← 看不出是 DiT

光靠文件名，这三个我一个都放不对。

换个思路：读文件内部

.safetensors 的头里写着每个张量的名字。那些名字就是结构的指纹。

encoder.down.* + decoder.up.*        →  VAE
blocks.0.attn.wq/wk/wv + mlp.gate    →  DiT 主干（Krea / Chroma 那类）
layers.0.proj.k.lora_A / lora_B      →  LoRA（哪怕文件名里没有 lora）
model.language_model.*               →  文本编码器（Qwen3-VL 那类）
cap_embedder / noise_refiner         →  DiT（Z-Image 那类）

只读头部，通常几百 KB，不加载权重。

12 条规则是这么一条条试出来的

没有人给我这份表。是我拿本机模型库里每个文件，把它的前几个张量名打出来，一条条对照着写的。

MOSS-Image   → layers.N.proj.*     （没有 model.diffusion_model 前缀）
Krea / Chroma → blocks.N.attn.wq   （没有 double_blocks，也不是 layers）
Qwen3-VL     → model.language_model.layers.*  （比 model.layers 多一层）

每认出一个新结构，就往表里加一条。加完再跑一遍全库，看有没有把别的判错。

现在的成绩

本机模型库 15 个真实文件
判出        15 / 15
与现有目录一致  14 / 15

那个「不一致」的，是 moss_image_edit.safetensors——它现在躺在一个叫 moss-image-edit\ 的非标准目录里。

但它的张量是 layers.N.proj.k.lora_A/lora_B，它确实是 LoRA。

所以是我的判定对，是那个文件放错了地方。

三条我坚持要有的规矩

它要移动你的文件，所以：

① 绝不覆盖
   同名同大小 → 跳过
   同名不同大小 → 另存 xxx_1.safetensors，原文件不动

② 判不出来就不动
   只说「判断不出来」，不猜、不乱放

③ --dry-run 先看
   报告会放到哪，一个字节都不动

「判不出来」比「猜错了」好一百倍。猜错了用户不会知道，直到加载报错。

一句话

文件名是别人起的，张量名是模型自己长的。 信模型自己。

官方那个「下载」按钮，在国内基本按不动

2026-11-08T16:10:00+00:00

打开别人分享的工作流，右边红字：缺失模型。

点官方的「下载」——它直连 huggingface.co，转圈，然后没了。

我一开始以为是网速。后来把桌面版拆开数了一遍：

对 resources\app.asar（64 MB）做字符串统计：
    hf-mirror           0 处
    modelscope          0 处
    HF_ENDPOINT         0 处
    useChineseMirrors   136 处  ← 但它的标签是
                                 "Use Chinese Mirrors (Git & PyPI)"

那个开关只管 Git 和 pip，不管模型文件。

所以在国内网络下，模型下载这一块，官方是空的。

三条路，只有两条通

通道	走法	支不支持镜像
桌面版标题栏 Downloads	Electron 直连 huggingface.co	❌ 没有开关
Manager「模型」页	Python 下载器	✅ 认 `HF_ENDPOINT`
终端 `hf`	huggingface_hub	✅ 认
迅雷 / aria2c	你给它的直链	✅ 换个域名就行

问题不是「没有镜像」，是「点了那个按钮走的是不通的那条」。

于是做了这个

在「缺失模型」面板的同一个位置，加一个 「镜像补缺」 按钮：

扫出缺哪些文件
   ↓
按文件名去镜像反查官方仓库，优先 Comfy-Org/*
   ↓
断点续传下到 models//

它不修改 ComfyUI 任何文件——因为它是扩展，不是补丁。升级不碎。

两个反查上的坑，值得写下来

① 不能用前缀当搜索词

qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors 这个文件，仓库叫 MiniMax-H3。用前缀 qwen3vl 去搜，永远搜不到它。

改成取所有相邻词对——minimax_h3 出现在搜索词里，才搜得到。

② 「搜到官方仓库就停」是个陷阱

我当初写了个「已经有 Comfy-Org 的候选就不必再搜」的提前退出。结果第一个关键词命中了无关的 Comfy-Org 仓库（Qwen），于是它再也不搜 minimax。

四个文件全找不到，两个 bug 叠在一起。

修完之后：35 秒 → 8-11 秒（关键词并行 + 仓库并行探测），四个文件全部命中。

一句话

缺模型不是用户的错，是这个按钮指错了地方。 我把按钮指对，剩下的不动。