cc-viewer 1.7.21 → 1.7.23

package/concepts/uk/Tool-SendUserFile.md

@@ -0,0 +1,38 @@
+# SendUserFile
+
+Надсилає користувачу один або кілька файлів — згенеровані артефакти, знімки екрана, звіти — з контролем над тим, як клієнт їх представляє.
+
+## Коли використовувати
+
+- Ви створили файл, який потрібен користувачу (звіт, зображення, HTML-сторінку), і хочете показати його, а не лише згадати його шлях.
+- Відповідь із вкладенням (`status="normal"`) або проактивний показ чогось, чого користувач не просив, але що йому потрібно побачити зараз (`status="proactive"`).
+
+## Активація
+
+- Доступний лише тоді, коли підключено клієнт Remote Control або сесія працює в керованому хмарному середовищі (наприклад, Claude Code on the web).
+- Недоступний на Amazon Bedrock, Google Cloud і Microsoft Foundry.
+- Вимагає, щоб сесія дозволяла надсилання файлів (можливість, закрита налаштуваннями/функціональними прапорцями); не пропонується в brief-режимі.
+
+## Параметри
+
+- `files` (array of strings, обовʼязковий): Шляхи файлів (абсолютні або відносні до cwd) для надсилання користувачу. Завжди передавайте масив, навіть для одного файлу.
+- `caption` (string, необовʼязковий): Короткий підпис до файлу(ів).
+- `status` (string, обовʼязковий): `proactive`, коли показуєте файл, якого користувач не просив і який йому потрібно побачити зараз — згенерований артефакт, завершений звіт; `normal`, коли відповідаєте на щойно сказане користувачем.
+- `display` (string, необовʼязковий): `render` відкриває файл вбудовано в бічній панелі (HTML, SVG, Mermaid, зображення, PDF); `attach` показує лише картку завантаження (результати, які користувач збереже й відкриє в іншому місці). Пропустіть, щоб клієнт вирішив за типом файлу.
+
+## Приклади
+
+### Приклад 1: Доставка згенерованого звіту
+
+```
+SendUserFile(
+  files=["./out/weekly-report.html"],
+  caption="Weekly usage report",
+  status="proactive",
+  display="render"
+)
+```
+
+## Примітки
+
+- Обирайте `display="attach"` для файлів, які користувач зберігає й відкриває в іншому застосунку; `render` — для всього, на що він має подивитися негайно.

package/concepts/uk/Tool-SendUserMessage.md

@@ -0,0 +1,38 @@
+# SendUserMessage
+
+Надсилає повідомлення користувачу — основний видимий канал виводу в сесіях у стилі brief. Відомий також під застарілим псевдонімом `Brief`.
+
+## Коли використовувати
+
+- Відповідь на щойно сказане користувачем (`status="normal"`).
+- Проактивний показ чогось, чого користувач не просив і що йому потрібно побачити зараз — завдання завершується, поки він відсутній, блокатор, на який ви натрапили, непрохане оновлення статусу (`status="proactive"`).
+
+## Активація
+
+- За замовчуванням прихований в інтерактивних сесіях; більшість інтерактивних CLI-сесій натомість розмовляють з користувачем напряму.
+- Увімкнено в brief-режимі або через серверні функціональні прапорці.
+
+## Параметри
+
+У brief-режимі:
+
+- `message` (string, обовʼязковий): Повідомлення для користувача. Підтримує форматування markdown.
+- `attachments` (array, необовʼязковий): Вкладення, показані поруч із повідомленням. Кожен запис — або шлях файлу (абсолютний або відносний до cwd) для локально читаного файлу, або попередньо розвʼязаний обʼєкт `{file_uuid, file_name, size, is_image}`, отриманий від інструмента пристрою, такого як `attach_file`.
+- `status` (string, обовʼязковий): `proactive` для непроханих оновлень, які потрібні користувачу зараз; `normal`, коли відповідаєте користувачу.
+
+У збірках без brief доступний лише `message`.
+
+## Приклади
+
+### Приклад 1: Проактивне сповіщення про завершення
+
+```
+SendUserMessage(
+  message="The migration finished — 42 files updated, tests green.",
+  status="proactive"
+)
+```
+
+## Примітки
+
+- Використовуйте `proactive` економно — він призначений для речей, які справді потребують уваги користувача зараз.

