首次启动必懂：数据目录、日志、托盘与自动启动

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 快速建号池