# Файлы на компьютере

> Как сделать так, чтобы папка проектов облачного Eggent лежала у тебя на компьютере как обычная папка и синхронизировалась в обе стороны через Syncthing.

Source: https://eggent.ai/r/docs/file-sync/

Папку проектов облачного воркспейса можно держать у себя на компьютере как обычную папку: меняешь здесь — меняется там, и наоборот. Работает через **Syncthing** — бесплатную программу с открытым кодом.

> [!NOTE]
> Если пользуешься [приложением Eggent для Mac](https://eggent.ai/r/docs/desktop-app.md), всё это не нужно: приложение само держит файлы, чаты и память агента в одном состоянии с облаком ([как](https://eggent.ai/r/docs/desktop-cloud.md)).

Зачем это нужно:

- открывать результаты агента в привычных программах: Word, Excel, Obsidian, редакторе кода;
- класть материалы в папку на компьютере, а не загружать их через браузер;
- держать копию всех файлов у себя.

## Что синхронизируется {#what}

Только **папка проектов** (`data/projects`): файлы оркестратора и все проекты. Не синхронизируются чаты, настройки, ключи и служебные папки (`.pi`, `node_modules`), а также `.mcp.json`, потому что в нём бывают токены.

Синхронизация работает, **даже когда воркспейс спит**.

## Подключить компьютер {#setup}

Открой `https://cloud.eggent.ai/sync/имя` и войди тем же email и паролем, что и в воркспейс. Дальше четыре шага, по одному разу на устройство:

1. **Установи Syncthing** с [syncthing.net](https://syncthing.net/downloads/) и оставь работать в фоне.
2. **Скажи нам ID своего устройства.** В Syncthing: **Actions → Show ID**, скопируй длинный код и вставь на странице.
3. **Добавь сервер в Syncthing.** В Syncthing нажми **Add Remote Device** и вставь ID сервера со страницы. Отметь галочку, что добавил, и нажми **Подключить**.
4. **Прими папку.** Через минуту Syncthing на компьютере предложит папку. Прими её и выбери, где она будет лежать на диске.

> [!TIP]
> Если предложение папки пропало, **не создавай новую папку**: у неё будет другой ID, и стороны не найдут друг друга. Добавь папку вручную, вставь в поле **Folder ID** значение «ID папки» со страницы синхронизации и поделись ею с сервером.

## Если не подключается {#troubleshooting}

- Подожди минуту: устройства находят друг друга не мгновенно.
- Если связи так и нет, открой в Syncthing настройки устройства-сервера, вкладку **Advanced**, и впиши в поле **Addresses** адрес сервера, указанный на странице синхронизации.
- Проверь статус на странице синхронизации: «Синхронизировано», «Синхронизируется, N%», «Не в сети, последний раз …» или «Ждём первого подключения».

## Несколько устройств {#devices}

На той же странице — **Подключённые устройства**. Можно подключить ещё компьютер или отключить старый. При отключении уже скачанные файлы остаются на устройстве.

## Удалённые файлы и корзина {#trash}

Файлы, удалённые или перезаписанные при синхронизации, 30 дней хранятся в корзине Syncthing (папка `.stversions`). Её не видно в панели файлов Eggent.

## Когда тариф неактивен {#inactive}

Если пробный период или тариф закончились, синхронизация продолжает **отдавать** файлы на компьютер, но перестаёт **принимать** изменения с него. На странице синхронизации это видно. После оплаты синхронизация снова работает в обе стороны.
