Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions packages/web/src/content/docs/zh-cn/mcp-servers.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -169,7 +169,7 @@ opencode自动处理远程MCP服务器的OAuth身份验证。当服务器需要

1. 检测 401 响应并启动 OAuth 流程
2. 如果服务器支持,请使用**动态客户端注册 (RFC 7591)**
3. 安全地存儲Tokens以供将來的请求
3. 安全地存储Tokens以供将来的请求

---

Expand All @@ -189,7 +189,7 @@ opencode自动处理远程MCP服务器的OAuth身份验证。当服务器需要
}
```

如果服務器需要身份验证,opencode 将在您第一次嘗試使用它時提示您进行身份验证。如果沒有,您可以使用 `timeout`[手动觸發流量](#authenticating)。
如果服务器需要身份验证,opencode 将在您第一次尝试使用它时提示您进行身份验证。如果没有,您可以使用 `timeout`[手动触发流量](#authenticating)。

---

Expand Down Expand Up @@ -218,7 +218,7 @@ opencode自动处理远程MCP服务器的OAuth身份验证。当服务器需要

### 身份验证

您可以手动觸發身份验证或管理憑據
您可以手动触发身份验证或管理凭据

使用特定MCP服务器进行身份验证:

Expand All @@ -232,7 +232,7 @@ opencode mcp auth my-oauth-server
opencode mcp list
```

删除存儲的憑據
删除存储的凭据

