cc-viewer 1.6.182 → 1.6.183

package/concepts/ru/Tool-Glob.md

@@ -1,39 +1,35 @@
 # Glob
 
-## Определение
+Сопоставляет имена файлов с glob-паттерном и возвращает пути, отсортированные по времени последнего изменения (от новых к старым). Оптимизирован для быстрого поиска файлов в кодовых базах любого размера без вызова `find`.
 
-Быстрый инструмент сопоставления шаблонов имён файлов, поддерживающий кодовые базы любого размера. Возвращает совпавшие пути файлов, отсортированные по времени модификации.
+## Когда использовать
 
-## Параметры
+- Перечисление всех файлов определённого расширения (например, все `*.ts` под `src`)
+- Поиск конфигурационных или фикстурных файлов по соглашениям об именовании (`**/jest.config.*`, `**/*.test.tsx`)
+- Сужение области поиска перед прицельным `Grep`
+- Проверка, существует ли уже файл по известному паттерну, перед вызовом `Write`
+- Поиск недавно изменённых файлов с опорой на порядок по времени изменения
 
-| Параметр | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `pattern` | string | Да | Шаблон glob (например, `**/*.js`, `src/**/*.ts`) |
-| `path` | string | Нет | Каталог поиска, по умолчанию текущий рабочий каталог. Не передавайте "undefined" или "null" |
+## Параметры
 
-## Сценарии использования
+- `pattern` (string, обязательный): glob-выражение для сопоставления. Поддерживает `*` для односегментных подстановок, `**` для рекурсивных совпадений и `{a,b}` для альтернатив, например `src/**/*.{ts,tsx}`.
+- `path` (string, необязательный): каталог для поиска. Должен быть валидным путём каталога, если указан. Полностью опустите поле, чтобы искать в текущем рабочем каталоге. Не передавайте строки `"undefined"` или `"null"`.
 
-**Подходящее применение:**
-- Поиск файлов по шаблону имени
-- Поиск всех файлов определённого типа (например, всех файлов `.tsx`)
-- Локализация файлов при поиске определения класса (например, `class Foo`)
-- Можно параллельно отправлять несколько вызовов Glob в одном сообщении
+## Примеры
 
-**Неподходящее применение:**
-- Поиск содержимого файлов — следует использовать Grep
-- Открытое исследование, требующее нескольких раундов поиска — следует использовать Task (тип Explore)
+### Пример 1: все файлы TypeScript
+Вызовите `Glob` с `pattern: "src/**/*.ts"`. Результат — список, отсортированный по mtime, так что наиболее недавно изменённые файлы идут первыми, что удобно для фокусировки на горячих точках.
 
-## Примечания
+### Пример 2: поиск кандидата на определение класса
+Если вы подозреваете, что класс живёт в файле с неизвестным вам именем, ищите с `pattern: "**/*UserService*"`, чтобы сузить кандидатов, затем действуйте через `Read` или `Grep`.
 
-- Поддерживает стандартный синтаксис glob: `*` соответствует одному уровню, `**` — нескольким уровням, `{}` — множественному выбору
-- Результаты отсортированы по времени модификации
-- Более рекомендуется, чем команда `find` в Bash
+### Пример 3: параллельное обнаружение перед крупной задачей
+В одном сообщении сделайте несколько вызовов `Glob` (например, один для `**/*.test.ts` и один для `**/fixtures/**`), чтобы они выполнялись параллельно, а их результаты можно было сопоставить.
 
-## Оригинальный текст
+## Примечания
 
-<textarea readonly>- Fast file pattern matching tool that works with any codebase size
-- Supports glob patterns like "**/*.js" or "src/**/*.ts"
-- Returns matching file paths sorted by modification time
-- Use this tool when you need to find files by name patterns
-- When you are doing an open ended search that may require multiple rounds of globbing and grepping, use the Agent tool instead
-- You can call multiple tools in a single response. It is always better to speculatively perform multiple searches in parallel if they are potentially useful.</textarea>
+- Результаты упорядочены по времени изменения файла (сначала новые), а не по алфавиту. Сортируйте после, если нужен стабильный порядок.
+- Паттерны обрабатываются инструментом, а не shell; вам не нужно их экранировать или кавычить, как в командной строке.
+- Для открытого исследования, требующего нескольких раундов поиска и рассуждений, делегируйте `Agent` с типом агента Explore вместо цепочки множества вызовов `Glob`.
+- Предпочитайте `Glob` вызовам `find` или `ls` через `Bash` для поиска по именам файлов; он стабильно обрабатывает права и возвращает структурированный вывод.
+- Для поиска содержимого внутри файлов вместо имён используйте `Grep`.

package/concepts/ru/Tool-Grep.md

@@ -1,57 +1,46 @@
 # Grep
 
-## Определение
+Ищет по содержимому файлов с помощью движка ripgrep. Полная поддержка регулярных выражений, фильтрация по типу файла и три режима вывода, позволяющие балансировать между точностью и компактностью.
 
