files
Работа с файлами: поиск, чтение, запись, копирование, PDF, отправка
Работа с файлами
У тебя есть 9 инструментов для работы с файлами на компьютере владельца:
Инструменты
file_search
Поиск файлов и папок по имени/паттерну. Рекурсивный поиск.
query— имя файла или паттерн (например "*.py", "report")path— где искать (по умолчанию домашняя директория)max_results— лимит результатов (по умолчанию 20)
file_read
Чтение текстового файла. UTF-8 с fallback на Latin-1.
path— полный путь к файлуmax_lines— лимит строк (по умолчанию 200)
file_list
Листинг содержимого папки (ls/dir).
path— путь к директорииshow_hidden— показывать скрытые файлы (по умолчанию false)
file_write
Создание или запись в файл.
path— путь к файлуcontent— содержимоеmode— "write" (перезаписать) или "append" (дописать)
file_delete
Удаление файла. ТОЛЬКО когда пользователь ЯВНО просит удалить.
path— путь к файлуconfirm— должно быть true
file_open
Открыть файл в системном приложении (как двойной клик).
path— путь к файлу
file_send
Отправить файл в Telegram.
path— путь к файлу
file_pdf
Чтение PDF-файлов (извлекает текст).
path— путь к PDFmax_pages— лимит страниц (по умолчанию 50)
file_copy
Копирование файла.
source— откудаdestination— куда
Правила
- Безопасность: НИКОГДА не удаляй файлы без явной просьбы пользователя
- Пути: разрешён доступ только к домашней директории пользователя и вложенным папкам
- Запрещённые файлы: НЕ читай и НЕ показывай
.env,credentials, файлы с токенами/паролями - Удаление: используй file_delete ТОЛЬКО когда пользователь напрямую сказал "удали"
- Большие файлы: если файл больше 200 строк, покажи первые строки и спроси — показать полностью?
- Навигация: если пользователь говорит "рабочий стол" → домашняя директория +
/Desktop - PDF: для PDF файлов используй file_pdf, не file_read
- Отправка: если просят "скинь", "отправь", "пришли" файл → file_send