cc-viewer 1.7.21 → 1.7.23

package/concepts/zh/Tool-ListSkills.md

@@ -0,0 +1,37 @@
+# ListSkills
+
+列出用户已启用的 claude.ai skill，可选按关键词过滤。
+
+## 何时使用
+
+- 你需要当前已启用 skill 的权威列表——在调用某个 skill 之前，或确认 `SuggestSkills` 卡片添加了什么。
+- 用户询问他们有哪些 skill。
+
+## 启用方式
+
+- 需要插件注册表访问权限。
+- 在 HIPAA 环境中禁用。
+- 在远程会话中始终可用。
+
+## 参数
+
+- `keywords` (array of strings, 可选)：过滤列表——最多 8 项，每项 1–64 个字符。省略则列出全部。
+
+## 示例
+
+### 示例 1：列出已启用的 skill
+
+```
+ListSkills()
+```
+
+### 示例 2：按关键词过滤
+
+```
+ListSkills(keywords=["review"])
+```
+
+## 注意事项
+
+- 若目录不可达（被禁止），工具会降级为带警告的空列表，而不是失败。
+- 本工具列出*已启用*的 skill；用 `SuggestSkills` 呈现用户可以添加的 skill。

package/concepts/zh/Tool-Monitor.md

@@ -10,6 +10,13 @@
 - 在多次迭代中等待特定条件（例如训练步骤里程碑或队列清空）
 - **不适用于**简单的"等待完成"场景——请改用带 `run_in_background` 的 `Bash`，它会在进程退出时发送一次完成通知
 
+## 启用方式
+
+- 默认关闭（服务端功能开关）。
+- 在 Amazon Bedrock、Google Cloud 和 Microsoft Foundry 上不可用。
+- 当设置了 `DISABLE_TELEMETRY` 或 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 时关闭。
+- WebSocket 源需要 Claude Code 2.1.195+。
+
 ## 参数
 
 - `command`（字符串，必填）：要运行的 shell 命令或脚本。写入标准输出的每一行都会成为独立的通知事件。进程退出后监视器结束。

package/concepts/zh/Tool-Projects.md

@@ -0,0 +1,46 @@
+# Projects
+
+管理用户 Claude 项目知识库中的项目文档：读取、搜索、写入和删除文档，或获取项目信息。
+
+## 何时使用
+
+- 将文档（交付物、笔记、参考资料）持久化到用户项目中，使其在会话结束后依然存在。
+- 读取或搜索现有项目文档，让当前任务基于先前的上下文。
+- 将本地文件上传到项目中，而无需把其内容加载进上下文。
+- 删除过时的项目文档。
+
+## 参数
+
+- `method` (string, 必填)：`project_info`、`project_read`、`project_search`、`project_write`、`project_delete` 之一。
+- `path` (string, 可选)：用于 `project_read`/`project_write`/`project_delete`：文档路径。用于 `project_write`：已存在的路径会被就地替换；新的裸文件名（不含 "/"）会命名空间化为 `claude/<name>`。
+- `content` (string, 可选)：用于 `project_write`：内联文档文本。与 `local_path` 互斥。
+- `local_path` (string, 可选)：用于 `project_write`：工作目录内要上传的文件——其内容永远不会进入你的上下文。与 `content` 互斥。
+- `present_to_user` (boolean, 可选)：用于 `project_write`：将该文档标记为用户需要查看的交付物。默认 false；例行保存和批量写入时保持不设置。
+- `query` (string, 可选)：用于 `project_search`：知识库查询。
+- `n` (number, 可选)：用于 `project_search`：命中数量（默认 5）。
+
+## 示例
+
+### 示例 1：把交付物写入项目
+
+```
+Projects(
+  method="project_write",
+  path="claude/migration-plan.md",
+  local_path="./migration-plan.md",
+  present_to_user=true
+)
+```
+
+上传本地文件而不把其内容拉进上下文，并将其标记为用户的交付物。
+
+### 示例 2：搜索知识库
+
+```
+Projects(method="project_search", query="authentication refresh tokens", n=5)
+```
+
+## 注意事项
+
+- `content` 用于你内联撰写的文本；`local_path` 用于磁盘上已有的任何内容——永远不要把两者混用。
+- 谨慎使用 `present_to_user=true`：只用于用户要求或必须处理的那一份文档。

