首次啟動必懂：資料目錄、日誌、系統托盤與自動啟動

Antigravity Tools 的很多「看起來像魔法」的能力（帳號池、配額、監控、統計、後台執行），最後都要落到兩樣東西上：資料目錄和日誌。第一次跑起來就把這兩塊搞清楚，後面排障會省很多時間。

什麼是資料目錄？

資料目錄是 Antigravity Tools 在你本機儲存狀態的資料夾：帳號 JSON、配額相關檔案、日誌檔案，以及 Token Stats/Proxy Monitor 的 SQLite 資料庫都放在這裡。你做備份/遷移/排障時，只要先定位這個目錄，基本就能找到權威資料來源。

學完你能做什麼

• 知道 Antigravity Tools 的資料目錄在哪（並能一鍵開啟）
• 弄清哪些檔案該備份，哪些是日誌/快取
• 需要排障時，能快速定位到日誌與監控資料庫
• 理解「關閉視窗」和「退出程式」的區別（系統托盤常駐）
• 區分兩類自動啟動：開機自啟 vs 反代自動啟動

你現在的困境

• 你想備份/遷移帳號，但不知道帳號到底儲存在哪
• UI 報錯/反代呼叫失敗，但你找不到日誌
• 你把視窗關了，以為程式退出了，結果它還在後台跑

什麼時候用這一招

• 你剛裝好 Antigravity Tools，想確認「資料放在哪」
• 你準備換電腦/重裝系統，想先把帳號和統計資料備份出來
• 你要排查：OAuth 失敗、重新整理配額失敗、反代啟動失敗、呼叫報 401/429

🎒 開始前的準備

• 已安裝並能開啟 Antigravity Tools
• 你能進入 Settings 頁面（右上角/側邊欄的設定入口）
• 你的系統帳號有權限存取自己的 Home 目錄

提醒

本課會告訴你哪些檔案是「真資料」，但不建議你手動編輯這些檔案。你要改設定，請優先在 UI 裡改。

核心思路

先記住一句話：

「資料目錄是本地狀態的單一真相來源；日誌是排障的第一入口。」

Antigravity Tools 會在你的 Home 目錄下建立 .antigravity_tools 資料目錄，並把帳號、日誌、統計庫等內容都放進去（目錄不存在會自動建立）。

同時，它預設啟用系統托盤：你關掉視窗時，程式不會立刻退出，而是隱藏到系統托盤，繼續在後台執行。

跟我做

第 1 步：在設定頁開啟資料目錄

為什麼 你先把資料目錄定位準，後面不管是備份還是排障，都有「落點」。

在 Antigravity Tools 裡開啟 Settings，然後切到 Advanced。

你會看到一塊「資料目錄」的唯讀輸入框（它會顯示真實路徑），旁邊有一個開啟按鈕。

點擊開啟按鈕。

你應該看到：系統檔案管理員開啟了一個目錄，路徑類似 ~/.antigravity_tools/。

第 2 步：確認你的資料目錄路徑（跨系統）

為什麼 你後續寫腳本備份、或者在命令列裡排查問題時，得知道這個目錄在你系統上的實際路徑。

macOS/Linux

echo "$HOME/.antigravity_tools"
ls -la "$HOME/.antigravity_tools"

Windows

$dataDir = Join-Path $HOME ".antigravity_tools"
$dataDir
Get-ChildItem -Force $dataDir

你應該看到：目錄存在（如果你第一次開啟設定頁，目錄會被自動建立）。

第 3 步：認識資料目錄裡的「關鍵檔案」

為什麼 不是所有檔案都值得備份。先把「哪些是帳號資料」「哪些是統計庫/日誌」分清。

下面這些檔名來自專案原始碼，都是固定的：

你會看到的內容	用途	你需要關心什麼
accounts.json	帳號索引（包含帳號列表/目前帳號）	遷移帳號時建議一起備份
accounts/	每個帳號一個 *.json 檔案	這是帳號資料主體
logs/	應用日誌目錄	排障優先看這裡
token_stats.db	Token Stats 的 SQLite 資料庫	你在 Token Stats 頁看到的資料來自它
proxy_logs.db	Proxy Monitor 的 SQLite 資料庫	你在 Monitor 頁看到的請求日誌來自它
warmup_history.json	Smart Warmup 的本地歷史紀錄	主要用於避免重複 warmup
update_settings.json	更新檢查設定（自動檢查/間隔等）	一般不需要手動動它

你應該看到：至少有 logs/ 目錄；如果你還沒新增帳號，accounts.json/accounts/ 可能還沒出現。

第 4 步：把日誌位置記牢（排障靠它）

為什麼 UI 的錯誤提示通常只給「現象」，真正的失敗原因（例如請求失敗、檔案讀寫失敗）往往在日誌裡。

Antigravity Tools 會把日誌寫到資料目錄下的 logs/。

macOS/Linux

ls -la "$HOME/.antigravity_tools/logs"

Windows

Get-ChildItem -Force (Join-Path $HOME ".antigravity_tools\logs")

你應該看到：目錄下存在按天滾動的日誌檔案（檔名以 app.log 開頭）。

第 5 步：需要「清空日誌」時，用設定頁的一鍵清理

為什麼 有些問題你只想重現一次，然後把那次的日誌單獨留下來；這時先清空日誌會更好對比。

在 Settings -> Advanced 裡，找到日誌區域，點擊「清理日誌」。

你應該看到：彈出確認框；確認後提示清理成功。

你會擔心的兩件事

• 日誌會自動做「按天滾動」，並在啟動時嘗試清理超過 7 天的舊日誌。
• 「清理日誌」會把日誌檔案截斷為 0 位元組，方便正在執行的程式繼續寫同一個檔案控制碼。

