cc-viewer 1.7.22 → 1.8.0

package/concepts/zh/Tool-TeamDelete.md

@@ -1,44 +0,0 @@
-# TeamDelete
-
-拆解当前活跃团队，移除其配置目录和共享任务目录。这是 `TeamCreate` 的清理对偶，通常在团队目标达成且所有队友已关停后调用。
-
-## 何时使用
-
-- 团队已完成工作，最终报告已交付给用户。
-- 团队创建有误，或其范围变化巨大以至于重新开始比继续更清爽。
-- 你需要创建新团队，但已有一个活跃团队——先删除旧的，因为同一时间只能领一个团队。
-- 团队已跨会话陈旧，`~/.claude/teams/` 下其持久化状态不再需要。
-
-当队友仍在运行时，不要调用——先通过 `SendMessage` 发送 `shutdown_request`，等待每个 `shutdown_response`，再删除。
-
-## 参数
-
-`TeamDelete` 在典型用法下不接受任何参数。它作用于调用会话所拥有的当前活跃团队。
-
-## 示例
-
-### 示例 1：成功后的例行关停
-
-1. 向团队广播 shutdown request：
-   ```
-   SendMessage(to="*", message={ "type": "shutdown_request" })
-   ```
-2. 等待每个队友以 `shutdown_response` 回复。
-3. 调用 `TeamDelete()` 移除团队目录与任务目录。
-
-### 示例 2：替换误配置的团队
-
-若 `TeamCreate` 传入了错误的 `agent_type` 或 `description`，请先确认尚未派生队友（或先关停它们），然后：
-
-```
-TeamDelete()
-TeamCreate(team_name="...", description="...", agent_type="...")
-```
-
-## 注意事项
-
-- 若仍有队友活跃，`TeamDelete` 会失败。错误响应会列出活跃队友——通过 `SendMessage` 向每个队友发送 `shutdown_request`，等待其 `shutdown_response`，然后重试。
-- 从工具视角看删除不可逆。团队的配置 `~/.claude/teams/{team_name}/config.json` 及其任务目录将从磁盘移除。如需保留任务列表，请在删除前导出或复制该目录。
-- 只有创建团队的负责人会话才能删除它。被派生的队友不能对自己的团队调用 `TeamDelete`。
-- 删除团队不会回滚队友在仓库中所做的文件系统改动。那些是普通的 git 跟踪编辑，如果不想保留必须另外回退。
-- 在 `TeamDelete` 成功返回后，会话可自由再次调用 `TeamCreate` 以新建团队。

package/concepts/zh/Tool-executeCode.md

@@ -1,47 +0,0 @@
-# executeCode
-
-在 IDE 集成提供的活跃内核或沙箱中执行一段代码（例如与当前打开 notebook 绑定的 Jupyter 内核）。该工具只有在 Claude Code 与兼容的 IDE 桥（如选择了 Jupyter 内核的 VS Code 扩展）同时运行时才存在。
-
-## 何时使用
-
-- 针对活跃 Jupyter 内核中已加载的状态，运行一次快速计算、数据检查或绘图。
-- 在粘入 notebook cell 之前验证一段代码。
-- 探索存在于内核但未序列化到磁盘的内存 dataframe、变量或模型。
-- 生成用户希望在 IDE 中内嵌渲染的图表或数值结果。
-
-不要用于独立脚本——那些更适合 `Bash` 运行 `python script.py`；也不要用于需要跨新内核持久化的代码。
-
-## 参数
-
-- `code` (string, 必填)：要在当前内核中执行的代码。像粘进 notebook cell 一样运行——定义的变量会在内核中持久，直到重启。
-- `language` (string, 可选)：当 IDE 桥支持多种内核时，代码片段的语言。通常省略；默认使用活跃内核的语言（通常是 Python）。
-
-## 示例
-
-### 示例 1：检查内存中的 dataframe
-
-```
-executeCode(
-  code="df.head()\nprint(df.shape)\nprint(df.dtypes)"
-)
-```
-
-返回内核中已加载的 dataframe 的前几行、形状和列 dtype。
-
-### 示例 2：一次性数值检查
-
-```
-executeCode(
-  code="import numpy as np\nnp.mean([1, 2, 3, 4, 5])"
-)
-```
-
-在不新建 notebook cell 的前提下运行一次性计算。
-
-## 注意事项
-
-- `executeCode` 是 IDE 桥工具。在 Claude Code 的纯终端会话中不可用；它只在会话连接到暴露内核的 IDE（例如 VS Code Jupyter 扩展）时出现。
-- 状态在内核中持久。一次 `executeCode` 调用定义的变量对后续调用、notebook cell 及用户都可见——当心副作用。
-- 长时间运行或阻塞的代码会阻塞内核。片段应保持简短；多分钟工作请写成真正的脚本并通过 `Bash` 运行。
-- 输出（stdout、返回值、图像）会回传到会话。非常大的输出可能被 IDE 桥截断。
-- 文件编辑请优先使用 `Edit`、`Write` 或 `NotebookEdit`——`executeCode` 不是撰写源文件的替代品。

