> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velesagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Рабочие папки

> Как объединять чаты и файлы по отдельным рабочим папкам в Велесе.

Рабочая папка объединяет материалы одной темы и все созданные из неё чаты. Велес хранит такие папки в общей рабочей области по пути `docs/work-folders/<название>`, а Nerve только показывает их и передаёт команды шлюзу. Поэтому одна и та же папка доступна при локальном запуске, в контейнере и при удалённом подключении.

## Создание папки и чата

1. Откройте левую панель **Файлы**.
2. Раскройте секцию **Рабочие папки**.
3. Нажмите кнопку создания и укажите название.
4. Нажмите кнопку нового чата рядом с нужной папкой.
5. В обычном окне выберите личность и создайте диалог.

Связь задаётся только при создании чата и сохраняется по устойчивому идентификатору папки. Уже существующий чат нельзя подключить к папке или перенести в другую папку. Связанный чат остаётся виден и в общем списке сессий.

В представлении **Чаты** используются те же строки, что и в общем списке сессий: с заголовком, источником, временем последнего обновления, выделением активного чата и меню действий. Список занимает всю доступную ширину без дополнительных полей по краям. Меню выводится поверх панели и не обрезается её границами. Переименование или удаление чата из этого списка действует на ту же запись сессии.

Связанные диалоги также можно искать прямо в панели **Сессии**. Переключитесь в режим **Папки**: Nerve соберёт диалоги по названиям рабочих папок, расположит папки по алфавиту, а внутри каждой группы покажет сначала недавно обновлённые диалоги. Группы можно сворачивать. Поиск проверяет и название папки, и название диалога; если совпало название папки, показываются все её диалоги. Этот список не создаёт отдельную копию связи и получает названия папок от Велеса.

## Работа с файлами

В раскрытой папке доступны два представления: **Чаты** и **Файлы**. В представлении файлов можно:

* создавать подпапки через контекстное меню корня или выбранного каталога;
* загружать файлы через это же контекстное меню или перетаскиванием;
* открывать и скачивать файлы;
* переименовывать и удалять элементы через контекстное меню;
* перемещать элементы мышью между подпапками одной рабочей папки.

Внутри переключателя **Файлы** справа от названия находится кнопка обновления дерева выбранной рабочей папки. Внизу дерева всегда видна область **Перетащите файлы для загрузки**. Эта надпись служит и доступным названием области; отдельная подсказка от прежней кнопки загрузки не используется. Перетащите файлы на неё или нажмите саму область, чтобы выбрать файлы и добавить их в корень рабочей папки. На узком экране действия с файлом или каталогом открываются кнопкой с тремя точками в соответствующей строке. Корневое контекстное меню по-прежнему можно открыть правой кнопкой по области загрузки.

Перемещение между разными рабочими папками не поддерживается. Если имя загружаемого файла уже занято, Велес добавляет числовой суффикс и не перезаписывает существующий файл. Вложения, добавленные через связанный чат, всегда попадают в корень его рабочей папки; выбранный браузером путь не может изменить это правило.

## Как рабочая папка влияет на агента

В связанном чате Велес сначала ищет материалы в рабочей папке и по умолчанию создаёт там обычные результаты. Доступ к остальной рабочей области сохраняется. Явный путь в запросе пользователя, подтверждённая папка результата проекта и служебные каталоги Велеса имеют более высокий приоритет. Подагенты наследуют рабочую папку родительского чата.

## Переименование и удаление

Название папки и имена элементов проверяются по переносимым правилам Windows и POSIX. Велес запрещает зарезервированные имена, опасные символы, выход за пределы папки и перезапись существующего пути. После переименования или перемещения он обновляет структурированные ссылки вложений и состояния проектов; при ошибке файловая операция откатывается.

Удаление рабочей папки необратимо. Для подтверждения нужно ввести её точное название. Велес отменяет активные ответы и проекты связанных чатов, затем удаляет все связанные истории, включая ранее скрытые, состояния проектов и содержимое папки независимо от обычной настройки скрытия сессий. Чистый чат, который появляется после скрытия связанной истории, не наследует рабочую папку и не считается ещё одним связанным чатом. Операция использует служебный журнал восстановления, чтобы перезапуск не оставил частично удалённую папку.

<Warning>
  Перед каскадным удалением скачайте нужные материалы. Восстановить удалённые файлы и чаты через интерфейс нельзя.
</Warning>