第 6 步：弄清「關閉視窗」和「退出程式」的區別（系統托盤）

為什麼 Antigravity Tools 預設啟用系統托盤；你點視窗右上角關閉時，程式會隱藏到系統托盤繼續執行。如果你以為它退出了，很容易出現「連接埠還在佔用/後台還在跑」的錯覺。

你可以用這個小流程確認：

操作：關閉視窗（不是退出）

┌─────────────────────────────────────────────────────────────┐
│  第 1 步                第 2 步                             │
│  點擊視窗關閉       →   去系統托盤/功能表列找圖示              │
└─────────────────────────────────────────────────────────────┘

你應該看到：系統托盤圖示仍然存在，點它可以重新顯示視窗。

系統托盤選單裡還有兩個常用動作（不走 UI 的時候很方便）：

• 切換帳號：切換到下一個帳號
• 重新整理配額：重新整理目前帳號配額（同時會通知前端重新整理顯示）

第 7 步：設定開機自啟（讓它啟動後自動最小化）

為什麼 如果你希望它像「常駐服務」一樣工作（系統托盤常駐 + 後台重新整理），開機自啟會省掉每次手動開啟。

在 Settings -> General 裡找到「開機自動啟動」，選擇啟用。

你應該看到：切換後提示啟用成功；下次開機啟動時會帶上 --minimized 參數執行。

兩類「自動啟動」，別搞混

名稱	指的是什麼	證據
開機自啟	電腦啟動後自動啟動 Antigravity Tools（桌面應用本身）	啟動參數包含 --minimized，並提供 toggle_auto_launch 命令
反代自動啟動	Antigravity Tools 啟動後，如果設定 proxy.auto_start=true，會嘗試自動啟動本地反代服務	應用啟動時讀取設定並 start_proxy_service(...)

檢查點 ✅

• [ ] 你能在 Settings -> Advanced 看到資料目錄的真實路徑
• [ ] 你能開啟資料目錄，並大致認得 accounts.json、accounts/、logs/、token_stats.db、proxy_logs.db
• [ ] 你知道日誌在 logs/ 下，並會用命令列快速檢視
• [ ] 你知道關閉視窗後程式仍在系統托盤，退出要用系統托盤選單的 Quit
• [ ] 你能區分「開機自啟」和「反代自動啟動」

踩坑提醒

場景	你可能會怎麼做（❌）	推薦做法（✓）
找不到資料目錄	在系統裡亂搜 App 的安裝目錄	直接去 Settings -> Advanced 看「資料目錄」並一鍵開啟
關掉視窗以為退出了	點視窗關閉後就去改設定/換連接埠	先看系統托盤圖示是否還在；要退出用系統托盤 Quit
日誌太多不好排查	一邊重現問題一邊翻舊日誌	先「清理日誌」，再重現一次，最後只看這次的日誌檔案
想改帳號資料	手動編輯 accounts/*.json	用 UI 的匯入/匯出/遷移流程（下一節相關章節會講）

本課小結

• 資料目錄固定在 Home 下的 .antigravity_tools（macOS/Linux 下通常表現為隱藏目錄），帳號/日誌/統計庫都在這裡
• 日誌目錄是 logs/，排障時優先看；需要時可以在設定頁一鍵清理
• 關閉視窗會隱藏到系統托盤繼續執行；要徹底退出用系統托盤 Quit
• 自動啟動有兩類：開機自啟（應用）和反代自動啟動（Proxy）

---

下一課預告

下一課我們學習 新增帳號：OAuth/Refresh Token 雙通道與最佳實踐。

---

附錄：原始碼參考

點擊展開查看原始碼位置

更新時間：2026-01-23

功能	檔案路徑	行號
資料目錄位置（~/.antigravity_tools）	src-tauri/src/modules/account.rs	16-33
帳號索引與帳號檔案目錄（accounts.json / accounts/）	src-tauri/src/modules/account.rs	16-46
日誌目錄與按天滾動（logs/ + app.log）	src-tauri/src/modules/logger.rs	17-83
清理日誌（截斷檔案）	src-tauri/src/modules/logger.rs	149-169
設定頁展示資料目錄 + 一鍵開啟	src/pages/Settings.tsx	525-576
設定頁一鍵清理日誌（按鈕 + 彈窗邏輯）	src/pages/Settings.tsx	127-135
設定頁一鍵清理日誌（Advanced tab 按鈕）	src/pages/Settings.tsx	732-747
系統托盤選單與點擊事件（切換帳號/重新整理/顯示/退出）	src-tauri/src/modules/tray.rs	9-158
---	---	---
---	---	---
開機自啟開關（toggle_auto_launch / is_auto_launch_enabled）	src-tauri/src/commands/autostart.rs	4-39
一鍵開啟資料目錄 / 取得路徑 / 清理日誌命令	src-tauri/src/commands/mod.rs	578-621
Token Stats 資料庫檔名（token_stats.db）	src-tauri/src/modules/token_stats.rs	58-61
Proxy Monitor 資料庫檔名（proxy_logs.db）	src-tauri/src/modules/proxy_db.rs	5-8
Warmup 歷史檔名（warmup_history.json）	src-tauri/src/modules/scheduler.rs	14-17
更新設定檔名（update_settings.json）	src-tauri/src/modules/update_checker.rs	150-177
反代自動啟動（proxy.auto_start=true 時啟動服務）	src-tauri/src/lib.rs	107-126

下一課預告

下一課我們學習 新增帳號：OAuth/Refresh Token 雙通道與最佳實踐。

你會學到：

• 什麼時候用 OAuth，什麼時候直接用 refresh_token
• 回調失敗與拿不到 refresh_token 時怎麼處理
• 怎麼批次匯入 refresh_token 快速建帳號池