📱 手機與雲端媒體比對工具 (Media Sync Checker)

這是一套為「完全不懂程式」的使用者設計的小工具。

當我們把手機照片與影片備份到 Google 雲端硬碟（或 Google 相簿）時，常常會遇到兩個痛點：

1. 漏傳： 不確定到底哪些檔案還留在手機裡、哪些已經上傳了？
2. 被壓縮： Google 相簿有時會偷偷壓縮檔案大小，導致雲端上的不是原始高畫質檔案。

這套工具會自動幫你盤點手機與雲端的所有媒體（圖片與影片），並產出一份清單，精準抓出「哪邊缺了檔案」以及「哪個檔案被壓縮了（大小不一樣）」。

---

🛠️ 事前準備

在開始之前，請確保你具備以下環境：

• 手機端 (Android)：
  • 請至 Google Play 商店下載免費的 App：「Pydroid 3 - IDE for Python 3」。
  • 重要： 安裝後，請至手機的「設定」>「應用程式」>「Pydroid 3」>「權限」，將「檔案與媒體」設定為「允許管理所有檔案」。
• 電腦端 (Windows / Mac)：
  • 請確認電腦已安裝 Python (可至 python.org 下載，安裝時務必勾選 "Add Python to PATH")。
  • 請確認電腦已安裝並登入 Google 雲端硬碟電腦版，並能從檔案總管看到你的雲端硬碟資料夾。
  • 準備一個方便操作的資料夾（例如在桌面上新增一個「比對工具」資料夾）。

---

🚀 使用教學

整個流程分為三個簡單的步驟：掃描手機、掃描雲端、進行比對。

步驟一：產生手機端清單 (在手機上執行)

1. 在手機上開啟 Pydroid 3 App。
2. 將本專案中的 手機掃描工具.py 裡面的程式碼，完整複製並貼到 Pydroid 3 的空白畫面中。
3. 點擊畫面右下角的 黃色播放鍵 (▶) 執行。
4. 依照畫面上的中文指示，輸入數字選擇你要掃描的手機資料夾。
5. 掃描完成後，打開手機內建的「檔案管理員」，在內部儲存空間的最外層，會找到一個名為 phone_media_list_[日期].csv 的檔案。
6. 請透過 LINE、Email 或傳輸線，將這個檔案傳送到你的電腦上。

步驟二：產生雲端清單 (在電腦上執行)

1. 將本專案的 雲端掃描工具.py 下載到電腦上的「比對工具」資料夾中。
2. 對著檔案點兩下執行（或按右鍵選擇 Edit with IDLE 後按 F5 執行）。
3. 畫面會出現黑底白字視窗，請貼上你 Google 雲端硬碟中放影片/照片的「資料夾完整路徑」，然後按 Enter。
4. 掃描完成後，同一個資料夾內會產生一個 drive_media_list_[日期].csv 的檔案。

步驟三：比對差異並產出報表 (在電腦上執行)

1. 確認你的「比對工具」資料夾裡面，現在有三個檔案：
   • 剛傳到電腦的 phone_media_list_[日期].csv
   • 剛產生的 drive_media_list_[日期].csv
   • 本專案的 差異比對工具.py
2. 對著 差異比對工具.py 點兩下執行。
3. 程式會自動抓取最新日期的兩份清單進行比對，並在幾秒鐘後產出最終報表：media_comparison_report_[日期].csv。
4. 請使用 Excel 或 LibreOffice Calc 打開這份報表。裡面會清楚列出單邊缺少的檔案，以及兩邊都有但大小被壓縮的檔案！

---

💡 常見問題

• 報表裡顯示的「大小差異」是用什麼單位？
  • 單位是 MB，並且精確到小數點後兩位 (0.01 MB)。只要兩邊檔案大小相差超過 0.01 MB，程式就會將其標示出來，方便你抓出被輕微壓縮的照片。
• 如果檔案兩邊都有，而且大小一樣，會出現在報表裡嗎？
  • 不會。為了讓報表保持乾淨，只有「發生異常（缺檔或大小不同）」的檔案才會被列出來。