Файлы
Где лежат файлы воркспейса, как их загружать (в том числе целыми папками), открывать, скачивать и удалять, как увидеть веб-страницу в готовом виде и поменять в ней слова, как сохранить файл в PDF, как каждое изменение сохраняется версией, которую можно сравнить и восстановить, какие есть ограничения и как агент показывает файлы в ответах.
У каждого проекта своя папка с файлами. Агент работает прямо в ней: читает то, что ты загрузил, и кладёт туда то, что сделал.
Панель «Файлы»
Кнопка Файлы в шапке открывает дерево файлов справа от чата. Оно показывает папку текущего проекта (или оркестратора) и остаётся открытым при переходах между экранами. На телефоне панель открывается поверх чата.
В дереве:
- выделен открытый файл и текущая папка;
- папки раскрываются по клику и остаются раскрытыми, когда ты переходишь в другой чат или на другой экран;
- у каждой папки есть кнопки: загрузить файлы, загрузить папку, скачать архивом .zip, новый файл, новая папка; верхняя строка (
/) скачивает всю папку воркспейса; - у каждого файла — открыть, скачать и удалить.
Клик по файлу открывает его в этой же панели, рядом с чатом, так что разговор остаётся перед глазами: текст и код можно прочитать и отредактировать в редакторе с номерами строк и подсветкой (Сохранить или Cmd/Ctrl+S), веб-страницу — увидеть в готовом виде (см. Страницы), картинку — посмотреть, аудио — прослушать. Панель расширяется под файл — ширину меняет перетаскивание её левого края, она запоминается. Стрелка возвращает к дереву, а Открыть на всю страницу показывает файл на отдельном экране. Так же открываются путь к файлу, который агент назвал в ответе, и файл из списка под ответом; Cmd/Ctrl-клик открывает полную страницу в новой вкладке.
Загрузка
- Файлы — кнопкой у нужной папки или перетаскиванием на папку.
- Папка целиком — кнопкой «загрузить папку»: переносится вся структура вложенных папок, как на компьютере. Выбор папки есть в браузерах на компьютере; на iPhone кнопка выбирает файлы.
- В чат — вложения сообщения хранятся вместе с чатом. Если файл нужен для всей работы, а не одного разговора, загрузи его в проект.
Если файл с таким именем уже есть, Eggent спросит, заменить ли его.
Открыть и скачать
- Открыть — веб-страницы (
.html), PDF и картинки открываются в новой вкладке уже в готовом виде. Это удобно, когда агент собрал сайт или отчёт: его можно сразу посмотреть. Страница открывается в изолированном режиме и не имеет доступа к твоему воркспейсу. - Скачать — любой файл скачивается кнопкой скачивания. Имена на русском и других языках сохраняются.
Страницы
Веб-страница (.html) открывается в готовом виде, со стилями и картинками из папки рядом с ней; кнопка Код переключает на исходник. Страница показывается изолированно: её скрипты работают, но не могут добраться до твоего воркспейса или что-то куда-то отправить.
- Выбрать позволяет указать на часть страницы: щелчок выбирает блок, и агент рядом с чатом видит именно этот кусок файла — так что «сделай этот заголовок короче» относится к нему. Показать в коде находит его в исходнике.
- Двойной щелчок меняет слова блока прямо на странице; Enter сохраняет, Esc отменяет. В файле меняются только эти слова — всё остальное остаётся как было, байт в байт, — а правка становится версией в истории файла. Всё остальное (новый блок, стиль) — через агента или в коде.
- Если файл изменился, пока страница была открыта, она показывается заново и ничего не записывается.
Сохранить в PDF
Кнопка с принтером рядом с файлом открывает копию для печати и диалог печати браузера: выбери Сохранить как PDF. Веб-страница печатается такой, как выглядит на экране: всё, что появляется при прокрутке, показано, анимации остановлены, шапка, которая держится на экране, отпущена, чтобы не закрывать каждую страницу, фон сохранён, а блок по возможности не разрезается между двумя страницами. Markdown печатается как документ, остальной текст — как есть.
Общий доступ и согласование
В воркспейсе, который входит в компанию, у панели и страницы файла ещё две кнопки: Поделиться открывает файл коллегам для просмотра, комментариев или правки (Общие файлы), а Согласование отправляет коллегам по порядку на согласование версию, которая в файле сейчас (Согласования). Строка над файлом говорит, когда он открыт коллегам или на согласовании.
Папка одним архивом
Кнопка архива у папки (и у верхней строки, которая означает весь проект) скачивает её одним файлом .zip: структура, имена на русском и других языках и признак исполняемого файла сохраняются. Архив собирается по мере отправки, поэтому большая папка не нагружает воркспейс.
- Файлы с секретами в архив не попадают: файлы
.env,.mcp.json,auth.json, файлы ключей и сертификатов (.pem,.key,.p12), облачные учётные данные (credentials.json, ключи сервисных аккаунтов,kubeconfig,*.tfvars) и папки, созданные для их хранения (.ssh,.aws,.kube), — в том числе когда ты сам указываешь такую папку. После скачивания из карточки ответа страница говорит, сколько файлов осталось за бортом. - Не попадают и зависимости с рабочим состоянием агента (
node_modules,.git,.venv,.pi). Ссылки за пределы папки никогда не раскрываются, файл, у которого есть и другое имя в другом месте, пропускается, а файл, который исчез или был подменён ссылкой, пока архив отправлялся, пропускается, а не обрывает скачивание. - Предел — 1 ГБ и 10 000 файлов на архив; если больше, кнопка скажет об этом, и скачать нужно по частям. За раз готовится один архив: второй попросит повторить через минуту.
Файлы в ответах агента
Когда агент в ответе упоминает файл, который существует, путь становится ссылкой — не нужно искать его в дереве. Аудиофайлы (mp3, ogg, wav, m4a и другие) проигрываются прямо в ответе: кнопка воспроизведения, длительность и прогресс. Картинки, которые агент вставил в ответ, показываются в чате.
Файлы, которые сделал ответ
Если ответ сделал файлы, под ним появляется их список: файлы, которые он назвал, файлы, которые записали его инструменты, и — когда он запускал команды и больше ничто не указывает на результат — то, что появилось в папке нового. У каждой строки есть открыть (для страниц, PDF и картинок), скачать и, если подключён Telegram, отправить в Telegram: файл придёт в твой чат. Если файлов больше пяти, остальные считаются, а Скачать все архивом .zip забирает всё сразу.
Список намеренно осторожный: только обычные файлы, записанные во время этого ответа, внутри папки, где шла работа; никогда — заметки, навыки и инструменты самого агента и никогда — файлы с секретами. Если файл потом удалили, его строка пропадает. Правки уже существовавших файлов попадают в список, только если ответ их называет. То, что проект сделал по запросу @проект, показывается под ответом того чата, который спрашивал.
История файла
Каждое изменение документа или текстового файла в проекте сохраняется версией, кто бы его ни сделал: ты, когда сохраняешь файл в редакторе, агент, когда пишет его или запускает команду, которая его переписывает, загрузка, которая его заменяет, или синхронизация, которая принесла копию, исправленную на компьютере. История начинается с первой правки файла, и то, что в нём было прямо перед ней, тоже сохраняется; у файла, который только создали или загрузили, возвращаться пока не к чему, и места он лишнего не занимает. Кнопка с часами в шапке открытого файла (История на отдельной странице файла) показывает версии, новые сверху, и у каждой — кто её сделал: Вы, Агент с чатом, в котором он работал, Загружен, Изменён вне редактора (синхронизация, терминал или другая программа).
- Сравнить. Выбери версию, и увидишь, что изменилось по сравнению с предыдущей; можно сравнить её и с файлом как он есть сейчас, и с любой другой версией. Текст показывает новую формулировку, а старые слова зачёркнуты прямо в ней — так читается отредактированный документ; Строки показывают старые строки над новыми, с номерами, — так удобнее для кода. Неизменённые части свёрнуты, а стрелки (или Alt+↑ / Alt+↓) переходят от одного изменения к следующему.
- Восстановить. Восстановить возвращает версию. То, что было в файле до этого, тоже сохраняется, так что и восстановление можно отменить. Исключение — файл, который с тех пор вырос больше 10 МБ или не читается: над списком версий об этом сказано, и восстановление сначала спрашивает, потому что заменённое сохранить нельзя.
- Скачать сохраняет любую версию отдельным файлом с её номером, например
договор (v3).docx.
Документы (.docx, .xlsx, .pptx, .odt) сравниваются по тексту внутри: абзацы, строки таблиц, слайды, строки листа. Оформление не сравнивается. У картинок, записей, архивов и PDF истории нет, как и у заметок и навыков самого агента, папок с зависимостями, файлов с секретами и общих папок компании (это файлы компании, а не воркспейса).
Каждая версия хранится 30 дней после того, как её заменила более новая, потом по одной в день до 90 дней, и не больше 200 на файл. История учитывается в месте на диске воркспейса и никогда не занимает больше его четверти: сверх этого первыми уходят версии, заменённые раньше всех, а когда диск почти заполнен, история сжимается, чтобы освободить место самим файлам. Настройки → Общие → История версий файлов показывает, сколько она занимает, удаляет версии старше недели или всю историю и выключает её. Историю одного файла можно удалить прямо из её списка.
Агент тоже читает историю: спроси, что поменялось в документе со вчерашнего дня, или попроси вернуть прежнюю версию. Когда файл открыт рядом с чатом, агент понимает, о каком файле речь, — см. «Чаты».
Удаление
Кнопка удаления у файла или папки удаляет их после подтверждения. Удаление папки удаляет всё внутри. Файл, удалённый здесь, уходит вместе со своей историей. Если включена синхронизация с компьютером, удалённые файлы 30 дней хранятся в корзине синхронизации.
Место на диске
В облаке у воркспейса ограниченный диск: на пробном периоде 100 МБ, на тарифах больше. История файлов тоже в нём учитывается. Когда диск заполнен на три четверти, в боковой панели появляется предупреждение. Если диск заполнен полностью, агент перестаёт отвечать, но панель Файлы работает — удали лишнее, и работа продолжится со следующего сообщения. Подробнее — в «Тарифы и баланс».
На своём сервере место ограничено только диском машины.
Где физически лежат файлы
| Что | Путь внутри воркспейса |
|---|---|
| Файлы проекта | data/projects/<id-проекта>/ |
| Файлы оркестратора | data/projects/ (рядом с папками проектов) |
| Вложения чатов | data/chat-files/<id-чата>/ |
| Версии файлов | data/versions/ |
Полное устройство — в «Устройство воркспейса».