-Мощный инструмент поиска по содержимому на основе ripgrep. Поддерживает регулярные выражения, фильтрацию по типам файлов и несколько режимов вывода.
+## Когда использовать
+
+- Поиск всех мест вызова функции или всех ссылок на идентификатор
+- Проверка, встречается ли строка или сообщение об ошибке где-либо в кодовой базе
+- Подсчёт вхождений паттерна для оценки масштаба перед рефакторингом
+- Сужение поиска до типа файлов (`type: "ts"`) или glob (`glob: "**/*.tsx"`)
+- Извлечение многострочных совпадений, таких как многострочные определения структур или блоки JSX, с `multiline: true`
 
 ## Параметры
 
-| Параметр | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `pattern` | string | Да | Шаблон поиска регулярного выражения |
-| `path` | string | Нет | Путь поиска (файл или каталог), по умолчанию текущий рабочий каталог |
-| `glob` | string | Нет | Фильтр имён файлов (например, `*.js`, `*.{ts,tsx}`) |
-| `type` | string | Нет | Фильтр типа файла (например, `js`, `py`, `rust`), эффективнее чем glob |
-| `output_mode` | enum | Нет | Режим вывода: `files_with_matches` (по умолчанию), `content`, `count` |
-| `-i` | boolean | Нет | Поиск без учёта регистра |
-| `-n` | boolean | Нет | Отображение номеров строк (только режим content), по умолчанию true |
-| `-A` | number | Нет | Количество строк, отображаемых после совпадения |
-| `-B` | number | Нет | Количество строк, отображаемых перед совпадением |
-| `-C` / `context` | number | Нет | Количество строк, отображаемых до и после совпадения |
-| `head_limit` | number | Нет | Лимит количества результатов, по умолчанию 0 (без лимита) |
-| `offset` | number | Нет | Пропуск первых N результатов |
-| `multiline` | boolean | Нет | Включение многострочного режима сопоставления, по умолчанию false |
-
-## Сценарии использования
-
-**Подходящее применение:**
-- Поиск определённых строк или шаблонов в кодовой базе
-- Нахождение мест использования функций/переменных
-- Фильтрация результатов поиска по типу файла
-- Подсчёт совпадений
-
-**Неподходящее применение:**
-- Поиск файлов по имени — следует использовать Glob
-- Открытое исследование, требующее нескольких раундов поиска — следует использовать Task (тип Explore)
+- `pattern` (string, обязательный): регулярное выражение для поиска. Использует синтаксис ripgrep, поэтому буквальные фигурные скобки нужно экранировать (например, `interface\{\}` для поиска `interface{}`).
+- `path` (string, необязательный): файл или каталог для поиска. По умолчанию — текущий рабочий каталог.
+- `glob` (string, необязательный): фильтр имён файлов, например `*.js` или `*.{ts,tsx}`.
+- `type` (string, необязательный): сокращение по типу файла, например `js`, `py`, `rust`, `go`. Эффективнее `glob` для стандартных языков.
+- `output_mode` (enum, необязательный): `files_with_matches` (по умолчанию, возвращает только пути), `content` (возвращает совпавшие строки) или `count` (возвращает подсчёты совпадений).
+- `-i` (boolean, необязательный): нечувствительное к регистру сопоставление.
+- `-n` (boolean, необязательный): включать номера строк в режиме `content`. По умолчанию `true`.
+- `-A` (number, необязательный): строк контекста после каждого совпадения (требует режима `content`).
+- `-B` (number, необязательный): строк контекста перед каждым совпадением (требует режима `content`).
+- `-C` / `context` (number, необязательный): строк контекста с обеих сторон каждого совпадения.
+- `multiline` (boolean, необязательный): разрешить паттернам пересекать переводы строк (`.` совпадает с `\n`). По умолчанию `false`.
+- `head_limit` (number, необязательный): ограничить возвращаемые строки, пути файлов или записи подсчётов. По умолчанию 250; передайте `0` для неограниченного (используйте экономно).
+- `offset` (number, необязательный): пропустить первые N результатов перед применением `head_limit`. По умолчанию `0`.
+
+## Примеры
+
+### Пример 1: найти все места вызова функции
+Задайте `pattern: "registerHandler\\("`, `output_mode: "content"` и `-C: 2`, чтобы увидеть окружающие строки каждого вызова.
+
+### Пример 2: подсчёт совпадений по типу
+Задайте `pattern: "TODO"`, `type: "py"` и `output_mode: "count"`, чтобы увидеть пофайловые итоги TODO по исходникам Python.
+
+### Пример 3: многострочное совпадение по структуре
+Используйте `pattern: "struct Config \\{[\\s\\S]*?version"` с `multiline: true`, чтобы захватить поле, объявленное на несколько строк внутри Go-структуры.
 
 ## Примечания
 
