Первый запуск: Каталог данных, журналы, трей и автозапуск
Многие возможности Antigravity Tools, которые кажутся «магическими» (пул аккаунтов, квоты, мониторинг, статистика, фоновая работа), в итоге сводятся к двум вещам: каталог данных и журналы. Если разобраться с этими двумя компонентами при первом запуске, это сэкономит много времени при устранении неполадок в будущем.
Что такое каталог данных?
Каталог данных — это папка на вашем компьютере, где Antigravity Tools сохраняет своё состояние: JSON-файлы аккаунтов, файлы квот, файлы журналов, а также базы данных SQLite для Token Stats и Proxy Monitor. При создании резервных копий/миграции/устранении неполадок достаточно определить этот каталог, чтобы найти авторитетный источник данных.
Чему вы научитесь
- Знать, где находится каталог данных Antigravity Tools (и уметь открыть его одним кликом)
- Понимать, какие файлы нужно резервировать, а какие — это журналы/кэш
- При устранении неполадок быстро находить журналы и базу данных мониторинга
- Понимать разницу между «закрытием окна» и «выходом из программы» (фоновый режим в трее)
- Различать два типа автозапуска: автозапуск при включении компьютера vs автозапуск прокси
Текущие проблемы
- Вы хотите создать резервную копию/мигрировать аккаунты, но не знаете, где они хранятся
- В интерфейсе возникает ошибка/неудача вызова прокси, но вы не можете найти журналы
- Вы закрыли окно и думаете, что программа вышла, но она продолжает работать в фоновом режиме
Когда использовать этот метод
- Вы только что установили Antigravity Tools и хотите подтвердить «где хранятся данные»
- Вы готовитесь сменить компьютер/переустановить систему и хотите сначала создать резервную копию аккаунтов и статистики
- Вам нужно устранить неполадки: сбой OAuth, сбой обновления квоты, сбой запуска прокси, ошибки 401/429 при вызове
🎒 Подготовка
- Установлен и запущен Antigravity Tools
- Вы можете войти на страницу Settings (в правом верхнем углу или на боковой панели)
- Ваш системный аккаунт имеет права доступа к домашнему каталогу
Напоминание
Этот урок расскажет, какие файлы являются «реальными данными», но не рекомендуется редактировать их вручную. Для изменения конфигурации используйте интерфейс.
Основная идея
Запомните одно утверждение:
«Каталог данных — это единственный источник правды о локальном состоянии; журналы — это первый вход для устранения неполадок.»
Antigravity Tools создаст каталог данных .antigravity_tools в вашем домашнем каталоге и поместит туда аккаунты, журналы, базу статистики и другое содержимое (если каталог не существует, он будет создан автоматически).
В то же время по умолчанию включён трей: при закрытии окна программа не выйдет сразу, а скроется в трей и продолжит работать в фоновом режиме.
Пошаговое руководство
Шаг 1: Откройте каталог данных на странице настроек
Зачем Сначала точно определите каталог данных — это даст вам точку отсчёта для последующего резервного копирования или устранения неполадок.
Откройте Settings в Antigravity Tools, затем перейдите на вкладку Advanced.
Вы увидите поле ввода «Каталог данных» (только для чтения, оно покажет реальный путь) и рядом кнопку «Открыть».
Нажмите кнопку «Открыть».
Что вы должны увидеть: Откроется системный файловый менеджер с каталогом, путь похож на ~/.antigravity_tools/.
Шаг 2: Подтвердите путь к каталогу данных (кроссплатформенность)
Зачем При написании скриптов для резервного копирования или устранении неполадок в командной строке нужно знать фактический путь этого каталога в вашей системе.
echo "$HOME/.antigravity_tools"
ls -la "$HOME/.antigravity_tools"$dataDir = Join-Path $HOME ".antigravity_tools"
$dataDir
Get-ChildItem -Force $dataDirЧто вы должны увидеть: Каталог существует (если вы впервые открываете страницу настроек, каталог будет создан автоматически).
Шаг 3: Узнайте «ключевые файлы» в каталоге данных
Зачем Не все файлы стоят резервировать. Сначала разберитесь, что такое «данные аккаунтов», а что — «база статистики/журналы».
Ниже приведены имена файлов из исходного кода проекта, они фиксированные:
| Что вы увидите | Назначение | Что важно для вас |
|---|---|---|
accounts.json | Индекс аккаунтов (список аккаунтов/текущий аккаунт) | При миграции аккаунтов рекомендуется создавать резервную копию вместе |
accounts/ | Для каждого аккаунта отдельный файл *.json | Это основные данные аккаунтов |
logs/ | Каталог журналов приложения | При устранении неполадок в первую очередь смотрите сюда |
token_stats.db | База данных SQLite для Token Stats | Данные, которые вы видите на странице Token Stats, берутся отсюда |
proxy_logs.db | База данных SQLite для Proxy Monitor | Журналы запросов, которые вы видите на странице Monitor, берутся отсюда |
warmup_history.json | Локальная история для Smart Warmup | В основном используется для избежания повторного warmup |
update_settings.json | Настройки обновления (автоматическая проверка/интервал и т.д.) | Обычно не нужно редактировать вручную |
Что вы должны увидеть: Как минимум есть каталог logs/; если вы ещё не добавили аккаунты, accounts.json/accounts/ могут не появиться.
Шаг 4: Запомните расположение журналов (для устранения неполадок)
Зачем Сообщения об ошибках в интерфейсе обычно показывают только «симптомы», а настоящие причины (например, неудачный запрос, ошибка чтения/записи файла) часто находятся в журналах.
Antigravity Tools записывает журналы в подкаталог logs/ каталога данных.
ls -la "$HOME/.antigravity_tools/logs"Get-ChildItem -Force (Join-Path $HOME ".antigravity_tools\logs")Что вы должны увидеть: В каталоге есть файлы журналов с ежедневной ротацией (имя файла начинается с app.log).
Шаг 5: При необходимости «очистить журналы» используйте функцию очистки на странице настроек
Зачем Для некоторых проблем вы хотите воспроизвести её один раз и оставить только этот журнал; сначала очистка журналов упростит сравнение.
На странице Settings -> Advanced найдите область журналов и нажмите «Очистить журналы».
Что вы должны увидеть: Появится диалоговое окно с подтверждением; после подтверждения появится сообщение об успешной очистке.
Две вещи, которые вас могут беспокоить
- Журналы автоматически «ротируются по дням» и при запуске пытаются очистить старые журналы старше 7 дней.
- «Очистка журналов» усекает файлы журналов до 0 байт, чтобы запущенные процессы могли продолжать писать в тот же дескриптор файла.
Шаг 6: Разберитесь в разнице между «закрытием окна» и «выходом из программы» (трей)
Зачем По умолчанию в Antigravity Tools включён трей; при нажатии кнопки закрытия в правом верхнем углу окна программа скроется в трей и продолжит работать. Если вы думаете, что она вышла, легко создать ложное впечатление «порт всё ещё занят/программа работает в фоне».
Вы можете использовать этот небольшой процесс для подтверждения:
Действие: закрыть окно (не выходить)
┌─────────────────────────────────────────────────────────────┐
│ Шаг 1 Шаг 2 │
│ Нажмите закрытие → Найдите значок в системном трее/меню │
└─────────────────────────────────────────────────────────────┘
Что вы должны увидеть: значок трея всё ещё существует, нажатие на него снова покажет окно.В меню трея есть два часто используемых действия (очень удобно, когда не используете интерфейс):
- Переключить аккаунт: переключиться на следующий аккаунт
- Обновить квоту: обновить квоту текущего аккаунта (и одновременно уведомить фронтенд об обновлении отображения)
Шаг 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 в меню трея
- [ ] Вы можете различать «автозапуск при включении» и «автозапуск прокси»
Частые ошибки
| Ситуация | Что вы можете сделать (❌) | Рекомендуемый подход (✓) |
|---|---|---|
| Не можете найти каталог данных | Хаотично искать каталог установки приложения в системе | Перейдите на Settings -> Advanced, посмотрите «Каталог данных» и откройте одним кликом |
| Закрыли окно и думаете, что вышли | После закрытия окна сразу меняете конфигурацию/порт | Сначала проверьте, есть ли значок трея; для выхода используйте Quit в трее |
| Слишком много журналов, трудно устранять неполадки | При воспроизведении проблемы просматриваете старые журналы | Сначала «очистите журналы», затем воспроизведите снова, в конце смотрите только этот файл журнала |
| Хотите изменить данные аккаунтов | Вручную редактировать accounts/*.json | Используйте процессы импорта/экспорта/миграции в интерфейсе (связанные главы следующего раздела объяснят) |
Итог урока
- Каталог данных фиксирован в
.antigravity_toolsв домашнем каталоге (в macOS/Linux обычно表现为 скрытый каталог), аккаунты/журналы/база статистики всё здесь - Каталог журналов — это
logs/, при устранении неполадок смотрите в первую очередь; при необходимости можно очистить одним кликом на странице настроек - Закрытие окна скроет его в трей и продолжит работать; для полного выхода используйте Quit в трее
- Два типа автозапуска: автозапуск при включении (приложение) и автозапуск прокси (Proxy)
Предпросмотр следующего урока
В следующем уроке мы изучим Добавление аккаунтов: OAuth/Refresh Token двойной канал и лучшие практики.
Вы узнаете:
- Когда использовать OAuth, когда напрямую refresh_token
- Как обрабатывать сбой обратного вызова и когда не удаётся получить refresh_token
- Как массово импортировать 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) | 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 |