package/concepts/zh/Tool-getDiagnostics.md

@@ -1,44 +0,0 @@
-# getDiagnostics
-
-从连接的 IDE 获取特定文件或当前所有打开文件的语言服务诊断（错误、警告、提示）。用于在宣告任务完成前验证代码改动是否干净编译。
-
-## 何时使用
-
-- 在 `Edit` 或 `Write` 之后，确认改动没有引入类型错误、语法错误或 lint 警告。
-- 在结束任务之前，扫视每个打开文件是否存在未解决的问题。
-- 在诊断用户报告的错误时——从 IDE 直接拉取编译器或类型检查器的精确消息，避免凭空猜测。
-- 当你只需检查静态正确性时，可作为运行完整构建或测试命令的轻量替代。
-
-不要把 `getDiagnostics` 当作测试套件的替代。它报告语言服务所见，并不等于测试或生产时运行的结果。
-
-## 参数
-
-- `uri` (string, 可选)：要获取诊断的文件 URI（通常为 `file:///absolute/path`）。省略时，工具返回 IDE 当前打开的每个文件的诊断。
-
-## 示例
-
-### 示例 1：编辑后检查单个文件
-
-```
-getDiagnostics(
-  uri="file:///Users/sky/project/src/auth.ts"
-)
-```
-
-返回 `src/auth.ts` 的任何 TypeScript 错误、ESLint 警告或其他语言服务消息。
-
-### 示例 2：扫视所有打开文件
-
-```
-getDiagnostics()
-```
-
-返回每个当前打开编辑器的诊断。多文件重构结束时很有用，可确保别处未出现回退。
-
-## 注意事项
-
-- `getDiagnostics` 是 IDE 桥工具。它仅在 Claude Code 连接到受支持的 IDE 集成（例如 VS Code 扩展）时可用。在纯终端会话中工具不会出现。
-- 结果反映 IDE 加载的语言服务——TypeScript、Pyright、ESLint、rust-analyzer 等。质量与覆盖取决于用户的 IDE 配置，而非 Claude Code。
-- 诊断是实时的。编辑后请给语言服务一点时间重新分析，再把空结果当作成功——若文件刚保存请重跑一次。
-- 严重级别通常包含 `error`、`warning`、`information`、`hint`。优先关注 `error`；警告可能是项目风格所致。
-- 对于当前未在 IDE 中打开的文件，即使文件真的有问题，语言服务也可能没有诊断可报告。请打开该文件或运行构建以获得权威覆盖。

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

@@ -1,53 +0,0 @@
-# TeamCreate
-
-建立一個具有共享任務清單與代理間訊息頻道的新協作團隊。團隊是多代理工作的協調原語——主工作階段擔任領導，並透過 `Agent` 工具派生具名隊友。
-
-## 使用時機
-
-- 使用者明確要求團隊、swarm、crew 或多代理協作。
-- 專案有多個明顯獨立的工作流，適合交給專屬角色（例如前端、後端、測試、文件）。
-- 你需要由多個代理共同更新進度的持久共享任務清單。
-- 你想要具名且可尋址的隊友，透過 `SendMessage` 交換訊息，而不只是一次性的子代理呼叫。
-
-不要為了單次委派搜尋或一次性平行扇出而使用——純 `Agent` 呼叫更輕量也足夠。
-
-## 參數
-
-- `team_name`（string，必填）：團隊的唯一識別碼。作為 `~/.claude/teams/` 下的目錄名稱，也作為派生隊友時的 `team_name` 參數。
-- `description`（string，必填）：團隊目標的簡短陳述。每位隊友派生時會看到，並寫入團隊設定。
-- `agent_type`（string，選填）：套用在未覆寫此值之隊友上的預設子代理角色。常見值為 `general-purpose`、`Explore` 或 `Plan`。
-
-## 範例
-
-### 範例 1：建立重構團隊
-
-```
-TeamCreate(
-  team_name="refactor-crew",
-  description="Refactor the data access layer from raw SQL to Prisma, including migrations and tests.",
-  agent_type="general-purpose"
-)
-```
-
-建立後，以 `Agent` 搭配 `team_name: "refactor-crew"` 與不同的 `name` 值（例如 `db-lead`、`migrations`、`tests`）派生隊友。
-
-### 範例 2：建立調查團隊
-
-```
-TeamCreate(
-  team_name="perf-investigation",
-  description="Identify and rank the top three performance regressions introduced in the last release.",
-  agent_type="Explore"
-)
-```
-
-每位被派生的隊友都繼承 `Explore` 為預設角色，呼應此工作的唯讀調查性質。
-
-## 注意事項
-
-- 單一工作階段同時只能領導一個團隊。先結束或刪除目前的團隊，再建立另一個。
-- 團隊與共享任務清單為 1:1。領導負責任務建立、指派與結案；隊友則更新自己正在進行的任務狀態。
-- 團隊設定會持久化於 `~/.claude/teams/{team_name}/config.json`，而任務目錄位於其旁邊。這些檔案會跨工作階段保留，直到以 `TeamDelete` 明確移除。
-- 隊友以 `Agent` 工具搭配相同 `team_name` 加上不同 `name` 派生。`name` 成為 `SendMessage` 用來尋址的位址。
-- 挑選對檔案系統友善的 `team_name`（字母、數字、破折號、底線）。避免空白或斜線。
-- 寫 `description` 時要假設一位全新的隊友會冷讀——他應能在無額外背景下理解團隊目標。它會成為每位隊友開機 prompt 的一部分。

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

