APP-4882 - fix misleading oversized-file read error — субагент
Субагент APP-4882 - fix misleading oversized-file read error для Claude Code исправляет сообщения о сбоях чтения больших файлов. Он подключается к задачам по read_files, get_files и search_codebase.
AGPL-3.0 ★ 720 обновлён 2026-11-10
.claude/agents/APP-4882---fix-misleading-oversized-file-read-error.mdЧто делает APP-4882 - fix misleading oversized-file read error
Субагент исправляет классификацию ошибок при чтении локальных файлов. Вместо общего сообщения он различает отсутствующий файл, превышение лимита и сбой обработки изображения. Для файла больше 1 MB сообщение содержит его размер и лимит, а для отсутствующего пути остаётся отдельная причина.
Изменение охватывает read_files, get_files и search_codebase: они используют общий помощник describe_failed_files, который собирает путь и причину для каждого сбоя. Частично успешное чтение сохраняется, а удалённый путь получает тот же текст через proto. Успешное чтение, усечение и бюджетирование файлов не меняются.
Какие задачи решает
- исправить сообщение для существующего файла больше 1 MB
- различить отсутствующий файл и сбой обработки изображения
- показать причины всех ошибок в смешанной пачке файлов
- синхронизировать сообщения в
read_files,get_filesиsearch_codebase
Примеры запросов агенту
- Подключи субагент APP-4882 - fix misleading oversized-file read error и исправь ошибку чтения слишком большого файла.
- Проверь, чтобы
read_files,get_filesиsearch_codebaseпоказывали отдельные причины для каждого сбоя. - Обнови обработку
BinaryFileReadResult, не меняя успешное чтение и лимит 1 MB.
Как установить APP-4882 - fix misleading oversized-file read error
Вручную: положить файлы
.claude/agents/APP-4882---fix-misleading-oversized-file-read-error.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/APP-4882---fix-misleading-oversized-file-read-error.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/APP-4882---fix-misleading-oversized-file-read-error.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы об APP-4882 - fix misleading oversized-file read error
Как установить APP-4882 - fix misleading oversized-file read error в Claude Code?
Добавьте файл .claude/agents/APP-4882---fix-misleading-oversized-file-read-error.md в каталог агентов Claude Code.
Что делает APP-4882 - fix misleading oversized-file read error?
Субагент заменяет общее сообщение об отсутствующем файле на отдельные причины: файл не найден, файл слишком велик или изображение не удалось обработать. Те же причины используются тремя инструментами чтения.
Как APP-4882 обрабатывает файл больше лимита?
Существующий файл больше 1 MB получает сообщение с его размером и допустимым лимитом. Причина передаётся отдельно от пути, поэтому итоговый текст не дублирует имя файла.