📍 第二階段：解剖 auto_bot 專案架構

當一個專案變得複雜時，我們不能把所有的東西都塞進一個 .py 檔案。auto_bot 採用的結構能讓開發者更輕鬆地維護與除錯。

2.1 專案結構拆解

我們來看看您的資料夾裡有什麼，以及它們各自扮演的角色：

1. pictures/ (圖庫管理)：
2. • 這是機器人的「眼睛記憶」。將所有的按鈕截圖（如 battle.png, confirm.png）放在獨立資料夾中，可以避免主目錄混亂，也方便你在換電腦或遊戲改版時快速更新圖檔。
   • 精髓：裡面甚至有 shop_whitelist 子資料夾，這代表它不僅僅是找按鈕，還能辨識特定的商品圖標。
2. tools.py (核心工具模組)：
3. • 這是整個專案的大腦核心。它不執行具體的遊戲任務，而是定義了「怎麼找圖」、「怎麼點擊」、「怎麼寫日誌」等通用功能。
   • 為什麼這樣做？ 如果你有 10 個不同的任務腳本（解每日、刷體力、自動推圖），你只需要在 tools.py 改動一次代碼，所有腳本都會同步更新。這就是 DRY 原則 (Don't Repeat Yourself)。
3. 任務導向的主程式 (game_bot_daily_mission.py, auto_next_level.py)：
4. • 這些檔案就像是「劇本」，它們負責呼叫 tools.py 裡的工具來執行特定的流程。例如「先點擊 A，如果看到 B 就點擊 C，最後等待 5 秒」。
4. logs/ (運作日誌)：
5. • 當你睡覺讓機器人跑時，如果出錯了，你不需要通靈。看 scheduled_run.log 就能知道程式在幾點幾分卡在哪個步驟。

2.2 模組化運作：程式碼是如何連動的？

在您的專案中，最關鍵的語法是出現在主程式開頭的 import tools。這讓主程式能直接使用 tools.py 裡封裝好的高級功能。

我們透過下方的互動式視覺化工具，來模擬一個「自動化任務」啟動時，專案內部各個模組之間是如何溝通協作的。