fix(docs): locale translations

This commit is contained in:
Adam
2026-02-10 07:11:13 -06:00
parent 19ad7ad809
commit 4c4e30cd71
351 changed files with 3744 additions and 3765 deletions

View File

@@ -1,15 +1,15 @@
---
title: 代理商
description: 配置和使用門的代理。
description: 配置和使用門的代理。
---
代理是門的人工智能助手,可以針特定任和工作流程進行配置。它們允許您創建具有自定義提示、模型和工具訪問權限的用工具。
代理是門的人工智能助手,可以針特定任和工作流程進行配置。它們允许您创建具有自定義提示、模型和工具访问权限的用工具。
:::tip
使用計劃代理來分析代碼並審查建議,而無需進行任何代碼更改。
使用計劃代理來分析代碼并审查建議,而無需進行任何代碼更改。
:::
您可以在會話期間在代理之間切換,或使用 `@` 提及來調用它們。
您可以在会话期間在代理之間切換,或使用 `@` 提及來用它們。
---
@@ -28,13 +28,13 @@ opencode有两种类型的代理主代理和次代理。
:::
opencode附带两个内置的主要代理**Build** 和 **Plan**。地
看看下面些。
看看下面些。
---
### 子代理
子代理是主要代理可以調用​​來行特定任務的專業助手。您可以通在消息中**@提及**它們來手動調用它們。
子代理是主要代理可以用​​來行特定任务的专業助手。您可以通在消息中**@提及**它們來手动调用它們。
opencode附带两个内置子代理**General** 和 **Explore**。我们将在下面看看这个。
@@ -50,7 +50,7 @@ opencode附带两个内置主代理和两个内置子代理。
_模式_`primary`
構建是用所有工具的**默認**主要代理。是用需要完全訪問文件操作和系統命令的開發工作的標準代理。
構建是用所有工具的**默認**主要代理。是用需要完全访问文件操作和系統命令的開發工作的標準代理。
---
@@ -58,7 +58,7 @@ _模式_`primary`
_模式_`primary`
專為規劃和分析而設計的受限代理。我使用限系統您提供更多控制防止意外更改。
专为規劃和分析而設計的受限代理。我使用限系統您提供更多控制防止意外更改。
默认情况下,以下所有项均设置为`ask`
- `file edits`:所有书写、修复和编辑
@@ -72,7 +72,7 @@ _模式_`primary`
_模式_`subagent`
研究複雜問題和執行多步驟任務的通用代理。具有完整的工具訪問權限(待辦事項除外),因此可在需要時更改文件。使用它可以並行運行多工作元。
研究复杂问题和执行多步骤任务的通用代理。具有完整的工具访问权限(待办事项除外),因此可在需要时修改文件,并并行运行多工作元。
---
@@ -80,7 +80,7 @@ _模式_`subagent`
_模式_`subagent`
探索代碼庫的快速只讀代理。法修改文件。您需要按模式快速查找文件、搜索代碼中的關鍵字或回答有關代碼庫的問題時,使用此功能。
探索代碼庫的快速只讀代理。法修改文件。您需要按模式快速查找文件、搜索代碼中的關鍵字或回答有關代碼庫的問題時,使用此功能。
---
@@ -112,25 +112,25 @@ _模式_`primary`
1. 对于主要代理,请在会话期间使用 **Tab** 键循环浏览它们。您还可以使用配置的 `switch_agent` 键绑定。
2. 可以調用子代理:
- **自**由主要代理根據其描述執行專門任
- 通在消息中**@提及**子代理手進行。例如。
2. 可以用子代理:
- **自**由主要代理根據其描述执行专門任
- 通在消息中**@提及**子代理手進行。例如。
```txt frame="none"
@general help me search for this function
```
3. **會話之間導航**子代理建自己的子會話時,您可以使用以下命令在父會話和所有子會話之間導航:
3. **会话之间导航**子代理建自己的子会话時,您可以使用以下命令在父会话和所有子会话之间导航:
- **\<Leader>+Right**(或您配置的 `session_child_cycle` 鍵綁定)向前循環父級 → 子級 1 → 子級 2 → ... → 父級
- **\<Leader>+Left**(或您配置的 `session_child_cycle_reverse` 鍵綁定)向後循環父級 ← 子級 1 ← 子級 2 ← ... ← 父級
使您可以在主要對話和專門的子代理工作之間無縫切換。
使您可以在主要对话和专門的子代理工作之間無縫切換。
---
## 配置
您可以自定義置代理或通配置建您自己的代理。可以通過兩種方式配置代理:
您可以自定義置代理或通配置建您自己的代理。可以通过两种方式配置代理:
---
@@ -177,7 +177,7 @@ _模式_`primary`
---
### 降價
### Markdown
您还可以使用 Markdown 文件定义代理。将它们放入:
@@ -212,7 +212,7 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代
## 選項
讓我詳細看看些配置選項。
讓我詳細看看些配置選項。
---
@@ -230,7 +230,7 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代
}
```
是一**必需的**配置選項。
是一**必需的**配置選項。
---
@@ -238,7 +238,7 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代
使用 `temperature` 配置控制 LLM 响应的随机性和创意。
較低的值使響更加集中和確定,而較高的值增加創造力和可變性。
較低的值使響更加集中和確定,而較高的值增加创建力和可變性。
```json title="opencode.json"
{
@@ -253,11 +253,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"
{
@@ -277,15 +277,15 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代
}
```
如果未指定温度opencode 将使用特定于型的默认值;大多数型通常为 0Qwen 型为 0.55。
如果未指定温度opencode 将使用特定于型的默认值;大多数型通常为 0Qwen 型为 0.55。
---
### 最大步數
控制代理在被迫使用文本響之前可以行的最大代理迭代次數。這允許希望控成本的用戶代理操作置限制。
控制代理在被迫使用文本響之前可以行的最大代理迭代次數。这允许希望控成本的用戶代理操作置限制。
如果未置,代理繼續迭代,直到模型選擇停止或用戶中斷會話
如果未置,代理繼續迭代,直到模型选择停止或用戶中斷会话
```json title="opencode.json"
{
@@ -299,7 +299,7 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代
}
```
達到限制時,代理收到特殊的系統提示,指示其響其工作摘要和建議的剩餘任
達到限制時,代理收到特殊的系統提示,指示其響其工作摘要和建議的剩餘任
:::caution
旧版 `maxSteps` 字段已废弃。请改用`steps`。
@@ -343,7 +343,7 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代
### 模型
使用 `model` 配置此代理的模型。对于使用针对不同任务优化的不同模型很有。例如,更快的规划模型、更强大的实施模型。
使用 `model` 配置此代理的模型。对于使用针对不同任务优化的不同模型很有帮助。例如,更快的规划模型、更强大的实施模型。
:::tip
如果您不指定模型,主代理将使用[全局配置的模型](/docs/config#models),而子代理将使用调用子代理的主代理的模型。
@@ -386,7 +386,7 @@ opencode配置中的模型ID使用格式`provider/model-id`。例如,如果您
```
:::note
特定代理的配置會覆蓋全局配置。
特定代理的配置会覆盖全局配置。
:::
您还可以使用通配符同时控制多个工具。例如,要禁用 MCP 服务器中的所有工具:
@@ -410,7 +410,7 @@ opencode配置中的模型ID使用格式`provider/model-id`。例如,如果您
---
###
###
您可以配置权限来管理代理可以执行的操作。 目前,`edit`、`bash` 和 `webfetch` 工具的权限可以配置为:
@@ -427,7 +427,7 @@ opencode配置中的模型ID使用格式`provider/model-id`。例如,如果您
}
```
您可以覆蓋每個代理的這些權限。
您可以覆盖每个代理的这些权限。
```json title="opencode.json" {3-5,8-10}
{
@@ -482,7 +482,7 @@ Only analyze code and suggest changes.
}
```
可以採用全局模式。
可以採用全局模式。
```json title="opencode.json" {7}
{
@@ -499,8 +499,8 @@ Only analyze code and suggest changes.
}
```
可以使用`*`通配符來管理所有命令的限。
於最後一個匹配規則優先,因此 `*` 通配符放在前面,特定規則放在面。
可以使用`*`通配符來管理所有命令的限。
于最后一个匹配规则优先,因此 `*` 通配符放在前面,特定规则放在面。
```json title="opencode.json" {8}
{
@@ -542,7 +542,7 @@ Only analyze code and suggest changes.
### 隱
使用`hidden: true`从`@`自动完成菜单隐藏子代理。对于只能由其他代理通过任务工具以编程方式调用的内部子代理很有
使用`hidden: true`从`@`自动完成菜单隐藏子代理。对于只能由其他代理通过任务工具以编程方式调用的内部子代理很有帮助
```json title="opencode.json"
{
@@ -555,7 +555,7 @@ Only analyze code and suggest changes.
}
```
這僅影響自動完成菜中的用戶可見性。如果限允,模型仍然可以通過任務工具調用隱藏代理。
这仅影响自动完成菜中的用户可见性。如果限允,模型仍然可以通过任务工具调用隐藏代理。
:::note
仅适用于`mode: subagent`代理。
@@ -563,7 +563,7 @@ Only analyze code and suggest changes.
---
### 任務權
### 任务权
使用`permission.task`控制代理可以通过任务工具调用哪些子代理。使用glob模式进行灵活匹配。
@@ -591,7 +591,7 @@ Only analyze code and suggest changes.
:::
:::tip
用戶始終可以通 `@` 自完成菜直接調用任何子代理,即使代理的任務權限會拒絕它。
用戶始終可以通 `@` 自完成菜直接用任何子代理,即使代理的任务权限会拒絕它。
:::
---
@@ -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` 查看可用模型的列表。
@@ -662,20 +662,20 @@ Only analyze code and suggest changes.
---
## 建代理
## 建代理
您可以使用以下命令建新代理:
您可以使用以下命令建新代理:
```bash
opencode agent create
```
此交互式命令
此交互式命令
1. 詢問代理保存在哪裡;全局或特定項目。
2. 描述代理應該做什麼。
3. 生成適的系統提示和標識符。
4. 讓您選擇代理可以訪問哪些工具。
2. 描述代理应该做什麼。
3. 生成適的系統提示和標識符。
4. 讓您选择代理可以访问哪些工具。
5. 最后使用代理配置创建一个markdown文件。
---
@@ -684,17 +684,17 @@ opencode agent create
以下是不同代理的一些常見用例。
- **構建代理**用所有工具的完整開發工作
- **構建代理**用所有工具的完整開發工作
- **規劃代理**:分析規劃,不做改動
- **查代理**:具有隻讀訪問權限和文工具的代碼
- **查代理**:具有隻讀访问权限和文工具的代碼
- **调试代理**专注于启用bash和读取工具的调查
- **文代理**:使用文件操作但不使用系統命令的文編寫
- **文代理**:使用文件操作但不使用系統命令的文編寫
---
## 示例
以下是一些您可能覺得有用的示例代理。
以下是一些您可能覺得有用的示例代理。
:::tip
您有想要分享的经纪人吗? [提交 PR](https://github.com/anomalyco/opencode)。