Civitai Companion：通过自动元数据提取和资源管理简化AI图像工作流程

Civitai Companion是一个强大的工具，旨在简化从Civitai.com处理AI生成图像的过程。该工具通过自动提取提示元数据、下载所需资源以及格式化信息以供各种AI图像生成工具使用，满足了AI艺术家和爱好者的需求。最初作为Dream Factory的伴侣，Civitai Companion已经发展为支持多个平台，包括Automatic1111等，通过其灵活的模板系统。

Civitai Companion提供了一套强大的功能，以增强您的AI图像工作流程： 1. 批量元数据提取：高效提取Civitai图像和Dream Factory创作中的提示及相关元数据。 2. 自动资源下载：下载生成图像所需的模型、LoRAs和嵌入，支持文件类型和大小的自定义选项。 3. 可定制的输出格式：使用基于模板的系统以用户指定的格式输出提取的信息。 4. LoRA路径优化：自动修改LoRA引用以匹配您的本地路径结构。 5. 元数据值调整：允许为某些提示元数据设置最小/最大值，确保与您的设置兼容。 6. 内容过滤：提供选项自动删除提示中的不需要的单词或LoRAs。 7. 图像尺寸优化：将图像调整为与基础模型最接近的“官方”分辨率，同时保持纵横比。 8. 采样器名称翻译：将不支持的采样器名称转换为与Automatic1111等工具兼容的替代名称。

设置Civitai Companion非常简单： 1. 要求：一个可用的Python环境（已在3.10上测试）。 2. 安装： - 克隆仓库：`git clone https://github.com/rbbrdckybk/civitai-companion` - 进入目录：`cd civitai-companion` - 安装所需的包：`pip install --no-input requests tqdm pillow` 如果您已经在使用Dream Factory，可以跳过包安装步骤。

使用Civitai Companion： 1. 运行脚本：`python civitai_reader.py --config_file config-example.txt` 2. 工具将扫描示例图像，提取元数据，下载引用的LoRAs，并创建输出文件。 3. 要获得完整功能，请获取Civitai API密钥并将其添加到您的配置文件中。 4. 根据您的需要自定义配置文件中的设置。 该工具将根据您的配置和选择的模板处理图像、下载资源并生成输出文件。

Civitai Companion使用灵活的模板系统进行输出格式化。关键标记包括： - [PROMPT]：用于图像的正向提示 - [NEG_PROMPT]：负向提示 - [MODEL]：使用的模型 - [SEED]、[SAMPLER]、[CLIP_SKIP]、[WIDTH]、[HEIGHT]、[SCALE]、[STEPS]：各种生成参数 - [BASE_MODEL]：基础模型（例如，SDXL 1.0，SD 1.5） - [FILENAME]、[FILEPATH]：原始图像文件信息 请参考template-example.txt文件以获取可用标记和格式选项的完整列表。

要充分利用Civitai Companion： 1. 使用命令行参数覆盖特定工作流程的配置文件设置。 2. 检查logs文件夹中的log.txt文件以获取详细的运行信息和故障排除。 3. 通过编辑缓存文件夹中的do_not_download.txt文件来管理资源黑名单。 4. 利用civitai_version_ids.txt文件查找特定资源的版本ID。 这些高级功能允许您对Civitai Companion工作流程进行精细控制和自定义，使您能够高效优化AI图像生成过程。