Папка данных GrigDesk
Вся работа сервера — чаты, маршруты, профили, плагины и состояние — живёт в одной папке. Она создаётся сама при первом запуске и переносится целиком.
Где находится
По умолчанию GrigDesk хранит данные в ~/.grigdesk — в домашней папке пользователя, от имени которого работает сервер. Если данные нужно разместить в другом месте, путь переопределяется переменной GRIGDESK_HOME, а настройки машины задаются в файле .env внутри этой же папки.
Папка появляется автоматически при первом запуске сервера. Создавать каталоги вручную не нужно: отдельные каталоги добавляются, когда вы начинаете пользоваться соответствующей возможностью — например, привязываете телефон или открываете раздел 3D.
Что внутри
| Каталог | Что хранит |
|---|---|
.env | Настройки машины: переменные окружения сервера — порт, пути, исполнители. |
state/ | Рабочее состояние сервера: журнал, сессии входа, настройки, профили подключений, установки исполнителей. |
chats/ | История чатов с агентами: файлы по месяцам, вложения и ходы разговоров. |
artifacts/ | Рабочая папка агентов: снимки экрана, отчёты проверок, дампы и подготовленные файлы. |
factory/ | Состояние движка конвейеров: опубликованные маршруты, журналы прогонов, настройки этапов. |
profiles/ | Профили проектов: окружение, исполнители и правила проверок каждого проекта. |
plugins/ | Установленные плагины; их данные лежат отдельно, в state/plugins/. |
drivers/ | Установленные драйверы трекеров. |
db-engines/ | Установленные внешние движки баз данных. |
runtimes/ | Поставляемые рантаймы: обновления сервера и пакеты встроенного исполнителя DeepSeek. |
mobile/ | Доступ с телефона: TLS-сертификаты сервера и привязанные устройства. |
telegram/, github/ | Архивы входящих из каналов Telegram и GitHub. |
3d/ | Библиотека 3D-раздела: модели, задания генерации и загрузки. |
browser/ | Служебный сокет встроенного браузера. |
provider-cli-leases/ | Блокировки одновременного запуска внешних CLI-исполнителей. |
Состояние сервера — state/
Самый широкий каталог. Сервер ведёт его сам, вручную файлы редактировать не нужно:
grigdesk-server.log— журнал сервера, рядом лежат его сжатые ротации;server.lock— блокировка от запуска второго экземпляра;auth-sessions.json— сессии входа;prefs.json— настройки интерфейса;models.json— реестр моделей исполнителей;ssh/,db/— профили подключений и журналы аудита SSH и баз данных;web-log/— журнал веб-интерфейса;tickets/,sandboxes/— внутренние задачи и ручные песочницы;provider-installs/— состояние установленных CLI-исполнителей;plugins/— данные плагинов, отделённые от их пакетов;ui-releases/— скачиваемые обновления веб-интерфейса;mobile-apk/— APK мобильного приложения;media-venv/,hf/,speech-install/— окружение и модели распознавания и синтеза речи;tracker-data/— рабочие данные подключённых трекеров;arbiter-cards.json,task-shelf.jsonи другие файлы личных подсказок и подборок.
Движок конвейеров — factory/
routes/— опубликованные маршруты: каждая версия неизменяема;state/— журналы и результаты прогонов;control/— доверенные настройки этапов конкретных запусков;config/— настройки движка;analysis/— заметки триажа задач.
Приватность и резервные копии
- Резервная копия — вся папка целиком: каталоги не взаимозаменяемы, а часть состояния обновляется при каждом ходе агента. Перед копированием сервер останавливают.
- Внутри есть чувствительное: сессии входа и токены в
state/, TLS-ключи и журнал устройств вmobile/, учётные данные трекеров. Папку не публикуют и не пересылают, копию хранят в защищённом месте. - Удаление папки стирает историю чатов, маршруты, профили и настройки безвозвратно, поэтому отдельные подкаталоги вручную не чистят.
Связанные страницы
- Архитектура — где выполняется работа и как связаны компоненты.
- Установка — первый запуск и обновление.
- Устройство профиля — что лежит в
profiles/. - Маршруты — как работают опубликованные версии маршрутов.
- Плагины — установка и устройство пакетов.
- Трекеры задач — драйверы в
drivers/. - Базы данных — профили подключений и внешние движки.