-- Использует синтаксис ripgrep (не grep), специальные символы вроде фигурных скобок требуют экранирования
-- Режим `files_with_matches` возвращает только пути файлов, наиболее эффективный
-- Режим `content` возвращает содержимое совпавших строк, поддерживает контекстные строки
-- Многострочное сопоставление требует установки `multiline: true`
-- Всегда предпочитайте инструмент Grep вместо команд `grep` или `rg` в Bash
-
-## Оригинальный текст
-
-<textarea readonly>A powerful search tool built on ripgrep
-
-  Usage:
-  - ALWAYS use Grep for search tasks. NEVER invoke `grep` or `rg` as a Bash command. The Grep tool has been optimized for correct permissions and access.
-  - Supports full regex syntax (e.g., "log.*Error", "function\s+\w+")
-  - Filter files with glob parameter (e.g., "*.js", "**/*.tsx") or type parameter (e.g., "js", "py", "rust")
-  - Output modes: "content" shows matching lines, "files_with_matches" shows only file paths (default), "count" shows match counts
-  - Use Agent tool for open-ended searches requiring multiple rounds
-  - Pattern syntax: Uses ripgrep (not grep) - literal braces need escaping (use `interface\{\}` to find `interface{}` in Go code)
-  - Multiline matching: By default patterns match within single lines only. For cross-line patterns like `struct \{[\s\S]*?field`, use `multiline: true`
-</textarea>
+- Всегда предпочитайте `Grep` запуску `grep` или `rg` через `Bash`; инструмент оптимизирован для корректных прав и структурированного вывода.
+- Режим вывода по умолчанию — `files_with_matches`, самый дешёвый. Переключайтесь на `content` только когда нужно видеть сами строки.
+- Флаги контекста (`-A`, `-B`, `-C`) игнорируются, если `output_mode` не `content`.
+- Большие наборы результатов сжигают токены контекста. Используйте `head_limit`, `offset` или более узкие фильтры `glob`/`type`, чтобы оставаться сфокусированным.
+- Для поиска по именам файлов используйте `Glob`; для открытых исследований, растянутых на много раундов, отправляйте `Agent` с агентом Explore.

package/concepts/ru/Tool-Monitor.md

@@ -0,0 +1,50 @@
+# Monitor
+
+Запускает фоновый монитор, который передаёт события от долго работающего скрипта. Каждая строка стандартного вывода становится уведомлением — продолжайте работать, пока события поступают в чат.
+
+## Когда использовать
+
+- Отслеживание ошибок, предупреждений или сигнатур сбоев в файле журнала во время выполнения развёртывания
+- Опрос удалённого API, PR или конвейера CI каждые 30 секунд для обнаружения новых событий состояния
+- Наблюдение за изменениями в каталоге файловой системы или в выводе сборки в реальном времени
+- Ожидание определённого условия на протяжении многих итераций (например, контрольной точки шага обучения или опустошения очереди)
+- **Не** для простого "ждать завершения" — для этого используйте `Bash` с `run_in_background`; он отправит одно уведомление о завершении, когда процесс завершится
+
+## Параметры
+
+- `command` (строка, обязательный): Команда оболочки или скрипт для запуска. Каждая строка, записанная в стандартный вывод, становится отдельным событием уведомления. Монитор завершается, когда завершается процесс.
+- `description` (строка, обязательный): Короткая читаемая метка, отображаемая в каждом уведомлении. Быть конкретным — "ошибки в deploy.log" лучше, чем "наблюдение за логами". Эта метка определяет, какой монитор сработал.
+- `timeout_ms` (число, по умолчанию `300000`, макс `3600000`): Крайний срок принудительного завершения в миллисекундах. По истечении этого времени процесс завершается. Игнорируется при `persistent: true`.
+- `persistent` (логическое, по умолчанию `false`): Когда `true`, монитор работает в течение всей сессии без тайм-аута. Остановить явно с помощью `TaskStop`.
+
+## Примеры
+
+### Пример 1: Отслеживание файла журнала на наличие ошибок и сбоев
+
+Этот пример охватывает все конечные состояния: маркер успеха, трейсбек, общие ключевые слова ошибок, завершение из-за OOM и неожиданный выход процесса.
+
+```bash
+tail -F /var/log/deploy.log | grep -E --line-buffered \
+  "deployed|Traceback|Error|FAILED|assert|Killed|OOM"
+```
+
+Использовать `grep --line-buffered` в каждом конвейере. Без него ОС буферизует вывод блоками по 4 КБ и события могут задерживаться на минуты. Паттерн чередования охватывает как путь успеха (`deployed`), так и пути сбоя (`Traceback`, `Error`, `FAILED`, `Killed`, `OOM`). Монитор, наблюдающий только за маркером успеха, молчит при сбое — тишина неотличима от "всё ещё работает".
+
+### Пример 2: Опрос удалённого API каждые 30 секунд
+
+```bash
+while true; do
+  curl -sf "https://api.example.com/status" || true
+  sleep 30
+done | grep --line-buffered -E "completed|failed|error"
+```
+
+`|| true` предотвращает завершение цикла из-за временного сетевого сбоя. Интервалы опроса 30 секунд и более подходят для удалённых API во избежание ограничений частоты запросов. Настроить паттерн grep для захвата как успешных, так и ошибочных ответов, чтобы ошибки на стороне API не маскировались тишиной.
+
+## Примечания
+
+- **Всегда использовать `grep --line-buffered` в конвейерах.** Без этого буферизация конвейера задерживает события на минуты, поскольку ОС накапливает вывод до заполнения блока 4 КБ. `--line-buffered` принудительно сбрасывает буфер после каждой строки.
+- **Фильтр должен охватывать как сигнатуры успеха, так и сбоя.** Монитор, наблюдающий только за маркером успеха, молчит при сбое, зависании или неожиданном выходе. Расширить чередование: включить `Error`, `Traceback`, `FAILED`, `Killed`, `OOM` и аналогичные маркеры конечного состояния наряду с ключевым словом успеха.
+- **Интервалы опроса: 30 секунд и более для удалённых API.** Частый опрос внешних сервисов рискует получить ошибки ограничения частоты запросов или блокировку. Для локальных проверок файловой системы или процессов подходит 0,5–1 секунда.
+- **Использовать `persistent: true` для мониторов на время сессии.** Стандартный `timeout_ms` в 300 000 мс (5 минут) завершает процесс. Для мониторов, которые должны работать до явной остановки, установить `persistent: true` и вызвать `TaskStop` по завершении.
+- **Автоматическая остановка при потоке событий.** Каждая строка стандартного вывода — это сообщение в разговоре. Если фильтр слишком широкий и производит слишком много событий, монитор останавливается автоматически. Перезапустить с более строгим паттерном `grep`. Строки, поступающие в течение 200 мс, объединяются в одно уведомление.