package/concepts/uk/Tool-SuggestConnectors.md

@@ -0,0 +1,28 @@
+# SuggestConnectors
+
+Розвʼязує повні payload-и конекторів для значень `directoryUuid`, повернутих `SearchMcpRegistry`, щоб користувачу можна було запропонувати конкретні конектори для увімкнення.
+
+## Коли використовувати
+
+- Після того, як `SearchMcpRegistry` повернув конектори-кандидати, — щоб отримати їхні повні деталі для представлення.
+
+## Активація
+
+- Доступний лише у віддалених (claude.ai) сесіях на офіційному API.
+
+## Параметри
+
+- `uuids` (array of strings, обовʼязковий): Значення `directoryUuid` або `server_id` для розвʼязання. 1–32 елементи, кожен 1–64 символи.
+
+## Приклади
+
+### Приклад 1: Розвʼязання двох збігів з реєстру
+
+```
+SuggestConnectors(uuids=["d290f1ee-6c54-4b01-90e6-d701748f0851", "a1b2c3d4-0000-4000-8000-abcdefabcdef"])
+```
+
+## Примітки
+
+- Ніколи не вгадуйте UUID — розвʼязуйте лише ідентифікатори, що надійшли від `SearchMcpRegistry`.
+- Інструмент сам нічого не підключає; увімкнення конектора відбувається поза межами цього інструмента.

package/concepts/uk/Tool-SuggestPluginInstall.md

@@ -0,0 +1,39 @@
+# SuggestPluginInstall
+
+Відображає вбудовану картку встановлення плагіна з результатів `SearchPlugins`, привʼязуючи пропозиції плагінів до запиту користувача.
+
+## Коли використовувати
+
+- Пошук плагінів виявив плагіни, що збігаються з тим, що користувач намагається зробити, і ви хочете запропонувати їх до встановлення.
+
+## Активація
+
+- Лише тоді, коли підключено клієнт Remote Control або сесія працює в керованому хмарному середовищі.
+- Вимкнено за корпоративних конфігурацій HIPAA.
+- Не в brief-режимі.
+
+## Параметри
+
+- `contextLabel` (string, обовʼязковий): Короткий заголовок, що привʼязує пропозицію до запиту користувача (максимум 128 символів).
+- `plugins` (array, обовʼязковий): Плагіни, взяті з результатів `SearchPlugins` — 1–16 записів, кожен із:
+  - `pluginId` (string, обовʼязковий)
+  - `pluginName` (string, обовʼязковий)
+  - `description` (string, обовʼязковий)
+  - `skills` (array, необовʼязковий): До 32 записів `{name, description?}`, що описують навички плагіна.
+
+## Приклади
+
+### Приклад 1: Пропозиція відповідного плагіна
+
+```
+SuggestPluginInstall(
+  contextLabel="For reviewing pull requests",
+  plugins=[{pluginId="pr-toolkit", pluginName="PR Toolkit", description="Review helpers"}]
+)
+```
+
+Картка відображається для користувача; увімкнення плагіна відбувається поза межами цього інструмента. Викличте `ListPlugins` після цього, щоб дізнатися, що насправді було встановлено.
+
+## Примітки
+
+- Включайте лише плагіни, що надійшли з результатів пошуку — ніколи не вигадуйте записів плагінів.

package/concepts/uk/Tool-SuggestSkills.md

