From dc53086c1e73d43d3a28fc4cdf161e83d09b1877 Mon Sep 17 00:00:00 2001
From: Adam <2363879+adamdotdevin@users.noreply.github.com>
Date: Mon, 9 Feb 2026 11:34:35 -0600
Subject: wip(docs): i18n (#12681)

---
 packages/web/src/content/docs/zh-cn/modes.mdx | 331 ++++++++++++++++++++++++++
 1 file changed, 331 insertions(+)
 create mode 100644 packages/web/src/content/docs/zh-cn/modes.mdx

(limited to 'packages/web/src/content/docs/zh-cn/modes.mdx')

diff --git a/packages/web/src/content/docs/zh-cn/modes.mdx b/packages/web/src/content/docs/zh-cn/modes.mdx
new file mode 100644
index 000000000..b9c5926d4
--- /dev/null
+++ b/packages/web/src/content/docs/zh-cn/modes.mdx
@@ -0,0 +1,331 @@
+---
+title: 模式
+description: 不同的模式適用於不同的用例。
+---
+
+:::警告
+现在通过opencode配置中的`agent`选项配置模式。这
+`mode` 选项现已废弃。 [了解更多](/docs/agents)。
+:::
+
+opencode 中的模式允许自定义不同的示例行为、工具和提示。
+
+它具有兩種內置模式：**構建**和**計劃**。您可以定制
+这些或通过 opencode 配置配置您自己的。
+
+您可以在會話期間在模式之間切換或在配置文件中配置它們。
+
+---
+
+## 內建
+
+opencode 有两种内置模式。
+
+---
+
+### 建造
+
+構建是啟用所有工具的**默認**模式。這是開發工作的標準模式，您需要完全訪問文件操作和系統命令。
+
+---
+
+### 計劃
+
+專為規劃和分析而設計的受限模式。在計劃模式下，默認情況下禁用以下工具：
+
+- `write` - 无法创建新文件
+- `edit` - 无法修改现有文件，位于 `.opencode/plans/*.md` 的用于详细说明计划本身的文件另外
+- `patch` - 无法应用补丁
+- `bash` - 无法执行 shell 命令
+
+当您希望人工智能分析代码、建议更改或创建计划而不对代码库进行任何实际修改时，此模式非常有用。
+
+---
+
+## 交換
+
+您可以在会话期间使用 _Tab_ 键在模式之间切换。或者您配置的 `switch_mode` 键绑定。
+
+另请参见：[格式化程序](/docs/formatters)相关代码配置的信息。
+
+---
+
+## 配置
+
+您可以自定義內置模式或通過配置創建自己的模式。可以通過兩種方式配置模式：
+
+### JSON 配置
+
+在 `opencode.json` 配置文件中配置模式：
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mode": {
+    "build": {
+      "model": "anthropic/claude-sonnet-4-20250514",
+      "prompt": "{file:./prompts/build.txt}",
+      "tools": {
+        "write": true,
+        "edit": true,
+        "bash": true
+      }
+    },
+    "plan": {
+      "model": "anthropic/claude-haiku-4-20250514",
+      "tools": {
+        "write": false,
+        "edit": false,
+        "bash": false
+      }
+    }
+  }
+}
+```
+
+### 降價配置
+
+您还可以使用 Markdown 文件定义模式。将它们放入：
+
+- 全球：`~/.config/opencode/modes/`
+- 项目：`.opencode/modes/`
+
+```markdown title="~/.config/opencode/modes/review.md"
+---
+model: anthropic/claude-sonnet-4-20250514
+temperature: 0.1
+tools:
+  write: false
+  edit: false
+  bash: false
+---
+
+You are in code review mode. Focus on:
+
+- Code quality and best practices
+- Potential bugs and edge cases
+- Performance implications
+- Security considerations
+
+Provide constructive feedback without making direct changes.
+```
+
+Markdown 文件名成为模式名称（例如，`review.md` 创建`review` 模式）。
+
+讓我們詳細看看這些配置選項。
+
+---
+
+### 模型
+
+使用`model`配置覆盖此模式的默认模型。对于使用针对不同任务优化的不同模型很有用。例如，更快的规划模型、更强大的实施模型。
+
+```json title="opencode.json"
+{
+  "mode": {
+    "plan": {
+      "model": "anthropic/claude-haiku-4-20250514"
+    }
+  }
+}
+```
+
+---
+
+### 溫度
+
+使用`temperature`配置控制AI响应的随机性和创造。较低的值使响应更加集中和确定，而较高的值则增加创造力和可变性。
+
+```json title="opencode.json"
+{
+  "mode": {
+    "plan": {
+      "temperature": 0.1
+    },
+    "creative": {
+      "temperature": 0.8
+    }
+  }
+}
+```
+
+溫度值的範圍通常為 0.0 到 1.0：
+
+- **0.0-0.2**：非常集中且確定的響應，非常適合代碼分析和規劃
+- **0.3-0.5**：具有一定創造力的平衡響應，適合一般開發任務
+- **0.6-1.0**：更有創意和多樣化的反應，有助於頭腦風暴和探索
+
+```json title="opencode.json"
+{
+  "mode": {
+    "analyze": {
+      "temperature": 0.1,
+      "prompt": "{file:./prompts/analysis.txt}"
+    },
+    "build": {
+      "temperature": 0.3
+    },
+    "brainstorm": {
+      "temperature": 0.7,
+      "prompt": "{file:./prompts/creative.txt}"
+    }
+  }
+}
+```
+
+如果未指定温度，opencode将使用特定于模型的默认值（大多数模型通常为0，Qwen模型为0.55）。
+
+---
+
+### 迅速的
+
+使用 `prompt` 配置为模式指定自定义系统提示文件。提示文件应包含特定于该模式用途的指令。
+
+```json title="opencode.json"
+{
+  "mode": {
+    "review": {
+      "prompt": "{file:./prompts/code-review.txt}"
+    }
+  }
+}
+```
+
+該路徑是相對於配置文件所在位置的。所以這適用於
+全局开放代码配置和项目特定配置。
+
+---
+
+### 工具
+
+使用 `tools` 配置控制模式下可用的工具。您可以通过将特定工具设置为 `true` 或 `false` 来启用或禁用特定工具。
+
+```json
+{
+  "mode": {
+    "readonly": {
+      "tools": {
+        "write": false,
+        "edit": false,
+        "bash": false,
+        "read": true,
+        "grep": true,
+        "glob": true
+      }
+    }
+  }
+}
+```
+
+如果未指定任何工具，則默認啟用所有工具。
+
+---
+
+#### 可用工具
+
+這裡是所有可以通過模式配置控制的工具。
+
+|工具|描述 |
+| ----------- | ----------------------- |
+| `bash` | 执行shell命令 |
+| `edit` | 修改现有文件 |
+| `write` |创建新文件 |
+| `read` | 读取文件内容 |
+| `grep` |搜索文件内容 |
+| `glob` |按模式查找文件 |
+| `list` | 上市目录内容 |
+| `patch` |对文件应用补丁 |
+| `todowrite` | 管理待办事项列表 |
+| `todoread` |阅读待办事项列表 |
+| `webfetch` |获取网页内容 |
+
+---
+
+## 自定義模式
+
+您可以通過將自定義模式添加到配置來創建自己的自定義模式。以下是使用這兩種方法的示例：
+
+### 使用 JSON 配置
+
+```json title="opencode.json" {4-14}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mode": {
+    "docs": {
+      "prompt": "{file:./prompts/documentation.txt}",
+      "tools": {
+        "write": true,
+        "edit": true,
+        "bash": false,
+        "read": true,
+        "grep": true,
+        "glob": true
+      }
+    }
+  }
+}
+```
+
+### 使用 Markdown 文件
+
+在`.opencode/modes/`中为项目特定模式创建模式文件，在`~/.config/opencode/modes/`中为全局模式创建模式文件：
+
+```markdown title=".opencode/modes/debug.md"
+---
+temperature: 0.1
+tools:
+  bash: true
+  read: true
+  grep: true
+  write: false
+  edit: false
+---
+
+You are in debug mode. Your primary goal is to help investigate and diagnose issues.
+
+Focus on:
+
+- Understanding the problem through careful analysis
+- Using bash commands to inspect system state
+- Reading relevant files and logs
+- Searching for patterns and anomalies
+- Providing clear explanations of findings
+
+Do not make any changes to files. Only investigate and report.
+```
+
+```markdown title="~/.config/opencode/modes/refactor.md"
+---
+model: anthropic/claude-sonnet-4-20250514
+temperature: 0.2
+tools:
+  edit: true
+  read: true
+  grep: true
+  glob: true
+---
+
+You are in refactoring mode. Focus on improving code quality without changing functionality.
+
+Priorities:
+
+- Improve code readability and maintainability
+- Apply consistent naming conventions
+- Reduce code duplication
+- Optimize performance where appropriate
+- Ensure all tests continue to pass
+```
+
+---
+
+### 使用案例
+
+以下是不同模式的一些常見用例。
+
+- **構建模式**：啟用所有工具的完整開發工作
+- **計劃模式**：分析和計劃，無需更改
+- **審閱模式**：使用只讀訪問權限和文檔工具進行代碼審閱
+- **调试模式**：专注于启用bash和读取工具的调查
+- **文檔模式**：使用文件操作但不使用系統命令的文檔編寫
+
+您可能還會發現不同的模型適用於不同的用例。
-- 
cgit v1.2.3