package/concepts/ru/Tool-NotebookEdit.md

@@ -1,33 +1,39 @@
 # NotebookEdit
 
-## Определение
+Модифицирует одну ячейку в блокноте Jupyter (`.ipynb`). Поддерживает замену исходного текста ячейки, вставку новой ячейки или удаление существующей ячейки, сохраняя остальную структуру блокнота.
 
-Заменяет, вставляет или удаляет определённую ячейку в Jupyter notebook (файл .ipynb).
+## Когда использовать
+
+- Исправление или обновление кодовой ячейки в аналитическом блокноте без перезаписи всего файла
+- Замена markdown-ячейки для улучшения повествования или добавления документации
+- Вставка новой кодовой или markdown-ячейки в известной позиции существующего блокнота
+- Удаление устаревшей или сломанной ячейки, чтобы последующие ячейки больше от неё не зависели
+- Подготовка воспроизводимого блокнота путём итеративной правки ячеек по одной
 
 ## Параметры
 
-| Параметр | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `notebook_path` | string | Да | Абсолютный путь к файлу notebook |
-| `new_source` | string | Да | Новое содержимое ячейки |
-| `cell_id` | string | Нет | ID ячейки для редактирования. В режиме вставки новая ячейка вставляется после этого ID |
-| `cell_type` | enum | Нет | Тип ячейки: `code` или `markdown`. Обязателен в режиме вставки |
-| `edit_mode` | enum | Нет | Режим редактирования: `replace` (по умолчанию), `insert`, `delete` |
+- `notebook_path` (string, обязательный): абсолютный путь к файлу `.ipynb`. Относительные пути отклоняются.
+- `new_source` (string, обязательный): новый исходный текст ячейки. Для `replace` и `insert` становится телом ячейки; для `delete` игнорируется, но всё равно обязателен по схеме.
+- `cell_id` (string, необязательный): ID целевой ячейки. В режимах `replace` и `delete` инструмент действует на эту ячейку. В режиме `insert` новая ячейка вставляется сразу после ячейки с этим ID; опустите, чтобы вставить в начало блокнота.
+- `cell_type` (enum, необязательный): либо `code`, либо `markdown`. Обязателен, когда `edit_mode` — `insert`. Если опущен при `replace`, сохраняется существующий тип ячейки.
+- `edit_mode` (enum, необязательный): `replace` (по умолчанию), `insert` или `delete`.
 
-## Сценарии использования
+## Примеры
 
-**Подходящее применение:**
-- Модификация ячеек кода или markdown в Jupyter notebook
-- Добавление новых ячеек в notebook
-- Удаление ячеек из notebook
+### Пример 1: замена ошибочной кодовой ячейки
+Вызовите `NotebookEdit` с `notebook_path`, установленным в абсолютный путь, `cell_id`, установленным в ID целевой ячейки, и `new_source`, содержащим исправленный код Python. Оставьте `edit_mode` по умолчанию — `replace`.
 
-## Примечания
+### Пример 2: вставка markdown-пояснения
+Чтобы добавить markdown-ячейку сразу после существующей ячейки `setup`, задайте `edit_mode: "insert"`, `cell_type: "markdown"`, `cell_id` — ID ячейки setup, а повествование положите в `new_source`.
 