package/concepts/zh/Tool-ProposeGoal.md

@@ -0,0 +1,43 @@
+# ProposeGoal
+
+为会话提出一个可验证的完成目标。该目标（默认）在审批对话框中展示给用户，一旦设定，便引导后续对话朝着一个可检查的结果推进。
+
+## 何时使用
+
+- 会话有一个评估者可以从对话中验证的具体终态（例如「test/auth 中的所有测试通过」）。
+- 你希望在开始实质工作之前，让用户明确确认「完成」的含义。
+- 用户自己的话已经陈述了结果，你希望将其记录为会话目标。
+
+## 启用方式
+
+- 默认关闭（服务端功能开关）。
+- 不用于交互式和后台会话。
+- 通过 `modelProposedGoals: "disabled"` 设置键关闭。
+
+## 参数
+
+- `condition` (string, 必填)：完成条件，写法要让一个独立的评估者能从对话中验证（例如「test/auth 中的所有测试通过（bun test 退出码为 0）」）。最多 500 个字符——用户必须能在审批对话框中读到完整条件。
+- `ask_user` (boolean, 可选)：设定目标之前是否征求用户审批。默认 true（展示审批对话框）。仅当用户在本对话中的原话已把该结果陈述为他们想要的时才设为 false；此时目标直接设定并显示可见提示，用户可用 `/goal clear` 清除。
+
+## 示例
+
+### 示例 1：提出有测试支撑的目标
+
+```
+ProposeGoal(condition="npm run test exits 0 with the new catalog cases included")
+```
+
+用户会在审批对话框中看到该条件，并可以接受、编辑或拒绝它。
+
+### 示例 2：直接采纳用户陈述的结果
+
+```
+ProposeGoal(condition="the login form validates email format and shows an inline error", ask_user=false)
+```
+
+仅当用户此前在对话中明确陈述过该结果时才有效。
+
+## 注意事项
+
+- 保持 `condition` 简短且可客观检查——含糊的目标（「做得更好」）达不到目的。
+- `ask_user=false` 严格限于用户自己陈述过的结果；其他一切都必须经过审批对话框。

package/concepts/zh/Tool-PushNotification.md

@@ -14,6 +14,12 @@
 
 不要在任务进行中发送常规进度更新通知，也不要在回答用户刚刚提出、显然还在等待的问题时发送通知。短任务完成时不要通知——如果用户刚提交并在等待，通知没有任何价值，反而会削弱对后续通知的信任。强烈建议默认不发送。
 
+## 启用方式
+
+- 默认关闭（服务端功能开关）。
+- 投递经由 Anthropic 托管的基础设施——在 Amazon Bedrock、Claude Platform on AWS、Google Cloud 或 Microsoft Foundry 上不可用。
+- 手机推送还需要连接 Remote Control 客户端。
+
 ## 参数
 
 - `message`（字符串，必填）：通知正文。保持在 200 个字符以内；移动操作系统会截断超长字符串。以用户会采取行动的内容开头："build failed: 2 auth tests" 比 "task complete" 更有用。

package/concepts/zh/Tool-REPL.md

