docs: improve zh-cn and zh-tw documentation translations (#13942)
This commit is contained in:
chenmi
@@ -1,58 +1,56 @@
|
||||
---
|
||||
title: 模式
|
||||
description: 不同的模式适用于不同的用例。
|
||||
description: 不同模式适用于不同的使用场景。
|
||||
---
|
||||
|
||||
:::caution
|
||||
现在通过opencode配置中的`agent`选项配置模式。这
|
||||
`mode` 选项现已废弃。 [了解更多](/docs/agents)。
|
||||
模式现在通过 opencode 配置中的 `agent` 选项进行配置。`mode` 选项已废弃。[了解更多](/docs/agents)。
|
||||
:::
|
||||
|
||||
opencode 中的模式允许自定义不同的示例行为、工具和提示。
|
||||
opencode 中的模式允许你为不同的使用场景自定义行为、工具和提示词。
|
||||
|
||||
它具有两种内置模式：**构建**和**计划**。您可以定制
|
||||
这些或通过 opencode 配置配置您自己的。
|
||||
opencode 自带两种内置模式：**build** 和 **plan**。你可以自定义这些模式，也可以通过 opencode 配置创建自己的模式。
|
||||
|
||||
您可以在会话期间在模式之间切换或在配置文件中配置它们。
|
||||
你可以在会话中切换模式，也可以在配置文件中进行配置。
|
||||
|
||||
---
|
||||
|
||||
## 内置
|
||||
## 内置模式
|
||||
|
||||
opencode 有两种内置模式。
|
||||
opencode 自带两种内置模式。
|
||||
|
||||
---
|
||||
|
||||
### 构建
|
||||
### Build
|
||||
|
||||
构建是启用所有工具的**默认**模式。这是开发工作的标准模式，您需要完全访问文件操作和系统命令。
|
||||
Build 是启用了所有工具的**默认**模式。这是进行开发工作的标准模式，你可以完全访问文件操作和系统命令。
|
||||
|
||||
---
|
||||
|
||||
### 计划
|
||||
### Plan
|
||||
|
||||
专为规划和分析而设计的受限模式。在计划模式下，默认情况下禁用以下工具：
|
||||
Plan 是一种为规划和分析设计的受限模式。在 plan 模式下，以下工具默认被禁用：
|
||||
|
||||
- `write` - 无法创建新文件
|
||||
- `edit` - 无法修改现有文件，位于 `.opencode/plans/*.md` 的用于详细说明计划本身的文件另外
|
||||
- `edit` - 无法修改现有文件，但位于 `.opencode/plans/*.md` 的文件除外，用于详细说明计划本身
|
||||
- `patch` - 无法应用补丁
|
||||
- `bash` - 无法执行 shell 命令
|
||||
|
||||
当您希望人工智能分析代码、建议更改或创建计划而不对代码库进行任何实际修改时，此模式非常有用。
|
||||
当你希望 AI 分析代码、提出修改建议或制定计划，而不对代码库进行任何实际更改时，此模式非常有用。
|
||||
|
||||
---
|
||||
|
||||
## 切换
|
||||
|
||||
您可以在会话期间使用 _Tab_ 键在模式之间切换。或者您配置的 `switch_mode` 键绑定。
|
||||
你可以在会话中使用 _Tab_ 键切换模式，或者使用你配置的 `switch_mode` 快捷键。
|
||||
|
||||
另请参见：[格式化程序](/docs/formatters)相关代码配置的信息。
|
||||
另请参阅：[格式化工具](/docs/formatters)了解代码格式化配置的相关信息。
|
||||
|
||||
---
|
||||
|
||||
## 配置
|
||||
|
||||
您可以自定义内置模式或通过配置创建自己的模式。可以通过两种方式配置模式：
|
||||
你可以自定义内置模式或通过配置创建自己的模式。模式可以通过两种方式进行配置：
|
||||
|
||||
### JSON 配置
|
||||
|
||||
@@ -85,9 +83,9 @@ opencode 有两种内置模式。
|
||||
|
||||
### Markdown 配置
|
||||
|
||||
您还可以使用 Markdown 文件定义模式。将它们放入：
|
||||
你还可以使用 Markdown 文件定义模式。将文件放置在以下位置：
|
||||
|
||||
- 全球：`~/.config/opencode/modes/`
|
||||
- 全局：`~/.config/opencode/modes/`
|
||||
- 项目：`.opencode/modes/`
|
||||
|
||||
```markdown title="~/.config/opencode/modes/review.md"
|
||||
@@ -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` 配置可以覆盖该模式的默认模型。这对于针对不同任务使用不同模型非常有用。例如，规划时使用更快的模型，实现时使用更强大的模型。
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -134,7 +132,7 @@ Markdown 文件名成为模式名称（例如，`review.md` 创建`review` 模
|
||||
|
||||
### 温度
|
||||
|
||||
使用`temperature`配置控制AI响应的随机性和创造。较低的值使响应更加集中和确定，而较高的值则增加创造力和可变性。
|
||||
使用 `temperature` 配置控制 AI 响应的随机性和创造性。较低的值使响应更加集中和确定性，较高的值则增加创造性和多样性。
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -149,11 +147,11 @@ Markdown 文件名成为模式名称（例如，`review.md` 创建`review` 模
|
||||
}
|
||||
```
|
||||
|
||||
温度值范围通常为 0.0 到 1.0：
|
||||
温度值的范围通常为 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` 配置为模式指定自定义系统提示词文件。提示词文件应包含针对该模式用途的具体指令。
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -191,14 +189,13 @@ Markdown 文件名成为模式名称（例如，`review.md` 创建`review` 模
|
||||
}
|
||||
```
|
||||
|
||||
该路径是相对于配置文件所在位置的。所以这适用于
|
||||
全局opencode配置和项目特定配置。
|
||||
此路径相对于配置文件所在位置。因此，全局 opencode 配置和项目特定配置均可使用。
|
||||
|
||||
---
|
||||
|
||||
### 工具
|
||||
|
||||
使用 `tools` 配置控制模式下可用的工具。您可以通过将特定工具设置为 `true` 或 `false` 来启用或禁用特定工具。
|
||||
使用 `tools` 配置控制该模式下可用的工具。你可以将特定工具设置为 `true` 或 `false` 来启用或禁用它们。
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -223,27 +220,27 @@ Markdown 文件名成为模式名称（例如，`review.md` 创建`review` 模
|
||||
|
||||
#### 可用工具
|
||||
|
||||
这里是所有可以通过模式配置控制的工具。
|
||||
以下是所有可通过模式配置控制的工具。
|
||||
|
||||
| 工具 | 描述 |
|
||||
| ----------- | ---------------- |
|
||||
| `bash` | 执行shell命令 |
|
||||
| `bash` | 执行 shell 命令 |
|
||||
| `edit` | 修改现有文件 |
|
||||
| `write` | 创建新文件 |
|
||||
| `read` | 读取文件内容 |
|
||||
| `grep` | 搜索文件内容 |
|
||||
| `glob` | 按模式查找文件 |
|
||||
| `list` | 上市目录内容 |
|
||||
| `list` | 列出目录内容 |
|
||||
| `patch` | 对文件应用补丁 |
|
||||
| `todowrite` | 管理待办事项列表 |
|
||||
| `todoread` | 阅读待办事项列表 |
|
||||
| `todoread` | 读取待办事项列表 |
|
||||
| `webfetch` | 获取网页内容 |
|
||||
|
||||
---
|
||||
|
||||
## 自定义模式
|
||||
|
||||
您可以通过将自定义模式添加到配置来创建自己的自定义模式。以下是使用这两种方法的示例：
|
||||
你可以通过在配置中添加自定义模式来创建自己的模式。以下是两种方式的示例：
|
||||
|
||||
### 使用 JSON 配置
|
||||
|
||||
@@ -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