-- `cell_number` индексируется с 0
-- Режим `insert` вставляет новую ячейку в указанную позицию
-- Режим `delete` удаляет ячейку в указанной позиции
-- Путь должен быть абсолютным
+### Пример 3: удаление устаревшей ячейки
+Задайте `edit_mode: "delete"` и укажите `cell_id` ячейки, которую нужно удалить. Передайте любую строку в `new_source`; она не применяется.
 
-## Оригинальный текст
+## Примечания
 
-<textarea readonly>Completely replaces the contents of a specific cell in a Jupyter notebook (.ipynb file) with new source. Jupyter notebooks are interactive documents that combine code, text, and visualizations, commonly used for data analysis and scientific computing. The notebook_path parameter must be an absolute path, not a relative path. The cell_number is 0-indexed. Use edit_mode=insert to add a new cell at the index specified by cell_number. Use edit_mode=delete to delete the cell at the index specified by cell_number.</textarea>
+- Всегда передавайте абсолютный путь. `NotebookEdit` не разрешает относительные пути относительно рабочего каталога.
+- Инструмент переписывает только целевую ячейку; счётчики выполнения, выводы и метаданные несвязанных ячеек остаются нетронутыми.
+- Вставка без `cell_id` помещает новую ячейку в самое начало блокнота.
+- `cell_type` обязателен для вставок. Для замен опускайте, если только вы явно не хотите превратить кодовую ячейку в markdown или наоборот.
+- Чтобы осмотреть ячейки и захватить их ID, сначала используйте инструмент `Read` на блокноте; он возвращает ячейки с их содержимым и выводами.
+- Для обычных исходных файлов используйте обычный `Edit`; `NotebookEdit` специфичен для JSON `.ipynb` и понимает его структуру ячеек.

package/concepts/ru/Tool-PushNotification.md

@@ -0,0 +1,48 @@
+# PushNotification
+
+Отправляет уведомление на рабочий стол из текущей сессии Claude Code. Если подключён Remote Control, уведомление также поступает на телефон пользователя, привлекая его внимание обратно к сессии — чем бы он ни занимался.
+
+## Когда использовать
+
+- Длительная задача завершилась, пока пользователь, вероятно, отсутствовал у терминала
+- Сборка, прогон тестов или развёртывание завершены и результат готов к проверке
+- Достигнута точка принятия решения, требующая участия пользователя, прежде чем можно продолжить работу
+- Возникла ошибка или блокировка, которую невозможно устранить автономно
+- Пользователь явно попросил уведомить его, когда выполнится определённая задача или условие
+
+## Когда не использовать
+
+Не отправляйте уведомление для плановых обновлений о ходе выполнения задачи и не подтверждайте им ответ на вопрос, который пользователь только что задал и явно ждёт. Не уведомляйте о завершении коротких задач — если пользователь только что отправил задачу и ждёт, уведомление не несёт никакой ценности и подрывает доверие к будущим уведомлениям. Настоятельно склоняйтесь к тому, чтобы не отправлять.
+
+## Параметры
+
+- `message` (строка, обязательный): текст уведомления. Держите его в пределах 200 символов; мобильные операционные системы обрезают более длинные строки. Начинайте с того, на что пользователь будет реагировать: "build failed: 2 auth tests" информативнее, чем "task complete".
+- `status` (строка, обязательный): всегда устанавливайте в `"proactive"`. Это фиксированный маркер, он не меняется.
+
+## Примеры
+
+### Пример 1: уведомление о завершении длительного анализа
+
+Был запрошен аудит зависимостей по всему репозиторию, который занял несколько минут. Пользователь отошёл. Когда отчёт готов:
+
+```
+message: "Аудит зависимостей завершён: 3 критические CVE в lodash, axios, jsonwebtoken. Отчёт: audit-report.txt"
+status: "proactive"
+```
+
+### Пример 2: обозначение точки принятия решения при автономной работе
+
+В ходе многошаговой рефакторинговой работы обнаружено, что два модуля имеют конфликтующие интерфейсы и не могут быть объединены без проектного решения:
+
+```
+message: "Рефакторинг приостановлен: AuthService и UserService имеют конфликтующие интерфейсы токенов. Требуется ваше решение."
+status: "proactive"
+```
+
+## Примечания
+
+- Настоятельно склоняйтесь к тому, чтобы **не отправлять**. Уведомление прерывает пользователя независимо от того, чем он занят. Рассматривайте его как стоимость, которую необходимо оправдать ценностью информации.
+- Начинайте с содержательного, побуждающего к действию текста. Первые слова должны сообщать пользователю, что произошло и что, если что-то нужно сделать — а не общий статусный ярлык.
+- Держите `message` в пределах 200 символов. Мобильные операционные системы обрежут более длинные строки, и самая важная часть может потеряться, если она в конце.
+- Если результат указывает на то, что push не был отправлен из-за отсутствия подключения Remote Control, это ожидаемое поведение. Повторная попытка или дополнительные действия не требуются; локальное уведомление на рабочем столе всё равно будет показано.
+- Избегайте спама уведомлениями. Если уведомления отправляются часто по незначительным поводам, пользователь начнёт их игнорировать. Приберегайте этот инструмент для моментов, когда есть реальная вероятность того, что пользователь ушёл и захочет узнать результат прямо сейчас.