@@ -0,0 +1,33 @@
+# SuggestSkills
+
+Відображає картку автономних навичок, які користувач може додати (навичок, які ще не увімкнено), на основі тематичних ключових слів.
+
+## Коли використовувати
+
+- Запит користувача збігається з навичками, які він не має увімкненими (`trigger="user_asked"`, коли він попросив, `trigger="proactive"`, коли ви пропонуєте без запиту).
+
+## Активація
+
+- Лише тоді, коли підключено клієнт Remote Control або сесія працює в керованому хмарному середовищі.
+- Вимкнено за корпоративних конфігурацій HIPAA.
+- Не в brief-режимі.
+
+## Параметри
+
+- `keywords` (array of strings, обовʼязковий): Тематичні ключові слова із запиту користувача. 1–8 елементів, кожен 1–64 символи.
+- `contextLabel` (string, необовʼязковий): Коротка мітка, що привʼязує пропозицію до запиту (максимум 128 символів).
+- `trigger` (string, необовʼязковий): Як почалася ця пропозиція — `user_asked` або `proactive`.
+
+## Приклади
+
+### Приклад 1: Пропозиція навичок за темою
+
+```
+SuggestSkills(keywords=["data visualization", "charts"], contextLabel="For building the dashboard", trigger="user_asked")
+```
+
+Уже увімкнені навички відфільтровуються з результату.
+
+## Примітки
+
+- Відображає лише картку пропозиції — додавання навички відбувається поза межами цього інструмента; викличте `ListSkills` після цього, щоб підтвердити.

package/concepts/uk/Tool-TaskCreate.md

@@ -12,6 +12,12 @@
 
 Пропустіть `TaskCreate` для тривіальних одноразових дій, чистої розмови чи будь-чого, що можна виконати за два-три прямі виклики інструментів.
 
+## Активація
+
+- Доступний за замовчуванням на більшості моделей.
+- Недоступний на Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 і пізніших сімействах (v2.1.233+), якщо не ввімкнено через `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`, `--allowedTools` або `--tools`.
+- Усю систему завдань вимкнено, коли `CLAUDE_CODE_ENABLE_TASKS=false`.
+
 ## Параметри
 
 - `subject` (string, обовʼязковий): Короткий імперативний заголовок, наприклад `Fix login redirect on Safari`. Тримайте його приблизно до восьмидесяти символів.

package/concepts/uk/Tool-TaskGet.md

@@ -12,6 +12,12 @@
 
 Віддавайте перевагу `TaskList`, коли вам потрібен лише високорівневий огляд; резервуйте `TaskGet` для конкретного запису, який ви маєте намір уважно прочитати чи модифікувати.
 
+## Активація
+
+- Доступний за замовчуванням на більшості моделей.
+- Недоступний на Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 і пізніших сімействах (v2.1.233+), якщо не ввімкнено через `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`, `--allowedTools` або `--tools`.
+- Усю систему завдань вимкнено, коли `CLAUDE_CODE_ENABLE_TASKS=false`.
+
 ## Параметри
 
 - `taskId` (string, обовʼязковий): Ідентифікатор завдання, повернутий `TaskCreate` чи `TaskList`. ID стабільні протягом усього життя завдання.

package/concepts/uk/Tool-TaskList.md

@@ -12,6 +12,12 @@
 
 `TaskList` лише для читання і дешевий; викликайте його вільно щоразу, коли вам потрібен огляд.
 
+## Активація
+
+- Доступний за замовчуванням на більшості моделей.
+- Недоступний на Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 і пізніших сімействах (v2.1.233+), якщо не ввімкнено через `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`, `--allowedTools` або `--tools`.
+- Усю систему завдань вимкнено, коли `CLAUDE_CODE_ENABLE_TASKS=false`.
+
 ## Параметри
 
 `TaskList` не приймає параметрів. Він завжди повертає повний набір завдань для активного контексту.

package/concepts/uk/Tool-TaskUpdate.md

@@ -10,6 +10,12 @@
 - Запис нововиявлених залежностей через `addBlocks` / `addBlockedBy`.
 - Прикріплення структурованих `metadata`, таких як ID зовнішніх тикетів чи підказки пріоритету.
 
+## Активація
+
+- Доступний за замовчуванням на більшості моделей.
+- Недоступний на Opus 4.8 / Sonnet 5 / Fable 5 / Mythos 5 і пізніших сімействах (v2.1.233+), якщо не ввімкнено через `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`, `--allowedTools` або `--tools`.
+- Усю систему завдань вимкнено, коли `CLAUDE_CODE_ENABLE_TASKS=false`.
+
 ## Параметри
 
 - `taskId` (string, обовʼязковий): Завдання для модифікації. Отримайте з `TaskList` чи `TaskCreate`.

