Файлы

Приложение «Файлы» — проводник рабочего пространства. Оно позволяет открывать папки, просматривать и редактировать поддерживаемые форматы, загружать и скачивать файлы, а также передавать их агенту.

Навигация

• Нажмите папку, чтобы перейти внутрь.
• Используйте хлебные крошки или кнопку «Назад» для возврата.
• Кнопка «На главную» открывает корень рабочего пространства.
• Недавние папки помогают быстро вернуться к последним проектам.
• Переключатель вида меняет карточки на список.
• Сортировка располагает элементы по времени изменения.

Поиск

Введите часть имени в поле поиска. Поиск помогает найти файл во всём доступном пространстве, а не только визуально просматривать длинный каталог.

Если результатов слишком много, добавьте расширение или более точную часть названия.

Создание и загрузка

Через кнопку Добавить или меню действий можно:

• создать файл;
• создать папку;
• загрузить файл с устройства;
• скачать текущую папку как ZIP.

Перед созданием проверьте текущий путь: новый элемент появится именно в открытой папке.

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

Доступные действия зависят от формата:

• просмотр текста, изображений, видео, документов и таблиц;
• редактирование поддерживаемых текстовых форматов;
• сохранение изменений;
• скачивание;
• переименование;
• просмотр информации;
• прикрепление к сообщению агенту.

Большой файл помечается красным индикатором. Файлы больше 10 МБ могут открываться или передаваться медленнее.

Передача агенту

Нажмите Прикрепить, чтобы добавить файл к сообщению. Агент получит путь и содержимое в поддерживаемом формате.

Прикладывайте только релевантные материалы. Для большой папки лучше назвать агенту конкретные файлы или попросить сначала изучить структуру.

Инструкции и CLI для агента

Отдельной focused-инструкции с topic files и отдельного CLI promto-files нет. Для работы с файлами главный агент использует:

• Promto Runtime Rules — topic runtime;
• Promto UI Markers And User-Facing Paths — topic ui_markers, когда нужно вернуть ссылку OpenFile.

Инструкции загружаются встроенным get_instruction({ topic: "runtime" }), а не shell-командой. Обычные файлы агент читает, ищет и изменяет своими файловыми инструментами. Для двух специальных операций используются встроенные инструменты Promto:

• promto_disk — проверить свободное место и самые объёмные каталоги;
• promto_asset — загрузить готовый медиафайл и получить публичный URL.

В терминале их аналоги называются promto disk, promto disk top [путь] [количество] и promto asset upload <файл> [--content-type <тип>] [--json]. Перед началом терминальный агент может загрузить общий контракт через promto instructions.

Готовый промпт для агента

Сначала вызови get_instruction по теме runtime. Найди фактический путь и выполни задачу только с указанными файлами: <опишите действие и пути>. Не создавай дубликаты и не меняй соседние файлы без необходимости. Если места может не хватить, проверь его через promto_disk; если нужен публичный URL готового медиафайла, используй promto_asset. Перед итогом загрузи ui_markers и верни OpenFile для каждого результата, а также перечисли выполненные проверки.

Удаление и корзина

Удаление из контекстного меню может быть необратимым и требует подтверждения. Отдельное представление «Корзина» позволяет:

• восстановить файл;
• окончательно очистить удалённые элементы.

Некоторые системные элементы защищены от удаления и переименования.

Файлы .git, .gitignore, .mcp.json и promto.yaml защищены от открытия, переименования, удаления и публикации. Не обходите эту защиту через другие интерфейсы.

Скачивание и режим IDE могут требовать активной подписки.

Режим IDE

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

Если файл не открывается

1. Обновите список файлов.
2. Проверьте, что файл не был перемещён или удалён агентом.
3. Убедитесь, что выбран файл, а не папка.
4. Для неподдерживаемого формата скачайте файл и откройте его локальным приложением.
5. Не создавайте дубликат, пока не проверили фактический путь.