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（可自由使用、修改與重新分發，須遵循相同授權）。

適用對象 – 需要在重新排版前快速去除漫畫面板文字的翻譯者、掃描翻譯者，或需要為下游電腦視覺任務取得乾淨氣泡影像的研究人員。