```bash
opencode mcp logout my-oauth-server
Expand Down Expand Up @@ -297,7 +297,7 @@ opencode mcp debug my-oauth-server

### 全局

这意味著您可以全局启用或禁用它們
这意味著您可以全局启用或禁用它们

```json title="opencode.json" {14}
{
Expand Down
40 changes: 20 additions & 20 deletions packages/web/src/content/docs/zh-cn/models.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ opencode 使用 [AI SDK](https://ai-sdk.dev/) 和 [Models.dev](https://models.de

## 选择模型

配置完提供商後,您可以通过輸入以下內容來选择您想要的模型
配置完提供商后,您可以通过输入以下内容来选择您想要的模型

```bash frame="none"
/models
Expand All @@ -27,29 +27,29 @@ opencode 使用 [AI SDK](https://ai-sdk.dev/) 和 [Models.dev](https://models.de

## 推荐模型

那裡有很多模型,每週都会有新模型問世
那里有很多模型,每周都会有新模型问世

:::tip
考慮使用我们推薦的模型之一
考虑使用我们推荐的模型之一
:::

然而,既擅長生成代碼又擅長工具调用的只有少數
然而,既擅长生成代码又擅长工具调用的只有少数

以下是与 opencode 配合良好的几个模型,排名不分前面。(这不是好看的列表,也不一定是最新的):

- GPT 5.2
- GPT 5.1 法典
- 近距離工作4.5
- 克勞德十四行詩 4.5
- 极小极M2.1
- 雙子座 3 专業版
- GPT 5.1 Codex
- Claude Opus 4.5
- Claude Sonnet 4.5
- Minimax M2.1
- Gemini 3 Pro

---

## 设置默认值

要将其中之一设置为默認模型,您可以在您的
打開代碼配置
要将其中之一设置为默认模型,您可以在您的
打开代码配置

```json title="opencode.json" {3}
{
Expand Down Expand Up @@ -143,14 +143,14 @@ opencode 使用 [AI SDK](https://ai-sdk.dev/) 和 [Models.dev](https://models.de

opencode 附带了许多重大的默认变体:

**人擇**:
**Anthropic**:

- `high` - 高思维预算(默认)
- `max` - 最大预算规划

**OpenAI**:

因模型而異,但大致如下:
因模型而异,但大致如下:

- `none` - 没有推理
- `minimal` - 最少的推理工作
Expand All @@ -159,18 +159,18 @@ opencode 附带了许多重大的默认变体:
- `high` - 高推理能力
- `xhigh` - 极高的推理能力

**谷歌**:
**Google**:

- `low` - 降低工作量/Tokens預算
- `high` - 更高的努力/Tokens預算
- `low` - 降低工作量/Tokens预算
- `high` - 更高的努力/Tokens预算

:::tip
该列表并不全面。許多其他提供商也有内置的默認值
该列表并不全面。许多其他提供商也有内置的默认值
:::

### 自定义变体

您可以覆盖現有變體或添加您自己的變體
您可以覆盖现有变体或添加您自己的变体

```jsonc title="opencode.jsonc" {7-18}
{
Expand All @@ -195,7 +195,7 @@ opencode 附带了许多重大的默认变体:
}
```

### 循环变体
### 切换变体

使用按键绑定`variant_cycle`在变体之间快速切换。 [了解更多](/docs/keybinds)。

Expand All @@ -220,4 +220,4 @@ opencode 附带了许多重大的默认变体:

3. 最后使用的模型。

4. 第一个模型使用内部优先級
4. 第一个模型使用内部优先级
32 changes: 16 additions & 16 deletions packages/web/src/content/docs/zh-cn/modes.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: 模式
description: 不同的模式適用于不同的用例
description: 不同的模式适用于不同的用例
---

:::caution
Expand All @@ -13,7 +13,7 @@ opencode 中的模式允许自定义不同的示例行为、工具和提示。
它具有两种内置模式:**构建**和**计划**。您可以定制
这些或通过 opencode 配置配置您自己的。

您可以在会话期間在模式之間切換或在配置文件中配置它們
您可以在会话期间在模式之间切换或在配置文件中配置它们

---

Expand All @@ -25,13 +25,13 @@ opencode 有两种内置模式。

### 构建

構建是启用所有工具的**默認**模式。这是開發工作的標準模式,您需要完全访问文件操作和系統命令
构建是启用所有工具的**默认**模式。这是开发工作的标准模式,您需要完全访问文件操作和系统命令

---

### 计划

专为規劃和分析而設計的受限模式。在計劃模式下,默認情况下禁用以下工具
专为规划和分析而设计的受限模式。在计划模式下,默认情况下禁用以下工具

- `write` - 无法创建新文件
- `edit` - 无法修改现有文件,位于 `.opencode/plans/*.md` 的用于详细说明计划本身的文件另外
Expand All @@ -52,7 +52,7 @@ opencode 有两种内置模式。

## 配置

您可以自定義内置模式或通过配置创建自己的模式。可以通过两种方式配置模式:
您可以自定义内置模式或通过配置创建自己的模式。可以通过两种方式配置模式:

### JSON 配置

Expand Down Expand Up @@ -112,7 +112,7 @@ Provide constructive feedback without making direct changes.

Markdown 文件名成为模式名称(例如,`review.md` 创建`review` 模式)。

讓我们詳細看看这些配置選項
让我们详细看看这些配置选项

---

Expand Down Expand Up @@ -191,7 +191,7 @@ Markdown 文件名成为模式名称(例如,`review.md` 创建`review` 模
}
```

该路徑是相对于配置文件所在位置的。所以这適用于
该路径是相对于配置文件所在位置的。所以这适用于
全局opencode配置和项目特定配置。

---
Expand All @@ -217,13 +217,13 @@ Markdown 文件名成为模式名称(例如,`review.md` 创建`review` 模
}
```

如果未指定任何工具,则默認启用所有工具
如果未指定任何工具,则默认启用所有工具

---

#### 可用工具

这裡是所有可以通过模式配置控制的工具
这里是所有可以通过模式配置控制的工具

| 工具 | 描述 |
| ----------- | ---------------- |
Expand All @@ -243,7 +243,7 @@ Markdown 文件名成为模式名称(例如,`review.md` 创建`review` 模

## 自定义模式

您可以通过将自定義模式添加到配置來创建自己的自定義模式。以下是使用这两种方法的示例:
您可以通过将自定义模式添加到配置来创建自己的自定义模式。以下是使用这两种方法的示例:

### 使用 JSON 配置

Expand Down Expand Up @@ -320,12 +320,12 @@ Priorities:

### 使用案例

以下是不同模式的一些常見用例
以下是不同模式的一些常见用例

- **构建模式**:启用所有工具的完整開發工作
- **计划模式**:分析和計劃,無需更改
- **审阅模式**:使用只讀访问权限和文档工具進行代碼审阅
- **构建模式**:启用所有工具的完整开发工作
- **计划模式**:分析和计划,无需更改
- **审阅模式**:使用只读访问权限和文档工具进行代码审阅
- **调试模式**:专注于启用bash和读取工具的调查
- **文档模式**:使用文件操作但不使用系統命令的文档編寫
- **文档模式**:使用文件操作但不使用系统命令的文档编写

您可能还会發現不同的模型適用于不同的用例
您可能还会发现不同的模型适用于不同的用例
6 changes: 3 additions & 3 deletions packages/web/src/content/docs/zh-cn/network.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: 网络
description: 配置代理和自定義證書
description: 配置代理和自定义证书
---

opencode支持企业网络环境的标准代理环境变量和自定义证书。
Expand All @@ -9,7 +9,7 @@ opencode支持企业网络环境的标准代理环境变量和自定义证书。

## 代理

opencode 尊重标准代理环境变量
opencode 遵循标准代理环境变量

```bash
# HTTPS proxy (recommended)
Expand Down Expand Up @@ -39,7 +39,7 @@ export HTTPS_PROXY=http://username:password@proxy.example.com:8080
```

:::caution
避免对密碼進行硬編碼。使用環境變量或安全憑證存儲
避免对密码进行硬编码。使用环境变量或安全凭证存储
:::

对于需要高级身份验证(例如 NTLM 或 Kerberos)的代理,请考虑使用支持您的身份验证方法的 LLM 网关。
Expand Down
20 changes: 10 additions & 10 deletions packages/web/src/content/docs/zh-cn/permissions.mdx
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: 权限
description: 控制哪些操作需要批准才能運行
description: 控制哪些操作需要批准才能运行
---

opencode 使用`permission` 配置来决定给定的操作是否应自动运行、提示您或被阻止。
Expand Down Expand Up @@ -47,7 +47,7 @@ opencode 使用`permission` 配置来决定给定的操作是否应自动运行

## 粒度规则(对象语法)

对于大多數权限,您可以使用对像根據工具輸入应用不同的操作
对于大多数权限,您可以使用对象根据工具输入应用不同的操作

```json title="opencode.json"
{
Expand All @@ -68,19 +68,19 @@ opencode 使用`permission` 配置来决定给定的操作是否应自动运行
}
```

规则通过模式匹配進行評估,**最后匹配的规则獲勝**。常見的模式是将包羅万象的 `"*"` 规则放在前面,然後再放置更具體的规则
规则通过模式匹配进行评估,**最后匹配的规则获胜**。常见的模式是将包罗万象的 `"*"` 规则放在前面,然后再放置更具体的规则

### 通配符

权限模式使用簡單的通配符匹配
权限模式使用简单的通配符匹配

- `*` 匹配零个或多个任意字符
- `?` 恰好匹配一个字符
- 所有其他字符均按字面意思匹配

### 主目录扩展

您可以在模式目录中使用 `~` 或 `$HOME` 来引用您的主目录。这对于 [`external_directory`](#external-directories) 规则特别有用。
您可以在模式目录中使用 `~` 或 `$HOME` 来引用您的主目录。这对于 [`外部目录`](#external_directory) 规则特别有用。

- `~/projects/*` -> `/Users/username/projects/*`
- `$HOME/projects/*` -> `/Users/username/projects/*`
Expand Down Expand Up @@ -133,22 +133,22 @@ opencode权限由工具名称和一些安全防护措施决定:
- `edit` — 所有文件修改(头部`edit`、`write`、`patch`、`multiedit`)
- `glob` — 文件通配符(匹配通配符模式)
- `grep` — 内容搜索(匹配正则表达式模式)
- `list` — 上市目录中的文件(与目录路径匹配)
- `list` — 列出目录中的文件(与目录路径匹配)
- `bash` — 运行 shell 命令(匹配 `git status --porcelain` 等解析命令)
- `task` — 启动子代理(与子代理类型匹配)
- `skill` — 加载技能(与技能名称匹配)
- `lsp` — 运行 LSP 查询(当前非粒度)
- `todoread`、`todowrite` — 讀取/更新待辦事項列表
- `todoread`、`todowrite` — 读取/更新待办事项列表
- `webfetch` — 获取 URL(与 URL 匹配)
- `websearch`、`codesearch` — 網頁/代碼搜索(与查询匹配)
- `websearch`、`codesearch` — 网页/代码搜索(与查询匹配)
- `external_directory` — 当工具访问项目工作目录外部的路径时触发
- `doom_loop` — 当相同的工具调用相同的输入重复 3 次时触发

---

## 默认值

如果您未指定任何内容,opencode分散许可的默认值开始
如果您未指定任何内容,opencode将从宽松的默认值开始

- 大部分权限默认为`"allow"`。
- `doom_loop`和`external_directory`默认为`"ask"`。
Expand All @@ -171,7 +171,7 @@ opencode权限由工具名称和一些安全防护措施决定:

## “询问”的作用是什么

当 opencode 提示批准时,UI 会提供清晰的结果
当 opencode 提示批准时,UI 会提供三种结果

- `once` — 仅批准此请求
- `always` — 批准与建议模式匹配的未来请求(对于当前 opencode 会话的其余部分)
Expand Down
Loading
Loading