CivitaiFreeTool
免费的 Civitai / HuggingFace 模型下载与本地模型管理工作台。
下载最新版 · 更新日志 · 问题反馈 · Linux / macOS
当前工作台
- 文件夹显示 / 排除（v2.6.26）：首次默认显示全部。点父文件夹会统一显示或排除整个子树，覆盖之前的子目录选择；再单独点子目录可覆盖父目录。只想显示 A/B：先排除 A，再显示 B。勾选 A 后排除 B：只排除 B 子树，其它内容保留。只筛选显示，不移动 / 删除文件；选择立即保存。
- 多文件下载安全：正确列出 Diffusion Model 等权重变体，弹窗可见后才开始 10 秒默认选择；显式 fileId 不退回第一项。下载列表右键按任务 ID 移除，停止写入后清理所属 .part，模型/历史保留，退出后继续未完成清理，不扫除旧历史断点。
- 校验不一致文件手动关联：下载管理可明确确认后把已完整落盘的文件关联到来源 C站模型，保存名称/版本/封面信息。真实与官方 SHA256 分别保留，任务、历史和详情持续警告；不修改模型、不把关联当作校验成功、不覆盖已有信息。
- WeiLin 提示词兼容：工作流分析与图片生成数据按实际采样器连接读取，支持 WeiLin 编辑器和链接文字，忽略禁用旧节点。负向条件清零明确说明；无法还原的外接触发词/随机输出不猜测。旧生成信息缓存自动重解析，已有原图缓存保留。
- 名称显示与可调滚动：整卡悬浮时 C站名称与本地文件名紧接为一组，在底部资料上方垂直居中。C站名优先换行、放不下才省略；本地名空间够就完整换行，不够才单行滚动。作者、类型、版本及大小置底。外观设置可调速度和首尾停顿，默认 70px/秒、350/250 毫秒。短单行名字不动，屏幕外暂停，不改变卡片和列宽。
- 原生窗口恢复：首次加载后核实窗口真的可见；重复打开按实例 PID 恢复窗口，不误认同名文件管理器，不擅自改浏览器模式。
- 瀑布流悬浮介绍：设置 → 外观与布局可选常驻、封面悬停滑出或淡入；覆盖下方或整个卡片。深色半透明底 + 大号文字，亮色主题自动换亮底深字，本地文件名始终单行。
- 透明表格与宽屏适配：原生 Mica 客户区材质可透过下载表格及斑马纹；更新页宽屏铺满、窄窗按需滚动，菜单说明不会被二级菜单盖住。
- 左侧导航 + 常驻模型详情：列表/瀑布流共用管理能力；单击仍选中模型，同时更新右侧详情；勾选格独立用于批量选择。打开详情不挤走模型卡片。无可见顶栏，右上角保留窗口按钮，顶部空白和页面标题可拖动。
- 工作流自适配：报告式总结 + 大窗三栏（节点 / 只读详情 / 模型）；小窗直接切纵向报告。保持当前节点、搜索和展开状态，路径/哈希折叠，正负提示词独立复制，兼容本地字体和界面缩放。
- 批量操作安全：筛选变化清除不可见选择，移动 / 改名 / 反查只处理当前可见的所选模型；右键一级“移动到…文件夹”只移动当前模型。后台改名结束再刷新，模型、附属文件和
.images图片目录同步，冲突不覆盖，失败回退。 - 下载与历史修复：移除已完成只清队列、保留历史；重试任务不假装失败历史，封面不会持续闪烁。高清悬浮预览单独读取并缓存，大窗下载列表铺满、窄窗按需横向滚动；勾选与点阵排序手柄放大居中。
- 独立目录选择：文件夹显隐中，子目录选择优先；隐藏 A 仍可单独勾选 A/B，显示 A、隐藏 B 即排除 B 子树。默认包含子目录；设置可改为仅显示勾选目录直属的模型。只筛选，不移动文件。
- 模型类型筛选：大模型 / LoRA / VAE / ControlNet / Embedding 等，与底模、作者、关键词叠加，列表和瀑布流均生效；优先读取元数据，缺失时按标准目录判断，否则保留未识别。
- 队列优先级：手柄拖动排序，前面的等待任务优先，已有下载不中断；下载行为可设同时下载数量 1–32 个。网络重试单独显示“等待重试”，恢复传输后正确回到“下载中”。
- 下载细节：选中开始 / 继续，优先缓存封面，鼠标旁悬浮大封面；任务 / 历史 / 更新 / 反查表格都可拖动列宽，双击复位并记住设置。
- 下载自动命名：原文件名 / C站名 / 中文名，“附加原始版本号”默认关闭，开启即“模型名字-版本号.后缀”；预览和改名沿用，不需要下载后额外点击改名。
- 更新同步：更新管理“同步本地模型”清理已删除模型的旧更新记录，不移动或删除模型；目录离线或写入失败保留记录。
- 工作流完整模式：右上角精简 / 完整切换；真实节点连线、平移缩放、关联模型封面。支持 ComfyUI 与 Forge / A1111 PNG 参数；Forge 无节点数据时不造连线。
- 保护已有分类：切换全局下载落点不移动已完成模型；重启后的历史完成任务不再次触发搬移或重写元数据。移动仅通过明确的“保存到 / 移动”操作。
- 多文件版本下载：同版本多个模型文件弹窗多选，无人操作 10 秒下载第一个；勾选即停止倒计时，确认 / 取消。设置下载行为可改为直接第一个 / 全部；按独立文件 ID / URL 与 SHA256 入队，不把量化变体误下为主文件。
- 目录记录管理：收藏胶囊中键取消收藏；右键打开所在位置或清理收藏/失效记录，绝不删除磁盘目录与模型。失效目录仍能清理，确认选择前重新检查。
- 批量移动：模型管理勾选多个模型 → 整理 → 批量移动到…文件夹，一次选择并确认。模型、JSON、封面和示例图一同移动，冲突跳过不覆盖，进度及失败单独报告。
- 紧凑信息列：勾选固定小列、名称按档位定宽，路径承担剩余空间；保留其余列手动宽度，避免勾选格占半行。
- 三档模型列表：完整为当前最大样式；紧凑同时收起封面和作者，保留本地文件名；极简精简为 C站名称与勾选格，但类型、基础模型、版本、更新、大小、下载时间与路径等信息列在三档中都保留。悬停“列表”按钮调节，设置自动保存，不改变全局缩放或瀑布流。
- 当前模型立即识别：详情按钮一次点击直接开始，不跳页、不启动其它排队模型；左下角显示进度，成功更新当前详情。
- 全功能快捷键入口：设置中搜索功能，点击绑定按钮录入一次组合键；修改后左侧出现单项重置。无多预设选择，只有一套常规初始值；Esc / 退格清除，Tab / 失焦取消。默认关闭；大图左右键也受总开关约束，输入/确认弹窗中不触发，Delete 仍需回收站确认。
- 双位置状态反馈：保留左下角，同时在底部中央弹出自动消失圆胶囊；不会拦截鼠标，不盖住设置页底部操作。
- 设置防呆：未保存时离页或关窗，选择保存并离开、放弃修改或继续编辑；保存失败仍留在原页。已即时保存的选项不重复提醒。
- 持久下载任务与历史：任务前勾选框与表头全选，单击选中；支持全部暂停、全部移除确认、全部结束任务移入历史。自动保存任务；已结束任务可收进独立历史。历史提供缩略图/信息缓存、保存到文件夹、打开实际文件位置、C站入口，以及模型卡片定位。
- 文件夹显隐：可选择哪些文件夹的模型显示，隐藏父目录也隐藏子目录；锁定顶部工具栏时菜单仍正常展开，选择自动保存，不移动或删除文件。
- 更清楚的右键菜单：常用动作直接展示；复制、改名与整理、元数据与更新按用途折叠。删除进入回收站并确认。
- 图片与生成数据：大图可拖动、连续跟手缩放（相对适合窗口 5%–3200%），滚轮立即响应、按钮短促快到慢过渡、翻页、右键复制/保存；半透明背景保留后面的模型页。读取原图 PNG/ComfyUI/EXIF 元数据，并按图片 ID 查询 C站
withMeta=true数据。资源按明确 ID / URL / AIR 直达当前站点，版本 ID 使用站点原生重定向，不依赖额外 API 查询、不自动搜索 ID；默认 civitai.red。提示词、资源和采样参数只显示来源实际提供的内容。 - 收藏与固定工具栏：模型右键或详情星标收藏置顶，改名/移动跟随；标题右侧固定菜单，让滚轮只滚动模型列表。
- 本地原图缓存：只保存打开过的原图和来源生成数据，已缓存的在线示例图可在详情中提前恢复高清与信息，不预下载未查看的在线图；同一会话重开直接复用已解码图片，重启后首次查看仍需读磁盘与解码；默认 1 GB，可关闭、调容量或清理，随软件数据迁移。不含任何运行缓存的源码/便携包。
- 滚轮导航：鼠标停在左侧菜单，滚轮上下切换页面；Ctrl + 滚轮仍用于全局缩放，首尾不循环。
- 分组设置：常用、外观、下载、目录、分类整理、网络、翻译、维护；跨分类搜索，分类规则旁直接提供步骤与示例。
- 自由外观：14 套配色、本地字体名称即预览、五档独立字号与图标尺寸、强调色、密度、圆角和局部画布交互特效；动画上限可输入 15–360，0 跟随屏幕（不保证达到指定帧率）。瀑布流按钮悬停展开竖向图片大小滑条。
界面示例
下面是 当前前端的演示截图：使用虚构模型、文件路径及程序绘制的风景；不包含用户 API Key、私有模型或真实下载任务。它们用于展示界面，不代表下载或生成结果。
瀑布流：只看封面，悬停显示大号介绍
左侧卡片处于悬停状态，右侧只显示封面；截图为“淡入 + 整个卡片”，两种名称相邻成组、在上方剩余区域居中，空间足够时都完整换行；辅助资料置底。支持滑出 / 淡入、部分 / 整卡片覆盖，默认仍为常驻介绍。
工作流分析：大窗三栏 / 小窗报告
按内容区实际宽度切换，同一份结果不重新解析；配色继续跟随主题。节点详情为只读，不编辑工作流。
工作流完整画布
只读展示实际保存的节点与连接，点击节点查看参数；不是 ComfyUI 执行器。Forge 图片通常只有生成参数，界面明确说明不绘制虚假连线。
下载任务布局与完成项管理
表格利用可用宽度，只有确实超宽才出现横向滚动；“移除已完成”不删除模型或下载历史。
多文件版本选择
默认弹窗选择；无人操作 10 秒选第一个，勾选后停止倒计时。取消不下载。扩展提交后也在软件内选择。
模型管理与常驻详情
目录显隐与类型筛选
默认按更具体的子目录选择覆盖父目录选择；隐藏父目录也可以显示单独勾选的子目录。
类型优先使用已有元数据，无元数据时只按明确的模型目录判断，不按文件大小猜测。
模型列表三档大小
完整（最大）：
!完整列表
紧凑（无封面与作者）：
!紧凑列表
极简（精简名称，保留基础、版本等信息列；窄窗可横向滚动）：
!极简列表
下载目录收藏与失效记录管理
右键只清理记录，不删除磁盘文件；胶囊中键取消收藏。
快捷键设置与底部状态胶囊
大图、半透明背景与生成数据
下载历史
外观设置
!外观设置
分类规则与使用介绍
页面式引导
先在 civitai.red 申请并填写 API Key；空值不能继续或跳过，Key 先保存。之后保留六步结构中的页面介绍，七个页面都给出说明。点击页面卡片直接体验，引导缩到右下角，可随时继续。不会自动下载。
快速开始（Windows）
- 在 Releases 下载 Windows 便携 ZIP 或版本号 EXE。
- 解压到个人可写目录，运行
CivitaiFreeToolWeb.exe。默认启动软件窗口，失败才按兜底开关打开浏览器。设置“启动界面”为浏览器后，以后直接启动浏览器，不创建软件窗口；选择即保存、重启生效。临时打开浏览器不会改长期模式。 - 设置下载目录、模型管理目录；如需要，在 C站账户中申请 API Key 后填写。它不是使用本地模型管理的前提。
- 粘贴 Civitai / HuggingFace 链接进行下载，或扫描已有模型。
隐私与 Key
user_config.json可能包含 API Key、翻译密钥或代理信息，不要上传或分享。- 配置、任务/历史 JSON、模型文件和运行缓存不属于发布源码/便携包。
- 示例截图与测试使用虚构数据。遇到问题提供日志时仍需先脱敏。
- 客户端访问 C站使用账户权限；不绕过付费、Early Access、浏览等级或访问限制。
下载与模型管理
- 多链接批量解析、断点续传、并发下载、暂停/重试；SHA256 校验，拒绝把 HTML 错误页面当成模型。
- 多目录扫描、关键词/底模/作者/状态/文件夹筛选、列宽调整及多种排序。
- 自定义改名、文件名 → C站名称、文件名翻译；按手动分类、tags 或自定义规则整理。
- 移动模型连同 sidecar/预览图/images 目录；冲突拒绝覆盖。历史路径同步更新，误整理可按日志恢复。
- 更新检测、版本选择、更新白名单；更新下载由用户触发，默认保留旧版。
- SHA256 反向识别模型、简介翻译、触发词复制、封面选择；解析 ComfyUI 工作流中的模型引用和提示词。
外观与快捷键
| 操作 | 行为 | | --- | --- | | Ctrl + 滚轮 | 全局界面缩放 | | Alt + 滚轮（瀑布流） | 调整模型图片大小 | | 图片查看器普通滚轮 | 缩放当前图片 | | 按住放大后的图片拖动 | 移动查看位置 | | 图片查看器空白处 / Escape | 关闭大图；有右键菜单时 Escape 先关闭菜单 | | 双击窗口拖动区 | 最大化 / 还原 |
Mica / Mica Alt 是 Windows 原生壁纸色调材质，并不透视其他窗口；失焦、系统关闭透明、高对比度等条件下会回退纯色。内置效果需要支持的 Windows 11；外部模式配合 Mica For Everyone 需要另行安装/配置，框架切换需重启。参见 微软 Mica 说明。
v2.6.25：批量标签页与反查指引
- Chrome / Firefox 扩展更新到 1.3.0：保留当前页发送，新增所有窗口 / 当前窗口的模型页勾选列表、搜索、全选和批量发送；跨 red/com 重复页合并，不同版本与文件 ID 保留。提交由扩展后台执行，关闭小窗不会中断；仅向本机 CFT 发送勾选的模型链接，不发送其它标签页、Cookie 或 API Key。
- 未填写并保存 Civitai API Key 时，批量下载、下载管理、检查更新、反向解析显示半透明遮罩及账号配置指引。模型管理中的识别入口与扩展下载入口同样拒绝开始新的在线任务。本地模型浏览、移动和工作流分析可继续使用；不会删除模型或历史，也不强停已经运行的下载。
- 反向解析提供五步教程：模型管理 → 全选 → 信息处理 → 识别模型信息 → 开始反查。教程只指导，用户点击才会提交和反查。
- 反查列表支持行勾选、仅显示/反查失败、反查选中和移除选中。筛选后不会误操作隐藏勾选；移除仅清列表，不删磁盘文件，进行中的记录保留。
- 反查与下载历史表格默认随窗口铺满，保留手动调列宽；自定义列宽过大时允许横向滚动。
- 工作流分析识别 LoRA Manager 的
loras.__value__（含无后缀模型名 / JSON 字符串 / UI 数组）。启用模型加入引用，关闭或旁路模型单独显示，不把注释或旧 UI 状态当作实际引用；本地匹配覆盖全部已配置模型目录。
!标签页批量发送 !API Key 配置指引 !反查列表选择
Chrome / Firefox 扩展
Release 同时附带两款扩展 ZIP，manifest.json 在压缩包根目录。
- Chrome / Edge：解压 Chrome 包，在扩展管理页启用开发者模式，加载已解压目录。
- Firefox：当前包未签名，通过
about:debugging临时加载；长期安装需要 Mozilla 签名。不能把它当作已签名永久扩展。 - 软件运行后，点击扩展图标，发送当前页，或切换“批量标签页”后全选 / 勾选并发送；当前页不是模型也能提交其它已打开的模型页。
源码运行与构建
Windows 使用 Python 3.12 与现有 requirements.txt：
python -m venv .venv
.\.venv\Scripts\python -m pip install -r requirements.txt
.\.venv\Scripts\python main_web.py --window
构建：Spec 包含网页、原生辅助 DLL、托盘及 Tcl/Tk
.\.venv\Scripts\python -m pip install pyinstaller
.\.venv\Scripts\python -m PyInstaller -y CivitaiFreeToolWeb.spec原生辅助代码由 Windows 自带 .NET Framework C# 编译器构建，不需要额外安装完整 Visual Studio。Linux/macOS 使用社区提供的适配，安装依赖与限制见 LINUX.md；本轮原生窗口验证在 Windows 完成，不声称其他平台已复测。
测试、贡献与维护
- 后端/桥服务回归与隔离前端测试位于
tests/；需要真实窗口的改动另做原生检查。 - GitHub Actions 的状态以实际运行结果为准，版本号/本地测试通过不等于远端 CI 已通过。
- 修复后发布包含 EXE、Windows ZIP、源码 ZIP、两款扩展和 SHA256 的完整附件，见 发布流程。
- 感谢 guanhaisen、LckHot 等社区贡献；本次 Fork 检查 说明哪些分支存在独立变更及检查范围。
反馈
GitHub Issues · 作者 B 站 · 粉丝群：909810278
校验不一致文件的手动关联
以下为合成文件与虚构模型示例。确认只关联来源信息，不代表该文件与官方模型相同。
大模型多格式选择
合成例图：仅勾选 bf16；未显示弹窗时不启动倒计时，勾选后停止自动选择。