Вложения

Как приложить

Приложите локальный файл и попросите агента им воспользоваться. В Desktop и веб-клиенте — «Прикрепить файл», вставка файла или перетаскивание в поле ввода.

Сделай резюме приложенного README.md и перечисли шаги настройки.

Выбор файлов в Desktop — до 20 МиБ суммарно; другие интерфейсы могут иметь свои, более низкие лимиты.

В терминале файл прикладывается упоминанием @путь/файл в запросе (TUI); zubrcode run --file <путь> — для одной команды.

Форматы

Сессии 2.x показывают модели такие типы вложений:

Вход	Что получает модель	Пример
Текстовый файл UTF-8	имя файла и текст	`README.md`
Каталог	нерекурсивный список файлов и подкаталогов	`file:///home/me/`
PNG, JPEG, GIF или WebP	изображение	`diagram.png`

SVG считается текстом. PDF, AVIF, BMP, аудио, видео и другие бинарные вложения в запрос модели не попадают: сначала преобразуйте их в текст или поддерживаемое изображение (например, выгрузите страницу PDF как page-1.png). Тип определяется по байтам, так что переименование файла ситуацию не исправит.

Каждое вложение читается до приёма запроса: отвергаются некорректные URL, нечитаемые пути, не файлы и не каталоги, а также распакованные вложения больше 20 МиБ.

Изображения

Нормализация изображений настраивается в opencode.json или opencode.jsonc:

{
  "media": {
    "image": {
      "auto_resize": true,
      "max_width": 2000,
      "max_height": 2000,
      "max_base64_bytes": 5242880
    }
  }
}

Поле	По умолчанию	Поведение
`auto_resize`	`true`	уменьшать изображение сверх лимита; `false` — отклонять
`max_width`	`2000`	максимальная ширина в пикселях
`max_height`	`2000`	максимальная высота в пикселях
`max_base64_bytes`	`5242880`	максимум байт в Base64-кодировке

Настройки действуют и на изображения в запросах, и на картинки, которые возвращает инструмент read. При auto_resize: true пропорции сохраняются, изображение уменьшается до лимитов по сторонам, затем пробуются всё более мелкие кодировки PNG и JPEG до лимита Base64 — итоговый формат может измениться. Если ни одна кодировка не подходит, обработка падает; при auto_resize: false изображение сверх любого лимита отклоняется сразу.

Если ресайзер недоступен, изображение проходит как есть — настройки являются лимитами обработки, а не границей безопасности.

Лимиты

Лимит	Значение
Прямое вложение	20 МиБ распакованных на элемент; клиенты могут ставить меньше
Выбор файлов в Desktop	20 МиБ суммарно
`max_base64_bytes`	только кодировка Base64, без полного `data:` URL
Лимиты провайдера	применяются после обработки ZubrCode
Текстовые вложения	не требуют мультимодальной модели
Чтение через `read`	свои лимиты страниц и обрезки

Тот, что клиент принял файл, ещё не значит, что его содержимое дойдёт до модели: вложение должно быть в видимом для модели формате и укладываться в лимиты ZubrCode и провайдера.