package/concepts/uk/Tool-TodoWrite.md

@@ -0,0 +1,43 @@
+# TodoWrite
+
+Записує структурований todo-список для поточної сесії, замінюючи попередній список. Кожен елемент містить свій текст, статус і форму теперішнього тривалого часу, яка показується в індикаторах прогресу.
+
+## Коли використовувати
+
+- Завдання має кілька окремих кроків, і відстеження їх допомагає вам (і користувачу) бачити прогрес.
+- Користувач явно просить todo-список.
+- Ви хочете позначити рівно один елемент як «у процесі», поки решта залишаються очікуваними або завершеними.
+
+## Активація
+
+- Застарілий інструмент: вимкнено за замовчуванням у сесіях, які пропонують інструменти завдань (`TaskCreate`, `TaskUpdate`, `TaskList`).
+- Увімкніть його знову через `CLAUDE_CODE_ENABLE_TASKS=0`.
+
+## Параметри
+
+- `todos` (array, обовʼязковий): Повний оновлений todo-список. Кожен запис має:
+  - `content` (string): Опис завдання.
+  - `status` (string): Одне з `pending`, `in_progress`, `completed`.
+  - `activeForm` (string): Текст у теперішньому тривалому часі, який показується, поки елемент виконується (наприклад, "Running tests").
+
+## Приклади
+
+### Приклад 1: Відстеження зміни з трьох кроків
+
+```
+TodoWrite(
+  todos=[
+    {content="Update the parser", status="in_progress", activeForm="Updating the parser"},
+    {content="Add unit tests", status="pending", activeForm="Adding unit tests"},
+    {content="Run the full test suite", status="pending", activeForm="Running the full test suite"}
+  ]
+)
+```
+
+Весь список перезаписується при кожному виклику — завжди включайте всі елементи, а не лише ті, що змінилися.
+
+## Примітки
+
+- Список повністю замінюється при кожному виклику; щоб оновити один елемент, повторно надішліть усі елементи з новим статусом.
+- Тримайте рівно один елемент у статусі `in_progress` одночасно.
+- У сесіях, де увімкнено структуровані інструменти завдань (`TaskCreate`/`TaskUpdate`/`TaskList`), оболонка може запропонувати їх замість `TodoWrite` — віддавайте перевагу тому набору інструментів, який оголошено.

package/concepts/uk/Tool-ToolSearch.md

@@ -10,6 +10,11 @@
 
 Якщо схема інструмента вже є в контексті, не шукайте знову — просто викличте його.
 
+## Активація
+
+- Увімкнено за замовчуванням.
+- Вимкнено, коли `ANTHROPIC_BASE_URL` вказує на не-Anthropic кінцеву точку (якщо не встановлено `ENABLE_TOOL_SEARCH`), коли встановлено `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`, коли модель не має підтримки tool-reference (моделі Vertex AI до Claude 4.5) або коли заборонено через `"deny": ["ToolSearch"]`.
+
 ## Параметри
 
 - `query` (string, обовʼязковий): Запит для пошуку відкладених інструментів. Підтримуються три форми:

package/concepts/uk/Tool-WebSearch.md

@@ -10,6 +10,12 @@
 - Перевірка факту, який міг змінитися з моменту навчання моделі.
 - Виявлення кількох перспектив на тему перед отриманням будь-якої окремої сторінки через `WebFetch`.
 
+## Активація
+
+- Доступність залежить від провайдера та моделі: доступний на Anthropic API і Claude Platform on AWS; на Microsoft Foundry потребує розгортання, розміщеного в Anthropic; на Google Cloud працює з моделями Claude 4+.
+- Недоступний на Amazon Bedrock.
+- Обмежте до 200 викликів за сесію через `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION`.
+
 ## Параметри
 
 - `query` (string, обовʼязковий): Пошуковий запит. Мінімальна довжина 2 символи. Включайте поточний рік, коли запитуєте про "latest" чи "recent" інформацію, щоб результати були свіжими.

