monadical/opencode
14
0
Fork 0
Code Issues Pull Requests Actions 5 Packages Projects Releases Wiki Activity

fix(docs): locale translations

Browse Source
This commit is contained in:
Adam
2026-02-10 13:59:14 -06:00
committed by opencode
parent fbc41475b4
commit fd5531316f
282 changed files with 4973 additions and 5314 deletions
Download Patch File Download Diff File Expand all files Collapse all files

174
packages/web/src/content/docs/zh-cn/agents.mdx
View File

@@ -1,65 +1,65 @@
---
title: 代理商
description: 配置和使用专門的代理。
title: Agents
description: 配置和使用专门的代理。
---
代理是专門的人工智能助手，可以針对特定任务和工作流程進行配置。它們允许您创建具有自定義提示、模型和工具访问权限的专用工具。
代理是专门的人工智能助手，可以针对特定任务和工作流程进行配置。它们允许您创建具有自定义提示、模型和工具访问权限的专用工具。
:::tip
使用計劃代理來分析代碼并审查建議，而無需進行任何代碼更改。
使用 Plan 代理来分析代码并审查建议，而无需进行任何代码更改。
:::
您可以在会话期間在代理之間切換，或使用 `@` 提及來调用它們。
您可以在会话期间在代理之间切换，或使用 `@` 提及来调用它们。
---
## 類型
## 类型
opencode有两种类型的代理；主代理和次代理。
OpenCode 有两种类型的代理；主代理和子代理。
---
### 主要代理
### Primary 代理
主要代理是与您直接交互的主要助手。您可以使用 **Tab** 键或您配置的 `switch_agent` 键绑定循环浏览它们。这些代理处理您的主要对话。工具访问是通过权限配置的 - 例如，“构建”启用了所有工具，而“计划”则受到限制。
Primary 代理是与您直接交互的主要助手。您可以使用 **Tab** 键或您配置的 `switch_agent` 键绑定循环浏览它们。这些代理处理您的主要对话。工具访问是通过权限配置的 - 例如，“Build”启用了所有工具，而“Plan”则受到限制。
:::tip
您可以在会话期间使用 **Tab** 键在主要代理之间进行切换。
您可以在会话期间使用 **Tab** 键在 Primary 代理之间进行切换。
:::
opencode附带两个内置的主要代理：**Build** 和 **Plan**。地
OpenCode 附带两个内置的 Primary 代理：**Build** 和 **Plan**。
看看下面这些。
---
### 子代理
### Subagents (子代理)
子代理是主要代理可以调用​​來执行特定任务的专業助手。您还可以通过在消息中**@提及**它們來手动调用它們。
Subagents (子代理) 是 Primary 代理可以调用​​来执行特定任务的专业助手。您还可以通过在消息中 **@提及** 它们来手动调用它们。
opencode附带两个内置子代理：**General** 和 **Explore**。我们将在下面看看这个。
OpenCode 附带两个内置子代理：**General** 和 **Explore**。我们将在下面看看这个。
---
## 內建
## 内置
opencode附带两个内置主代理和两个内置子代理。
OpenCode 附带两个内置主代理和两个内置子代理。
---
### 使用構建
### 使用 Build
_模式_：`primary`
構建是启用所有工具的**默認**主要代理。这是用于需要完全访问文件操作和系統命令的開發工作的標準代理。
Build 是启用所有工具的 **默认** Primary 代理。这是用于需要完全访问文件操作和系统命令的开发工作的标准代理。
---
### 使用計劃
### 使用 Plan
_模式_：`primary`
专为規劃和分析而設計的受限代理。我们使用权限系統为您提供更多控制并防止意外更改。
默认情况下，以下所有项均设置为`ask`：
专为规划和分析而设计的受限代理。我们使用权限系统为您提供更多控制并防止意外更改。
默认情况下，以下所有项均设置为 `ask`：
- `file edits`：所有书写、修复和编辑
- `bash`：所有 bash 命令
@@ -68,7 +68,7 @@ _模式_：`primary`
---
### 使用一般
### 使用 General
_模式_：`subagent`
@@ -76,15 +76,15 @@ _模式_：`subagent`
---
### 使用探索
### 使用 Explore
_模式_：`subagent`
用于探索代碼庫的快速只讀代理。无法修改文件。当您需要按模式快速查找文件、搜索代碼中的關鍵字或回答有關代碼庫的問題時，请使用此功能。
用于探索代码库的快速只读代理。无法修改文件。当您需要按模式快速查找文件、搜索代码中的关键字或回答有关代码库的问题时，请使用此功能。
---
### 使用壓實
### 使用 Compact
_模式_：`primary`
@@ -92,7 +92,7 @@ _模式_：`primary`
---
### 使用標題
### 使用 Title
_模式_：`primary`
@@ -100,7 +100,7 @@ _模式_：`primary`
---
### 使用總結
### 使用 Summary
_模式_：`primary`
@@ -110,27 +110,27 @@ _模式_：`primary`
## 用法
1. 对于主要代理，请在会话期间使用 **Tab** 键循环浏览它们。您还可以使用配置的 `switch_agent` 键绑定。
1. 对于 Primary 代理，请在会话期间使用 **Tab** 键循环浏览它们。您还可以使用配置的 `switch_agent` 键绑定。
2. 可以调用子代理：
- **自动**由主要代理根據其描述执行专門任务。
- 通过在消息中**@提及**子代理手动進行。例如。
- **自动**由 Primary 代理根据其描述执行专门任务。
- 通过在消息中 **@提及** 子代理手动进行。例如。
```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 ← ... ← 父级
这使您可以在主要对话和专門的子代理工作之間無縫切換。
这使您可以在主要对话和专门的子代理工作之间无缝切换。
---
## 配置
您可以自定義内置代理或通过配置创建您自己的代理。可以通过两种方式配置代理：
您也可以自定义内置代理或通过配置创建您自己的代理。可以通过两种方式配置代理：
---
@@ -181,7 +181,7 @@ _模式_：`primary`
您还可以使用 Markdown 文件定义代理。将它们放入：
- 全球：`~/.config/opencode/agents/`
- 全局：`~/.config/opencode/agents/`
- 每个项目：`.opencode/agents/`
```markdown title="~/.config/opencode/agents/review.md"
@@ -206,13 +206,13 @@ You are in code review mode. Focus on:
Provide constructive feedback without making direct changes.
```
Markdown 文件名成为代理名称。例如，`review.md` 创建`review` 代理。
Markdown 文件名成为代理名称。例如，`review.md` 创建 `review` 代理。
---
## 選項
## 选项
讓我们詳細看看这些配置選項。
让我们详细看看这些配置选项。
---
@@ -230,15 +230,15 @@ Markdown 文件名成为代理名称。例如，`review.md` 创建`review` 代
}
```
这是一个**必需的**配置選項。
这是一个 **必需的** 配置选项。
---
### 溫度
### 温度
使用 `temperature` 配置控制 LLM 响应的随机性和创意。
較低的值使響应更加集中和確定，而較高的值则增加创建力和可變性。
较低的值使响应更加集中和确定，而较高的值则增加创造力和可变性。
```json title="opencode.json"
{
@@ -277,15 +277,15 @@ Markdown 文件名成为代理名称。例如，`review.md` 创建`review` 代
}
```
如果未指定温度，opencode 将使用特定于模型的默认值；大多数模型通常为 0，Qwen 模型为 0.55。
如果未指定温度，OpenCode 将使用特定于模型的默认值；大多数模型通常为 0，Qwen 模型为 0.55。
---
### 最大步數
### 最大步数
控制代理在被迫仅使用文本響应之前可以执行的最大代理迭代次數。这允许希望控制成本的用戶对代理操作设置限制。
控制代理在被迫仅使用文本响应之前可以执行的最大代理迭代次数。这允许希望控制成本的用户对代理操作设置限制。
如果未设置，代理将繼續迭代，直到模型选择停止或用戶中斷会话。
如果未设置，代理将继续迭代，直到模型选择停止或用户中断会话。
```json title="opencode.json"
{
@@ -299,17 +299,17 @@ Markdown 文件名成为代理名称。例如，`review.md` 创建`review` 代
}
```
当達到限制時，代理会收到特殊的系統提示，指示其響应其工作摘要和建議的剩餘任务。
当达到限制时，代理会收到特殊的系统提示，指示其响应其工作摘要和建议的剩余任务。
:::caution
旧版 `maxSteps` 字段已废弃。请改用`steps`。
旧版 `maxSteps` 字段已废弃。请改用 `steps`。
:::
---
### 禁用
设置为`true`以取消代理。
设置为 `true` 以取消代理。
```json title="opencode.json"
{
@@ -323,7 +323,7 @@ Markdown 文件名成为代理名称。例如，`review.md` 创建`review` 代
---
### 迅速的
### 提示
使用 `prompt` 配置为代理指定自定义系统提示文件。提示文件应包含特定于代理目的的说明。
@@ -337,7 +337,7 @@ Markdown 文件名成为代理名称。例如，`review.md` 创建`review` 代
}
```
该路径相对于文件所在位置的配置。因此，这适用于全局 opencode 配置和项目特定配置。
该路径相对于文件所在位置的配置。因此，这适用于全局 OpenCode 配置和项目特定配置。
---
@@ -346,7 +346,7 @@ Markdown 文件名成为代理名称。例如，`review.md` 创建`review` 代
使用 `model` 配置此代理的模型。对于使用针对不同任务优化的不同模型很有帮助。例如，更快的规划模型、更强大的实施模型。
:::tip
如果您不指定模型，主代理将使用[全局配置的模型](/docs/config#models)，而子代理将使用调用子代理的主代理的模型。
如果您不指定模型，Primary 代理将使用 [全局配置的模型](/docs/config#models)，而子代理将使用调用子代理的 Primary 代理的模型。
:::
```json title="opencode.json"
@@ -359,7 +359,7 @@ 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。
---
@@ -482,7 +482,7 @@ Only analyze code and suggest changes.
}
```
这可以採用全局模式。
这可以采用全局模式。
```json title="opencode.json" {7}
{
@@ -499,7 +499,7 @@ Only analyze code and suggest changes.
}
```
您还可以使用`*`通配符來管理所有命令的权限。
您还可以使用 `*` 通配符来管理所有命令的权限。
由于最后一个匹配规则优先，因此将 `*` 通配符放在前面，将特定规则放在后面。
```json title="opencode.json" {8}
@@ -524,7 +524,7 @@ Only analyze code and suggest changes.
### 模式
使用`mode` 配置控制代理的模式。 `mode` 选项用于确定如何使用代理。
使用 `mode` 配置控制代理的模式。 `mode` 选项用于确定如何使用代理。
```json title="opencode.json"
{
@@ -536,13 +536,13 @@ Only analyze code and suggest changes.
}
```
`mode` 选项可设置为`primary`、`subagent` 或`all`。如果未指定`mode`，则默认为`all`。
`mode` 选项可设置为 `primary`、`subagent` 或 `all`。如果未指定 `mode`，则默认为 `all`。
---
### 隱
### 隐藏
使用`hidden: true`从`@`自动完成菜单隐藏子代理。对于只能由其他代理通过任务工具以编程方式调用的内部子代理很有帮助。
使用 `hidden: true` 从 `@` 自动完成菜单隐藏子代理。对于只能由其他代理通过任务工具以编程方式调用的内部子代理很有帮助。
```json title="opencode.json"
{
@@ -558,14 +558,14 @@ Only analyze code and suggest changes.
这仅影响自动完成菜单中的用户可见性。如果权限允许，模型仍然可以通过任务工具调用隐藏代理。
:::note
仅适用于`mode: subagent`代理。
仅适用于 `mode: subagent` 代理。
:::
---
### 任务权限
使用`permission.task`控制代理可以通过任务工具调用哪些子代理。使用glob模式进行灵活匹配。
使用 `permission.task` 控制代理可以通过任务工具调用哪些子代理。使用 glob 模式进行灵活匹配。
```json title="opencode.json"
{
@@ -584,23 +584,23 @@ Only analyze code and suggest changes.
}
```
当设置为`deny`时，子代理社区任务工具描述中因此完全删除，模型不会尝试调用它。
当设置为 `deny` 时，子代理社区任务工具描述中因此完全删除，模型不会尝试调用它。
:::tip
规则按顺序评估，**最后匹配的规则触发**。在上面的示例中，`orchestrator-planner` 匹配`*`（拒绝）和`orchestrator-*`（允许），但由于`orchestrator-*` 位于`*` 之后，因此结果为`allow`。
规则按顺序评估，**最后匹配的规则触发**。在上面的示例中，`orchestrator-planner` 匹配 `*`（拒绝）和 `orchestrator-*`（允许），但由于 `orchestrator-*` 位于 `*` 之后，因此结果为 `allow`。
:::
:::tip
用戶始終可以通过 `@` 自动完成菜单直接调用任何子代理，即使代理的任务权限会拒絕它。
用户始终可以通过 `@` 自动完成菜单直接调用任何子代理，即使代理的任务权限会拒绝它。
:::
---
### 顏色
### 颜色
在UI中的界面外观中使用`color`选项自定义代理。这会影响代理在界面中的显示方式。
在 UI 中的界面外观中使用 `color` 选项自定义代理。这会影响代理在界面中的显示方式。
使用有效的十六进制颜色（例如`#FF5733`）或主题颜色：`primary`、`secondary`、`accent`、`success`、`warning`、`error`、`info`。
使用有效的十六进制颜色（例如 `#FF5733`）或主题颜色：`primary`、`secondary`、`accent`、`success`、`warning`、`error`、`info`。
```json title="opencode.json"
{
@@ -617,7 +617,7 @@ Only analyze code and suggest changes.
---
### 顶P
### Top P
使用 `top_p` 选项控制响应多样性。控制随机性的温度替代方案。
@@ -631,13 +631,13 @@ Only analyze code and suggest changes.
}
```
值范围從 0.0 到 1.0。較低的值更加集中，較高的值更加多樣化。
值范围从 0.0 到 1.0。较低的值更加集中，较高的值更加多样化。
---
### 額外的
### 其他
您在代理配置中指定的任何其他選項都将作为模型選項**直接**傳遞給提供商。这允许您使用特定于提供商的功能和參數。
您在代理配置中指定的任何其他选项都将作为模型选项 **直接** 传递给提供商。这允许您使用特定于提供商的功能和参数。
例如，使用 OpenAI 的推理模型，您可以控制推理工作：
@@ -654,7 +654,7 @@ Only analyze code and suggest changes.
}
```
这些附加選項是特定于模型和提供商的。检查提供商的文档以获取可用參數。
这些附加选项是特定于模型和提供商的。检查提供商的文档以获取可用参数。
:::tip
运行 `opencode models` 查看可用模型的列表。
@@ -672,37 +672,37 @@ opencode agent create
此交互式命令将：
1. 詢問代理保存在哪裡；全局或特定項目。
2. 描述代理应该做什麼。
3. 生成適当的系統提示和標識符。
4. 讓您选择代理可以访问哪些工具。
5. 最后，使用代理配置创建一个markdown文件。
1. 询问代理保存在哪里；全局或特定项目。
2. 描述代理应该做什么。
3. 生成适当的系统提示和标识符。
4. 让您选择代理可以访问哪些工具。
5. 最后，使用代理配置创建一个 markdown 文件。
---
## 使用案例
以下是不同代理的一些常見用例。
以下是不同代理的一些常见用例。
- **構建代理**：启用所有工具的完整開發工作
- **規劃代理**：分析規劃，不做改動
- **审查代理**：具有隻讀访问权限和文档工具的代碼审查
- **调试代理**：专注于启用bash和读取工具的调查
- **文档代理**：使用文件操作但不使用系統命令的文档編寫
- **Build Agent**：启用所有工具的完整开发工作
- **Plan Agent**：分析规划，不做改动
- **Review Agent**：具有只读访问权限和文档工具的代码审查
- **Debug Agent**：专注于启用 bash 和读取工具的调查
- **Docs Agent**：使用文件操作但不使用系统命令的文档编写
---
## 示例
以下是一些您可能会覺得有用的示例代理。
以下是一些您可能会觉得有用的示例代理。
:::tip
您有想要分享的经纪人吗？ [提交 PR](https://github.com/anomalyco/opencode)。
您有想要分享的代理吗？ [提交 PR](https://github.com/anomalyco/opencode)。
:::
---
### 文件代理
### 文档代理
```markdown title="~/.config/opencode/agents/docs-writer.md"
---
@@ -724,7 +724,7 @@ Focus on:
---
### 安全審核員
### 安全审计员
```markdown title="~/.config/opencode/agents/security-auditor.md"
---