2026-04-09

Outlook Mail Deduplicator v1.0

運用 Claude Opus4.6 詠唱出來的小工具

Outlook Mail Deduplicator v1.0.26.04.09.09.45
https://drive.google.com/file/d/1KSnW80APDB8V9o_9SqRBrgL53LOpFtN6

History:
Outlook Mail Deduplicator v1.0.26.04.09.09.06
發布前最後一次修改,Claude 把一個 worker 意外覆蓋掉了,導致按下 [開始掃描] 沒作用

# Outlook Mail Deduplicator 使用手冊

## 一、系統概述

**Outlook Mail Deduplicator** 是一款安全、高效的 Microsoft Outlook 重複郵件檢測與處理工具。

### 核心功能
- **重複檢測**:基於 Message-ID、From、To、Subject、傳送時間等多維度識別重複郵件
- **安全驗證**:顯示重複郵件對比,使用者手動確認保留哪一封
- **智慧處理**:支援三種處理策略(保留最舊/最新/預覽)
- **衝突管理**:對於完全相同的郵件基於使用者選擇處理

---

## 二、系統架構

### 核心模組

#### 2.1 Outlook Profile 管理
- **enumerate_profiles()**:列舉當前系統中所有 Outlook Profile
- **ProfileLoaderThread**:後臺載入 Profile 對應的郵箱帳號

#### 2.2 郵件掃描引擎
- **FolderWalker**:遞迴遍歷所有郵件夾
- **DuplicateEngine**:多維度重複檢測(Message-ID、From、To、Subject、時間容忍)
- **ScanWorker**:後臺掃描執行緒,支援暫停/繼續/取消

#### 2.3 報告生成
- **report_writer.py**:生成 JSON 報告(記錄所有重複群組、衝突、處理結果)
- **CSV 報告**:可選的 Excel 相容格式報告

#### 2.4 衝突處理
- **ConflictDialog**:衝突處理主對話方塊
- **ConflictWorker**:衝突搬移後臺執行緒
- **增量更新**:暫停/取消/進度時自動儲存處理進度

---