package/concepts/uk/Tools.md

@@ -15,16 +15,19 @@ Claude Code надає моделі набір вбудованих інстру
 | [TaskGet](Tool-TaskGet.md) | Отримання деталей завдання |
 | [TaskUpdate](Tool-TaskUpdate.md) | Оновлення статусу завдання, залежностей тощо |
 | [TaskList](Tool-TaskList.md) | Перелік усіх завдань |
+| [ListAgents](Tool-ListAgents.md) | Перелік агентів, доступних у сесії |
 
 ## Команда та оркестровка
 
 | Інструмент | Призначення |
 |------------|-------------|
-| [TeamCreate](Tool-TeamCreate.md) | Створення команди агентів для спільної роботи |
-| [TeamDelete](Tool-TeamDelete.md) | Розформування команди агентів |
 | [SendMessage](Tool-SendMessage.md) | Відправка повідомлення іншому агенту |
 | [Workflow](Tool-Workflow.md) | Запуск детермінованого скрипту багатоагентної оркестровки |
 | [Monitor](Tool-Monitor.md) | Потокове передавання подій від тривалого скрипту як сповіщень |
+| [SendFile](Tool-SendFile.md) | Надсилання файлів іншій сесії Claude Code |
+| [SendUserFile](Tool-SendUserFile.md) | Надсилання файлів користувачу |
+| [SendUserMessage](Tool-SendUserMessage.md) | Надсилання повідомлення користувачу (застарілий інструмент Brief) |
+| [EndConversation](Tool-EndConversation.md) | Завершення поточної розмови |
 
 ## Операції з файлами
 
@@ -48,6 +51,7 @@ Claude Code надає моделі набір вбудованих інстру
 | Інструмент | Призначення |
 |------------|-------------|
 | [Bash](Tool-Bash.md) | Виконання shell-команд |
+| [REPL](Tool-REPL.md) | Запуск JavaScript у постійному Node.js REPL |
 
 ## Web
 
@@ -66,6 +70,10 @@ Claude Code надає моделі набір вбудованих інстру
 | [ExitPlanMode](Tool-ExitPlanMode.md) | Вихід з режиму планування та подання плану на затвердження користувачем |
 | [AskUserQuestion](Tool-AskUserQuestion.md) | Запитання користувачу для уточнення або прийняття рішення |
 | [ReportFindings](Tool-ReportFindings.md) | Звіт про висновки перевірки коду як типізований список для хост-інтерфейсу |
+| [TodoWrite](Tool-TodoWrite.md) | Запис структурованого todo-списку для сесії |
+| [SendFeedback](Tool-SendFeedback.md) | Надсилання структурованого відгуку про Claude Code до Anthropic |
+| [Projects](Tool-Projects.md) | Керування документами бази знань проєкту |
+| [ProposeGoal](Tool-ProposeGoal.md) | Пропозиція перевірюваної мети завершення для сесії |
 
 ## Робочі дерева
 
@@ -84,6 +92,7 @@ Claude Code надає моделі набір вбудованих інстру
 | [ScheduleWakeup](Tool-ScheduleWakeup.md) | Власний темп ітерацій /loop путём планування наступного пробудження |
 | [PushNotification](Tool-PushNotification.md) | Відправка сповіщення на робочий стіл/мобільний пристрій користувачу |
 | [RemoteTrigger](Tool-RemoteTrigger.md) | Управління claude.ai remote-trigger підпрограмами |
+| [ReadNotifications](Tool-ReadNotifications.md) | Читання очікуваних сповіщень сесії |
 
 ## Розширення
 
@@ -91,10 +100,23 @@ Claude Code надає моделі набір вбудованих інстру
 |------------|-------------|
 | [Skill](Tool-Skill.md) | Виконання навички (slash command) |
 