@@ -0,0 +1,47 @@
+# REPL
+
+在会话内的持久化 Node.js vm 上下文中执行 JavaScript。支持顶层 `await`，一次调用中定义的变量/函数在后续调用中仍然可用。
+
+## 何时使用
+
+- 用代码比 shell 单行命令更容易的快速计算、数据转换或 JSON 处理。
+- 中间状态需要在调用之间保持的多步脚本（计数器、累计结果）。
+- 在写入文件之前，交互式地探测某个 API 或库的行为。
+
+## 启用方式
+
+- 默认关闭——设置 `CLAUDE_CODE_REPL=true` 启用。
+- 在终端（`cli`）和 claude.ai（`remote`）会话中，服务端功能开关也可能启用它。
+- 关闭时，REPL 不在模型的工具列表中。开启时，`Read`、`Glob`、`Grep`、`Bash`、`PowerShell` 和 `NotebookEdit` 被替换为 REPL 简写形式。
+
+## 参数
+
+- `code` (string, 必填)：要执行的 JavaScript 代码。支持顶层 await。状态在调用之间保持。
+- `description` (string, 可选)：对这个脚本做什么的清晰、简洁描述，用主动语态（5–10 个词），例如 "Trace upgrade message to its GrowthBook flag"。
+- `timeout` (number, 可选)：超时时间（毫秒）。默认 30000；最大 600000。
+
+## 示例
+
+### 示例 1：计算并复用状态
+
+```
+REPL(code="const counts = new Map(); ['a','b','a'].forEach(k => counts.set(k, (counts.get(k)||0)+1)); counts.get('a')")
+```
+
+返回 `2`；`counts` 在同一会话后续的 REPL 调用中仍然有定义。
+
+### 示例 2：带更长超时的顶层 await
+
+```
+REPL(
+  code="const res = await fetch('https://example.com/api'); await res.json()",
+  description="Fetch example API and parse JSON",
+  timeout=60000
+)
+```
+
+## 注意事项
+
+- 状态按会话隔离：重启会话会清除所有定义。
+- 这是 JavaScript（Node）环境——shell 命令、文件系统密集操作或非 JS 运行时请用 Bash。
+- 长时间运行的代码应显式设置 `timeout`；默认 30 秒会杀掉任何更慢的代码。

package/concepts/zh/Tool-ReadMcpResource.md

@@ -0,0 +1,32 @@
+# ReadMcpResource
+
+按 URI 读取一个已连接 MCP（Model Context Protocol）服务器暴露的单个资源。
+
+## 何时使用
+
+- MCP 服务器公示了某个资源（文件、记录、文档），你需要其内容进入上下文。
+- 你有一个具体的资源 URI——来自 `ListMcpResources`、服务器文档或先前的工具结果。
+
+## 启用方式
+
+- 始终启用，但不暴露在模型的工具列表中——面向 thin-client / sidecar 使用。
+
+## 参数
+
+- `server` (string, 必填)：MCP 服务器名称。
+- `uri` (string, 必填)：要读取的资源 URI。
+
+## 示例
+
+### 示例 1：按 URI 读取服务器资源
+
+```
+ReadMcpResource(server="github", uri="file:///repo/docs/architecture.md")
+```
+
+返回 `github` MCP 服务器提供的资源内容。
+
+## 注意事项
+
+- 若不清楚服务器暴露了哪些资源，先用 `ListMcpResources`；目录型列表用 `ReadMcpResourceDir`。
+- URI scheme 因服务器而异（`file://`、`https://`、自定义 scheme）——查看目标服务器公示的内容。

package/concepts/zh/Tool-ReadMcpResourceDir.md

@@ -0,0 +1,32 @@
+# ReadMcpResourceDir
+
+按 URI 列出一个已连接 MCP 服务器暴露的目录型资源的条目。
+
+## 何时使用
+
+- MCP 服务器以层级方式组织资源，你需要枚举该层级的一层。
+- 你想在用 `ReadMcpResource` 逐个读取之前先浏览。
+
+## 启用方式
+
+- 始终启用，但不暴露在模型的工具列表中——面向 thin-client / sidecar 使用。
+
+## 参数
+
+- `server` (string, 必填)：MCP 服务器名称。
+- `uri` (string, 必填)：要列出的目录资源 URI。
+
+## 示例
+
+### 示例 1：列出资源目录
+
+```
+ReadMcpResourceDir(server="filesystem", uri="file:///project/src/")
+```
+
+返回服务器在该目录 URI 下暴露的子条目。
+
+## 注意事项
+
+- 只有把资源建模为目录的服务器才支持本工具；扁平服务器会返回错误或空列表——此时回退到 `ListMcpResources`。
+- 与 `ReadMcpResource` 结合使用，深入看起来相关的条目。

package/concepts/zh/Tool-ReadNotifications.md

