Repository navigation
Releases: leeymxz/ComfyUI-MissingDoctor
Release list
v1.4.14 · 📍 缺失模型也能画布定位：按引用节点 ID 精准跳转
UI MissingDoctor v1.4.14
ComfyUI 体检中心：缺失节点/模型检测 + 一键自动安装 + 模型下载到模型库 + 查重 + 目录映射 + 调用记录防误删 + 安全清理 + 环境管理 + 一键更新
📍 本版（v1.4.14）：缺失模型也能「在画布上定位」
此前只有缺失节点有「📍 在画布上定位」，缺失模型卡片只显示节点号文字——用户得在画布上肉眼找引用该模型的节点。现在补齐：
- 缺失模型卡片新增「📍 在画布上定位」：按检测到的引用节点 ID 精准跳转并高亮（支持子图递归查找）
- 多个节点引用同一模型时循环定位：每点一次切换到下一个引用节点（与缺失节点定位同款交互）
- 定位核心统一重构：缺失节点 / 缺失模型共用同一套「官方居中 API + 循环定位 + 闪烁高亮」逻辑，行为完全一致
🔍 v1.4.13 回顾：全面审查修复
- 下载器流作用域根因修复（0 字节假下载的真正原因）
- 磁盘空间预检从未生效 → 已修正
- 节点自动安装（git clone）镜像兜底
✨ 既有能力（v1.4.x 累积）
- 🛡 下载完整性校验（v1.4.12） / 🐛 pip worker 修复（v1.4.11） / ⬇ 下载体验优化（v1.4.10）
- 🧰 pip 加固（v1.4.9） / 🌐 一键更新网络兜底（v1.4.8） / 📍 画布定位精修（v1.4.7） / 🚨 Manager 官方库修复（v1.4.6）
- 🇨🇳 魔搭免登录搜索 / 🧪 环境管理 / 🛡 防误删 / 🧹 安全清理 / 🚩 社区纠错
📦 安装
cd ComfyUI/custom_nodes
git clone https://github.com/leeymxz/ComfyUI-MissingDoctor.git重启 ComfyUI，点击右下角 🩺 悬浮球开始体检。可选依赖：pip install -r requirements.txt（send2trash 回收站支持）。
v1.4.13 · 🔍 全面审查：修复下载器流关闭根因 + 节点安装镜像兜底
UI MissingDoctor v1.4.13
ComfyUI 体检中心：缺失节点/模型检测 + 一键自动安装 + 模型下载到模型库 + 查重 + 目录映射 + 调用记录防误删 + 安全清理 + 环境管理 + 一键更新
🔍 本版（v1.4.13）：全面代码审查修复
对全部模块做系统性审查，发现并修复三个隐藏 bug：
- 模型下载器「0 字节假下载」的真正根因（比 v1.4.12 更深一层）：
r.iter_content()在with requests.get(...) as r:块外执行——with 退出会关闭未读的流，之后从已关闭连接读数据只能得到空 → 一开始就"下载完成"0 字节。现已把流消费移回 with 块内；v1.4.12 的完整性校验保留作为双保险。 - 磁盘空间预检从未生效：预检代码在
.part路径变量定义之前引用了它，抛出的 UnboundLocalError 被except: pass静默吞掉。已修正变量顺序，预检真正工作。 - 节点自动安装（git clone）镜像兜底：与一键更新同款的国内网络问题——clone 直连 github.com 被墙必失败。现在 clone 失败且为网络错误时自动走 ghproxy.net / gh-proxy.com 镜像重试（仅 github 仓库，不改用户配置）。
✨ 既有能力（v1.4.x 累积）
- 🛡 下载完整性校验（v1.4.12） / 🐛 pip worker 修复（v1.4.11） / ⬇ 下载体验优化（v1.4.10）
- 🧰 pip 加固（v1.4.9） / 🌐 一键更新网络兜底（v1.4.8） / 📍 画布定位精修（v1.4.7） / 🚨 Manager 官方库修复（v1.4.6）
- 🇨🇳 魔搭免登录搜索 / 🧪 环境管理 / 🛡 防误删 / 🧹 安全清理 / 🚩 社区纠错
📦 安装
cd ComfyUI/custom_nodes
git clone https://github.com/leeymxz/ComfyUI-MissingDoctor.git重启 ComfyUI，点击右下角 🩺 悬浮球开始体检。可选依赖：pip install -r requirements.txt（send2trash 回收站支持）。
v1.4.12 · 🛡 下载完整性校验：空响应/不完整/过小一律失败
🩺 ComfyUI MissingDoctor v1.4.12
ComfyUI 体检中心：缺失节点/模型检测 + 一键自动安装 + 模型下载到模型库 + 查重 + 目录映射 + 调用记录防误删 + 安全清理 + 环境管理 + 一键更新
🛡 本版（v1.4.12）：模型下载完整性校验
问题：候选链接返回空内容（Content-Length: 0 或 0 字节响应体）时，下载器原有校验只查"网页/LFS 指针特征"——空响应不命中 → 直接把 0 字节文件改名保存还报"下载完成"。
修复（多层兜底）：
- 预检：响应头明确
Content-Length: 0→ 直接失败，提示"候选失效请换来源" - 完成后校验（在原有网页/LFS 检查之外新增）：
downloaded == 0→ 报"服务器返回空内容"，删除 .part 残留total > 0 且 downloaded != total→ 报"下载不完整"，删除残留文件 < 1KB→ 报"过小不是有效模型"（safetensors 至少含元数据头）
- 0 字节残留文件自动清理：之前失败留下的 0 字节文件，再次下载时不再被"已存在"挡住，自动删掉重下
✨ 既有能力（v1.4.x 累积）
- 🐛 pip worker 修复（v1.4.11） / ⬇ 下载体验优化（v1.4.10） / 🧰 pip 加固（v1.4.9）
- 🌐 一键更新网络兜底（v1.4.8） / 📍 画布定位精修（v1.4.7） / 🚨 Manager 官方库修复（v1.4.6）
- 🇨🇳 魔搭免登录搜索 / 🧪 环境管理 / 🛡 防误删 / 🧹 安全清理 / 🚩 社区纠错
📦 安装
cd ComfyUI/custom_nodes
git clone https://github.com/leeymxz/ComfyUI-MissingDoctor.git重启 ComfyUI，点击右下角 🩺 悬浮球开始体检。可选依赖：pip install -r requirements.txt（send2trash 回收站支持）。
v1.4.11 · 🐛 紧急修复：v1.4.9 pip 安装 UnboundLocalError
🩺 ComfyUI MissingDoctor v1.4.11
ComfyUI 体检中心：缺失节点/模型检测 + 一键自动安装 + 模型下载到模型库 + 查重 + 目录映射 + 调用记录防误删 + 安全清理 + 环境管理 + 一键更新
🐛 本版（v1.4.11）：紧急修复 v1.4.9 引入的 pip 安装 bug
v1.4.9 重构 pip 执行器时引入变量作用域错误：输出裁剪用切片赋值（tail = tail[-60:]）发生在嵌套函数内，导致 tail 被误判为局部变量，所有 pip 安装一启动就报 cannot access local variable 'tail'。
修复：裁剪改为原地删除（del tail[:-60]），不重新绑定变量；模拟测试覆盖三种场景全部通过（长输出裁剪 / 构建后端缺失自动补装重试 / 补装失败明确报错）。
v1.4.9 / v1.4.10 用户请更新本版后重新使用「一键安装缺失依赖」等功能。
✨ 既有能力（v1.4.x 累积）
- ⬇ 下载体验优化（v1.4.10）：文件已存在可选覆盖 + HF 引用名自动解析（kijai_MiniMax-H3 等秒出直链）
- 🧰 pip 加固（v1.4.9）：国内镜像源 + 构建依赖自动补装
- 🌐 一键更新网络兜底（v1.4.8） / 📍 画布定位精修（v1.4.7） / 🚨 Manager 官方库修复（v1.4.6）
- 🇨🇳 魔搭免登录搜索 / 🧪 环境管理 / 🛡 防误删 / 🧹 安全清理 / 🚩 社区纠错
📦 安装
cd ComfyUI/custom_nodes
git clone https://github.com/leeymxz/ComfyUI-MissingDoctor.git重启 ComfyUI，点击右下角 🩺 悬浮球开始体检。可选依赖：pip install -r requirements.txt（send2trash 回收站支持）。
v1.4.10 · ⬇ 下载体验优化：文件已存在可选覆盖 + HF 引用名自动解析
🩺 ComfyUI MissingDoctor v1.4.10
ComfyUI 体检中心：缺失节点/模型检测 + 一键自动安装 + 模型下载到模型库 + 查重 + 目录映射 + 调用记录防误删 + 安全清理 + 环境管理 + 一键更新
⬇ 本版（v1.4.10）：模型下载体验优化
1. 「目标文件已存在」不再粗暴报错
此前文件已存在时直接弹「下载启动失败」。现在改为友好确认：文件已存在（可能是刚下载完成，缺失列表还是旧检测结果）→ 弹窗选择「覆盖重新下载」或「保留现有文件」，取消时引导重新检测即可从缺失列表移除。
2. HF 引用名自动解析（MiniMax H3 等新生态文件秒出直链）
ComfyUI 系下载工具常把 HuggingFace 链接拼成 作者_仓库_resolve_main_文件名.safetensors 的引用名（如 kijai_MiniMax-H3-experimental_resolve_main_minimax_h3_video_vae_int8_convrot.safetensors），常规搜索完全查不到。现在自动解析出真实仓库与文件名，HEAD 验证通过后直接给出 hf-mirror 直链（实测 kijai/MiniMax-H3-experimental 的 3.17GB 文件秒出「✓ 文件匹配」下载按钮）。验证不通过不推荐，杜绝瞎猜。
3. 上版回顾（v1.4.9）：pip 安装加固
默认清华镜像源 + prefer-binary + 构建后端（hatchling）缺失自动补装重试。
✨ 既有能力（v1.4.x 累积）
- 🌐 一键更新网络兜底（v1.4.8） / 📍 画布定位精修（v1.4.7） / 🚨 Manager 官方库修复（v1.4.6）
- 🔧 一键更新加固（v1.4.5） / 🎯 flux-ae 别名直链（v1.4.4） / 🩹 comfy.icu 稳定命中（v1.4.2）
- 🇨🇳 魔搭免登录搜索 / 🧪 环境管理 / 🛡 防误删 / 🧹 安全清理 / 🚩 社区纠错
📦 安装
cd ComfyUI/custom_nodes
git clone https://github.com/leeymxz/ComfyUI-MissingDoctor.git重启 ComfyUI，点击右下角 🩺 悬浮球开始体检。可选依赖：pip install -r requirements.txt（send2trash 回收站支持）。
v1.4.9 · 🧰 pip 安装加固：国内镜像源 + 构建依赖自动补装重试
🩺 ComfyUI MissingDoctor v1.4.9
ComfyUI 体检中心：缺失节点/模型检测 + 一键自动安装 + 模型下载到模型库 + 查重 + 目录映射 + 调用记录防误删 + 安全清理 + 环境管理 + 一键更新
🧰 本版（v1.4.9）：pip 依赖安装加固
问题：装源码包时报 BackendUnavailable: Cannot import 'hatchling.build'——根因是国内网络访问 pypi 官方源超时，pip 在构建隔离环境里下载构建依赖（hatchling）失败，导致部分源码包（pyproject.toml 声明 hatchling 的）装不上。
修复（插件内所有 pip 安装路径，包括依赖体检一键安装 / 单包安装 / requirements.txt）：
- 默认走清华 PyPI 镜像（
-i https://pypi.tuna.tsinghua.edu.cn/simple），构建隔离环境下载 hatchling 等构建依赖同样生效 --prefer-binary：有预编译轮子就优先用，从源头减少源码构建- 构建后端缺失自动修复：检测到
BackendUnavailable / Cannot import 'hatchling'等报错时，自动补装hatchling setuptools wheel后重试一次原安装，全程日志可见 - 可用环境变量自定义：
MD_PIP_INDEX=<镜像url>换源、MD_PIP_INDEX=none禁用（尊重用户自己的 pip 配置）
遇到此报错的用户也可立即手动修复（不需要升级插件）：
python_embeded\python.exe -m pip install -U hatchling setuptools wheel -i https://pypi.tuna.tsinghua.edu.cn/simple
python_embeded\python.exe -m pip install -U pip -i https://pypi.tuna.tsinghua.edu.cn/simple
然后重新点「一键安装缺失依赖」。
✨ 既有能力（v1.4.x 累积）
- 🌐 一键更新网络兜底（v1.4.8）：直连失败自动走代理/镜像
- 📍 画布定位精修（v1.4.7） / 🚨 Manager 官方库修复（v1.4.6） / 🔧 一键更新加固（v1.4.5）
- 🎯 flux-ae 别名直链（v1.4.4） / 🩹 comfy.icu 稳定命中（v1.4.2）
- 🇨🇳 魔搭免登录搜索 / 🧪 环境管理 / 🛡 防误删 / 🧹 安全清理 / 🚩 社区纠错
📦 安装
cd ComfyUI/custom_nodes
git clone https://github.com/leeymxz/ComfyUI-MissingDoctor.git重启 ComfyUI，点击右下角 🩺 悬浮球开始体检。可选依赖：pip install -r requirements.txt（send2trash 回收站支持）。
v1.4.8 · 🌐 一键更新网络兜底：直连失败自动走代理/镜像
🩺 ComfyUI MissingDoctor v1.4.8
ComfyUI 体检中心：缺失节点/模型检测 + 一键自动安装 + 模型下载到模型库 + 查重 + 目录映射 + 调用记录防误删 + 安全清理 + 环境管理 + 一键更新
🌐 本版（v1.4.8）：一键更新网络兜底——直连失败自动走代理/镜像
问题：国内网络下检查更新正常（走 api.github.com），但 git pull 直连 github.com:443 被墙（curl 28 Failed to connect），一键更新必失败且没有自救手段。
修复：git pull 失败时自动三级重试（全程日志可见，前端实时显示当前步骤）：
- 直连
git pull --ff-only - 本机代理兜底：自动探测环境变量代理与常见本地代理端口（Clash 7890 / Clash Verge 7897 / v2rayN 10809 / 1080 等），并真实访问 github.com 验证可用后，带代理重试（不写入 git 全局配置）
- 镜像站兜底：ghproxy.net / gh-proxy.com 加速拉取（不修改用户的 remote 配置）
另外修复：本地改动冲突检测的大小写 bug（git 输出 "Not possible" 此前因大小写不匹配而检测失效）；更新进度现在会实时显示当前步骤（如"尝试镜像: ghproxy.net"）。
✨ 既有能力（v1.4.x 累积）
- 📍 画布定位精修（v1.4.7）：官方居中 API + 多节点循环定位 + 子图支持
- 🚨 Manager 官方节点库修复（v1.4.6）：4.1 万节点精准命中，pysssss/rgthree 不再误报幽灵
- 🔧 一键更新加固（v1.4.5） / 🎯 flux-ae 别名直链（v1.4.4） / 🩹 comfy.icu 稳定命中（v1.4.2）
- 🇨🇳 魔搭免登录搜索 / 🧪 环境管理 / 🛡 防误删 / 🧹 安全清理 / 🚩 社区纠错
📦 安装
cd ComfyUI/custom_nodes
git clone https://github.com/leeymxz/ComfyUI-MissingDoctor.git重启 ComfyUI，点击右下角 🩺 悬浮球开始体检。可选依赖：pip install -r requirements.txt（send2trash 回收站支持）。
v1.4.7 · 📍 画布定位精修：官方居中 API + 多节点循环 + 子图支持
🩺 ComfyUI MissingDoctor v1.4.7
ComfyUI 体检中心：缺失节点/模型检测 + 一键自动安装 + 模型下载到模型库 + 查重 + 目录映射 + 调用记录防误删 + 安全清理 + 环境管理 + 一键更新
📍 本版（v1.4.7）：「📍 在画布上定位」精修
针对定位不精确 / 定位不到的问题，重写了定位逻辑：
- 官方居中 API 优先：改用 ComfyUI/litegraph 官方
centerOnNode/focusNode居中，替代此前自算视口偏移——不同画布尺寸、缩放、DPI 下都能准确居中到节点。 - 多个同名节点循环定位：工作流里有多个同类型节点时，每点一次「定位」自动切换到下一个（并高亮），不再永远只定位第一个。
- 子图（subgraph）支持：递归搜索主图与子图内的节点，新版 ComfyUI 子图工作流里也能定位。
- 更醒目的高亮：橙红背景闪烁 3 次（约 2.7 秒），切换窗口后回来也能看到。
🚨 v1.4.6 重大修复回顾
Manager 官方节点库匹配从未生效（数据格式解析 bug，4.1 万节点索引为 0）——已修复，pysssss / rgthree / KJNodes 等知名插件节点全部精准命中，不再误报幽灵。
✨ 既有能力（v1.4.x 累积）
- 🔧 一键更新全面加固 / 🎯 flux-ae 等常见模型秒出下载按钮 / 🩹 comfy.icu 稳定命中 / 🇨🇳 魔搭免登录搜索
- 🧪 环境管理 / 🛡 防误删 / 🧹 安全清理 / 🚩 社区纠错
📦 安装
cd ComfyUI/custom_nodes
git clone https://github.com/leeymxz/ComfyUI-MissingDoctor.git重启 ComfyUI，点击右下角 🩺 悬浮球开始体检。可选依赖：pip install -r requirements.txt（send2trash 回收站支持）。
v1.4.6 · 🚨 重大修复：Manager 官方节点库匹配从未生效
🩺 ComfyUI MissingDoctor v1.4.6
ComfyUI 体检中心：缺失节点/模型检测 + 一键自动安装 + 模型下载到模型库 + 查重 + 目录映射 + 调用记录防误删 + 安全清理 + 环境管理 + 一键更新
🚨 本版（v1.4.6）：重大修复——Manager 官方节点库匹配从未生效
根因：ComfyUI-Manager 官方 extension-node-map.json 的数据格式是 [节点列表, 元信息] 二元数组，而本插件索引构建代码只处理了 dict 形态——5668 个仓库、4.1 万个节点的官方匹配数据全部被静默跳过（索引一直为 0），Manager 数据库匹配功能自发布以来从未真正生效。
后果：pysssss（ConstrainImage / ShowText）、rgthree（Image Comparer）等带 |、空格、括号等特殊字符的节点名在 comfy.icu 与 GitHub 兜底里都查不到，被大量误报「👻 疑似幽灵」。
修复与验证：
- 索引构建兼容
[list, dict]官方格式 → exact 索引 0 → 41833 个节点 - 实测命中：
ConstrainImage|pysssss→pythongosssss/ComfyUI-Custom-Scripts、Image Comparer (rgthree)→rgthree/rgthree-comfy、ImageConcanate→kijai/ComfyUI-KJNodes等全部秒级精准命中 - 节点库下载源新增 jsDelivr 国内镜像（此前只有 raw.githubusercontent.com，国内不可达时官方库直接拉不到，加剧误报）
✨ 既有能力（v1.4.x 累积）
- 🔧 一键更新全面加固（v1.4.5）：前端缓存自检 / 能力检测 / 失败必提示
- 🎯 常见模型秒出下载按钮（v1.4.4）：flux-ae.safetensors 等别名直链
- 🩹 comfy.icu 稳定命中（v1.4.2）+ ⚡ 一键更新（v1.4.1）+ 🇨🇳 魔搭免登录搜索
- 🧪 环境管理 / 🛡 防误删 / 🧹 安全清理 / 🚩 社区纠错
📦 安装
cd ComfyUI/custom_nodes
git clone https://github.com/leeymxz/ComfyUI-MissingDoctor.git重启 ComfyUI，点击右下角 🩺 悬浮球开始体检。可选依赖：pip install -r requirements.txt（send2trash 回收站支持）。
v1.4.5 · 🔧 一键更新全面加固（缓存自检/能力检测/失败提示）
🩺 ComfyUI MissingDoctor v1.4.5
ComfyUI 体检中心：缺失节点/模型检测 + 一键自动安装 + 模型下载到模型库 + 查重 + 目录映射 + 调用记录防误删 + 安全清理 + 环境管理 + 一键更新
🔧 本版（v1.4.5）：一键更新全面加固
背景：有用户反馈点击「一键更新」后毫无反应。排查发现三大原因，本轮逐一加固，让任何异常都"看得见"：
- 前端脚本缓存自检：ComfyUI 的前端 JS 由浏览器缓存，升级插件后页面不刷新会继续跑旧版脚本（旧版轮询有 bug：点击后界面零反馈）。现在面板打开时会对比「前端脚本版本 vs 后端版本」，不一致直接显示红色提示「请按 Ctrl+F5 强制刷新」。
- 一键更新能力检测：新增
GET /md/self_update_capable——检测插件是否为 git 仓库、系统是否安装 git。手动解压安装（秋叶整合包常见）或未装 git 时，「一键更新」按钮下方直接红字说明原因，而不是点击后才失败。 - 点击必有反馈 + 失败可见：点击「一键更新」后立即显示「正在启动更新...」；启动失败/轮询失败都会显示红色错误卡片（含原因与手动 git pull 的替代方案），不再静默无反应。
如果你之前"一键更新没反应"，请先 Ctrl+F5 强制刷新 ComfyUI 页面再试；若提示"手动解压安装"，需删除插件目录后
git clone重装。
✨ 既有能力（v1.4.x 累积）
- 🎯 常见模型秒出下载按钮（v1.4.4）：flux-ae.safetensors 等别名直链
- 🩹 comfy.icu 稳定命中（v1.4.2）：并发限流 + 超时重试 + 空结果不缓存 + 代码级验证优先
- ⚡ 一键更新（v1.4.1）、🇨🇳 魔搭免登录搜索、🧪 环境管理、🛡 防误删、🧹 安全清理、🚩 社区纠错
📦 安装
cd ComfyUI/custom_nodes
git clone https://github.com/leeymxz/ComfyUI-MissingDoctor.git重启 ComfyUI，点击右下角 🩺 悬浮球开始体检。可选依赖：pip install -r requirements.txt（send2trash 回收站支持）。