LINE Cleaner v0.5.3 Alpha

Windows 本機 LINE 官方帳號清理工具的實驗版。

v0.5.3 修正

• 修正完整盤點時，同一個官方帳號因頁面重疊、時間／未讀數／訊息預覽變化而被當成不同帳號重複收錄。
• 完整盤點新增第二層去重簽章：分開比較「頭像」與「帳號名稱」的穩定區域，不再只依賴包含右側動態資訊的舊 fingerprint。
• 頭像去重會先移除列的 hover／選取背景，再比較頭像結構與主要色彩；名稱則使用邊緣結構比對。
• 允許少量列對齊誤差，並保留 v0.5.1 的動態列邊界偵測，因此滑動停在半列時也不會靠重複項目補洞。
• 白名單仍沿用舊 identity_fingerprint，因此升級 v0.5.3 不會刻意讓既有白名單全部失效。

v0.5.1 修正

• 修正完整盤點時，滑鼠滾輪停在「半列」位置後仍用固定列高切圖，造成上一個帳號的底部被切進下一個帳號預覽的問題。
• 每張 LINE 畫面會先分析左側頭像欄的週期位置，自動估算目前帳號列的垂直位移。
• 只擷取完整帳號列；畫面頂端或底端被截到一半的列會留到下一張畫面再處理。
• 不需要 OCR，也沒有重新啟用 UIA Tree。

v0.5 新增

• 白名單：每個掃描到的官方帳號都有「白名單」勾選欄。
  • 勾選後立即保存到 %LOCALAPPDATA%\LINECleaner\whitelist.json。
  • 下次重新開啟 LINE Cleaner 仍會保留。
  • 白名單帳號不會被單頁批次封鎖，也會在整份清理中自動略過。
• 封鎖全部（白名單除外）：完整盤點後，可以直接清理整份官方帳號清單。
  • 不會拿盤點時的舊座標直接重播。
  • 執行時會重新捲到頂端，每一輪都重新截圖，再處理目前畫面上的帳號。
  • 封鎖成功後清單會往上縮，因此會先重新掃同一個 viewport，再繼續向下。
  • LINE 不允許封鎖的特殊帳號會自動按「確定」並略過。
  • 任何無法驗證的結果都會停止，不會假報成功。

基本使用流程

1. Windows 上開啟 LINE Desktop，切到 官方帳號。
2. 雙擊 run.bat。
3. 第一次使用先用一個確定不要的帳號執行 校準封鎖…。
4. 按 掃描全部帳號，等待完整盤點完成。
5. 在表格的 白名單 欄勾選要保留的帳號。
6. 確認後按 封鎖全部（白名單除外）。
7. 執行期間不要操作滑鼠、切換 LINE 頁面或大幅調整視窗尺寸。
8. 完成後再掃描全部一次，確認剩餘帳號。

如果只想清掉眼前幾個帳號，仍可使用：

掃描可見帳號 → 勾 此次封鎖 → 封鎖已選帳號

為什麼完整盤點後還要重新即時掃描

LINE 在每封鎖一個帳號後，左側清單會重新排列。如果直接拿盤點時記住的第 20 頁、第 4 列座標去點，後面的座標很快就會失效。

v0.5 的整份清理因此採用：

盤點供使用者 Review / 設白名單 → 執行時重新從頂端即時掃描 → 由下往上封鎖目前可見列 → 重新掃同一畫面 → 沒有可處理項目才向下捲

這樣比重播舊座標安全得多。

白名單識別方式

目前尚未加入 OCR。白名單使用每個帳號列的「頭像 + 名稱區」本機視覺 fingerprint 判斷，刻意排除較容易變動的訊息預覽區。

因此：

• LINE 更換帳號頭像、名稱、UI 主題後，可能需要重新勾白名單。
• v0.5 仍屬 Alpha；第一次整份清理請先保留少量帳號做實測。
• 所有 fingerprint、截圖與校準資料都只存本機，不會上傳。

打包給朋友

直接雙擊：

build.bat

它會自動：

1. 建立獨立 .build-venv
2. 安裝專案、pytest 與 PyInstaller
3. 執行測試
4. 建立 PyInstaller --onedir --windowed 可攜版
5. 放入 README
6. 產生 ZIP

成功後分享：

dist\LINE-Cleaner-v0.5.3-win64.zip

朋友解壓後直接執行：

LINE Cleaner\LINE Cleaner.exe

不需要安裝 Python。

不會被打包給朋友的本機資料

你的校準與白名單位於：

%LOCALAPPDATA%\LINECleaner\block-calibration.json
%LOCALAPPDATA%\LINECleaner\whitelist.json

它們不在專案資料夾，因此 build.bat 不會把你的設定塞進分享 ZIP。朋友第一次使用時應自行校準與建立白名單。

安全原則

• 不使用 LINE 私有 API。
• 不掃 Accessibility / UIA Tree。
• 單頁破壞性操作只接受剛完成的可見掃描結果。
• 整份清理每輪重新擷取畫面，不重播完整盤點的舊座標。
• 白名單優先於所有封鎖操作。
• 點擊後必須通過結果驗證才記為成功。
• LINE 拒絕封鎖會記為略過。
• 畫面無法驗證時立即停止。

專案狀態

Alpha / PoC。不是 LINE 官方產品，亦未獲 LINE 背書。

v0.5.3 打包修正

build.bat 現在只執行本版本實際附帶的測試檔，不會因為你曾把新版覆蓋解壓到舊版資料夾，而誤跑殘留的 test_classifier.py / test_models.py 等舊測試。仍建議每版解壓到新的空資料夾後再執行 build.bat。