Add files via upload
This commit is contained in:
DemonGatanjieu
@@ -1,175 +1,45 @@
|
||||
<div align="center">
|
||||
<h1>📦 Anomalous Model Browser</h1>
|
||||
<p><strong>A blazing fast, zero-dependency model browser and Civitai scraper for ComfyUI.</strong></p>
|
||||
<p>
|
||||
<a href="#english">English</a> | <a href="#chinese">中文</a>
|
||||
</p>
|
||||
<p>
|
||||
<a href="./CHANGELOG.md">📜 Changelog / 更新日志</a> |
|
||||
<a href="./error_and_experience_summary.md">💡 Dev Notes / 踩坑经验总结</a>
|
||||
</p>
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
<h2 id="english">🇬🇧 English</h2>
|
||||
|
||||
### 🌟 Why Anomalous Model Browser?
|
||||
|
||||
In the rapidly evolving landscape of AI art tools, legacy plugins have become bloated. They introduce heavy frameworks like Svelte and complex `npm` dependency chains just to render a UI, leading to complicated installations and environment conflicts.
|
||||
|
||||
**Anomalous Model Browser** was born out of an extreme pursuit of minimalism and high performance:
|
||||
- **True Zero Dependencies**: We completely abandoned Node.js, Webpack, Vue/React/Svelte, and other heavy frontend tools. The entire extension is written in pure **Native Python + Vanilla JS**!
|
||||
- **Unmatched Performance**: With a total codebase of under 250KB, it delivers a much smoother experience. No background polling loops, no memory leaks—just plug and play with millisecond response times.
|
||||
- **Smart Association & Synchronization**: Say goodbye to complex database building. It smartly and seamlessly associates your `.safetensors` files with their corresponding `.info` descriptions and `.png`/`.mp4` previews purely through file naming.
|
||||
|
||||
### ✨ Core Features
|
||||
|
||||
1. **🌳 Smart Tree View & Infinite Collapse**
|
||||
- Automatically reads ComfyUI's physical hard drive mappings (including `extra_model_paths.yaml`).
|
||||
- Perfectly supports deep subfolders for Checkpoints, Loras, UNet, Diffusion_Models, etc.
|
||||
- Infinite subfolder collapsing allows you to hide cluttered categories with a single click, keeping your interface incredibly clean.
|
||||
- Features a smart **One-click Expand / Collapse All** button for rapid structural navigation.
|
||||
|
||||
2. **🕵️♂️ Floating Quick-Access Button with Drag Memory**
|
||||
- Provides a minimalist, draggable 📦 floating button globally. Click to open anytime, close when done.
|
||||
- Features local "Drag Memory" (using LocalStorage)—it remembers its exact coordinates across browser refreshes and never blocks your workflow nodes.
|
||||
|
||||
3. **📋 Rich Detail Panel & Clipboard Integration**
|
||||
- **Native Markdown Rendering**: Perfectly displays rich text fetched from Civitai.
|
||||
- **Immersive Full-Panel Scroll**: The entire detail panel scrolls seamlessly, automatically hiding headers to maximize reading space for model descriptions.
|
||||
- **Base Model Badges**: The grid view automatically displays glowing Base Model badges (e.g., SDXL, SD 1.5) on the corners of model cards.
|
||||
- **One-Click Trigger Words**: Click any individual trained word to instantly copy it, or use the "Copy All" button to copy everything!
|
||||
- **One-Click Cleaner**: A dedicated 🗑️ Delete button that not only deletes the model file but also hunts down and deletes associated images and `.info` files.
|
||||
|
||||
4. **🤖 Smart Media Civitai Scraper (Multi-Threaded Daemon)**
|
||||
- Forget messy CMD windows! Use the dedicated `🔑 API Key Config` modal button in the Settings menu to securely enter your Civitai API Key (safely saved to both local server config and browser cache).
|
||||
- Click `Scan Folder` to silently launch a background daemon thread that computes SHA256, fetches metadata, and automatically renames your local `.safetensors` files to a clean format.
|
||||
- **Ultra-Fast Lightweight Mode**: The new incremental skip engine smartly bypasses heavy SHA256 computations when just updating text files, parsing hundreds of gigabytes of models in literal seconds.
|
||||
- **Detailed Scan Reports**: After scanning, the system alerts you exactly how many models were successfully downloaded, renamed, or skipped, and logs any failures.
|
||||
- **Strict Verification Engine**: The scraper uses a "triple-check" strict requirement (.safetensors + .info + preview) to ensure your model library is flawless; missing parts trigger an automatic redownload.
|
||||
- **Smart Version Deduplication**: Have you ever accidentally downloaded the same version of a model twice with different names? The scanner will detect identical Civitai versions and cleanly permanently delete the redundant clones, ensuring your disk is free of duplicates!
|
||||
- **Zero-API Tensor Fingerprinting (HuggingFace Support)**: What about models purely from HuggingFace that aren't on Civitai? If the API returns a 404, the scraper refuses to give up. It forcibly cracks open the `.safetensors` header and scans the physical neural network structure (Tensor Keys). By identifying specific blocks (e.g., `double_blocks.0.img_attn`), it deduces the underlying architecture (Flux, SDXL, SD 1.5) with 100% precision. It then generates a virtual local payload, granting your unindexed HuggingFace models full VIP access to the Cross-Folder Radar and Auto-Inject UI features!
|
||||
- **Smart Content-Type Detection**: The new scraper engine dynamically parses HTTP network headers. If a Civitai preview is a video, it perfectly saves it as an `.mp4` or `.webm` file rather than a corrupted PNG.
|
||||
- **Standalone Cleanup Button**: We extracted the `.civitai.info` cleanup process into a fast, dedicated `🧹 Clean Duplicate Info` button in the UI.
|
||||
- **Energy-Saving Previews**: Video previews only play on mouse hover!
|
||||
|
||||
5. **⚡ Workflow Superchargers**
|
||||
- **Cross-Folder Compatible Models**: Looking at a Base Model (like Flux.1 D)? The detail panel auto-magically scans all your Loras and Checkpoints across your entire disk and lists 100% compatible models based on internal metadata logic. It strictly de-duplicates models even if your extra paths alias the same folders!
|
||||
- **One-Click Auto-Inject**: Don't manually type filenames into nodes anymore! Use the "Apply to Canvas" floating button on any model. It creates the perfect node (CheckpointLoaderSimple, LoraLoader, UNETLoader) and magnetically sticks it to your cursor for precision placement!
|
||||
- **One-Click Error Annihilation**: Dragging in an old workflow? The auto-fix engine automatically locates missing models across your entire drive (utilizing a robust physical path deduplicator), forces a frontend dropdown update, and violently clears ComfyUI's visual red-box error states. A 100% resolution rate with zero browser refreshes needed!
|
||||
- **Workflow Portability & Self-Healing (Hash Injection)**: Whenever you generate an image or save a workflow, Anomalous automatically intercepts the process and invisibly embeds the precise Civitai Hash and filesize of every model you used directly into the image's metadata! When you share your image with other users running this plugin, it doesn't matter if their local model filenames are completely different—the plugin will read the genetic Hash DNA from your image and perfectly, automatically reconnect all their nodes to their local equivalents!
|
||||
|
||||
6. **🌐 Pure Bilingual Engine & Built-in Manual**
|
||||
- **Seamless i18n**: Switch between beautifully formatted pure English or pure Chinese UI with a single click, instantly transforming all buttons, dialogs, and dynamic text. The English UI has been specifically polished with generous padding and font scaling to match the visual weight of the Chinese design.
|
||||
- **Responsive Top-Bar**: The top menu buttons intelligently auto-hide to save space when the left sidebar is expanded on narrow screens, ensuring your grid always has room to breathe.
|
||||
- **Interactive Help Modal**: Never feel lost with the built-in `❓ Help` manual explaining every feature natively within the plugin. The sandwich layout ensures the close button is never pushed off-screen regardless of how long the text is.
|
||||
|
||||
7. **📑 Advanced Notebook System**
|
||||
- **Bilingual Prompt Editor**: A dedicated drafting workspace for your prompts featuring a dual-pane side-by-side translator. It auto-splits your prompts by commas into visual interactive tags with 1-click copying!
|
||||
- **Smart Architecture Filtering**: Select a Base Model from your local models, and the Notebook automatically curates a pristine, cross-folder gallery of exactly compatible Main Models and Loras.
|
||||
- **One-Click Deployment**: Compile your entire notebook (Checkpoints, multiple Loras, Prompts) and click 'Send to Canvas' to instantly deploy a fully connected workflow to your ComfyUI workspace.
|
||||
|
||||
8. **🖼️ Integrated Image Gallery**
|
||||
- **Local History Hub**: Seamlessly browse your ComfyUI `output` folder history directly within the plugin.
|
||||
- **Smart Lazy Loading**: Uses `IntersectionObserver` for infinite scrolling, rendering thousands of images with zero lag.
|
||||
- **Drag-and-Drop Ready**: Native drag-and-drop support. Drag any gallery image directly onto your ComfyUI canvas or `Load Image` nodes to instantly import images and their embedded workflows!
|
||||
- **Immersive Viewer & Management**: Click to view full-resolution images, and easily permanently delete unwanted generations with a foolproof overlay confirmation.
|
||||
|
||||
### 📥 Installation
|
||||
|
||||
Say goodbye to `pip install` and `npm install`!
|
||||
|
||||
1. Navigate to your ComfyUI custom nodes directory:
|
||||
```bash
|
||||
cd ComfyUI/custom_nodes
|
||||
```
|
||||
2. Clone this repository:
|
||||
```bash
|
||||
git clone https://github.com/DemonGatanjieu/Anomalous_Model_Browser.git Anomalous_Model_Browser
|
||||
```
|
||||
3. **Restart ComfyUI**. You will see the 📦 button in the bottom right corner—installation complete!
|
||||
|
||||
---
|
||||
|
||||
<h2 id="chinese">🇨🇳 中文说明</h2>
|
||||
|
||||
### 🌟 为什么选择 Anomalous Model Browser？
|
||||
|
||||
在 AI 绘画工具极速迭代的今天，旧时代的插件已经显得有些臃肿。为了实现复杂的界面，往往引入庞大的框架和繁琐的 `npm` 依赖链，不仅让安装变得复杂，还容易引发各种环境冲突。
|
||||
|
||||
**Anomalous Model Browser** 诞生于对“极简主义”和“高性能”的极致追求：
|
||||
- **真正的零依赖**：我们彻底抛弃了 Node.js、Webpack、Vue/React 等重型武器。全端采用最纯粹的 **原生 Python + Vanilla JS** 编写！
|
||||
- **降维打击的性能**：不到 250KB 的总代码量，实现了极度丝滑的体验。没有内存泄漏，即插即用，毫秒级响应。
|
||||
- **智能级联关联机制**：不再需要复杂的数据库，直接通过底层文件名映射，无缝关联 `.safetensors` 与其对应的 `.info` 描述及动态预览媒体。
|
||||
|
||||
### ✨ 核心特性
|
||||
|
||||
1. **🌳 智能自动层级映射 & 树状折叠**
|
||||
- 自动读取 ComfyUI 的物理硬盘映射（包含 `extra_model_paths.yaml`）。
|
||||
- 完美支持 Checkpoints、Loras、UNet、Diffusion_Models 等深层子文件夹。
|
||||
- 子文件夹无限折叠，一键收起冗杂的分类，界面清爽无比。
|
||||
- 侧边栏自带智能 **一键展开 / 收起全部** 按钮，轻松管理海量模型库分类结构。
|
||||
|
||||
2. **🕵️♂️ 隐形式悬浮交互与“拖拽记忆”**
|
||||
- 全局提供一个极简可拖拽的 📦 悬浮按钮，随时点开，用完即关。
|
||||
- 拥有浏览器级“拖拽记忆”功能，刷新页面后按钮依然留在你设定的坐标，绝不遮挡工作流节点。
|
||||
|
||||
3. **📋 沉浸式详情页与剪贴板神器**
|
||||
- **全局滑动沉浸空间**：向下滚动时自动隐藏顶部面板，把 100% 的视觉空间让给模型介绍。
|
||||
- **底模高亮角标**：网格视图中，卡片封面会自动贴上 SDXL / SD 1.5 等专属发光底模标签，一目了然。
|
||||
- **闪电触发词**：点击任意 Trained Word 闪亮复制，或者点击【复制全部】一键打包。
|
||||
- **一键清道夫**：专属的 🗑️ Delete 按钮，不仅删除模型本体，还会顺藤摸瓜清理残余的 `.mp4` 和 `.info`。
|
||||
|
||||
4. **🤖 全格式动态刮削引擎 (后台多线程守护)**
|
||||
- 告别繁琐的命令行！在设置面板点击专属的 `🔑 API 密钥配置` 悬浮弹窗输入你的 Civitai API Key（全局双端持久化保存），即可获取限制级模型封面。
|
||||
- 真正的独立后台多线程，计算海量 7GB 模型 SHA256 时前端 UI 完全不卡顿。
|
||||
- **极速轻量扫描**：完全跳过无意义的图片下载和全盘哈希计算（`--skip-media`），只需几秒钟即可扫完几百 GB 的模型库并瞬间点亮红框模型！
|
||||
- **详尽扫描报告**：扫描结束后，系统会弹窗向您详细汇报成功下载的数量、重命名的数量以及失败的信息，进度一目了然。
|
||||
- **严苛三证合一**：采用严厉的补齐逻辑，只要发现模型缺失 `.info` 配置文件或预览图其中任何一项，刮削器便会毫不犹豫地向服务器请求补齐残缺，确保您的模型生态完美无瑕。
|
||||
- **智能版本号去重守护**：后台扫描不仅会匹配信息，一旦发现某个模型在同文件夹下存在版本号完全一致的“多余分身”，它会毫不犹豫地将冗余副本永久删除，保证你的模型库只有唯一规范的版本！
|
||||
- **脱机张量基因推断 (原生 HuggingFace 支持)**：如果是纯纯的 HuggingFace 私有模型，C站 上根本没有怎么办？如果 API 查询返回 404，爬虫绝不放弃！它会瞬间撬开 `.safetensors` 的头文件，强行读取物理神经网络结构（Tensor Keys），通过独家特征图谱（如识别 `double_blocks.0.img_attn` 判定为 Flux）100% 精准推断底模架构，并在本地凭空捏造出一份虚拟配置文件。让你的孤儿模型也能完美享受跨文件夹雷达与磁吸加载的顶级待遇！
|
||||
- **独立重复 Info 清理**：历史遗留的冗余 `.civitai.info` 文件清理功能被独立为顶部的 `🧹 清理重复 Info` 按钮，一秒即可全盘扫描并完成清理。
|
||||
- **全媒体探测雷达**：不仅能抓图片，遇到新世代模型的 `.mp4` / `.webm` 视频封面，爬虫会根据 `Content-Type` 报文头精准保存对应的视频格式，彻底告别“损坏的图片”。
|
||||
- **节能渲染**：视频只在鼠标悬浮时播放，杜绝显卡资源浪费！
|
||||
|
||||
5. **⚡ 生产力飞跃 (Workflow Superchargers)**
|
||||
- **跨次元兼容模型雷达**：当你在查看 UNet (比如 Flux.1 D) 时，详情页底部会自动跨硬盘、跨文件夹为您检索出全部绝对兼容的 Lora / Checkpoints！并且完美自带系统级别的物理路径去重机制，即便你的 `extra_model_paths.yaml` 怎么套娃映射，都绝不显示重复项。
|
||||
- **一键磁吸加载器**：告别手动搜索文件名！鼠标悬停在模型上点击【投放到画布】，系统会自动为你生成匹配的节点 (如 LoraLoader、UNETLoader)，并将其磁吸在你的鼠标上！你只需要在画布的合适位置点一下左键，节点就会被优雅地放置好，丝滑无比。
|
||||
- **无脑暴力红框清除**：拖入了一张带旧工作流的图片并且模型爆红？一键修复模块会直接击穿 ComfyUI 的前后端缓存，底层自带物理级多重路径重叠去重引擎。它不仅帮你填好正确的名字，还会暴力抹杀节点上所有的视觉报错红框，无需重启即可直接点 Queue 跑图！修复成功率达 100%！
|
||||
- **基因级工作流自愈系统 (Hash Injection)**：只要你安装了该插件，每次你在 ComfyUI 中生成图片或者保存工作流时，插件会在底层悄无声息地拦截该过程，并将你使用的每一个模型的 C站 Hash 基因与精确文件大小注入到图片的元数据中！当你把这张图片分享给其他也安装了此插件的群友时，无论他本地的模型名字被改成了什么乱七八糟的拼音，只要他们把图片拖入 ComfyUI，插件就会自动提取图片里的 Hash DNA，并在他们的硬盘里大海捞针，完美地、全自动地将所有红框节点无缝重连到他们本地对应的模型上！
|
||||
|
||||
6. **🌐 纯净双语引擎与内置说明书**
|
||||
- **无缝 i18n 切换**：一键在纯中文与纯英文界面间自由切换，告别拥挤的双语混排，所有弹窗与提示会瞬间自适应目标语言。英文排版也经过了专属的大气布局打磨，彻底告别文字局促感。
|
||||
- **动态呼吸响应顶栏**：在侧边栏模式或窄屏设备下，顶部的导航按钮会自动智能折叠，将最宝贵的横向空间 100% 留给模型网格，带来极致的沉浸体验。
|
||||
- **交互式帮助面板**：内置随叫随到的 `❓ 帮助` 面板，提供中英文纯血的详细说明书，再也不用切回 GitHub 看使用文档了！三明治结构设计保证关闭按钮永远固定在视野内，不会因为文字过多而点不到。
|
||||
|
||||
7. **📑 极客级笔记本 (Notebook) 系统**
|
||||
- **双语交互式提示词工作台**：内置了极具高级感的双向对照编辑器，利用深色模式和磨砂质感，自动将你的中英文提示词按逗号拆分成一个个悬停交互的高级标签块，指哪亮哪，并支持一键精准复制单个单词！
|
||||
- **纯净架构雷达筛选**：当你新建一本笔记本并选定底模架构（纯净抓取你本地拥有的架构，绝不硬编码凑数），下方的图库会自动为你过滤出所有适配的主模型与 Lora，告别漫无目的的翻找。
|
||||
- **一键爆破式部署**：草稿打完后，点击“发送到画布”，所有的 Checkpoint、Lora 节点甚至连线逻辑都会瞬间部署至你的 ComfyUI 画布，真正的一气呵成！
|
||||
|
||||
8. **🖼️ 沉浸式历史图库**
|
||||
- **本地生成历史中心**：无缝读取并展示 ComfyUI 原生 `output` 文件夹的生成历史，按时间自动排序。
|
||||
- **智能无限懒加载**：基于 `IntersectionObserver` 的无限滚动瀑布流，哪怕有上万张图也丝毫不会卡顿。
|
||||
- **原生拖拽工作流还原**：完全支持原生拖拽！将图库中的任意图片直接拖入 ComfyUI 画布或“加载图像”节点，即可瞬间还原其内嵌的工作流参数。
|
||||
- **全屏预览与防误触管理**：点击图片即刻进入全屏无干扰预览；特设大面积防误触删除遮罩，给予充分的二次确认保护，一键彻底清理无用的废片。
|
||||
|
||||
### 📥 极简安装说明
|
||||
|
||||
告别 `pip install` 和 `npm install`！
|
||||
|
||||
1. 进入你的 ComfyUI 自定义节点目录：
|
||||
```bash
|
||||
cd ComfyUI/custom_nodes
|
||||
```
|
||||
2. 将本仓库克隆（或直接拖入）该目录中：
|
||||
```bash
|
||||
git clone https://github.com/DemonGatanjieu/Anomalous_Model_Browser.git Anomalous_Model_Browser
|
||||
```
|
||||
3. **彻底重启 ComfyUI**，在网页右下角看到 📦 按钮，即代表安装成功！
|
||||
|
||||
---
|
||||
|
||||
## 📜 License
|
||||
MIT License
|
||||
# Anomalous Model Browser
|
||||
|
||||
一个不到 250KB、零依赖、支持哈希级工作流修复的 ComfyUI 模型浏览器插件。
|
||||
|
||||
## 核心痛点解决：基因级自愈（哈希级工作流修复）
|
||||
|
||||
**只要是用本插件生成的图，都会自动注入模型对应的 Civitai Hash。**
|
||||
|
||||
当你拖入一张他人分享、但模型全红报错的图片时：
|
||||
1. 点一下界面上的**修复**按钮。
|
||||
2. 插件会自动根据内置的 Hash 数据，在你的本地目录中寻找对应的模型。
|
||||
3. 找到后自动重新连线替换。
|
||||
|
||||
**哪怕你把本地模型的名字改得面目全非，只要文件没变，插件就能认出来并完成修复。**
|
||||
|
||||
## 其他实用功能
|
||||
|
||||
* **O(1) 极速扫描与零依赖**
|
||||
* 不安装 Node.js，没有臃肿的依赖项。
|
||||
* 列表滚动性能极佳，加载几千个模型依然流畅不卡顿。
|
||||
* 支持悬停预览，鼠标放上去即可播放视频。
|
||||
* **智能节点组装**
|
||||
* 内置交互式双语提示词本。
|
||||
* 自动匹配与之关联的 Lora。
|
||||
* 免除繁琐的手动连线，一键即可投放到画布中完成节点组装。
|
||||
|
||||
## 安装指南
|
||||
|
||||
请打开命令行终端，进入 ComfyUI 的 `custom_nodes` 文件夹，执行以下命令即可完成安装：
|
||||
|
||||
```bash
|
||||
cd custom_nodes
|
||||
git clone https://github.com/your-username/Anomalous_Model_Browser.git
|
||||
```
|
||||
*(提示：克隆完成后，重启 ComfyUI 即可加载插件。请注意将 URL 替换为您实际的仓库地址)*
|
||||
|
||||
## 快速上手 (Quick Start)
|
||||
|
||||
**常规使用：**
|
||||
1. **第一步**：点击界面主菜单或侧边栏新增的 **Model Browser** 按钮，展开模型面板。
|
||||
2. **第二步**：在面板中浏览并找到需要的模型，点击卡片上的 **一键投放** 按钮，节点会自动出现在画布上并连好线。
|
||||
|
||||
**修复报错工作流：**
|
||||
1. **第一步**：将带有 Hash 信息的参考图拖入 ComfyUI 画布（因环境不同，部分节点可能会变红报错）。
|
||||
2. **第二步**：点击提示的 **修复工作流** 按钮，等待插件在本地检索 Hash 并自动恢复节点连接。
|
||||
|
||||
Reference in New Issue
Block a user