@@ -0,0 +1,27 @@
+# ReadNotifications
+
+读取当前会话中排队等待助手处理的通知——订阅的 PR 上的 GitHub 活动（`github_webhook`）、定时触发器的触发（`trigger_fire`），以及其他 Claude 会话发来的消息（`mcp_send_message`）。
+
+## 何时使用
+
+- 你被告知某事发生了——订阅的 PR 有更新、定时触发器触发、另一个会话给你发了消息——并且需要实际载荷。
+- 清空积压：大批通知会分批返回，因此要持续调用，直到结果报告 `remaining` 为 0。
+
+## 参数
+
+本工具不接受任何参数。
+
+## 示例
+
+### 示例 1：清空待处理通知
+
+```
+ReadNotifications()
+```
+
+按从旧到新的顺序返回排队的通知。结果中包含一个 `remaining` 计数，表示本次清空后仍排队的通知数量——再次调用本工具即可读取它们。
+
+## 注意事项
+
+- 每次清空有大小预算：后续调用返回的是同一队列的剩余部分（外加新到达的通知），而不只是新到达的通知。循环调用直到 `remaining` 为 0。
+- 通知来源于订阅 PR 上的 GitHub webhook、定时触发器以及其他 Claude 会话的消息；当前版本没有过滤参数。

package/concepts/zh/Tool-RemoteTrigger.md

@@ -10,6 +10,13 @@
 - 列出或审计所有当前触发器，以查看其配置和状态
 - 更新触发器设置，例如计划、负载或描述，而无需重新创建触发器
 
+## 启用方式
+
+- 需要 claude.ai Pro、Max、Team 或 Enterprise 套餐。
+- 在 Amazon Bedrock、Claude Platform on AWS、Google Cloud 或 Microsoft Foundry 上不可用。
+- 需要服务端功能开关以及 `allow_remote_sessions` / `allow_routines` 策略设置。
+- 不适用于远程会话本身。
+
 ## 参数
 
 - `action` (string, 必填)：要执行的操作 — 可选值为 `list`、`get`、`create`、`update` 或 `run`

package/concepts/zh/Tool-ScheduleWakeup.md

@@ -10,6 +10,11 @@
 - 运行无用户提示的自主循环——将字面量哨兵值 `<<autonomous-loop-dynamic>>` 作为 `prompt` 传入
 - 轮询即将发生状态变化的进程（使用较短延迟以保持缓存热态）
 
+## 启用方式
+
+- 在 Amazon Bedrock、Claude Platform on AWS、Google Cloud Agent Platform 或 Microsoft Foundry 上不可用。
+- 当功能开关获取被禁用（遥测/流量环境变量）时也关闭。
+
 ## 参数
 
 - `delaySeconds`（数字，必填）：距恢复的秒数。运行时会自动将值限制在 `[60, 3600]` 范围内，无需手动限制。

package/concepts/zh/Tool-SearchMcpRegistry.md

@@ -0,0 +1,31 @@
+# SearchMcpRegistry
+
+按关键词搜索 MCP 连接器注册表，以发现可能有助于完成任务的连接器。
+
+## 何时使用
+
+- 任务会受益于某个外部服务（数据库、issue 跟踪器、SaaS API），而你想确认是否存在对应的 MCP 连接器。
+- 用户点名某产品并要求连接它——在注册表中搜索匹配的连接器。
+
+## 启用方式
+
+- 仅在第一方 API 的远程（claude.ai）会话中可用。
+
+## 参数
+
+- `keywords` (array of strings, 必填)：描述用户意图或所点名产品的关键词短语。1–8 项，每项 1–64 个字符。
+
+## 示例
+
+### 示例 1：为点名产品找连接器
+
+```
+SearchMcpRegistry(keywords=["linear", "issue tracker"])
+```
+
+返回连接器与关键词匹配的注册表条目。用 `SuggestConnectors` 解析完整的连接器详情。
+
+## 注意事项
+
+- 只读且并发安全；结果大小有上限。
+- 搜索不会安装任何东西——纯粹是发现。

package/concepts/zh/Tool-SendFeedback.md