+## MCP і розширення
+
+| Інструмент | Призначення |
+|------------|-------------|
+| [ListMcpResources](Tool-ListMcpResources.md) | Перелік ресурсів, які надають підключені MCP-сервери |
+| [ReadMcpResource](Tool-ReadMcpResource.md) | Читання одного ресурсу MCP-сервера за URI |
+| [ReadMcpResourceDir](Tool-ReadMcpResourceDir.md) | Перелік каталогового MCP-ресурсу за URI |
+| [SearchMcpRegistry](Tool-SearchMcpRegistry.md) | Пошук у реєстрі конекторів MCP за ключовим словом |
+| [SuggestConnectors](Tool-SuggestConnectors.md) | Отримання деталей конекторів із результатів пошуку в реєстрі |
+| [ListConnectors](Tool-ListConnectors.md) | Перелік встановлених конекторів MCP |
+| [SuggestPluginInstall](Tool-SuggestPluginInstall.md) | Відображення вбудованої картки встановлення плагіна |
+| [SuggestSkills](Tool-SuggestSkills.md) | Відображення картки навичок, доступних для додавання |
+| [ListPlugins](Tool-ListPlugins.md) | Перелік увімкнених плагінів claude.ai |
+| [ListSkills](Tool-ListSkills.md) | Перелік увімкнених навичок claude.ai |
+
 ## Інтеграція з IDE
 
 | Інструмент | Призначення |
 |------------|-------------|
-| [getDiagnostics](Tool-getDiagnostics.md) | Отримання діагностичної інформації мови VS Code |
-| [executeCode](Tool-executeCode.md) | Виконання коду в Jupyter kernel |
 | [LSP](Tool-LSP.md) | Запити мовного сервера (визначення, посилання, символи) |

package/concepts/zh/ProxySwitch.md

@@ -58,3 +58,16 @@
 - `profiles` — profile 列表，`id: "max"` 为内置直连模式，不可删除
 - 使用旧版 `models` / `activeModel` 的 profile 在加载时会自动迁移为 `ANTHROPIC_MODEL`
 - 修改文件后约 1.5 秒自动生效（通过 `fs.watchFile` 监听），无需重启
+
+## 按角色分源（高级）
+
+当主 Agent 使用某个代理 profile 时，弹窗顶部会出现「角色分工」分配区，可让**子 Agent（SubAgent）**和 **Teammate** 分别指向与主 Agent 不同的源——典型用法是主 Agent 跑贵模型、子 Agent 跑便宜模型。
+
+- 每个角色可选：**跟随主 Agent**（默认）/ **Default（内置直连）** / 任一 profile
+- **count_tokens、心跳等 utility 请求永远跟随本进程主角色的源**（主进程内 = 主 Agent；Teammate 进程内 = Teammate 自己的分配）——第三方代理常不支持这些端点
+- 子 Agent 角色只作用于带 `cc_is_subagent=true` 标记的请求（Claude Code ≥ 2.1.181）；更早版本的子代理请求与压缩/标题等轻量请求一样留在主 Agent 源
+- Teammate 两种形态都支持：独立进程（`--agent-name` 识别，切换后约 1.5 秒经文件监听热生效）与同进程团队 agent（Claude Code 2.1.x 原生 agent teams，经 system prompt 团队标记识别，随 leader 进程热生效）
+- 当主 Agent 切回 **Default 且端点为官方 api.anthropic.com** 时，分配区自动隐藏，已配置的角色分配**保留但不生效**（休眠），主 Agent 再次切到代理时原样恢复；Default 背后是自定义端点（如 env 里配了第三方地址）时分配区仍然可见且生效
+- 角色分配按 workspace 隔离，存储在各项目的 `active-profile.json`（`{ activeId, roles }`）
+
+说明：ccv 代理模式（`ccv run` / `ccv` CLI / Electron 标签页）同样按角色分流——proxy 在缓冲请求体后按角色选上游并交给重试引擎，统计按实际角色 profile 归属；唯一例外是代理模式下的**独立进程 teammate**，其官方端点休眠判定不生效（它看到的端点是本地代理地址）。

package/concepts/zh/Tool-Artifact.md

