diff options
Diffstat (limited to 'packages/web/src/content/docs/zh-tw/agents.mdx')
| -rw-r--r-- | packages/web/src/content/docs/zh-tw/agents.mdx | 229 |
1 files changed, 114 insertions, 115 deletions
diff --git a/packages/web/src/content/docs/zh-tw/agents.mdx b/packages/web/src/content/docs/zh-tw/agents.mdx index fe8b4496e..c4d3d656b 100644 --- a/packages/web/src/content/docs/zh-tw/agents.mdx +++ b/packages/web/src/content/docs/zh-tw/agents.mdx @@ -1,15 +1,15 @@ --- -title: Agents -description: 配置和使用專門的代理。 +title: 代理 +description: 設定和使用專門的代理。 --- -代理是專門的AI助手，可以針對特定任務和工作流程進行配置。它們允許您創建具有自定義提示、模型和工具訪問權限的專用工具。 +代理是專門的 AI 助理，可以針對特定任務和工作流程進行設定。它們允許您建立具有自定義提示、模型和工具存取權限的專用工具。 :::tip -使用計劃代理來分析程式碼並審查建議，而無需進行任何程式碼更改。 +使用計畫代理來分析程式碼並審閱建議，而無需進行任何程式碼變更。 ::: -您可以在會話期間在代理之間切換，或使用 `@` 提及來調用它們。 +您可以在工作階段期間在代理之間切換，或使用 `@` 提及來呼叫它們。 --- @@ -21,122 +21,121 @@ opencode 中有兩種類型的代理；主要代理和子代理。 ### 主要代理 -主要代理是與您直接互動的主要助手。您可以使用 **Tab** 鍵或您配置的 `switch_agent` 鍵綁定循環瀏覽它們。這些代理處理您的主要對話。工具訪問是通過權限配置的 - 例如，“構建”啟用了所有工具，而“計劃”則受到限制。 +主要代理是與您直接互動的主要助理。您可以使用 **Tab** 鍵或您設定的 `switch_agent` 鍵綁定循環切換它們。這些代理處理您的主要對話。工具存取是透過權限設定的 - 例如，「Build」啟用了所有工具，而「Plan」則受到限制。 :::tip -您可以在會話期間使用 **Tab** 鍵在主要代理之間切換。 +您可以在工作階段期間使用 **Tab** 鍵在主要代理之間切換。 ::: -opencode 附帶兩個內置的主要代理：**Build** 和 **Plan**。出色地 -看看下面這些。 +opencode 附帶兩個內建的主要代理：**Build** 和 **Plan**。我們將在下面看看這些。 --- ### 子代理 -子代理是主要代理可以調用來執行特定任務的專業助手。您還可以通過在消息中**@提及**它們來手動調用它們。 +子代理是主要代理可以呼叫來執行特定任務的專業助理。您也可以透過在訊息中 **@提及** 它們來手動呼叫它們。 -opencode 附帶兩個內置子代理：**General** 和 **Explore**。我們將在下面看看這個。 +opencode 附帶兩個內建子代理：**General** 和 **Explore**。我們將在下面看看這個。 --- ## 內建 -opencode 附帶兩個內置主代理和兩個內置子代理。 +opencode 附帶兩個內建主代理和兩個內建子代理。 --- -### 使用構建 +### 使用 Build (構建) _模式_：`primary` -構建是啟用所有工具的**默認**主要代理。這是用於需要完全訪問文件操作和系統命令的開發工作的標準代理。 +Build 是啟用所有工具的**預設**主要代理。這是用於需要完全存取檔案操作和系統指令的開發工作的標準代理。 --- -### 使用計劃 +### 使用 Plan (計畫) _模式_：`primary` -專為規劃和分析而設計的受限代理。我們使用權限系統為您提供更多控制並防止意外更改。 -默認情況下，以下所有項均設置為`ask`： +專為規劃和分析而設計的受限代理。我們使用權限系統為您提供更多控制並防止意外變更。 +預設情況下，以下所有項均設定為 `ask`： - `file edits`：所有寫入、修補和編輯 -- `bash`：所有 bash 命令 +- `bash`：所有 bash 指令 -當您希望 LLM 分析程式碼、建議更改或創建計劃而不對程式碼庫進行任何實際修改時，此代理非常有用。 +當您希望 LLM 分析程式碼、建議變更或建立計畫而不對程式碼庫進行任何實際修改時，此代理非常有用。 --- -### 使用一般 +### 使用 General (一般) _模式_：`subagent` -用於研究複雜問題和執行多步驟任務的通用代理。具有完整的工具訪問權限（待辦事項除外），因此可以在需要時更改文件。使用它可以並行運行多個工作單元。 +用於研究複雜問題和執行多步驟任務的通用代理。具有完整的工具存取權限（待辦事項除外），因此可以在需要時變更檔案。使用它可以並行執行多個工作單元。 --- -### 使用探索 +### 使用 Explore (探索) _模式_：`subagent` -用於探索程式碼庫的快速只讀代理。無法修改文件。當您需要按模式快速查找文件、搜索程式碼中的關鍵字或回答有關程式碼庫的問題時，請使用此功能。 +用於探索程式碼庫的快速唯讀代理。無法修改檔案。當您需要按模式快速尋找檔案、搜尋程式碼中的關鍵字或回答有關程式碼庫的問題時，請使用此功能。 --- -### 使用壓實 +### 使用 Compact (壓縮) _模式_：`primary` -隱藏的系統代理，將長上下文壓縮為較小的摘要。它會在需要時自動運行，並且無法在 UI 中選擇。 +隱藏的系統代理，將長上下文壓縮為較小的摘要。它會在需要時自動執行，並且無法在 UI 中選擇。 --- -### 使用標題 +### 使用 Title (標題) _模式_：`primary` -生成短會話標題的隱藏系統代理。它會自動運行，並且無法在 UI 中選擇。 +生成短工作階段標題的隱藏系統代理。它會自動執行，並且無法在 UI 中選擇。 --- -### 使用總結 +### 使用 Summarize (摘要) _模式_：`primary` -創建會話摘要的隱藏系統代理。它會自動運行，並且無法在 UI 中選擇。 +建立工作階段摘要的隱藏系統代理。它會自動執行，並且無法在 UI 中選擇。 --- ## 用法 -1. 對於主要代理，請在會話期間使用 **Tab** 鍵循環瀏覽它們。您還可以使用配置的 `switch_agent` 鍵綁定。 +1. 對於主要代理，請在工作階段期間使用 **Tab** 鍵循環切換它們。您也可以使用設定的 `switch_agent` 鍵綁定。 -2. 可以調用子代理： +2. 可以呼叫子代理： - **自動**由主要代理根據其描述執行專門任務。 - - 通過在消息中**@提及**子代理手動進行。例如。 + - 透過在訊息中 **@提及** 子代理手動進行。例如： ```txt frame="none" @general help me search for this function ``` -3. **會話之間導航**：當子代理創建自己的子會話時，您可以使用以下命令在父會話和所有子會話之間導航： - - **\<Leader>+Right**（或您配置的 `session_child_cycle` 鍵綁定）向前循環父級 → 子級 1 → 子級 2 → ... → 父級 - - **\<Leader>+Left**（或您配置的 `session_child_cycle_reverse` 鍵綁定）向後循環父級 ← 子級 1 ← 子級 2 ← ... ← 父級 +3. **工作階段之間導航**：當子代理建立自己的子工作階段時，您可以使用以下指令在父工作階段和所有子工作階段之間導航： + - **\<Leader>+Right**（或您設定的 `session_child_cycle` 鍵綁定）向前循環父級 → 子級 1 → 子級 2 → ... → 父級 + - **\<Leader>+Left**（或您設定的 `session_child_cycle_reverse` 鍵綁定）向後循環父級 ← 子級 1 ← 子級 2 ← ... ← 父級 這使您可以在主要對話和專門的子代理工作之間無縫切換。 --- -## 配置 +## 設定 -您可以自定義內置代理或通過配置創建您自己的代理。可以通過兩種方式配置代理： +您可以自定義內建代理或透過設定建立您自己的代理。可以透過兩種方式設定代理： --- ### JSON -在 `opencode.json` 配置文件中配置代理： +在 `opencode.json` 設定檔中設定代理： ```json title="opencode.json" { @@ -179,10 +178,10 @@ _模式_：`primary` ### Markdown -您還可以使用 Markdown 文件定義代理。將它們放入： +您也可以使用 Markdown 檔案定義代理。將它們放入： -- 全球：`~/.config/opencode/agents/` -- 每個項目：`.opencode/agents/` +- 全域：`~/.config/opencode/agents/` +- 每個專案：`.opencode/agents/` ```markdown title="~/.config/opencode/agents/review.md" --- @@ -206,17 +205,17 @@ You are in code review mode. Focus on: Provide constructive feedback without making direct changes. ``` -Markdown 文件名成為代理名稱。例如，`review.md` 創建`review` 代理。 +Markdown 檔名成為代理名稱。例如，`review.md` 建立 `review` 代理。 --- ## 選項 -讓我們詳細看看這些配置選項。 +讓我們詳細看看這些設定選項。 --- -### 描述 +### 描述 (Description) 使用 `description` 選項提供代理的作用以及何時使用它的簡要描述。 @@ -230,15 +229,15 @@ Markdown 文件名成為代理名稱。例如，`review.md` 創建`review` 代� } ``` -這是一個**必需的**配置選項。 +這是一個**必需的**設定選項。 --- -### 溫度 +### 溫度 (Temperature) -使用 `temperature` 配置控制 LLM 響應的隨機性和創造性。 +使用 `temperature` 設定控制 LLM 回應的隨機性和創造性。 -較低的值使響應更加集中和確定，而較高的值則增加創造力和可變性。 +較低的值使回應更加集中和確定，而較高的值則增加創造力和可變性。 ```json title="opencode.json" { @@ -255,9 +254,9 @@ Markdown 文件名成為代理名稱。例如，`review.md` 創建`review` 代� 溫度值的範圍通常為 0.0 到 1.0： -- **0.0-0.2**：非常集中且確定的響應，非常適合程式碼分析和規劃 -- **0.3-0.5**：具有一定創造力的平衡響應，適合一般開發任務 -- **0.6-1.0**：更有創意和多樣化的反應，有助於頭腦風暴和探索 +- **0.0-0.2**：非常集中且確定的回應，非常適合程式碼分析和規劃 +- **0.3-0.5**：具有一定創造力的平衡回應，適合一般開發任務 +- **0.6-1.0**：更有創意和多樣化的反應，有助於腦力激盪和探索 ```json title="opencode.json" { @@ -277,15 +276,15 @@ Markdown 文件名成為代理名稱。例如，`review.md` 創建`review` 代� } ``` -如果未指定溫度，opencode 將使用特定於型號的默認值；大多數型號通常為 0，Qwen 型號為 0.55。 +如果未指定溫度，opencode 將使用特定於模型的預設值；大多數模型通常為 0，Qwen 模型為 0.55。 --- -### 最大步數 +### 最大步數 (Steps) -控制代理在被迫僅使用文本響應之前可以執行的最大代理迭代次數。這允許希望控製成本的用戶對代理操作設置限制。 +控制代理在被迫僅使用文字回應之前可以執行的最大代理迭代次數。這允許希望控制成本的使用者對代理操作設定限制。 -如果未設置，代理將繼續迭代，直到模型選擇停止或用戶中斷會話。 +如果未設定，代理將繼續迭代，直到模型選擇停止或使用者中斷工作階段。 ```json title="opencode.json" { @@ -299,17 +298,17 @@ Markdown 文件名成為代理名稱。例如，`review.md` 創建`review` 代� } ``` -當達到限制時，代理會收到特殊的系統提示，指示其響應其工作摘要和建議的剩餘任務。 +當達到限制時，代理會收到特殊的系統提示，指示其回應其工作摘要和建議的剩餘任務。 :::caution -舊版 `maxSteps` 字段已棄用。請改用`steps`。 +舊版 `maxSteps` 欄位已棄用。請改用 `steps`。 ::: --- -### 禁用 +### 禁用 (Disable) -設置為 `true` 以禁用代理。 +設定為 `true` 以禁用代理。 ```json title="opencode.json" { @@ -323,9 +322,9 @@ Markdown 文件名成為代理名稱。例如，`review.md` 創建`review` 代� --- -### 迅速的 +### 提示 (Prompt) -使用 `prompt` 配置為此代理指定自定義系統提示文件。提示文件應包含特定於代理目的的說明。 +使用 `prompt` 設定為此代理指定自定義系統提示檔案。提示檔案應包含特定於代理目的的說明。 ```json title="opencode.json" { @@ -337,16 +336,16 @@ Markdown 文件名成為代理名稱。例如，`review.md` 創建`review` 代� } ``` -該路徑是相對於配置文件所在位置的。因此，這適用於全局 opencode 配置和項目特定配置。 +該路徑是相對於設定檔所在位置的。因此，這適用於全域 opencode 設定和專案特定設定。 --- -### 模型 +### 模型 (Model) -使用 `model` 配置覆蓋此代理的模型。對於使用針對不同任務優化的不同模型很有用。例如，更快的規劃模型、更強大的實施模型。 +使用 `model` 設定覆蓋此代理的模型。對於使用針對不同任務最佳化的不同模型很有用。例如，更快的規劃模型、更強大的實作模型。 :::tip -如果您不指定模型，主代理將使用[全局配置的模型](/docs/config#models)，而子代理將使用調用子代理的主代理的模型。 +如果您不指定模型，主代理將使用 [全域設定的模型](/docs/config#models)，而子代理將使用呼叫子代理的主代理的模型。 ::: ```json title="opencode.json" @@ -359,13 +358,13 @@ Markdown 文件名成為代理名稱。例如，`review.md` 創建`review` 代� } ``` -opencode 配置中的模型 ID 使用格式`provider/model-id`。例如，如果您使用 [OpenCode Zen](/docs/zen)，則您將使用 `opencode/gpt-5.1-codex` 來表示 GPT 5.1 Codex。 +opencode 設定中的模型 ID 使用格式 `provider/model-id`。例如，如果您使用 [OpenCode Zen](/docs/zen)，則您將使用 `opencode/gpt-5.1-codex` 來表示 GPT 5.1 Codex。 --- -### 工具 +### 工具 (Tools) -使用 `tools` 配置控制此代理中可用的工具。您可以通過將特定工具設置為`true` 或`false` 來啟用或禁用特定工具。 +使用 `tools` 設定控制此代理中可用的工具。您可以透過將特定工具設定為 `true` 或 `false` 來啟用或禁用特定工具。 ```json title="opencode.json" {3-6,9-12} { @@ -386,10 +385,10 @@ opencode 配置中的模型 ID 使用格式`provider/model-id`。例如，如果 ``` :::note -特定於代理的配置會覆蓋全局配置。 +特定於代理的設定會覆蓋全域設定。 ::: -您還可以使用通配符同時控制多個工具。例如，要禁用 MCP 服務器中的所有工具： +您也可以使用萬用字元同時控制多個工具。例如，要禁用 MCP 伺服器中的所有工具： ```json title="opencode.json" { @@ -406,15 +405,15 @@ opencode 配置中的模型 ID 使用格式`provider/model-id`。例如，如果 } ``` -[了解有關工具的更多信息](/docs/tools)。 +[了解有關工具的更多資訊](/docs/tools)。 --- -### 權限 +### 權限 (Permissions) -您可以配置權限來管理代理可以執行的操作。目前，`edit`、`bash` 和`webfetch` 工具的權限可以配置為： +您可以設定權限來管理代理可以執行的操作。目前，`edit`、`bash` 和 `webfetch` 工具的權限可以設定為： -- `"ask"` — 運行工具之前提示批准 +- `"ask"` — 執行工具之前提示批准 - `"allow"` — 未經批准允許所有操作 - `"deny"` — 禁用該工具 @@ -445,7 +444,7 @@ opencode 配置中的模型 ID 使用格式`provider/model-id`。例如，如果 } ``` -您還可以在 Markdown 代理中設置權限。 +您還可以在 Markdown 代理中設定權限。 ```markdown title="~/.config/opencode/agents/review.md" --- @@ -464,7 +463,7 @@ permission: Only analyze code and suggest changes. ``` -您可以設置特定 bash 命令的權限。 +您可以設定特定 bash 指令的權限。 ```json title="opencode.json" {7} { @@ -482,7 +481,7 @@ Only analyze code and suggest changes. } ``` -這可以採用全局模式。 +這可以採用全域模式。 ```json title="opencode.json" {7} { @@ -499,8 +498,8 @@ Only analyze code and suggest changes. } ``` -您還可以使用`*`通配符來管理所有命令的權限。 -由於最後一個匹配規則優先，因此將 `*` 通配符放在前面，將特定規則放在後面。 +您也可以使用 `*` 萬用字元來管理所有指令的權限。 +由於最後一個匹配規則優先，因此將 `*` 萬用字元放在前面，將特定規則放在後面。 ```json title="opencode.json" {8} { @@ -518,13 +517,13 @@ Only analyze code and suggest changes. } ``` -[了解有關權限的更多信息](/docs/permissions)。 +[了解有關權限的更多資訊](/docs/permissions)。 --- -### 模式 +### 模式 (Mode) -使用`mode` 配置控制代理的模式。 `mode` 選項用於確定如何使用代理。 +使用 `mode` 設定控制代理的模式。 `mode` 選項用於確定如何使用代理。 ```json title="opencode.json" { @@ -536,13 +535,13 @@ Only analyze code and suggest changes. } ``` -`mode` 選項可設置為`primary`、`subagent` 或`all`。如果未指定`mode`，則默認為`all`。 +`mode` 選項可設定為 `primary`、`subagent` 或 `all`。如果未指定 `mode`，則預設為 `all`。 --- -### 隱 +### 隱藏 (Hidden) -使用 `@` 從 `hidden: true` 自動完成菜單隱藏子代理。對於只能由其他代理通過任務工具以編程方式調用的內部子代理很有用。 +使用 `@` 從 `hidden: true` 自動完成選單隱藏子代理。對於只能由其他代理透過任務工具以程式化方式呼叫的內部子代理很有用。 ```json title="opencode.json" { @@ -555,17 +554,17 @@ Only analyze code and suggest changes. } ``` -這僅影響自動完成菜單中的用戶可見性。如果權限允許，模型仍然可以通過任務工具調用隱藏代理。 +這僅影響自動完成選單中的使用者可見性。如果權限允許，模型仍然可以透過任務工具呼叫隱藏代理。 :::note -僅適用於`mode: subagent` 代理。 +僅適用於 `mode: subagent` 代理。 ::: --- -### 任務權限 +### 任務權限 (Task Permissions) -使用 `permission.task` 控制代理可以通過任務工具調用哪些子代理。使用 glob 模式進行靈活匹配。 +使用 `permission.task` 控制代理可以透過任務工具呼叫哪些子代理。使用 glob 模式進行靈活匹配。 ```json title="opencode.json" { @@ -584,23 +583,23 @@ Only analyze code and suggest changes. } ``` -當設置為 `deny` 時，子代理將從任務工具描述中完全刪除，因此模型不會嘗試調用它。 +當設定為 `deny` 時，子代理將從任務工具描述中完全刪除，因此模型不會嘗試呼叫它。 :::tip -規則按順序評估，**最後匹配的規則獲勝**。在上面的示例中，`orchestrator-planner` 匹配`*`（拒絕）和`orchestrator-*`（允許），但由於`orchestrator-*` 位於`*` 之後，因此結果為`allow`。 +規則按順序評估，**最後匹配的規則獲勝**。在上面的範例中，`orchestrator-planner` 匹配 `*`（拒絕）和 `orchestrator-*`（允許），但由於 `orchestrator-*` 位於 `*` 之後，因此結果為 `allow`。 ::: :::tip -用戶始終可以通過 `@` 自動完成菜單直接調用任何子代理，即使代理的任務權限會拒絕它。 +使用者始終可以透過 `@` 自動完成選單直接呼叫任何子代理，即使代理的任務權限會拒絕它。 ::: --- -### 顏色 +### 顏色 (Color) 使用 `color` 選項自定義代理在 UI 中的視覺外觀。這會影響代理在介面中的顯示方式。 -使用有效的十六進制顏色（例如`#FF5733`）或主題顏色：`primary`、`secondary`、`accent`、`success`、`warning`、`error`、`info`。 +使用有效的十六進位顏色（例如 `#FF5733`）或主題顏色：`primary`、`secondary`、`accent`、`success`、`warning`、`error`、`info`。 ```json title="opencode.json" { @@ -617,9 +616,9 @@ Only analyze code and suggest changes. --- -### 頂P +### Top P -使用 `top_p` 選項控制響應多樣性。控制隨機性的溫度替代方案。 +使用 `top_p` 選項控制回應多樣性。控制隨機性的溫度替代方案。 ```json title="opencode.json" { @@ -635,9 +634,9 @@ Only analyze code and suggest changes. --- -### 額外的 +### 額外選項 (Extra) -您在代理配置中指定的任何其他選項都將作為模型選項**直接**傳遞給提供商。這允許您使用特定於提供商的功能和參數。 +您在代理設定中指定的任何其他選項都將作為模型選項**直接**傳遞給供應商。這允許您使用特定於供應商的功能和參數。 例如，使用 OpenAI 的推理模型，您可以控制推理工作： @@ -654,47 +653,47 @@ Only analyze code and suggest changes. } ``` -這些附加選項是特定於型號和提供商的。檢查提供商的文檔以獲取可用參數。 +這些附加選項是特定於模型和供應商的。檢查供應商的文件以獲取可用參數。 :::tip -運行 `opencode models` 查看可用模型的列表。 +執行 `opencode models` 查看可用模型的列表。 ::: --- -## 創建代理 +## 建立代理 -您可以使用以下命令創建新代理： +您可以使用以下指令建立新代理： ```bash opencode agent create ``` -此交互式命令將： +此互動式指令將： -1. 詢問代理保存在哪裡；全局或特定項目。 +1. 詢問代理保存在哪裡；全域或特定專案。 2. 描述代理應該做什麼。 3. 生成適當的系統提示和標識符。 -4. 讓您選擇代理可以訪問哪些工具。 -5. 最後，使用代理配置創建一個 markdown 文件。 +4. 讓您選擇代理可以存取哪些工具。 +5. 最後，使用代理設定建立一個 markdown 檔案。 --- ## 使用案例 -以下是不同代理的一些常見用例。 +以下是不同代理的一些常見使用案例。 -- **構建代理**：啟用所有工具的完整開發工作 -- **規劃代理**：分析規劃，不做改動 -- **審查代理**：具有隻讀訪問權限和文檔工具的程式碼審查 -- **調試代理**：專注於啟用 bash 和讀取工具的調查 -- **文檔代理**：使用文件操作但不使用系統命令的文檔編寫 +- **Build 代理**：啟用所有工具的完整開發工作 +- **Plan 代理**：分析規劃，不做改動 +- **Review 代理**：具有唯讀存取權限和文件工具的程式碼審查 +- **Debug 代理**：專注於啟用 bash 和讀取工具的調查 +- **Docs 代理**：使用檔案操作但不使用系統指令的文件編寫 --- -## 示例 +## 範例 -以下是一些您可能會覺得有用的示例代理。 +以下是一些您可能會覺得有用的範例代理。 :::tip 您有想要分享的代理嗎？ [提交 PR](https://github.com/anomalyco/opencode)。 @@ -724,7 +723,7 @@ Focus on: --- -### 安全審核員 +### 安全稽核員 ```markdown title="~/.config/opencode/agents/security-auditor.md" --- |