@@ -0,0 +1,38 @@
+# SendFeedback
+
+在不出会话的情况下，向 Anthropic 发送关于 Claude Code 的结构化反馈——bug 报告、功能想法或缺失的能力。
+
+## 何时使用
+
+- 用户要求报告 bug 或发送关于 Claude Code 本身的反馈。
+- 你遇到值得上报的明确产品缺陷（命令失效、行为错误、崩溃）。
+- 用户描述了一个希望存在的功能（想法或缺失的能力）。
+
+## 参数
+
+- `type` (string, 必填)：`bug`、`idea`、`missing_capability` 之一。
+- `title` (string, 必填)：简短、具体的问题单行摘要。
+- `details` (string, 必填)：按顺序排列的带标签要点：**What happened:**（观察到的现象 vs 预期，错误文本较短时附原文）；**What the user said:**（用户原话引用，或 "User didn't comment; observed by the model."）；**Repro:**（最小复现步骤）；**Evidence:**（请求 ID、时间戳、路径、版本——没有则省略）；可选地在末尾附 **Cause:**，仅当在会话内已验证时。每个要点一到三行；不要叙事段落、不要推测、不要秘密。
+- `area` (string, 可选)：命名本反馈涉及 Claude Code 哪个部分的简短标签（例如 "hooks config"、"/help"、"file editing"）。不清楚则留空。
+- `failure_mode` (string, 可选)：对于模型行为类报告，选择最接近的失败模式（例如 `instruction_following`、`repetition_and_looping`、`context_and_memory`、`stopping_short` 或 `other`）。仅在报告是纯产品/工具 bug 时省略。
+- `task_category` (string, 可选)：问题发生时会话正在做什么：`code_edit`、`debug`、`explain`、`plan`、`shell`、`search`、`review` 或 `other`。
+
+## 示例
+
+### 示例 1：报告产品 bug
+
+```
+SendFeedback(
+  type="bug",
+  title="/export truncates the last message",
+  details="**What happened:** exported transcript is missing the final assistant message.\n**What the user said:** \"the last reply never shows up in the file\".\n**Repro:** run /export after any multi-turn session.\n**Evidence:** v2.1.233, macOS.",
+  area="/export",
+  task_category="other"
+)
+```
+
+## 注意事项
+
+- 永远不要在 `details` 中包含秘密、token 或用户私有数据。
+- 尽可能引用用户的原文；否则说明是模型观察到的问题。
+- 保持报告基于事实——关于根因的推测只有在会话内已验证时才能写入 `**Cause:**`。

package/concepts/zh/Tool-SendFile.md

@@ -0,0 +1,36 @@
+# SendFile
+
+向另一个 Claude Code 会话——`ListAgents` 列出的对等方，或一个显式的会话地址——发送一个或多个文件。
+
+## 何时使用
+
+- 对等会话需要你工作目录中的文件（报告、补丁、fixture）来继续它自己的任务。
+- 你在跨会话协调工作，希望交接产物而不只是文本（文本用 `SendMessage`）。
+
+## 启用方式
+
+- 会话必须可用跨会话文件传输；不可用时，校验会以 "Cross-session file transfer is not available in this session." 失败。
+- 受与 `ListAgents` 相同的跨会话消息条件门控（服务端功能开关，默认关闭）。
+
+## 参数
+
+- `to` (string, 必填)：接收方——来自 `ListAgents` 的对等会话名，或显式的 `uds:<socket>` / `bridge:<session id>` 地址。
+- `files` (array of strings, 必填)：要发送的文件路径（绝对路径或相对于 cwd）。即使只有一个文件也始终传数组。1–16 个文件，每个最多 30 MiB。
+- `message` (string, 可选)：随文件一起发送的简短消息。
+
+## 示例
+
+### 示例 1：向对等会话发送报告
+
+```
+SendFile(
+  to="teammate-a",
+  files=["./dist/report.html"],
+  message="The analysis you asked for"
+)
+```
+
+## 注意事项
+
+- 传输到远程机器可能需要额外审批。
+- 读取文件内容是发送的一部分——若权限规则禁用了文件读取，则会被拒绝。

package/concepts/zh/Tool-SendMessage.md

