cc-viewer 1.7.21 → 1.7.23

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

@@ -10,6 +10,11 @@
 
 如果某工具的 schema 已经在上下文里,就不要再搜一遍——直接调用即可。
 
+## 启用方式
+
+- 默认开启。
+- 当 `ANTHROPIC_BASE_URL` 指向非 Anthropic 端点（除非设置了 `ENABLE_TOOL_SEARCH`）、设置了 `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`、模型缺少工具引用支持（Claude 4.5 之前的 Vertex AI 模型），或通过 `"deny": ["ToolSearch"]` 被拒绝时关闭。
+
 ## 参数
 
 - `query` (string, 必填)：用于定位延迟工具的查询,支持三种写法:

package/concepts/zh/Tool-WebSearch.md

@@ -10,6 +10,12 @@
 - 核实自模型训练以来可能已变化的事实。
 - 在用 `WebFetch` 获取某个单页之前，先对某主题了解多方观点。
 
+## 启用方式
+
+- 可用性取决于提供方和模型：在 Anthropic API 和 Claude Platform on AWS 上可用；在 Microsoft Foundry 上需要 Anthropic 托管的部署；在 Google Cloud 上适用于 Claude 4+ 模型。
+- 在 Amazon Bedrock 上不可用。
+- 用 `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` 将每个会话的调用次数上限设为 200。
+
 ## 参数
 
 - `query` (string, 必填)：搜索查询。最小长度 2 个字符。询问「最新」或「最近」的信息时，在查询中包含当前年份，以确保结果新鲜。

package/concepts/zh/Tools.md

@@ -15,6 +15,7 @@ Claude Code 通过 Anthropic API 的 tool_use 机制向模型提供一组内置
 | [TaskGet](Tool-TaskGet.md) | 获取任务详情 |
 | [TaskUpdate](Tool-TaskUpdate.md) | 更新任务状态、依赖关系等 |
 | [TaskList](Tool-TaskList.md) | 列出所有任务 |
+| [ListAgents](Tool-ListAgents.md) | 列出会话中可用的 agent |
 
 ## 文件操作
 
@@ -29,11 +30,13 @@ Claude Code 通过 Anthropic API 的 tool_use 机制向模型提供一组内置
 
 | 工具 | 用途 |
 |------|------|