@@ -9,6 +9,13 @@
 - 列出用户现有 artifacts 以查找来自早期会话的文件（`action: "list"`）
 - **不适用于**必须保持本地的内容、纯文本答案或需要在查看时访问外部网络资源的任何东西——严格的 CSP 阻止所有外部主机
 
+## 启用方式
+
+- 需要 Pro、Max、Team 或 Enterprise 套餐并登录 claude.ai（`/login`）。
+- 仅限 Anthropic API——在 Amazon Bedrock、Google Cloud 或 Microsoft Foundry 上不可用。
+- 需要 Claude Code ≥ 2.1.183 或 Desktop 应用 ≥ 1.13576.0。
+- 通过 `disableArtifact` 设置或 `CLAUDE_CODE_DISABLE_ARTIFACT=1` 禁用。
+
 ## 参数
 
 - `file_path`（字符串）：要渲染的 `.html` 或 `.md` 文件路径。文件在发布时被包装在文档框架中，因此直接写入页面内容——不要包括 `<!DOCTYPE>`、`<html>`、`<head>` 或 `<body>` 标签。相同路径 → 重新部署时使用相同 URL；不同路径则申请新 URL。

package/concepts/zh/Tool-EndConversation.md

@@ -0,0 +1,35 @@
+# EndConversation
+
+结束当前对话，并阻止发送任何进一步的消息。
+
+## 何时使用
+
+- 仅用于持续的用户辱骂，或用户明确要求演示本工具时。
+
+这是最后手段：工具自身的规则要求在使用前先警告用户并确认，且绝不能在自残或伤害相关情境中使用。
+
+## 启用方式
+
+- 需要 Claude Code 2.1.213+ 以及 Opus 4.8 / Sonnet 5 / Fable 5 或更高版本家族的模型。
+- 仅限交互式终端会话——绝不用于 `--bare` 模式，也绝不提供给子代理。
+- 在 Amazon Bedrock、Claude Platform on AWS、Vertex AI、Microsoft Foundry 或云网关上不可用。
+- 需要服务端功能开关——大多数会话不提供此工具。
+
+## 参数
+
+本工具不接受任何参数。
+
+## 示例
+
+### 示例 1：结束对话
+
+```
+EndConversation()
+```
+
+流程分两步：第一次调用返回一条反思消息；紧接着的第二次调用才真正结束对话（`ended: true`）。
+
+## 注意事项
+
+- 高度门控：需要受支持的模型、CLI 入口和服务端功能开关——大多数会话不提供此工具。
+- 一旦结束，对话中就无法再发送任何消息。

package/concepts/zh/Tool-LSP.md

@@ -10,6 +10,11 @@
 - 查找接口或抽象方法的实现（`goToImplementation`）
 - 遍历函数的调用层级（`prepareCallHierarchy`、`incomingCalls`、`outgoingCalls`）
 
+## 启用方式
+
+- 在安装该语言的代码智能插件之前不活动（服务器二进制文件单独安装）。
+- 仅当 LSP 客户端已连接时，此工具才会出现。
+
 ## 参数
 
 - `operation` (string, 必填)：上述操作之一。

package/concepts/zh/Tool-ListAgents.md