@@ -10,6 +10,11 @@
 - 回复协议提示，例如团队负责人的关停请求或计划审批请求。
 - 在完成被委派的任务时收尾，让负责人可以把事项标记为完成。
 
+## 启用方式
+
+- 受与 `ListAgents` 相同的跨会话消息条件门控（服务端功能开关，默认关闭）。
+- 此外，队友功能还需要启用实验性 agent 团队。
+
 ## 参数
 
 - `to` (string, 必填)：目标队友在团队中注册的 `name`，或用 `*` 向所有队友广播。

package/concepts/zh/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/zh/Tool-SendUserMessage.md

@@ -0,0 +1,38 @@
+# SendUserMessage
+
+向用户发送消息——brief 风格会话中的主要可见输出通道。也以其旧版别名 `Brief` 为人所知。
+
+## 何时使用
+
+- 回复用户刚说的话（`status="normal"`）。
+- 主动呈现用户没有要求但现在需要看到的内容——他们离开时任务完成、你遇到的阻碍、未经请求的状态更新（`status="proactive"`）。
+
+## 启用方式
+
+- 默认在交互式会话中隐藏；大多数交互式 CLI 会话改为直接与用户对话。
+- 在 brief 模式或通过服务端功能开关启用。
+
+## 参数
+
+在 brief 模式下：
+
+- `message` (string, 必填)：给用户的消息。支持 markdown 格式。
+- `attachments` (array, 可选)：随消息显示的附件。每个条目要么是本地可读文件的路径（绝对路径或相对于 cwd），要么是从设备工具（如 `attach_file`）获得的预先解析的 `{file_uuid, file_name, size, is_image}` 对象。
+- `status` (string, 必填)：用户现在需要的未经请求的更新用 `proactive`；回复用户时用 `normal`。
+
+在非 brief 构建中只有 `message` 可用。
+
+## 示例
+
+### 示例 1：主动发送完成通知
+
+```
+SendUserMessage(
+  message="The migration finished — 42 files updated, tests green.",
+  status="proactive"
+)
+```
+
+## 注意事项
+
+- 谨慎使用 `proactive`——它用于确实需要用户现在注意的事情。

package/concepts/zh/Tool-SuggestConnectors.md

@@ -0,0 +1,28 @@
+# SuggestConnectors
+
+解析 `SearchMcpRegistry` 返回的 `directoryUuid` 值对应的完整连接器载荷，以便向用户提供可启用的具体连接器。
+
+## 何时使用
+
+- 在 `SearchMcpRegistry` 返回候选连接器之后，取回其完整详情用于展示。
+
+## 启用方式
+
+- 仅在第一方 API 的远程（claude.ai）会话中可用。
+
+## 参数
+
+- `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/zh/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 个描述该插件 skill 的 `{name, description?}` 条目。
+
+## 示例
+
+### 示例 1：提供匹配的插件
+
+```
+SuggestPluginInstall(
+  contextLabel="For reviewing pull requests",
+  plugins=[{pluginId="pr-toolkit", pluginName="PR Toolkit", description="Review helpers"}]
+)
+```
+
+卡片为用户渲染；启用插件在带外进行。后续调用 `ListPlugins` 可发现实际安装了什么。
+
+## 注意事项
+
+- 只包含来自搜索结果的插件——永远不要编造插件条目。

package/concepts/zh/Tool-SuggestSkills.md

@@ -0,0 +1,33 @@
+# SuggestSkills
+
+根据主题关键词渲染一张用户可以添加的独立 skill 卡片（尚未启用的 skill）。
+
+## 何时使用
+
+- 用户请求匹配了他们尚未启用的 skill（用户主动询问时 `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：按主题建议 skill
+
+```
+SuggestSkills(keywords=["data visualization", "charts"], contextLabel="For building the dashboard", trigger="user_asked")
+```
+
+已启用的 skill 会被从结果中过滤掉。
+
+## 注意事项
+
+- 只渲染建议卡片——添加 skill 在带外进行；之后调用 `ListSkills` 确认。

package/concepts/zh/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`。尽量不超过 80 字符。

package/concepts/zh/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 在任务生命周期内稳定。