@@ -1,44 +0,0 @@
-# TeamDelete
-
-拆除目前作用中的團隊，移除其設定目錄與共享任務目錄。這是 `TeamCreate` 的清理對應工具，通常在團隊目標達成且所有隊友關閉後呼叫。
-
-## 使用時機
-
-- 團隊已完成工作，最終報告已交給使用者。
-- 團隊是誤建，或其範圍劇烈改變，重新開始比繼續更乾淨。
-- 你需要建立新團隊，但已有一個作用中的團隊——先刪除舊的，因為一次只能領導一個團隊。
-- 團隊跨工作階段後變得陳舊，`~/.claude/teams/` 下的持久狀態已不再需要。
-
-不要在隊友仍在執行時呼叫——先透過 `SendMessage` 發送 `shutdown_request` 關閉他們，等每個 `shutdown_response` 收到後再刪除。
-
-## 參數
-
-`TeamDelete` 在典型呼叫中不接受任何參數。它作用於呼叫工作階段所擁有、當前作用中的團隊。
-
-## 範例
-
-### 範例 1：成功後的例行關閉
-
-1. 向團隊廣播關閉請求：
-   ```
-   SendMessage(to="*", message={ "type": "shutdown_request" })
-   ```
-2. 等每位隊友回覆 `shutdown_response`。
-3. 呼叫 `TeamDelete()` 以移除團隊目錄與任務目錄。
-
-### 範例 2：替換設定錯誤的團隊
-
-若 `TeamCreate` 以錯誤的 `agent_type` 或 `description` 被呼叫，先確認尚未派生任何隊友（或已將其關閉），然後：
-
-```
-TeamDelete()
-TeamCreate(team_name="...", description="...", agent_type="...")
-```
-
-## 注意事項
-
-- 若仍有隊友在執行，`TeamDelete` 會失敗。錯誤回應會列出在線的隊友——透過 `SendMessage` 傳送 `shutdown_request` 給每個，等候他們的 `shutdown_response`，然後重試。
-- 從工具的角度看，刪除是不可逆的。團隊位於 `~/.claude/teams/{team_name}/config.json` 的設定與其任務目錄會從磁碟移除。若需保留任務清單，請在刪除前匯出或複製該目錄。
-- 只有建立團隊的領導工作階段可以刪除它。被派生的隊友無法對自己團隊呼叫 `TeamDelete`。
-- 刪除團隊不會回溯隊友在 repo 中所做的任何檔案系統變更。那些是一般 git 追蹤的編輯，若不需要必須另行還原。
-- `TeamDelete` 成功回傳後，該工作階段可再次呼叫 `TeamCreate` 以建立新團隊。

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

