KOMA 是一款本地漫画收藏整理工具，支持去广告二维码、格式转换、重命名、归档查重、合集装订五大功能。基于 FFmpeg 多线程转换引擎和 WeChatQRCode 去广告识别，智能重命名让文件井井有条，帮你从此告别混乱的本地漫画库，实现高效的数字化管理，完全免费开源。
🎤 引言
本地漫画收藏这件事，收集的时候爽，整理起来是真的头疼。
下载了一大堆漫画，文件夹里乱七八糟——图片命名不统一、有广告二维码、有重复文件、单话散落在各处。每次想找一本漫画看，结果发现文件夹里图片顺序乱得一塌糊涂，根本没法正常阅读。
KOMA 就是来解决这个问题的。一款专为本地漫画/同人本收藏者设计的整理工具箱，扫描清理、格式转换、重命名、归档查重、合集装订，一条龙服务，让本地漫画库变得井井有条。
⭐ 核心功能
1. 🧹 扫描清理
本地漫画文件夹里经常会有各种"意外惊喜"——微信广告二维码、.url 文件、Thumbs.db、txt 说明文件... KOMA 的扫描清理功能帮你自动识别并剔除这些非图片文件。
特别是漫画尾部的广告二维码，KOMA 集成了 WeChatQRCode，能精准识别并剔除。强迫症患者狂喜。
2. 🛠️ 重命名
很多下载的漫画，图片命名乱七八糟，或者顺序不对。KOMA 支持将文件夹内图片按自然顺序重命名为 000, 001, 002... 的格式。
这个功能对于漫画阅读器的正确识别顺序非常重要，很多阅读器是按文件名排序的，乱序会导致漫画翻页错乱。
3. 🎨 格式转换
基于 FFmpeg 的多线程转换，支持多种现代图片格式：
- AVIF：SVT-AV1 编码速度快适合批量，AOM-AV1 质量更好
- WebP：兼容性最好，几乎所有浏览器和阅读器都支持
- JPEG XL：无损压缩最优选，可以无损转回原格式
转换完成后还会生成 CSV 报表，显示压缩率和体积变化，数据一目了然。
4. 📚 归档查重
手里漫画多了，难免有重复文件。KOMA 支持多路径递归扫描所有文件夹和压缩包，找出重复文件。
查重方式也很灵活：
- 从文件名提取
[社团 (作者)] 作品 (系列)等信息进行比对 - 按封面相似度分析查重（适合同一部作品不同版本）
5. 📖 合集装订
这是 KOMA 最实用的功能之一。把散乱的单张图片、单话文件夹、压缩包"装订"成整洁的合集。
支持拖拽排序，自由调整卷/话顺序，然后自动重命名，跨文件夹合并成一个完整的合集。
📥 安装使用
方式一：下载可执行文件（推荐普通用户）
前往 GitHub Releases 下载最新的 Koma-Windows.zip，解压即用。
如果下载的是不带 FFmpeg 的版本，需要确保系统安装了 ffmpeg.exe（编译时需要开启 --enable-libsvtav1、--enable-libaom、--enable-libjxl、--enable-libwebp）。
也可以直接下载内置 FFmpeg 的版本 Koma-Windows-with-FFmpeg.zip，省去配置步骤。
方式二：源码运行（开发人员）
本项目使用 uv 进行依赖管理：
git clone https://github.com/grasssand/koma.git
cd koma
uv sync
uv run koma配置说明
程序启动时会按以下优先级读取 config.toml：
- 用户配置目录 (
~/.config/koma/) - 程序所在目录
- 当前工作目录
如果未找到配置文件，程序会自动在用户配置目录下生成默认配置。
🎯 适用场景
1. 本地漫画收藏量大的用户
几百上千本漫画靠手动整理根本不现实，KOMA 的批量处理能力让你一键搞定。
2. 同人本爱好者
同人本通常来源混杂、格式不统一，KOMA 的去广告和格式转换功能特别适合这类场景。
3. 需要压缩存储空间的用户
JPEG XL 无损压缩可以在保持画质的前提下大幅缩减体积，省存储空间。
4. 漫画阅读器用户
重命名 + 合集装订功能让你的漫画库符合阅读器的目录结构要求，漫画阅读体验大幅提升。
🔍 对比/替代方案
| 工具 | 去广告 | 格式转换 | 合集装订 | 查重 | 平台 |
|---|---|---|---|---|---|
| KOMA | ✅ | ✅ 多格式 | ✅ | ✅ 双重 | Windows |
| 在线工具 | ❌ | ⚠️ 限制多 | ❌ | ❌ | Web |
| 手动整理 | ✅ | ❌ | ❌ | ❌ | - |
| Python 脚本 | ⚠️ | ⚠️ | ⚠️ | ⚠️ | 跨平台 |
KOMA 的优势在于一条龙服务 + 开箱即用，不需要写代码，不需要手动处理，适合大多数普通用户。
⚠️ 注意事项
1. 仅支持 Windows
目前 KOMA 的可执行文件只有 Windows 版本。macOS 和 Linux 用户可以通过源码方式运行。
2. 需要 FFmpeg
格式转换功能依赖 FFmpeg。不带 FFmpeg 的版本需要自行安装并确保编译时开启了相关编码器。
3. 处理重要数据前先备份
官方免责声明明确说了，软件按"原样"提供。虽然功能看起来稳定，但处理重要漫画库前建议先备份，以防万一。
4. 不支持在线漫画抓取
KOMA 只能整理本地文件，不支持从网上下载漫画。如果需要下载功能，需要配合其他工具使用。
✅ 总结
KOMA 解决的是本地漫画收藏者最实在的痛点——广告二维码、格式混乱、文件重复、目录散乱。这些问题单个看都不大，但累积起来就很烦人。
KOMA 把这些问题打包解决，Windows 用户下载即用，开发者可以源码运行。FFmpeg 驱动的格式转换支持 AVIF/WebP/JPEG XL 这些现代格式，合集装订功能让漫画库目录结构清晰整洁。
一句话评价：本地漫画收藏者的整理神器，功能实用，开箱即用，值得收藏。
| 项目 | 值 |
|---|---|
| GitHub | grasssand/koma |
| Stars | 63 |
| 最新版本 | v1.5.0（2026-05-28） |
| 提交次数 | 61 |
| 语言 | Python |
| 许可证 | MIT |
| 核心依赖 | FFmpeg / OpenCV / WeChatQRCode / 7-Zip |