Go Civitai Downloader最新版

如果你经常使用 Civitai.com 下载模型、LoRA 或图像，那么开发者 dreamfast 推出的 Go Civitai Downloader 可能会成为你的得力助手。这款用 Go 语言编写的命令行工具，专为高效、灵活地从 Civitai 下载资源而设计。它不仅支持多条件筛选和并发下载，还提供了本地数据库跟踪、文件验证以及磁力链接生成等功能，极大地提升了下载体验。

为什么需要 Go Civitai Downloader？

Civitai 是一个广受欢迎的 AI 模型分享平台，但随着模型数量的快速增长，手动下载变得繁琐且耗时。此外，部分模型可能因各种原因被移除，用户需要一种更可靠的方式来归档和分享这些资源。

开发者 dreamfast 表示，他最初开发这个工具是为了满足自己对 Civitai 资源的抓取需求，例如下载喜欢的模型、LoRA 和图像。然而，由于存储空间有限，他无法归档整个网站的内容。于是，他决定将工具开源，让更多有需求的用户能够轻松实现这一目标。

最近，该工具新增了 Torrent 支持，可以生成磁力链接。这使得用户不仅能下载模型，还能方便地分享即将从 Civitai 移除的内容。开发者希望有人能基于此创建一个 torrent 网站，进一步促进模型的共享。如果没人做，他甚至考虑亲自尝试。

核心功能一览

1. 基于条件的下载

通过多种过滤器精准定位你需要的资源：

• 类型（模型、LoRA、图像等）
• 基础模型
• NSFW 状态
• 查询词
• 标签
• 用户名

无论你是想下载特定类型的模型，还是根据标签筛选内容，都可以轻松实现。

2. 两阶段下载过程

• 第一阶段：元数据扫描
  工具会根据指定条件扫描 Civitai API，并与本地数据库进行比对，识别需要下载的文件。
• 第二阶段：确认与下载
  在正式下载前，工具会显示摘要信息（文件数量、总大小），并要求用户确认。这种设计避免了意外下载大量文件的情况。

3. 并发下载

支持同时下载多个文件，用户可以根据自己的网络环境配置并发级别，从而显著提升下载速度。

4. 本地数据库跟踪

• 使用 Bitcask 键/值存储（默认路径：civitai_download_db）来记录已下载文件的状态（Pending、Downloaded、Error），防止重复下载。
• 数据库条目采用 Gzip 压缩，有效减少存储空间占用。

5. 数据库管理命令

工具提供了丰富的数据库管理功能：

• db view: 列出数据库中的条目及其状态和版本 ID。
• db verify: 检查数据库中记录的文件是否存在于磁盘上，并可选择验证文件哈希值。
• db search [QUERY]: 按模型名称搜索条目。
• db redownload [VERSION_ID]: 根据模型版本 ID 重新下载特定文件。

6. 文件验证与元数据保存

• 下载完成后，工具会自动验证文件的完整性。
• 可选功能：在每个下载文件旁保存一个包含模型/版本/文件元数据的 .json 文件，便于后续管理和归档。

7. 配置灵活

• 配置文件: 使用 config.toml 进行持久化设置。
• 命令行标志: 大多数配置可以通过 CLI 标志动态覆盖，满足不同场景的需求。

8. 强大的 API 交互

• 自动处理 API 速率限制（429），通过指数退避和重试机制确保稳定访问。
• 支持游标分页，获取深层结果。
• 可选 API 日志记录到 api.log，便于调试和分析。

9. 结构化日志与进度显示

• 使用 Logrus 提供分级日志记录（可通过标志配置）。
• 借助 uilive 实现交互式进度显示，实时查看并发下载状态。

新增亮点：Torrent 支持

最新版本增加了 Torrent 支持，允许用户生成磁力链接。这一功能特别适合以下场景：

• 分享即将从 Civitai 移除的模型。
• 归档多年上传的图像/视频。
• 创建一个 torrent 网站，集中分享模型资源。

开发者希望通过这一功能，让用户更容易保存和传播 Civitai 上的宝贵资源。

如何获取与使用？

Go Civitai Downloader 是完全开源的，你可以通过以下步骤开始使用：

1. 下载并安装工具。
2. 配置 config.toml 文件，或直接通过命令行参数调整设置。
3. 使用命令行运行工具，根据条件筛选并下载所需资源。