package/concepts/ru/Tool-Read.md

@@ -1,56 +1,41 @@
 # Read
 
-## Определение
+Загружает содержимое одного файла из локальной файловой системы. Поддерживает простой текст, исходный код, изображения, PDF и блокноты Jupyter, возвращая результаты с 1-based номерами строк в стиле `cat -n`.
 
-Читает содержимое файла из локальной файловой системы. Поддерживает текстовые файлы, изображения, PDF и Jupyter notebook.
+## Когда использовать
+
+- Чтение исходного файла по известному пути перед правкой или анализом
+- Инспекция конфигурационных файлов, lockfile, логов или сгенерированных артефактов
+- Просмотр скриншотов или диаграмм, которые пользователь вставил в разговор
+- Извлечение конкретного диапазона страниц из длинного PDF-руководства
+- Открытие блокнота `.ipynb` для совместного просмотра кодовых ячеек, markdown и выводов ячеек
 
 ## Параметры
 
-| Параметр | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `file_path` | string | Да | Абсолютный путь к файлу |
-| `offset` | number | Нет | Номер начальной строки (для сегментного чтения больших файлов) |
-| `limit` | number | Нет | Количество строк для чтения (для сегментного чтения больших файлов) |
-| `pages` | string | Нет | Диапазон страниц PDF (например, "1-5", "3", "10-20"), применимо только к PDF |
+- `file_path` (string, обязательный): абсолютный путь к целевому файлу. Относительные пути отклоняются.
+- `offset` (integer, необязательный): 1-based номер строки, с которой начинается чтение. Полезно для больших файлов в паре с `limit`.
+- `limit` (integer, необязательный): максимальное число возвращаемых строк, начиная с `offset`. По умолчанию — 2000 строк с начала файла, если не указан.
+- `pages` (string, необязательный): диапазон страниц для PDF-файлов, например `"1-5"`, `"3"` или `"10-20"`. Обязателен для PDF длиннее 10 страниц; максимум 20 страниц за запрос.
+
+## Примеры
+
+### Пример 1: чтение небольшого файла целиком
+Вызовите `Read`, указав только `file_path` как `/Users/me/project/src/index.ts`. Возвращаются до 2000 строк с номерами, чего обычно достаточно для контекста правки.
 
-## Сценарии использования
+### Пример 2: постраничное чтение длинного лога
+Используйте `offset: 5001` и `limit: 500` на многотысячном файле лога, чтобы получить узкое окно без расхода токенов контекста.
 
-**Подходящее применение:**
-- Чтение файлов кода, конфигурационных файлов и других текстовых файлов
-- Просмотр файлов изображений (Claude — мультимодальная модель)
-- Чтение PDF-документов
-- Чтение Jupyter notebook (возвращает все ячейки с выводом)
-- Параллельное чтение нескольких файлов для получения контекста
+### Пример 3: извлечение конкретных страниц PDF
+Для PDF на 120 страниц по пути `/tmp/spec.pdf` задайте `pages: "8-15"`, чтобы вытащить только нужную главу. Опущенный `pages` на большом PDF выдаст ошибку.
 
-**Неподходящее применение:**
-- Чтение каталогов — следует использовать команду `ls` в Bash
-- Открытое исследование кодовой базы — следует использовать Task (тип Explore)
+### Пример 4: просмотр изображения
+Передайте абсолютный путь к PNG или JPG скриншоту. Изображение рендерится визуально, так что Claude Code может рассуждать о нём напрямую.
 
 ## Примечания
 
