VoxelCubes/PanelCleaner

Panel Cleaner – 基于 AI 的漫画面板文本移除工具

功能 – Panel Cleaner 是一个基于 Python 的应用程序，可自动检测漫画/漫画页面中对话气泡内的文本，生成精确的掩码，并选择性地移除文本（保留干净的气泡）或通过 OCR 提取文本。它使用预训练的文本检测模型、LaMa 进行图像修复，以及可选的 MangaOCR/Tesseract 进行 OCR。该工具可从命令行无头运行，也可通过 Qt GUI 使用，支持 CUDA 加速，并可在 Windows、macOS 和 Linux 上运行。

主要功能

• 检测日语和英语文本，生成高精度掩码，并扩展掩码以覆盖附近的伪影。
• 对无法干净掩码的气泡使用 LaMa 模型进行图像修复。
• 可保存清理后的图像、透明掩码层或两者。
• 支持文件夹和完整目录树的批量处理。
• 通过纯文本 配置文件（INI 格式）完全可配置 – 所有参数（掩码扩展、阈值等）均可调整并保存。
• 内置 OCR：日语使用 MangaOCR，英语/日语使用 Tesseract，GUI 中提供交互式编辑器。
• 初始约 500 MiB 模型下载后无需互联网连接。
• 可选 CUDA 支持以加快处理速度（仅在通过 pip 安装时可用，预构建二进制文件中不包含）。
• 多语言界面（英语、德语、保加利亚语、西班牙语）及社区翻译支持。

获取方式

1. 预构建二进制文件 – 从 GitHub Releases 页面下载最新版本（推荐大多数用户使用）。
2. Python 包 – pip install pcleaner（安装 CLI 和 GUI）或 pip install pcleaner-cli（仅命令行）。
3. AUR – yay -S panelcleaner（安装在 pipx 环境中，便于处理 CUDA）。
4. Flatpak – 从 Flathub 安装 io.github.voxelcubes.panelcleaner（不支持 CUDA）。
5. Docker – 构建提供的 Dockerfile 并运行容器，挂载主机文件夹中的图像。

典型命令行工作流

# 清理几个文件，保存清理后的图像
pcleaner clean page1.png page2.png

# 清理一个文件夹，仅保留掩码层
pcleaner clean -m my_folder

# 使用自定义配置文件
pcleaner clean -p my_profile folder/

# 运行 OCR 并将结果写入文本文件
pcleaner ocr my_folder --output-path=out.txt

GUI 可通过 pcleaner gui 或 pcleaner-gui 启动，提供掩码的可视化预览、分析和 OCR 编辑器。

限制

• 仅支持日语和英语的清理；OCR 支持日语（通过 MangaOCR）和英语（通过 Tesseract）。
• 掩码仅限灰度，因此适用于白色/黑色/灰色气泡，不适用于彩色气泡。
• AI 检测器不完美 – 约 2–8% 的气泡可能被遗漏或错误掩码，工具会跳过无法自信清理的气泡。
• 预构建二进制文件不包含 CUDA；GPU 加速需要通过 pip 安装并使用兼容的 PyTorch 构建。

许可证 – GNU GPL-v3（可自由使用、修改和重新分发，须遵循相同许可证）。

适用人群 – 需要在重新排版前快速去除漫画面板文本的翻译者、扫描翻译者，或需要为下游计算机视觉任务获取干净气泡图像的研究人员。