files

name	files
description	Работа с файлами: поиск, чтение, запись, копирование, PDF, отправка
tools	["file_search","file_read","file_list","file_write","file_delete","file_open","file_send","file_pdf","file_copy"]
trigger_keywords	["файл","файлы","папка","папки","директория","каталог","найди файл","прочитай файл","открой файл","создай файл","скопируй","удали файл","покажи файлы","что на рабочем столе","рабочий стол","desktop","документы","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 — путь к PDF
• max_pages — лимит страниц (по умолчанию 50)

file_copy

Копирование файла.

• source — откуда
• destination — куда

Правила

1. Безопасность: НИКОГДА не удаляй файлы без явной просьбы пользователя
2. Пути: разрешён доступ только к домашней директории пользователя и вложенным папкам
3. Запрещённые файлы: НЕ читай и НЕ показывай .env, credentials, файлы с токенами/паролями
4. Удаление: используй file_delete ТОЛЬКО когда пользователь напрямую сказал "удали"
5. Большие файлы: если файл больше 200 строк, покажи первые строки и спроси — показать полностью?
6. Навигация: если пользователь говорит "рабочий стол" → домашняя директория + /Desktop
7. PDF: для PDF файлов используй file_pdf, не file_read
8. Отправка: если просят "скинь", "отправь", "пришли" файл → file_send