-- Путь должен быть абсолютным, не относительным
-- По умолчанию читает первые 2000 строк файла
-- Строки длиннее 2000 символов будут обрезаны
-- Вывод использует формат `cat -n`, нумерация строк начинается с 1
-- Большие PDF (более 10 страниц) должны иметь указанный параметр `pages`, максимум 20 страниц за раз
-- Чтение несуществующего файла вернёт ошибку (не вызовет сбой)
-- Можно параллельно вызывать несколько Read в одном сообщении
-
-## Оригинальный текст
-
-<textarea readonly>Reads a file from the local filesystem. You can access any file directly by using this tool.
-Assume this tool is able to read all files on the machine. If the User provides a path to a file assume that path is valid. It is okay to read a file that does not exist; an error will be returned.
-
-Usage:
-- The file_path parameter must be an absolute path, not a relative path
-- By default, it reads up to 2000 lines starting from the beginning of the file
-- You can optionally specify a line offset and limit (especially handy for long files), but it's recommended to read the whole file by not providing these parameters
-- Any lines longer than 2000 characters will be truncated
-- Results are returned using cat -n format, with line numbers starting at 1
-- This tool allows Claude Code to read images (eg PNG, JPG, etc). When reading an image file the contents are presented visually as Claude Code is a multimodal LLM.
-- This tool can read PDF files (.pdf). For large PDFs (more than 10 pages), you MUST provide the pages parameter to read specific page ranges (e.g., pages: "1-5"). Reading a large PDF without the pages parameter will fail. Maximum 20 pages per request.
-- This tool can read Jupyter notebooks (.ipynb files) and returns all cells with their outputs, combining code, text, and visualizations.
-- This tool can only read files, not directories. To read a directory, use an ls command via the Bash tool.
-- You can call multiple tools in a single response. It is always better to speculatively read multiple potentially useful files in parallel.
-- You will regularly be asked to read screenshots. If the user provides a path to a screenshot, ALWAYS use this tool to view the file at the path. This tool will work with all temporary file paths.
-- If you read a file that exists but has empty contents you will receive a system reminder warning in place of file contents.</textarea>
+- Всегда предпочитайте абсолютные пути. Если пользователь указал один, доверяйте ему как есть.
+- Строки длиннее 2000 символов усекаются; относитесь к возвращённому содержимому как, возможно, усечённому для экстремально широких данных.
+- Читаете несколько независимых файлов? Делайте несколько вызовов `Read` в одном ответе, чтобы они выполнялись параллельно.
+- `Read` не может перечислять каталоги. Используйте вызов `ls` через `Bash` или инструмент `Glob`.
+- Чтение существующего, но пустого файла возвращает системное напоминание вместо байт файла, так что обрабатывайте этот сигнал явно.
+- Успешный `Read` обязателен, прежде чем вы сможете использовать `Edit` на том же файле в текущей сессии.

package/concepts/ru/Tool-RemoteTrigger.md

@@ -0,0 +1,73 @@
+# RemoteTrigger
+
+Вызывает API удалённых триггеров claude.ai для управления запланированными задачами и выполнением триггеров по требованию. Токен OAuth обрабатывается инструментом внутренне и никогда не передаётся модели или оболочке.
+
+## Когда использовать
+
+- Управление удалёнными агентами (триггерами) на claude.ai, включая просмотр списка, проверку и обновление существующих триггеров
+- Создание новой автоматизированной задачи на основе cron, которая запускает агента Claude по повторяющемуся расписанию
+- Запуск существующего триггера по требованию без ожидания следующего запланированного выполнения
+- Отображение или аудит всех текущих триггеров для проверки их конфигурации и состояния
+- Обновление настроек триггера, таких как расписание, полезная нагрузка или описание, без необходимости его пересоздания
+
+## Параметры
+
+- `action` (string, обязательный): выполняемая операция — одно из значений `list`, `get`, `create`, `update` или `run`
+- `trigger_id` (string, обязателен для `get`, `update` и `run`): идентификатор триггера, над которым выполняется операция; должен соответствовать шаблону `^[\w-]+$` (только символы слов и дефисы)
+- `body` (object, обязателен для `create` и `update`; необязателен для `run`): полезная нагрузка запроса, отправляемая в API
+
+## Примеры
+
+### Пример 1: получить список всех триггеров
+
+```json
+{
+  "action": "list"
+}
+```
+
+Вызывает `GET /v1/code/triggers` и возвращает массив JSON всех триггеров, связанных с аутентифицированным аккаунтом.
+
+### Пример 2: создать новый триггер, запускаемый каждое утро в рабочий день
+
+```json
+{
+  "action": "create",
+  "body": {
+    "name": "weekday-morning-report",
+    "schedule": "0 8 * * 1-5",
+    "description": "Генерировать ежедневную сводку каждый рабочий день в 08:00 UTC"
+  }
+}
+```
+
+Вызывает `POST /v1/code/triggers` с предоставленным телом запроса и возвращает объект нового триггера, включая присвоенный `trigger_id`.
+
+### Пример 3: запустить триггер по требованию
+
+```json
+{
+  "action": "run",
+  "trigger_id": "my-report-trigger"
+}
+```
+
+Немедленно вызывает `POST /v1/code/triggers/my-report-trigger/run`, минуя запланированное время.
+
+### Пример 4: получить один триггер
+
+```json
+{
+  "action": "get",
+  "trigger_id": "my-report-trigger"
+}
+```
+
+Вызывает `GET /v1/code/triggers/my-report-trigger` и возвращает полную конфигурацию триггера.
+
+## Примечания
+
+- Токен OAuth внедряется инструментом внутри процесса — никогда не копируйте, не вставляйте и не записывайте токены вручную; это создаёт угрозу безопасности и не нужно при использовании данного инструмента.
+- Используйте этот инструмент вместо прямого `curl` или других HTTP-клиентов для всех вызовов API триггеров; прямое использование HTTP обходит безопасное внедрение токена и может раскрыть учётные данные.
+- Инструмент возвращает необработанный JSON-ответ от API; вызывающая сторона несёт ответственность за разбор ответа и обработку кодов состояния ошибок.
+- Значение `trigger_id` должно соответствовать шаблону `^[\w-]+$` — допускаются только буквенно-цифровые символы, символы подчёркивания и дефисы; пробелы или специальные символы приведут к сбою запроса.

