mirror of
https://github.com/anomalyco/opencode.git
synced 2026-05-02 02:36:52 +00:00
docs: improve zh-cn and zh-tw documentation translations (#13942)
This commit is contained in:
chenmi
@@ -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 模式**：支援檔案操作但不支援系統指令的文件編寫
|
||||
|
||||
您可能還會發現不同的模型適用於不同的使用案例。
|
||||
您可能還會發現不同的模型適用於不同的使用情境。
|
||||
|
||||
Reference in New Issue
Block a user