@@ -1,47 +0,0 @@
-# executeCode
-
-在由 IDE 整合提供的活動 kernel 或 sandbox 中執行程式碼片段（例如目前開啟的 notebook 所綁定的 Jupyter kernel）。此工具只在 Claude Code 與相容的 IDE bridge 一起執行時才存在，例如選取了 Jupyter kernel 的 VS Code 擴充套件。
-
-## 使用時機
-
-- 對運作中的 Jupyter kernel 上已載入的狀態執行快速計算、資料檢查或繪圖。
-- 在把某段程式碼貼進 notebook cell 之前驗證它。
-- 探索存在於 kernel、但尚未序列化至磁碟的 in-memory dataframe、變數或模型。
-- 產生圖表或數值結果，讓使用者可在 IDE 中內嵌檢視。
-
-不要用於獨立指令稿——那更適合透過 `Bash` 執行 `python script.py`——也不要用於需要在新 kernel 中持續存在的程式碼。
-
-## 參數
-
-- `code`（string，必填）：要在目前 kernel 中執行的程式碼。執行效果如同貼到一個 notebook cell；定義的變數會保留在 kernel 中，直到 kernel 重新啟動。
-- `language`（string，選填）：當 IDE bridge 支援多個 kernel 時的片段語言。多數情況下省略；預設為作用中 kernel 的語言（通常為 Python）。
-
-## 範例
-
-### 範例 1：檢視 in-memory dataframe
-
-```
-executeCode(
-  code="df.head()\nprint(df.shape)\nprint(df.dtypes)"
-)
-```
-
-回傳已載入 kernel 的 dataframe 的前幾列、形狀與欄位 dtype。
-
-### 範例 2：快速數值檢查
-
-```
-executeCode(
-  code="import numpy as np\nnp.mean([1, 2, 3, 4, 5])"
-)
-```
-
-執行一次性計算，不建立 notebook cell。
-
-## 注意事項
-
-- `executeCode` 是 IDE bridge 工具。在 Claude Code 的純終端工作階段中無法使用；只有在工作階段連接到提供 kernel 的 IDE（例如 VS Code Jupyter 擴充套件）時才會出現。
-- 狀態會在 kernel 中保留。某次 `executeCode` 呼叫所定義的變數對後續呼叫、notebook cell 與使用者都可見——請注意副作用。
-- 長時間或阻塞的程式碼會阻塞 kernel。保持片段短小；對於耗時數分鐘的工作，請撰寫實際的指令稿並透過 `Bash` 執行。
-- 輸出（stdout、回傳值、圖片）會回傳給工作階段。非常大的輸出可能被 IDE bridge 截斷。
-- 對於檔案編輯，優先使用 `Edit`、`Write` 或 `NotebookEdit`——`executeCode` 不是撰寫原始檔的替代方案。

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

@@ -1,44 +0,0 @@
-# getDiagnostics
-
-從已連接的 IDE 擷取語言伺服器診斷（錯誤、警告、提示），可針對特定檔案或 IDE 目前開啟的所有檔案。用它在宣告任務完成之前確認程式碼變更能乾淨地編譯。
-
-## 使用時機
-
-- 在 `Edit` 或 `Write` 之後，確認變更未引入型別錯誤、語法錯誤或 lint 警告。
-- 在結束任務前掃過每個開啟的檔案，清查未解的問題。
-- 診斷使用者回報的錯誤時——從 IDE 中取得確切的編譯器或型別檢查訊息可避免臆測。
-- 只需檢查靜態正確性時，作為跑完整建構或測試指令的輕量替代。
-
-不要把 `getDiagnostics` 當成測試套件的替代品。它只回報語言伺服器所見，而不是測試或正式環境中實際執行的行為。
-
-## 參數
-
-- `uri`（string，選填）：要擷取診斷的檔案 URI（通常為 `file:///absolute/path`）。省略時會回傳 IDE 目前開啟的每個檔案的診斷。
-
-## 範例
-
-### 範例 1：編輯後檢查單一檔案
-
-```
-getDiagnostics(
-  uri="file:///Users/sky/project/src/auth.ts"
-)
-```
-
-回傳 `src/auth.ts` 的任何 TypeScript 錯誤、ESLint 警告或其他語言伺服器訊息。
-
-### 範例 2：掃過所有開啟的檔案
-
-```
-getDiagnostics()
-```
-
-回傳每個目前開啟編輯器的診斷。在多檔重構結束時很有用，可確保其他地方沒有退步。
-
-## 注意事項
-
-- `getDiagnostics` 是 IDE bridge 工具。只有在 Claude Code 連接到支援的 IDE 整合（例如 VS Code 擴充套件）時才可用。在純終端工作階段中，此工具不會出現。
-- 結果反映 IDE 所載入的語言伺服器——TypeScript、Pyright、ESLint、rust-analyzer 等。品質與覆蓋範圍取決於使用者的 IDE 設定，而非 Claude Code。
-- 診斷是即時的。在編輯之後，請給語言伺服器一點時間重新分析，再把空結果解讀為成功——若檔案剛存檔，可重新執行一次。
-- 嚴重程度通常包含 `error`、`warning`、`information` 與 `hint`。先處理 `error`；warning 可能是專案刻意的風格。
-- 對於目前未在 IDE 中開啟的檔案，即使實際有問題，語言伺服器也可能沒有診斷可回報。請開啟檔案，或以建構流程取得權威涵蓋範圍。