package/concepts/ru/Tool-ScheduleWakeup.md

@@ -0,0 +1,56 @@
+# ScheduleWakeup
+
+Планирует, когда возобновить работу в динамическом режиме `/loop`. Инструмент позволяет Claude самостоятельно управлять темпом итераций задачи, засыпая на выбранный интервал, а затем снова запускаясь с тем же промптом цикла.
+
+## Когда использовать
+
+- При самостоятельном управлении темпом динамической задачи `/loop`, где интервал итераций зависит от состояния работы, а не от фиксированного таймера
+- При ожидании завершения длительной сборки, развёртывания или запуска тестов перед проверкой результатов
+- При вставке холостых тиков между итерациями, когда нет конкретного сигнала для мониторинга в данный момент
+- При запуске автономного цикла без промпта пользователя — передать буквальный sentinel `<<autonomous-loop-dynamic>>` как `prompt`
+- При опросе процесса, состояние которого вот-вот изменится (использовать короткую задержку для поддержания кэша в тёплом состоянии)
+
+## Параметры
+
+- `delaySeconds` (число, обязательное): Секунды до возобновления. Среда выполнения автоматически ограничивает значение до `[60, 3600]`, поэтому ручное ограничение не требуется.
+- `reason` (строка, обязательная): Одно короткое предложение, объясняющее выбранную задержку. Отображается пользователю и записывается в телеметрию. Будьте конкретны — «проверяю длительную сборку bun» полезнее, чем «ожидание».
+- `prompt` (строка, обязательная): Входные данные `/loop` для запуска при пробуждении. Передавать ту же строку в каждом ходу, чтобы следующий запуск повторил задачу. Для автономного цикла без промпта пользователя передать буквальный sentinel `<<autonomous-loop-dynamic>>`.
+
+## Примеры
+
+### Пример 1: короткая задержка для повторной проверки быстро меняющегося сигнала (поддержание кэша в тёплом состоянии)
+
+Сборка только что запущена и обычно завершается за две-три минуты.
+
+```json
+{
+  "delaySeconds": 120,
+  "reason": "проверяю сборку bun, ожидаемое завершение через ~2 мин",
+  "prompt": "проверить статус сборки и сообщить об ошибках"
+}
+```
+
+120 секунд сохраняет контекст разговора в кэше промптов Anthropic (TTL 5 мин), поэтому следующее пробуждение выполняется быстрее и дешевле.
+
+### Пример 2: длинный холостой тик (принять промах кэша, амортизировать на более длительное ожидание)
+
+Миграция базы данных выполняется и обычно занимает 20–40 минут.
+
+```json
+{
+  "delaySeconds": 1200,
+  "reason": "миграция обычно занимает 20–40 мин; проверяю через 20 мин",
+  "prompt": "проверить статус миграции и продолжить если завершена"
+}
+```
+
+При пробуждении кэш будет холодным, но 20-минутное ожидание с лихвой амортизирует стоимость одного промаха. Опрос каждые 5 минут платил бы ту же цену промаха 4 раза без какой-либо выгоды.
+
+## Примечания
+
+- **TTL кэша 5 минут**: Кэш промптов Anthropic истекает через 300 секунд. Задержки менее 300 с сохраняют контекст тёплым; задержки более 300 с приводят к промаху кэша при следующем пробуждении.
+- **Избегайте ровно 300 с**: Это худший вариант из обоих миров — вы платите за промах кэша, не получая при этом значительно более длительного ожидания. Либо снизьте до 270 с (сохраните тёплый кэш), либо зафиксируйте 1200 с или больше (один промах обеспечивает гораздо более длительное ожидание).
+- **Значение по умолчанию для холостых тиков**: Когда нет конкретного сигнала для мониторинга, используйте **1200–1800 с** (20–30 мин). Это позволяет циклу периодически проверять, не сжигая кэш 12 раз в час без причины.
+- **Автоматическое ограничение**: Среда выполнения ограничивает `delaySeconds` до `[60, 3600]`. Значения ниже 60 становятся 60; значения выше 3600 становятся 3600. Не нужно самостоятельно обрабатывать эти границы.
+- **Пропустить вызов для завершения цикла**: Если вы намерены остановить итерации, не вызывайте ScheduleWakeup. Простое отсутствие вызова завершает цикл.
+- **Передавать тот же `prompt` в каждом ходу**: Поле `prompt` должно содержать исходную инструкцию `/loop` при каждом вызове, чтобы следующее пробуждение знало, какую задачу возобновить.