@@ -0,0 +1,35 @@
+# ListAgents
+
+列出你可以 `SendMessage` 的 agent：你派生的进程内子 agent、本机上的其他本地 Claude 会话、（当本会话有云端访问权限时）你的云端会话，以及——在连接了 Remote Control 时——你账号下的其他会话。每一行按类别标注。
+
+## 何时使用
+
+- 在给某个对等会话或子 agent 发消息之前，你需要它的精确名称。
+- 你想看看当前有哪些会话可从本会话到达。
+
+## 启用方式
+
+- 需要 Claude Code 2.1.224+ 以及跨会话消息（一个服务端功能开关，默认关闭）。
+- 跨会话消息在 Amazon Bedrock、Claude Platform on AWS、Google Cloud Agent Platform 和 Microsoft Foundry 上不可用。
+- 当设置了 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`、`DISABLE_TELEMETRY`、`DO_NOT_TRACK` 或 `DISABLE_GROWTHBOOK` 时关闭。
+- 用 `CLAUDE_CODE_HARBOR_KITE=1` 强制启用。
+
+## 参数
+
+- `channel` (string, 可选)：本构建中不可用；保持不设置。
+- `q` (string, 可选)：本构建中不可用；保持不设置。
+
+## 示例
+
+### 示例 1：列出可达的 agent
+
+```
+ListAgents()
+```
+
+每行打印一个名字——这个名字就是地址。用 `SendMessage({to: "<name>", message: "..."})` 发送，名字按打印的原样复制。仅当裸名字有歧义（两行共用同一名字，或报错要求你消歧）时才附加该行的 ` [ref]`。
+
+## 注意事项
+
+- 只读且并发安全。
+- 云端会话能收到你的消息，但暂时还不能回消息——请在它自己的转录中读取其回答。

package/concepts/zh/Tool-ListConnectors.md

@@ -0,0 +1,34 @@
+# ListConnectors
+
+列出用户 claude.ai 组织已安装的 MCP 连接器，可选按关键词过滤。
+
+## 何时使用
+
+- 在建议新连接器之前，你需要知道已安装了哪些。
+- 用户询问他们组织有哪些集成。
+
+## 启用方式
+
+- 仅在第一方 API 的远程（claude.ai）会话中可用。
+
+## 参数
+
+- `keywords` (array of strings, 可选)：过滤列表——最多 8 项，每项 1–64 个字符。省略则列出全部。
+
+## 示例
+
+### 示例 1：列出所有已安装连接器
+
+```
+ListConnectors()
+```
+
+### 示例 2：按关键词过滤
+
+```
+ListConnectors(keywords=["github"])
+```
+
+## 注意事项
+
+- 与 `SearchMcpRegistry`（发现）和 `SuggestConnectors`（详情）搭配，构成完整的寻找-启用流程。

package/concepts/zh/Tool-ListMcpResources.md

@@ -0,0 +1,35 @@
+# ListMcpResources
+
+列出已连接 MCP 服务器暴露的资源，可选按单个服务器过滤。
+
+## 何时使用
+
+- 你需要在读取之前发现 MCP 服务器提供了哪些资源（文件、记录、文档）。
+- 你想总览所有已连接服务器的全部资源。
+
+## 启用方式
+
+- 始终启用，但不暴露在模型的工具列表中——面向 thin-client / sidecar 使用。
+
+## 参数
+
+- `server` (string, 可选)：用于过滤资源的服务器名称。省略则列出所有已连接服务器的资源。
+
+## 示例
+
+### 示例 1：列出全部
+
+```
+ListMcpResources()
+```
+
+### 示例 2：列出单个服务器的资源
+
+```
+ListMcpResources(server="github")
+```
+
+## 注意事项
+
+- 这是发现步骤：把感兴趣的 URI 交给 `ReadMcpResource`（单个资源）或 `ReadMcpResourceDir`（目录列表）。
+- 服务器在会话生命周期内会连接和断开；若某服务器刚被添加，请重新列出。

package/concepts/zh/Tool-ListPlugins.md

@@ -0,0 +1,35 @@
+# ListPlugins
+
+列出用户已启用的 claude.ai 插件，可选按关键词过滤。
+
+## 何时使用
+
+- 你需要知道已启用了哪些插件——例如，在 `SuggestPluginInstall` 卡片之后确认实际安装了什么。
+- 用户询问他们有哪些插件。
+
+## 启用方式
+
+- 需要插件注册表访问权限。
+- 可用性取决于会话类型和功能上线情况——在 HIPAA 环境中禁用，在远程会话中始终可用。
+
+## 参数
+
+- `keywords` (array of strings, 可选)：过滤列表——最多 8 项，每项 1–64 个字符。省略则列出全部。
+
+## 示例
+
+### 示例 1：列出已启用的插件
+
+```
+ListPlugins()
+```
+
+### 示例 2：按关键词过滤
+
+```
+ListPlugins(keywords=["figma"])
+```
+
+## 注意事项
+
+- 若插件目录不可达（被禁止），工具会降级为带警告的空列表，而不是失败。