-| [TeamCreate](Tool-TeamCreate.md) | 为协作工作创建 agent 团队 |
-| [TeamDelete](Tool-TeamDelete.md) | 解散 agent 团队 |
 | [SendMessage](Tool-SendMessage.md) | 向另一个 agent 发送消息 |
 | [Workflow](Tool-Workflow.md) | 运行确定性多 agent 编排脚本 |
 | [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 通过 Anthropic API 的 tool_use 机制向模型提供一组内置
 | 工具 | 用途 |
 |------|------|
 | [Bash](Tool-Bash.md) | 执行 shell 命令 |
+| [REPL](Tool-REPL.md) | 在持久化 Node.js REPL 中运行 JavaScript |
 
 ## Web
 
@@ -66,6 +70,10 @@ Claude Code 通过 Anthropic API 的 tool_use 机制向模型提供一组内置
 | [ExitPlanMode](Tool-ExitPlanMode.md) | 退出规划模式并提交方案供用户审批 |
 | [AskUserQuestion](Tool-AskUserQuestion.md) | 向用户提问以获取澄清或决策 |
 | [ReportFindings](Tool-ReportFindings.md) | 将代码审查发现报告为主机 UI 的类型化列表 |
+| [TodoWrite](Tool-TodoWrite.md) | 为会话写入结构化 todo 列表 |
+| [SendFeedback](Tool-SendFeedback.md) | 向 Anthropic 发送关于 Claude Code 的结构化反馈 |
+| [Projects](Tool-Projects.md) | 管理项目知识库文档 |
+| [ProposeGoal](Tool-ProposeGoal.md) | 为会话提出可验证的完成目标 |
 
 ## 工作树
 
@@ -84,6 +92,7 @@ Claude Code 通过 Anthropic API 的 tool_use 机制向模型提供一组内置
 | [ScheduleWakeup](Tool-ScheduleWakeup.md) | 通过安排下一次唤醒来自行调整 /loop 迭代 |
 | [PushNotification](Tool-PushNotification.md) | 向用户发送桌面/移动通知 |
 | [RemoteTrigger](Tool-RemoteTrigger.md) | 管理 claude.ai 远程触发例程 |
+| [ReadNotifications](Tool-ReadNotifications.md) | 读取会话中待处理的通知 |
 
 ## 扩展
 
@@ -91,10 +100,23 @@ Claude Code 通过 Anthropic API 的 tool_use 机制向模型提供一组内置
 |------|------|
 | [Skill](Tool-Skill.md) | 执行技能（slash command） |
 
+## MCP 与扩展
+
+| 工具 | 用途 |
+|------|------|
+| [ListMcpResources](Tool-ListMcpResources.md) | 列出已连接 MCP 服务器暴露的资源 |
+| [ReadMcpResource](Tool-ReadMcpResource.md) | 按 URI 读取单个 MCP 服务器资源 |
+| [ReadMcpResourceDir](Tool-ReadMcpResourceDir.md) | 按 URI 列出目录型 MCP 资源 |
+| [SearchMcpRegistry](Tool-SearchMcpRegistry.md) | 按关键词搜索 MCP 连接器注册表 |
+| [SuggestConnectors](Tool-SuggestConnectors.md) | 从注册表搜索结果中解析连接器详情 |
+| [ListConnectors](Tool-ListConnectors.md) | 列出已安装的 MCP 连接器 |
+| [SuggestPluginInstall](Tool-SuggestPluginInstall.md) | 渲染内联插件安装卡片 |
+| [SuggestSkills](Tool-SuggestSkills.md) | 渲染可添加 skill 的卡片 |
+| [ListPlugins](Tool-ListPlugins.md) | 列出已启用的 claude.ai 插件 |
+| [ListSkills](Tool-ListSkills.md) | 列出已启用的 claude.ai skill |
+
 ## IDE 集成
 
 | 工具 | 用途 |
 |------|------|
-| [getDiagnostics](Tool-getDiagnostics.md) | 获取 VS Code 语言诊断信息 |
-| [executeCode](Tool-executeCode.md) | 在 Jupyter kernel 中执行代码 |
 | [LSP](Tool-LSP.md) | 语言服务器查询（定义、引用、符号） |

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

@@ -10,6 +10,11 @@
 - 查找介面或抽象方法的實作（`goToImplementation`）
 - 遍歷函式的呼叫階層（`prepareCallHierarchy`、`incomingCalls`、`outgoingCalls`）
 
+## 啟用方式
+
+- 在安裝該語言的程式碼智慧外掛之前保持停用（伺服器二進位檔另行安裝）。
+- 此工具僅在 LSP 用戶端連線時才會出現。
+
 ## 參數
 
 - `operation`（字串，必填）：上述操作之一。

package/concepts/zh-TW/Tool-ListAgents.md

@@ -0,0 +1,35 @@
+# ListAgents
+
+列出你可以傳送 `SendMessage` 的 agent：你啟動的行程內 SubAgent、這台機器上的其他本地 Claude 工作階段、你的雲端工作階段（當此工作階段具備雲端存取時），以及——當 Remote Control 已連線時——你帳號的其他工作階段。每一列以種類標示。
+
+## 使用時機
+
+- 在傳送訊息之前，你需要同儕工作階段或 SubAgent 的確切名稱。
+- 你想查看目前哪些工作階段可從此處連線。
+
+## 啟用方式
+
+- 需要 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-TW/Tool-ListConnectors.md

@@ -0,0 +1,34 @@
+# ListConnectors
+
+列出為使用者的 claude.ai 組織安裝的 MCP connector，可選擇性以關鍵字過濾。
+
+## 使用時機
+
+- 在建議新的 connector 之前，你需要知道已安裝哪些。
+- 使用者詢問他們的組織有哪些整合。
+
+## 啟用方式
+
+- 僅在第一方 API 的遠端（claude.ai）工作階段中可用。
+
+## 參數
+
+- `keywords`（string 陣列，選填）：過濾清單——最多 8 個項目，每個 1–64 個字元。省略則列出全部。
+
+## 範例
+
+### 範例 1：列出所有已安裝的 connector
+
+```
+ListConnectors()
+```
+
+### 範例 2：以關鍵字過濾
+
+```
+ListConnectors(keywords=["github"])
+```
+
+## 注意事項
+
+- 搭配 `SearchMcpRegistry`（探索）與 `SuggestConnectors`（詳情）完成完整的尋找並啟用流程。

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

@@ -0,0 +1,35 @@
+# ListPlugins
+
+列出使用者已啟用的 claude.ai 外掛，可選擇性以關鍵字過濾。
+
+## 使用時機
+
+- 你需要知道哪些外掛已啟用——例如，在 `SuggestPluginInstall` 卡片之後確認安裝了什麼。
+- 使用者詢問他們有哪些外掛。
+
+## 啟用方式
+
+- 需要外掛登錄檔存取權限。
+- 可用性取決於工作階段類型與功能推出——在 HIPAA 環境中停用，在遠端工作階段中一律可用。
+
+## 參數
+
+- `keywords`（string 陣列，選填）：過濾清單——最多 8 個項目，每個 1–64 個字元。省略則列出全部。
+
+## 範例
+
+### 範例 1：列出已啟用的外掛
+
+```
+ListPlugins()
+```
+
+### 範例 2：以關鍵字過濾
+
+```
+ListPlugins(keywords=["figma"])
+```
+
+## 注意事項
+
+- 若外掛目錄無法連線（禁止存取），工具會降級為帶警告的空清單，而非失敗。

package/concepts/zh-TW/Tool-ListSkills.md

@@ -0,0 +1,37 @@
+# ListSkills
+
+列出使用者已啟用的 claude.ai skills，可選擇性以關鍵字過濾。
+
+## 使用時機
+
+- 你需要目前啟用中之 skills 的權威清單——在呼叫某個 skill 之前，或確認 `SuggestSkills` 卡片新增了什麼。
+- 使用者詢問他們有哪些 skills。
+
+## 啟用方式
+
+- 需要外掛登錄檔存取權限。
+- 在 HIPAA 環境中停用。
+- 在遠端工作階段中一律可用。
+
+## 參數
+
+- `keywords`（string 陣列，選填）：過濾清單——最多 8 個項目，每個 1–64 個字元。省略則列出全部。
+
+## 範例
+
+### 範例 1：列出已啟用的 skills
+
+```
+ListSkills()
+```
+
+### 範例 2：以關鍵字過濾
+
+```
+ListSkills(keywords=["review"])
+```
+
+## 注意事項
+
+- 若目錄無法連線（禁止存取），工具會降級為帶警告的空清單，而非失敗。
+- 這列出*已啟用*的 skills；使用 `SuggestSkills` 來浮現使用者可新增的 skills。

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

@@ -0,0 +1,47 @@
+# REPL
+
+在工作階段內的持久性 Node.js vm context 中執行 JavaScript。支援頂層 `await`，且在一次呼叫中定義的變數/函式在後續呼叫中仍然可用。
+
+## 使用時機
+
+- 快速計算、資料轉換或 JSON 處理——用程式碼比 shell 單行指令更輕鬆。
+- 多步驟腳本作業，其中間狀態需要在呼叫之間保留（計數器、累積結果）。
+- 在寫入檔案之前，以互動方式探查 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-TW/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-TW/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` 深入看起來相關的條目。