diff options
| author | chenmi <[email protected]> | 2026-02-17 20:06:39 +0800 |
|---|---|---|
| committer | GitHub <[email protected]> | 2026-02-17 06:06:39 -0600 |
| commit | 4fd3141ab5d43a55566042982fb4459b5716e140 (patch) | |
| tree | a1faa0f22784999fffcace0a1f8853709a232b0d /packages/web/src/content/docs/zh-tw/modes.mdx | |
| parent | 8d0a303af48da5e6c6d5287ef2144bfb49ca13d0 (diff) | |
| download | opencode-4fd3141ab5d43a55566042982fb4459b5716e140.tar.gz opencode-4fd3141ab5d43a55566042982fb4459b5716e140.zip | |
docs: improve zh-cn and zh-tw documentation translations (#13942)
Diffstat (limited to 'packages/web/src/content/docs/zh-tw/modes.mdx')
| -rw-r--r-- | packages/web/src/content/docs/zh-tw/modes.mdx | 107 |
1 files changed, 52 insertions, 55 deletions
diff --git a/packages/web/src/content/docs/zh-tw/modes.mdx b/packages/web/src/content/docs/zh-tw/modes.mdx index 0d44dc2dd..73e6bd141 100644 --- a/packages/web/src/content/docs/zh-tw/modes.mdx +++ b/packages/web/src/content/docs/zh-tw/modes.mdx @@ -1,62 +1,60 @@ --- title: 模式 -description: 不同的模式適用於不同的使用案例。 +description: 不同模式適用於不同的使用情境。 --- :::caution -現在透過 opencode 設定中的 `agent` 選項配置模式。這 -`mode` 選項現已棄用。 [了解更多](/docs/agents)。 +模式現在透過 opencode 設定中的 `agent` 選項進行設定。`mode` 選項已廢棄。[了解更多](/docs/agents)。 ::: -opencode 中的模式允許您自定義不同使用案例的行為、工具和提示。 +opencode 中的模式允許您為不同的使用情境自訂行為、工具和提示詞。 -它具有兩種內建模式:**建置 (Build)**和**計畫 (Plan)**。您可以自定義 -這些或透過 opencode 設定配置您自己的。 +opencode 自帶兩種內建模式:**build** 和 **plan**。您可以自訂這些模式,也可以透過 opencode 設定建立自己的模式。 -您可以在工作階段期間在模式之間切換或在設定檔中配置它們。 +您可以在工作階段中切換模式,也可以在設定檔中進行設定。 --- -## 內建 +## 內建模式 -opencode 有兩種內建模式。 +opencode 自帶兩種內建模式。 --- -### 建置 (Build) +### Build -建置是啟用所有工具的**預設**模式。這是開發工作的標準模式,您需要完全存取檔案操作和系統指令。 +Build 是啟用了所有工具的**預設**模式。這是進行開發工作的標準模式,您可以完全存取檔案操作和系統指令。 --- -### 計畫 (Plan) +### Plan -專為規劃和分析而設計的受限模式。在計畫模式下,預設情況下禁用以下工具: +Plan 是一種為規劃和分析設計的受限模式。在 plan 模式下,以下工具預設被停用: - `write` - 無法建立新檔案 -- `edit` - 無法修改現有檔案,位於 `.opencode/plans/*.md` 的用於詳細說明計畫本身的檔案除外 -- `patch` - 無法套用 Patch +- `edit` - 無法修改現有檔案,但位於 `.opencode/plans/*.md` 的檔案除外,用於詳細說明計畫本身 +- `patch` - 無法套用補丁 - `bash` - 無法執行 shell 指令 -當您希望 AI 分析程式碼、建議變更或建立計畫而不對程式碼庫進行任何實際修改時,此模式非常有用。 +當您希望 AI 分析程式碼、提出修改建議或制定計畫,而不對程式碼庫進行任何實際更改時,此模式非常有用。 --- ## 切換 -您可以在工作階段期間使用 _Tab_ 鍵在模式之間切換。或者您配置的 `switch_mode` 鍵綁定。 +您可以在工作階段中使用 _Tab_ 鍵切換模式,或者使用您設定的 `switch_mode` 快捷鍵。 -另請參閱:[格式化程式](/docs/formatters) 有關程式碼格式配置的資訊。 +另請參閱:[格式化工具](/docs/formatters)了解程式碼格式化設定的相關資訊。 --- ## 設定 -您可以自定義內建模式或透過配置建立自己的模式。可以透過兩種方式配置模式: +您可以自訂內建模式或透過設定建立自己的模式。模式可以透過兩種方式進行設定: -### JSON 配置 +### JSON 設定 -在 `opencode.json` 設定檔中配置模式: +在 `opencode.json` 設定檔中設定模式: ```json title="opencode.json" { @@ -83,9 +81,9 @@ opencode 有兩種內建模式。 } ``` -### Markdown 配置 +### Markdown 設定 -您還可以使用 Markdown 檔案定義模式。將它們放入: +您還可以使用 Markdown 檔案定義模式。將檔案放置在以下位置: - 全域:`~/.config/opencode/modes/` - 專案:`.opencode/modes/` @@ -110,15 +108,15 @@ You are in code review mode. Focus on: Provide constructive feedback without making direct changes. ``` -Markdown 檔名成為模式名稱(例如,`review.md` 建立 `review` 模式)。 +Markdown 檔案名稱即為模式名稱(例如,`review.md` 建立一個名為 `review` 的模式)。 -讓我們詳細看看這些配置選項。 +下面讓我們詳細了解這些設定選項。 --- -### 模型 (Model) +### 模型 -使用 `model` 配置覆寫此模式的預設模型。對於使用針對不同任務最佳化的不同模型很有用。例如,更快的規劃模型、更強大的實作模型。 +使用 `model` 設定可以覆寫該模式的預設模型。這對於針對不同任務使用不同模型非常有用。例如,規劃時使用更快的模型,實作時使用更強大的模型。 ```json title="opencode.json" { @@ -132,9 +130,9 @@ Markdown 檔名成為模式名稱(例如,`review.md` 建立 `review` 模式� --- -### 溫度 (Temperature) +### 溫度 -使用 `temperature` 配置控制 AI 回應的隨機性和創造性。較低的值使回應更加集中和確定,而較高的值則增加創造力和可變性。 +使用 `temperature` 設定控制 AI 回應的隨機性和創造性。較低的值使回應更加集中和確定性,較高的值則增加創造性和多樣性。 ```json title="opencode.json" { @@ -151,9 +149,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" { @@ -173,13 +171,13 @@ Markdown 檔名成為模式名稱(例如,`review.md` 建立 `review` 模式� } ``` -如果未指定溫度,opencode 將使用特定於模型的預設值(大多數模型通常為 0,Qwen 模型為 0.55)。 +如果未指定溫度,opencode 將使用模型特定的預設值(大多數模型通常為 0,Qwen 模型為 0.55)。 --- -### 提示 (Prompt) +### 提示詞 -使用 `prompt` 配置為此模式指定自定義系統提示檔案。提示檔案應包含特定於該模式用途的指令。 +使用 `prompt` 設定為模式指定自訂系統提示詞檔案。提示詞檔案應包含針對該模式用途的具體指令。 ```json title="opencode.json" { @@ -191,14 +189,13 @@ Markdown 檔名成為模式名稱(例如,`review.md` 建立 `review` 模式� } ``` -該路徑是相對於設定檔所在位置的。所以這適用於 -全域 opencode 配置和專案特定配置。 +此路徑相對於設定檔所在位置。因此,全域 opencode 設定和專案特定設定均可使用。 --- -### 工具 (Tools) +### 工具 -使用 `tools` 配置控制在此模式下可用的工具。您可以透過將特定工具設定為 `true` 或 `false` 來啟用或禁用特定工具。 +使用 `tools` 設定控制該模式下可用的工具。您可以將特定工具設定為 `true` 或 `false` 來啟用或停用它們。 ```json { @@ -223,7 +220,7 @@ Markdown 檔名成為模式名稱(例如,`review.md` 建立 `review` 模式� #### 可用工具 -這裡是所有可以透過模式配置控制的工具。 +以下是所有可透過模式設定控制的工具。 | 工具 | 描述 | | ----------- | ---------------- | @@ -234,18 +231,18 @@ Markdown 檔名成為模式名稱(例如,`review.md` 建立 `review` 模式� | `grep` | 搜尋檔案內容 | | `glob` | 按模式尋找檔案 | | `list` | 列出目錄內容 | -| `patch` | 對檔案套用 Patch | +| `patch` | 對檔案套用補丁 | | `todowrite` | 管理待辦事項清單 | -| `todoread` | 閱讀待辦事項清單 | -| `webfetch` | 取得網頁內容 | +| `todoread` | 讀取待辦事項清單 | +| `webfetch` | 擷取網頁內容 | --- -## 自定義模式 +## 自訂模式 -您可以透過將自定義模式添加到配置來建立自己的自定義模式。以下是使用這兩種方法的範例: +您可以透過在設定中新增自訂模式來建立自己的模式。以下是兩種方式的範例: -### 使用 JSON 配置 +### 使用 JSON 設定 ```json title="opencode.json" {4-14} { @@ -268,7 +265,7 @@ Markdown 檔名成為模式名稱(例如,`review.md` 建立 `review` 模式� ### 使用 Markdown 檔案 -在 `.opencode/modes/` 中為專案特定模式建立模式檔案,在 `~/.config/opencode/modes/` 中為全域模式建立模式檔案: +在 `.opencode/modes/` 中建立專案特定的模式檔案,或在 `~/.config/opencode/modes/` 中建立全域模式檔案: ```markdown title=".opencode/modes/debug.md" --- @@ -318,14 +315,14 @@ Priorities: --- -### 使用案例 +### 使用情境 -以下是不同模式的一些常見使用案例。 +以下是不同模式的一些常見使用情境。 -- **建置模式**:啟用所有工具的完整開發工作 -- **計畫模式**:分析和計畫,無需變更 -- **審閱模式**:使用唯讀存取權限和文件工具進行程式碼審閱 -- **除錯模式**:專注於啟用 bash 和讀取工具的調查 -- **文件模式**:使用檔案操作但不使用系統指令的文件編寫 +- **Build 模式**:啟用所有工具的完整開發工作 +- **Plan 模式**:分析和規劃,不做任何更改 +- **Review 模式**:使用唯讀存取權限加文件工具進行程式碼審查 +- **Debug 模式**:啟用 bash 和讀取工具,專注於問題排查 +- **Docs 模式**:支援檔案操作但不支援系統指令的文件編寫 -您可能還會發現不同的模型適用於不同的使用案例。 +您可能還會發現不同的模型適用於不同的使用情境。 |
