From 4293632d92533288f95602b449d40807318077ee Mon Sep 17 00:00:00 2001 From: zhochi Date: Thu, 4 Jun 2026 13:24:34 +0800 Subject: [PATCH] 1. add chinese version of 'Policies.mdx'; 2. update the link to maintain a consistent view --- .../web/src/content/docs/zh-cn/agents.mdx | 8 +- packages/web/src/content/docs/zh-cn/cli.mdx | 8 +- .../web/src/content/docs/zh-cn/commands.mdx | 16 +- .../web/src/content/docs/zh-cn/config.mdx | 36 ++--- .../src/content/docs/zh-cn/custom-tools.mdx | 4 +- .../web/src/content/docs/zh-cn/enterprise.mdx | 4 +- .../web/src/content/docs/zh-cn/formatters.mdx | 2 +- packages/web/src/content/docs/zh-cn/go.mdx | 2 +- packages/web/src/content/docs/zh-cn/ide.mdx | 2 +- packages/web/src/content/docs/zh-cn/index.mdx | 10 +- .../src/content/docs/zh-cn/mcp-servers.mdx | 8 +- .../web/src/content/docs/zh-cn/models.mdx | 10 +- .../web/src/content/docs/zh-cn/network.mdx | 2 +- .../src/content/docs/zh-cn/permissions.mdx | 2 +- .../web/src/content/docs/zh-cn/plugins.mdx | 6 +- .../web/src/content/docs/zh-cn/policies.mdx | 137 ++++++++++++++++++ .../web/src/content/docs/zh-cn/providers.mdx | 6 +- packages/web/src/content/docs/zh-cn/rules.mdx | 2 +- packages/web/src/content/docs/zh-cn/sdk.mdx | 2 +- .../web/src/content/docs/zh-cn/server.mdx | 6 +- packages/web/src/content/docs/zh-cn/share.mdx | 8 +- packages/web/src/content/docs/zh-cn/tools.mdx | 16 +- .../content/docs/zh-cn/troubleshooting.mdx | 4 +- packages/web/src/content/docs/zh-cn/tui.mdx | 12 +- packages/web/src/content/docs/zh-cn/web.mdx | 4 +- .../src/content/docs/zh-cn/windows-wsl.mdx | 2 +- packages/web/src/content/docs/zh-cn/zen.mdx | 4 +- 27 files changed, 230 insertions(+), 93 deletions(-) create mode 100644 packages/web/src/content/docs/zh-cn/policies.mdx diff --git a/packages/web/src/content/docs/zh-cn/agents.mdx b/packages/web/src/content/docs/zh-cn/agents.mdx index 6f821ff7f869..6f0536cc716d 100644 --- a/packages/web/src/content/docs/zh-cn/agents.mdx +++ b/packages/web/src/content/docs/zh-cn/agents.mdx @@ -353,7 +353,7 @@ Markdown 文件名即为代理名称。例如，`review.md` 会创建一个名 使用 `model` 配置为代理覆盖模型。适用于针对不同任务使用不同的优化模型。例如，用更快的模型进行规划，用更强大的模型进行实现。 :::tip -如果您不指定模型，主代理将使用[全局配置的模型](/docs/config#models)，而子代理将使用调用它的主代理所使用的模型。 +如果您不指定模型，主代理将使用[全局配置的模型](/docs/zh-cn/config#models)，而子代理将使用调用它的主代理所使用的模型。 ::: ```json title="opencode.json" @@ -366,7 +366,7 @@ Markdown 文件名即为代理名称。例如，`review.md` 会创建一个名 } ``` -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/zh-cn/zen)，则可以使用 `opencode/gpt-5.1-codex` 来表示 GPT 5.1 Codex。 --- @@ -413,7 +413,7 @@ OpenCode 配置中的模型 ID 使用 `provider/model-id` 格式。例如，如 } ``` -[了解更多关于工具的信息](/docs/tools)。 +[了解更多关于工具的信息](/docs/zh-cn/tools)。 --- @@ -525,7 +525,7 @@ Only analyze code and suggest changes. } ``` -[了解更多关于权限的信息](/docs/permissions)。 +[了解更多关于权限的信息](/docs/zh-cn/permissions)。 --- diff --git a/packages/web/src/content/docs/zh-cn/cli.mdx b/packages/web/src/content/docs/zh-cn/cli.mdx index 46f090bb72ab..0475dbe30b38 100644 --- a/packages/web/src/content/docs/zh-cn/cli.mdx +++ b/packages/web/src/content/docs/zh-cn/cli.mdx @@ -5,7 +5,7 @@ description: OpenCode CLI 选项和命令。 import { Tabs, TabItem } from "@astrojs/starlight/components" -OpenCode CLI 在不带任何参数运行时，默认启动 [TUI](/docs/tui)。 +OpenCode CLI 在不带任何参数运行时，默认启动 [TUI](/docs/zh-cn/tui)。 ```bash opencode @@ -177,7 +177,7 @@ opencode github [command] opencode github install ``` -此命令会设置必要的 GitHub Actions 工作流并引导您完成配置过程。[了解更多](/docs/github)。 +此命令会设置必要的 GitHub Actions 工作流并引导您完成配置过程。[了解更多](/docs/zh-cn/github)。 --- @@ -290,7 +290,7 @@ opencode models [provider] 此命令以 `provider/model` 的格式显示所有已配置提供商中可用的模型。 -这对于确定在[配置文件](/docs/config/)中使用的确切模型名称非常有用。 +这对于确定在[配置文件](/docs/zh-cn/config/)中使用的确切模型名称非常有用。 您可以选择传入提供商 ID 来按提供商筛选模型。 @@ -363,7 +363,7 @@ opencode run --attach http://localhost:4096 "Explain async/await in JavaScript" ### serve -启动无界面的 OpenCode 服务器以提供 API 访问。查看[服务器文档](/docs/server)了解完整的 HTTP 接口。 +启动无界面的 OpenCode 服务器以提供 API 访问。查看[服务器文档](/docs/zh-cn/server)了解完整的 HTTP 接口。 ```bash opencode serve diff --git a/packages/web/src/content/docs/zh-cn/commands.mdx b/packages/web/src/content/docs/zh-cn/commands.mdx index 751a9ff27b18..7dc30ef5449e 100644 --- a/packages/web/src/content/docs/zh-cn/commands.mdx +++ b/packages/web/src/content/docs/zh-cn/commands.mdx @@ -9,7 +9,7 @@ description: 为重复任务创建自定义命令。 /my-command ``` -自定义命令是 `/init`、`/undo`、`/redo`、`/share`、`/help` 等内置命令之外的补充。[了解更多](/docs/tui#commands)。 +自定义命令是 `/init`、`/undo`、`/redo`、`/share`、`/help` 等内置命令之外的补充。[了解更多](/docs/zh-cn/tui#commands)。 --- @@ -48,7 +48,7 @@ frontmatter 定义命令属性，内容则成为模板。 ### JSON -在 OpenCode [配置](/docs/config)中使用 `command` 选项： +在 OpenCode [配置](/docs/zh-cn/config)中使用 `command` 选项： ```json title="opencode.jsonc" {4-12} { @@ -162,7 +162,7 @@ with the following content: $3 ### Shell 输出 -使用 _!`command`_ 将 [bash 命令](/docs/tui#bash-commands)输出注入到提示词中。 +使用 _!`command`_ 将 [bash 命令](/docs/zh-cn/tui#bash-commands)输出注入到提示词中。 例如，创建一个分析测试覆盖率的自定义命令： @@ -255,8 +255,8 @@ Check for performance issues and suggest improvements. ### Agent -使用 `agent` 配置可选地指定由哪个[代理](/docs/agents)执行此命令。 -如果这是一个[子代理](/docs/agents/#subagents)，该命令默认会触发子代理调用。 +使用 `agent` 配置可选地指定由哪个[代理](/docs/zh-cn/agents)执行此命令。 +如果这是一个[子代理](/docs/zh-cn/agents/#subagents)，该命令默认会触发子代理调用。 要禁用此行为，请将 `subtask` 设置为 `false`。 ```json title="opencode.json" @@ -275,9 +275,9 @@ Check for performance issues and suggest improvements. ### Subtask -使用 `subtask` 布尔值强制命令触发[子代理](/docs/agents/#subagents)调用。 +使用 `subtask` 布尔值强制命令触发[子代理](/docs/zh-cn/agents/#subagents)调用。 如果你希望命令不污染主要上下文，这会很有用，它会**强制**代理作为子代理运行， -即使[代理](/docs/agents)配置中的 `mode` 设置为 `primary`。 +即使[代理](/docs/zh-cn/agents)配置中的 `mode` 设置为 `primary`。 ```json title="opencode.json" { @@ -313,7 +313,7 @@ Check for performance issues and suggest improvements. ## 内置命令 -opencode 包含多个内置命令，如 `/init`、`/undo`、`/redo`、`/share`、`/help`；[了解更多](/docs/tui#commands)。 +opencode 包含多个内置命令，如 `/init`、`/undo`、`/redo`、`/share`、`/help`；[了解更多](/docs/zh-cn/tui#commands)。 :::note 自定义命令可以覆盖内置命令。 diff --git a/packages/web/src/content/docs/zh-cn/config.mdx b/packages/web/src/content/docs/zh-cn/config.mdx index c401bcf121fa..1465e0d277f3 100644 --- a/packages/web/src/content/docs/zh-cn/config.mdx +++ b/packages/web/src/content/docs/zh-cn/config.mdx @@ -172,7 +172,7 @@ opencode run "Hello world" - `scroll_speed` - 自定义滚动速度倍率（默认值：`3`，最小值：`1`）。如果 `scroll_acceleration.enabled` 为 `true`，则忽略此选项。 - `diff_style` - 控制差异渲染方式。`"auto"` 根据终端宽度自适应，`"stacked"` 始终显示单列。 -[在此了解更多关于 TUI 的信息](/docs/tui)。 +[在此了解更多关于 TUI 的信息](/docs/zh-cn/tui)。 --- @@ -201,7 +201,7 @@ opencode run "Hello world" - `mdnsDomain` - mDNS 服务的自定义域名。默认为 `opencode.local`。适用于在同一网络上运行多个实例的场景。 - `cors` - 从基于浏览器的客户端使用 HTTP 服务器时允许 CORS 的额外来源。值必须是完整的来源（协议 + 主机 + 可选端口），例如 `https://app.example.com`。 -[在此了解更多关于服务器的信息](/docs/server)。 +[在此了解更多关于服务器的信息](/docs/zh-cn/server)。 --- @@ -219,7 +219,7 @@ opencode run "Hello world" } ``` -[在此了解更多关于工具的信息](/docs/tools)。 +[在此了解更多关于工具的信息](/docs/zh-cn/tools)。 --- @@ -257,7 +257,7 @@ opencode run "Hello world" - `timeout` - 请求超时时间，单位为毫秒（默认值：300000）。设置为 `false` 可禁用超时。 - `setCacheKey` - 确保始终为指定提供商设置缓存键。 -您还可以配置[本地模型](/docs/models#local)。[了解更多](/docs/models)。 +您还可以配置[本地模型](/docs/zh-cn/models#local)。[了解更多](/docs/zh-cn/models)。 --- @@ -289,10 +289,10 @@ Amazon Bedrock 支持 AWS 特定配置： - `endpoint` - VPC 端点的自定义端点 URL。这是通用 `baseURL` 选项使用 AWS 特定术语的别名。如果两者都指定，`endpoint` 优先。 :::note -Bearer Token（`AWS_BEARER_TOKEN_BEDROCK` 或 `/connect`）优先于基于配置文件的身份验证。详情请参见[身份验证优先级](/docs/providers#authentication-precedence)。 +Bearer Token（`AWS_BEARER_TOKEN_BEDROCK` 或 `/connect`）优先于基于配置文件的身份验证。详情请参见[身份验证优先级](/docs/zh-cn/providers#authentication-precedence)。 ::: -[了解更多关于 Amazon Bedrock 配置的信息](/docs/providers#amazon-bedrock)。 +[了解更多关于 Amazon Bedrock 配置的信息](/docs/zh-cn/providers#amazon-bedrock)。 --- @@ -307,7 +307,7 @@ Bearer Token（`AWS_BEARER_TOKEN_BEDROCK` 或 `/connect`）优先于基于配置 } ``` -[在此了解更多](/docs/themes)。 +[在此了解更多](/docs/zh-cn/themes)。 --- @@ -333,7 +333,7 @@ Bearer Token（`AWS_BEARER_TOKEN_BEDROCK` 或 `/connect`）优先于基于配置 } ``` -您还可以使用 `~/.config/opencode/agents/` 或 `.opencode/agents/` 中的 Markdown 文件定义代理。[在此了解更多](/docs/agents)。 +您还可以使用 `~/.config/opencode/agents/` 或 `.opencode/agents/` 中的 Markdown 文件定义代理。[在此了解更多](/docs/zh-cn/agents)。 --- @@ -348,7 +348,7 @@ Bearer Token（`AWS_BEARER_TOKEN_BEDROCK` 或 `/connect`）优先于基于配置 } ``` -默认代理必须是主代理（不能是子代理）。可以是内置代理（如 `"build"` 或 `"plan"`），也可以是您定义的[自定义代理](/docs/agents)。如果指定的代理不存在或是子代理，OpenCode 将回退到 `"build"` 并发出警告。 +默认代理必须是主代理（不能是子代理）。可以是内置代理（如 `"build"` 或 `"plan"`），也可以是您定义的[自定义代理](/docs/zh-cn/agents)。如果指定的代理不存在或是子代理，OpenCode 将回退到 `"build"` 并发出警告。 此设置适用于所有界面：TUI、CLI（`opencode run`）、桌面应用和 GitHub Action。 @@ -356,7 +356,7 @@ Bearer Token（`AWS_BEARER_TOKEN_BEDROCK` 或 `/connect`）优先于基于配置 ### 分享 -您可以通过 `share` 选项配置[分享](/docs/share)功能。 +您可以通过 `share` 选项配置[分享](/docs/zh-cn/share)功能。 ```json title="opencode.json" { @@ -397,7 +397,7 @@ Bearer Token（`AWS_BEARER_TOKEN_BEDROCK` 或 `/connect`）优先于基于配置 } ``` -您还可以使用 `~/.config/opencode/commands/` 或 `.opencode/commands/` 中的 Markdown 文件定义命令。[在此了解更多](/docs/commands)。 +您还可以使用 `~/.config/opencode/commands/` 或 `.opencode/commands/` 中的 Markdown 文件定义命令。[在此了解更多](/docs/zh-cn/commands)。 --- @@ -412,7 +412,7 @@ Bearer Token（`AWS_BEARER_TOKEN_BEDROCK` 或 `/connect`）优先于基于配置 } ``` -[在此了解更多](/docs/keybinds)。 +[在此了解更多](/docs/zh-cn/keybinds)。 --- @@ -454,7 +454,7 @@ OpenCode 启动时会自动下载新版本。您可以使用 `autoupdate` 选项 } ``` -[在此了解更多关于格式化程序的信息](/docs/formatters)。 +[在此了解更多关于格式化程序的信息](/docs/zh-cn/formatters)。 --- @@ -474,7 +474,7 @@ OpenCode 启动时会自动下载新版本。您可以使用 `autoupdate` 选项 } ``` -[在此了解更多关于权限的信息](/docs/permissions)。 +[在此了解更多关于权限的信息](/docs/zh-cn/permissions)。 --- @@ -527,13 +527,13 @@ OpenCode 启动时会自动下载新版本。您可以使用 `autoupdate` 选项 } ``` -[在此了解更多](/docs/mcp-servers)。 +[在此了解更多](/docs/zh-cn/mcp-servers)。 --- ### 插件 -[插件](/docs/plugins)通过自定义工具、钩子和集成来扩展 OpenCode。 +[插件](/docs/zh-cn/plugins)通过自定义工具、钩子和集成来扩展 OpenCode。 将插件文件放置在 `.opencode/plugins/` 或 `~/.config/opencode/plugins/` 中。您还可以通过 `plugin` 选项从 npm 加载插件。 @@ -544,7 +544,7 @@ OpenCode 启动时会自动下载新版本。您可以使用 `autoupdate` 选项 } ``` -[在此了解更多](/docs/plugins)。 +[在此了解更多](/docs/zh-cn/plugins)。 --- @@ -559,7 +559,7 @@ OpenCode 启动时会自动下载新版本。您可以使用 `autoupdate` 选项 } ``` -该选项接受指令文件路径和 glob 模式的数组。[在此了解更多关于规则的信息](/docs/rules)。 +该选项接受指令文件路径和 glob 模式的数组。[在此了解更多关于规则的信息](/docs/zh-cn/rules)。 --- diff --git a/packages/web/src/content/docs/zh-cn/custom-tools.mdx b/packages/web/src/content/docs/zh-cn/custom-tools.mdx index 8b44a0450c2a..20aeadd31cc0 100644 --- a/packages/web/src/content/docs/zh-cn/custom-tools.mdx +++ b/packages/web/src/content/docs/zh-cn/custom-tools.mdx @@ -3,7 +3,7 @@ title: 自定义工具 description: 创建 LLM 可在 opencode 中调用的工具。 --- -自定义工具是你创建的函数，LLM 可以在对话过程中调用它们。它们与 opencode 的[内置工具](/docs/tools)（如 `read`、`write` 和 `bash`）协同工作。 +自定义工具是你创建的函数，LLM 可以在对话过程中调用它们。它们与 opencode 的[内置工具](/docs/zh-cn/tools)（如 `read`、`write` 和 `bash`）协同工作。 --- @@ -100,7 +100,7 @@ export default tool({ ``` :::note -除非你有意替换内置工具，否则最好用独特的名字。如果你想禁用内置工具但不想覆盖它，使用 [权限](/docs/permissions). +除非你有意替换内置工具，否则最好用独特的名字。如果你想禁用内置工具但不想覆盖它，使用 [权限](/docs/zh-cn/permissions). ::: --- diff --git a/packages/web/src/content/docs/zh-cn/enterprise.mdx b/packages/web/src/content/docs/zh-cn/enterprise.mdx index 83e823e93aec..7b479d8830a5 100644 --- a/packages/web/src/content/docs/zh-cn/enterprise.mdx +++ b/packages/web/src/content/docs/zh-cn/enterprise.mdx @@ -21,7 +21,7 @@ OpenCode 不会存储您的任何代码或上下文数据。 ## 试用 -OpenCode 是开源的，不会存储您的任何代码或上下文数据，因此您的开发人员可以直接[开始使用](/docs/)并进行试用。 +OpenCode 是开源的，不会存储您的任何代码或上下文数据，因此您的开发人员可以直接[开始使用](/docs/zh-cn/)并进行试用。 --- @@ -50,7 +50,7 @@ OpenCode 是开源的，不会存储您的任何代码或上下文数据，因 } ``` -[了解更多关于分享的信息](/docs/share)。 +[了解更多关于分享的信息](/docs/zh-cn/share)。 --- diff --git a/packages/web/src/content/docs/zh-cn/formatters.mdx b/packages/web/src/content/docs/zh-cn/formatters.mdx index 1f4035fda6b5..030b9e1690db 100644 --- a/packages/web/src/content/docs/zh-cn/formatters.mdx +++ b/packages/web/src/content/docs/zh-cn/formatters.mdx @@ -28,7 +28,7 @@ OpenCode 内置了多种适用于主流语言和框架的格式化工具。下 | nixfmt | .nix | `nixfmt` 命令可用 | | ocamlformat | .ml, .mli | `ocamlformat` 命令可用且存在 `.ocamlformat` 配置文件 | | ormolu | .hs | `ormolu` 命令可用 | -| oxfmt (Experimental) | .js, .jsx, .ts, .tsx | `package.json` 中有 `oxfmt` 依赖，且设置了[实验性环境变量标志](/docs/cli/#experimental) | +| oxfmt (Experimental) | .js, .jsx, .ts, .tsx | `package.json` 中有 `oxfmt` 依赖，且设置了[实验性环境变量标志](/docs/zh-cn/cli/#experimental) | | pint | .php | `composer.json` 中有 `laravel/pint` 依赖 | | prettier | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml 及[更多](https://prettier.io/docs/en/index.html) | `package.json` 中有 `prettier` 依赖 | | rubocop | .rb, .rake, .gemspec, .ru | `rubocop` 命令可用 | diff --git a/packages/web/src/content/docs/zh-cn/go.mdx b/packages/web/src/content/docs/zh-cn/go.mdx index 695fb68848a3..385dd0bae232 100644 --- a/packages/web/src/content/docs/zh-cn/go.mdx +++ b/packages/web/src/content/docs/zh-cn/go.mdx @@ -167,7 +167,7 @@ OpenCode Go 包含以下限制： | Qwen3.7 Plus | qwen3.7-plus | `https://opencode.ai/zen/go/v1/messages` | `@ai-sdk/anthropic` | | Qwen3.6 Plus | qwen3.6-plus | `https://opencode.ai/zen/go/v1/messages` | `@ai-sdk/anthropic` | -你 OpenCode 配置中的 [模型 ID](/docs/config/#models) 使用 `opencode-go/` 格式。例如，对于 Kimi K2.6，你将在配置中使用 `opencode-go/kimi-k2.6`。 +你 OpenCode 配置中的 [模型 ID](/docs/zh-cn/config/#models) 使用 `opencode-go/` 格式。例如，对于 Kimi K2.6，你将在配置中使用 `opencode-go/kimi-k2.6`。 --- diff --git a/packages/web/src/content/docs/zh-cn/ide.mdx b/packages/web/src/content/docs/zh-cn/ide.mdx index 1a759a8e6a04..03268ef7b688 100644 --- a/packages/web/src/content/docs/zh-cn/ide.mdx +++ b/packages/web/src/content/docs/zh-cn/ide.mdx @@ -24,7 +24,7 @@ OpenCode 可与 VS Code、Cursor 或任何支持终端的 IDE 集成。只需在 2. 打开集成终端 3. 运行 `opencode`——扩展将自动安装 -如果你希望在 TUI 中执行 `/editor` 或 `/export` 时使用自己的 IDE，需要设置 `export EDITOR="code --wait"`。[了解更多](/docs/tui/#editor-setup)。 +如果你希望在 TUI 中执行 `/editor` 或 `/export` 时使用自己的 IDE，需要设置 `export EDITOR="code --wait"`。[了解更多](/docs/zh-cn/tui/#editor-setup)。 --- diff --git a/packages/web/src/content/docs/zh-cn/index.mdx b/packages/web/src/content/docs/zh-cn/index.mdx index ed278e2397dc..5414e9e1a78e 100644 --- a/packages/web/src/content/docs/zh-cn/index.mdx +++ b/packages/web/src/content/docs/zh-cn/index.mdx @@ -91,7 +91,7 @@ curl -fsSL https://opencode.ai/install | bash #### Windows :::tip[推荐：使用 WSL] -为了在 Windows 上获得最佳体验，我们推荐使用 [Windows Subsystem for Linux (WSL)](/docs/windows-wsl)。它提供更好的性能，并完全兼容 OpenCode 的所有功能。 +为了在 Windows 上获得最佳体验，我们推荐使用 [Windows Subsystem for Linux (WSL)](/docs/zh-cn/windows-wsl)。它提供更好的性能，并完全兼容 OpenCode 的所有功能。 ::: - **使用 Chocolatey** @@ -134,7 +134,7 @@ curl -fsSL https://opencode.ai/install | bash 通过 OpenCode，你可以配置 API 密钥来使用任意 LLM 提供商。 -如果你刚开始接触 LLM 提供商，我们推荐使用 [OpenCode Zen](/docs/zen)。这是一组经过 OpenCode 团队测试和验证的精选模型。 +如果你刚开始接触 LLM 提供商，我们推荐使用 [OpenCode Zen](/docs/zh-cn/zen)。这是一组经过 OpenCode 团队测试和验证的精选模型。 1. 在 TUI 中运行 `/connect` 命令，选择 opencode，然后前往 [opencode.ai/auth](https://opencode.ai/auth)。 @@ -153,7 +153,7 @@ curl -fsSL https://opencode.ai/install | bash └ enter ``` -你也可以选择其他提供商。[了解更多](/docs/providers#directory)。 +你也可以选择其他提供商。[了解更多](/docs/zh-cn/providers#directory)。 --- @@ -320,7 +320,7 @@ Can you refactor the function in @packages/functions/src/api/index.ts? ## 分享 -你与 OpenCode 的对话可以[与团队分享](/docs/share)。 +你与 OpenCode 的对话可以[与团队分享](/docs/zh-cn/share)。 ```bash frame="none" /share @@ -340,4 +340,4 @@ Can you refactor the function in @packages/functions/src/api/index.ts? 以上就是全部内容！你现在已经是 OpenCode 的使用高手了。 -要让它更符合你的习惯，我们推荐[选择一个主题](/docs/themes)、[自定义快捷键](/docs/keybinds)、[配置代码格式化工具](/docs/formatters)、[创建自定义命令](/docs/commands)，或者探索 [OpenCode 配置](/docs/config)。 +要让它更符合你的习惯，我们推荐[选择一个主题](/docs/zh-cn/themes)、[自定义快捷键](/docs/zh-cn/keybinds)、[配置代码格式化工具](/docs/zh-cn/formatters)、[创建自定义命令](/docs/zh-cn/commands)，或者探索 [OpenCode 配置](/docs/zh-cn/config)。 diff --git a/packages/web/src/content/docs/zh-cn/mcp-servers.mdx b/packages/web/src/content/docs/zh-cn/mcp-servers.mdx index cac8778d485b..df1a8ce2e879 100644 --- a/packages/web/src/content/docs/zh-cn/mcp-servers.mdx +++ b/packages/web/src/content/docs/zh-cn/mcp-servers.mdx @@ -63,7 +63,7 @@ MCP 服务器会占用你的上下文空间，所以请谨慎选择启用哪些 } ``` -本地配置值会覆盖远程默认值。详情请参阅[配置优先级](/docs/config#precedence-order)。 +本地配置值会覆盖远程默认值。详情请参阅[配置优先级](/docs/zh-cn/config#precedence-order)。 --- @@ -348,7 +348,7 @@ opencode mcp debug my-oauth-server 如果你有大量 MCP 服务器，可以选择全局禁用它们，然后仅在特定代理中启用。具体做法： 1. 全局禁用该工具。 -2. 在[代理配置](/docs/agents#tools)中，将 MCP 服务器作为工具启用。 +2. 在[代理配置](/docs/zh-cn/agents#tools)中，将 MCP 服务器作为工具启用。 ```json title="opencode.json" {11, 14-18} { @@ -474,7 +474,7 @@ Show me the latest unresolved issues in my project. use sentry Configure a Cloudflare Worker script to cache JSON API responses for five minutes. use context7 ``` -你也可以在 [AGENTS.md](/docs/rules/) 中添加类似的规则。 +你也可以在 [AGENTS.md](/docs/zh-cn/rules/) 中添加类似的规则。 ```md title="AGENTS.md" When you need to search docs, use `context7` tools. @@ -504,7 +504,7 @@ When you need to search docs, use `context7` tools. What's the right way to set a custom domain in an SST Astro component? use the gh_grep tool ``` -你也可以在 [AGENTS.md](/docs/rules/) 中添加类似的规则。 +你也可以在 [AGENTS.md](/docs/zh-cn/rules/) 中添加类似的规则。 ```md title="AGENTS.md" If you are unsure how to do something, use `gh_grep` to search code examples from GitHub. diff --git a/packages/web/src/content/docs/zh-cn/models.mdx b/packages/web/src/content/docs/zh-cn/models.mdx index 5399a59abd62..fe7b84f8a8d2 100644 --- a/packages/web/src/content/docs/zh-cn/models.mdx +++ b/packages/web/src/content/docs/zh-cn/models.mdx @@ -11,7 +11,7 @@ OpenCode 使用 [AI SDK](https://ai-sdk.dev/) 和 [Models.dev](https://models.de 大多数热门提供商已默认预加载。如果你通过 `/connect` 命令添加了提供商的凭据，它们将在你启动 OpenCode 时自动可用。 -了解更多关于[提供商](/docs/providers)的信息。 +了解更多关于[提供商](/docs/zh-cn/providers)的信息。 --- @@ -57,9 +57,9 @@ OpenCode 使用 [AI SDK](https://ai-sdk.dev/) 和 [Models.dev](https://models.de } ``` -这里完整的 ID 格式为 `provider_id/model_id`。例如，如果你使用 [OpenCode Zen](/docs/zen)，则 GPT 5.1 Codex 对应的值为 `opencode/gpt-5.1-codex`。 +这里完整的 ID 格式为 `provider_id/model_id`。例如，如果你使用 [OpenCode Zen](/docs/zh-cn/zen)，则 GPT 5.1 Codex 对应的值为 `opencode/gpt-5.1-codex`。 -如果你配置了[自定义提供商](/docs/providers#custom)，`provider_id` 是配置中 `provider` 部分的键名，`model_id` 是 `provider.models` 中的键名。 +如果你配置了[自定义提供商](/docs/zh-cn/providers#custom)，`provider_id` 是配置中 `provider` 部分的键名，`model_id` 是 `provider.models` 中的键名。 --- @@ -102,7 +102,7 @@ OpenCode 使用 [AI SDK](https://ai-sdk.dev/) 和 [Models.dev](https://models.de 这里我们为两个内置模型配置了全局设置：通过 `openai` 提供商访问的 `gpt-5`，以及通过 `anthropic` 提供商访问的 `claude-sonnet-4-20250514`。 内置的提供商和模型名称可以在 [Models.dev](https://models.dev) 上查阅。 -你还可以为使用中的任何代理配置这些选项。代理配置会覆盖此处的全局选项。[了解更多](/docs/agents/#additional)。 +你还可以为使用中的任何代理配置这些选项。代理配置会覆盖此处的全局选项。[了解更多](/docs/zh-cn/agents/#additional)。 你也可以定义扩展内置变体的自定义变体。变体允许你为同一个模型配置不同的设置，而无需创建重复的条目： @@ -196,7 +196,7 @@ OpenCode 为许多提供商提供了默认变体： ### 切换变体 -使用快捷键 `variant_cycle` 可以快速在变体之间切换。[了解更多](/docs/keybinds)。 +使用快捷键 `variant_cycle` 可以快速在变体之间切换。[了解更多](/docs/zh-cn/keybinds)。 --- diff --git a/packages/web/src/content/docs/zh-cn/network.mdx b/packages/web/src/content/docs/zh-cn/network.mdx index 8289777a1e10..6ff87f7e5df8 100644 --- a/packages/web/src/content/docs/zh-cn/network.mdx +++ b/packages/web/src/content/docs/zh-cn/network.mdx @@ -26,7 +26,7 @@ export NO_PROXY=localhost,127.0.0.1 TUI 与本地 HTTP 服务器进行通信。你必须为此连接绕过代理，以防止路由循环。 ::: -你可以使用 [CLI 标志](/docs/cli#run)来配置服务器的端口和主机名。 +你可以使用 [CLI 标志](/docs/zh-cn/cli#run)来配置服务器的端口和主机名。 --- diff --git a/packages/web/src/content/docs/zh-cn/permissions.mdx b/packages/web/src/content/docs/zh-cn/permissions.mdx index 7f905ac22e97..ec1c294f311b 100644 --- a/packages/web/src/content/docs/zh-cn/permissions.mdx +++ b/packages/web/src/content/docs/zh-cn/permissions.mdx @@ -181,7 +181,7 @@ OpenCode 的权限以工具名称为键，外加几个安全防护项： ## 代理 -你可以为每个代理单独覆盖权限。代理权限会与全局配置合并，且代理规则优先。[了解更多](/docs/agents#permissions)关于代理权限的内容。 +你可以为每个代理单独覆盖权限。代理权限会与全局配置合并，且代理规则优先。[了解更多](/docs/zh-cn/agents#permissions)关于代理权限的内容。 :::note 有关更详细的模式匹配示例，请参阅上方的[细粒度规则（对象语法）](#细粒度规则对象语法)部分。 diff --git a/packages/web/src/content/docs/zh-cn/plugins.mdx b/packages/web/src/content/docs/zh-cn/plugins.mdx index e8a8bd70cbc3..13d13422a36a 100644 --- a/packages/web/src/content/docs/zh-cn/plugins.mdx +++ b/packages/web/src/content/docs/zh-cn/plugins.mdx @@ -5,7 +5,7 @@ description: 编写自己的插件来扩展 OpenCode。 插件允许你通过挂钩各种事件和自定义行为来扩展 OpenCode。你可以创建插件来添加新功能、集成外部服务，或修改 OpenCode 的默认行为。 -如需了解示例，请查看社区创建的[插件](/docs/ecosystem#plugins)。 +如需了解示例，请查看社区创建的[插件](/docs/zh-cn/ecosystem#plugins)。 --- @@ -39,7 +39,7 @@ description: 编写自己的插件来扩展 OpenCode。 支持常规和带作用域的 npm 包。 -浏览[生态系统](/docs/ecosystem#plugins)中的可用插件。 +浏览[生态系统](/docs/zh-cn/ecosystem#plugins)中的可用插件。 --- @@ -47,7 +47,7 @@ description: 编写自己的插件来扩展 OpenCode。 **npm 插件**在启动时使用 Bun 自动安装。包及其依赖项会缓存在 `~/.cache/opencode/node_modules/` 中。 -**本地插件**直接从插件目录加载。如果需要使用外部包，你必须在配置目录中创建 `package.json`（参见[依赖项](#dependencies)），或者将插件发布到 npm 并[将其添加到配置中](/docs/config#plugins)。 +**本地插件**直接从插件目录加载。如果需要使用外部包，你必须在配置目录中创建 `package.json`（参见[依赖项](#dependencies)），或者将插件发布到 npm 并[将其添加到配置中](/docs/zh-cn/config#plugins)。 --- diff --git a/packages/web/src/content/docs/zh-cn/policies.mdx b/packages/web/src/content/docs/zh-cn/policies.mdx new file mode 100644 index 000000000000..e39098493842 --- /dev/null +++ b/packages/web/src/content/docs/zh-cn/policies.mdx @@ -0,0 +1,137 @@ +--- +title: 策略 +description: 控制 OpenCode 可以使用哪些已配置的资源。 +--- + +策略控制 OpenCode 是否可以对指定资源执行操作。此功能为实验性功能，通过 `opencode.json` 中的 `experimental.policies` 数组进行配置。 + +策略与[权限](/docs/zh-cn/permissions)是不同的概念。权限控制工具在会话期间可以做什么，而策略控制 OpenCode 是否可以使用某个资源（例如 LLM 提供商）。 + +--- + +## 配置 + +每条策略声明包含三个字段： + +- `effect` — 取值为 `"allow"` 或 `"deny"`。 +- `action` — 被控制的操作。 +- `resource` — 该策略适用的资源 ID 或通配符模式。 + +例如，禁止使用 `openai` 提供商： + +```json title="opencode.json" +{ + "$schema": "https://opencode.ai/config.json", + "experimental": { + "policies": [ + { + "effect": "deny", + "action": "provider.use", + "resource": "openai" + } + ] + } +} +``` + +被策略禁止的提供商将无法用于模型选择或调用，即便其凭据和配置均已正确设置。 + +--- + +## 可用策略 + +OpenCode 目前支持一种策略操作： + +| 操作 | 资源 | 描述 | +| -------------- | ----------------------------- | ---------------------------------- | +| `provider.use` | 提供商 ID，例如 `openai` | 允许或禁止使用某个 LLM 提供商。 | + +未来可能会添加更多策略操作。 + +--- + +## 匹配 + +`resource` 字段支持通配符匹配。使用 `*` 匹配零个或多个字符，使用 `?` 匹配一个字符。 + +```json title="opencode.json" +{ + "$schema": "https://opencode.ai/config.json", + "experimental": { + "policies": [ + { + "effect": "deny", + "action": "provider.use", + "resource": "company-*" + } + ] + } +} +``` + +这将禁止 `company-us` 和 `company-eu` 等提供商。 + +--- + +## 规则顺序 + +当多条规则同时匹配时，最后一条匹配的规则生效。建议先放置较为宽泛的规则，再紧跟更具体的例外规则。 + +例如，仅允许 Anthropic： + +```json title="opencode.json" +{ + "$schema": "https://opencode.ai/config.json", + "experimental": { + "policies": [ + { + "effect": "deny", + "action": "provider.use", + "resource": "*" + }, + { + "effect": "allow", + "action": "provider.use", + "resource": "anthropic" + } + ] + } +} +``` + +如果没有策略匹配某个提供商，则默认允许使用该提供商。 + +策略可以在全局配置和项目配置中同时设置。如果两个位置的策略都匹配同一个提供商，则全局策略优先于项目策略。这可以防止某个项目仓库重新启用你已在全局禁用的提供商。 + +--- + +## 提供商列表 + +控制提供商访问权限时，推荐使用策略来替代旧的 `disabled_providers` 和 `enabled_providers` 配置。 + +替代 `disabled_providers` 的写法： + +```json title="opencode.json" +{ + "experimental": { + "policies": [ + { "effect": "deny", "action": "provider.use", "resource": "openai" }, + { "effect": "deny", "action": "provider.use", "resource": "google" } + ] + } +} +``` + +替代 `enabled_providers` 的写法：先禁止所有提供商，然后在其后允许选定的提供商： + +```json title="opencode.json" +{ + "experimental": { + "policies": [ + { "effect": "deny", "action": "provider.use", "resource": "*" }, + { "effect": "allow", "action": "provider.use", "resource": "anthropic" }, + { "effect": "allow", "action": "provider.use", "resource": "openai" } + ] + } +} +``` diff --git a/packages/web/src/content/docs/zh-cn/providers.mdx b/packages/web/src/content/docs/zh-cn/providers.mdx index 9c0a5d8a3bd5..001c2ef16708 100644 --- a/packages/web/src/content/docs/zh-cn/providers.mdx +++ b/packages/web/src/content/docs/zh-cn/providers.mdx @@ -49,7 +49,7 @@ OpenCode 使用 [AI SDK](https://ai-sdk.dev/) 和 [Models.dev](https://models.de ## OpenCode Zen -OpenCode Zen 是由 OpenCode 团队提供的模型列表，这些模型已经过测试和验证，能够与 OpenCode 良好配合使用。[了解更多](/docs/zen)。 +OpenCode Zen 是由 OpenCode 团队提供的模型列表，这些模型已经过测试和验证，能够与 OpenCode 良好配合使用。[了解更多](/docs/zh-cn/zen)。 :::tip 如果你是新用户，我们建议从 OpenCode Zen 开始。 @@ -1362,7 +1362,7 @@ Ollama 可以自动为 OpenCode 进行配置。详见 [Ollama 集成文档](http ### OpenCode Zen -OpenCode Zen 是由 OpenCode 团队提供的经过测试和验证的模型列表。[了解更多](/docs/zen)。 +OpenCode Zen 是由 OpenCode 团队提供的经过测试和验证的模型列表。[了解更多](/docs/zh-cn/zen)。 1. 登录 **OpenCode Zen** 并点击 **Create API Key**。 @@ -1926,7 +1926,7 @@ Vercel AI Gateway 允许你通过统一端点访问来自 OpenAI、Anthropic、G 配置详情： -- **apiKey**：使用 `env` 变量语法设置，[了解更多](/docs/config#env-vars)。 +- **apiKey**：使用 `env` 变量语法设置，[了解更多](/docs/zh-cn/config#env-vars)。 - **headers**：随每个请求发送的自定义请求头。 - **limit.context**：模型接受的最大输入 Token 数。 - **limit.output**：模型可生成的最大 Token 数。 diff --git a/packages/web/src/content/docs/zh-cn/rules.mdx b/packages/web/src/content/docs/zh-cn/rules.mdx index 9ce5c53de8bf..1775d2887f7d 100644 --- a/packages/web/src/content/docs/zh-cn/rules.mdx +++ b/packages/web/src/content/docs/zh-cn/rules.mdx @@ -72,7 +72,7 @@ opencode 还支持从多个位置读取 `AGENTS.md` 文件，不同的位置有 - **项目规则**：项目目录中的 `CLAUDE.md`（在没有 `AGENTS.md` 的情况下使用） - **全局规则**：`~/.claude/CLAUDE.md`（在没有 `~/.config/opencode/AGENTS.md` 的情况下使用） -- **技能**：`~/.claude/skills/` — 详情请参阅[代理技能](/docs/skills/) +- **技能**：`~/.claude/skills/` — 详情请参阅[代理技能](/docs/zh-cn/skills/) 要禁用 Claude Code 兼容性，请设置以下环境变量之一： diff --git a/packages/web/src/content/docs/zh-cn/sdk.mdx b/packages/web/src/content/docs/zh-cn/sdk.mdx index 121e423d10d9..3c1e3743e609 100644 --- a/packages/web/src/content/docs/zh-cn/sdk.mdx +++ b/packages/web/src/content/docs/zh-cn/sdk.mdx @@ -9,7 +9,7 @@ export const typesUrl = `${config.github}/blob/dev/packages/sdk/js/src/gen/types opencode JS/TS SDK 提供了一个类型安全的客户端，用于与服务器进行交互。 你可以用它来构建集成方案，并以编程方式控制 opencode。 -[了解更多](/docs/server)关于服务器的工作原理。如需示例，请查看社区构建的[项目](/docs/ecosystem#projects)。 +[了解更多](/docs/zh-cn/server)关于服务器的工作原理。如需示例，请查看社区构建的[项目](/docs/zh-cn/ecosystem#projects)。 --- diff --git a/packages/web/src/content/docs/zh-cn/server.mdx b/packages/web/src/content/docs/zh-cn/server.mdx index d28342ecc69a..52bf4a992b4b 100644 --- a/packages/web/src/content/docs/zh-cn/server.mdx +++ b/packages/web/src/content/docs/zh-cn/server.mdx @@ -46,7 +46,7 @@ OPENCODE_SERVER_PASSWORD=your-password opencode serve ### 工作原理 -当你运行 `opencode` 时，它会启动一个 TUI 和一个服务器。TUI 是与服务器通信的客户端。服务器暴露一个 OpenAPI 3.1 规范端点。该端点也用于生成 [SDK](/docs/sdk)。 +当你运行 `opencode` 时，它会启动一个 TUI 和一个服务器。TUI 是与服务器通信的客户端。服务器暴露一个 OpenAPI 3.1 规范端点。该端点也用于生成 [SDK](/docs/zh-cn/sdk)。 :::tip 使用 opencode 服务器以编程方式与 opencode 交互。 @@ -60,9 +60,9 @@ OPENCODE_SERVER_PASSWORD=your-password opencode serve #### 连接到现有服务器 -当你启动 TUI 时，它会随机分配端口和主机名。你也可以传入 `--hostname` 和 `--port` [标志](/docs/cli)，然后用它来连接对应的服务器。 +当你启动 TUI 时，它会随机分配端口和主机名。你也可以传入 `--hostname` 和 `--port` [标志](/docs/zh-cn/cli)，然后用它来连接对应的服务器。 -[`/tui`](#tui) 端点可用于通过服务器驱动 TUI。例如，你可以预填充或运行一个提示词。此方式被 OpenCode [IDE](/docs/ide) 插件所使用。 +[`/tui`](#tui) 端点可用于通过服务器驱动 TUI。例如，你可以预填充或运行一个提示词。此方式被 OpenCode [IDE](/docs/zh-cn/ide) 插件所使用。 --- diff --git a/packages/web/src/content/docs/zh-cn/share.mdx b/packages/web/src/content/docs/zh-cn/share.mdx index a2b34688e4dc..5415b42db617 100644 --- a/packages/web/src/content/docs/zh-cn/share.mdx +++ b/packages/web/src/content/docs/zh-cn/share.mdx @@ -37,7 +37,7 @@ OpenCode 支持三种分享模式，用于控制对话的共享方式： 这将生成一个唯一的 URL 并复制到您的剪贴板。 -要在[配置文件](/docs/config)中显式设置手动模式： +要在[配置文件](/docs/zh-cn/config)中显式设置手动模式： ```json title="opencode.json" { @@ -50,7 +50,7 @@ OpenCode 支持三种分享模式，用于控制对话的共享方式： ### 自动分享 -您可以在[配置文件](/docs/config)中将 `share` 选项设置为 `"auto"`，为所有新对话启用自动分享： +您可以在[配置文件](/docs/zh-cn/config)中将 `share` 选项设置为 `"auto"`，为所有新对话启用自动分享： ```json title="opencode.json" { @@ -65,7 +65,7 @@ OpenCode 支持三种分享模式，用于控制对话的共享方式： ### 禁用 -您可以在[配置文件](/docs/config)中将 `share` 选项设置为 `"disabled"`，完全禁用分享功能： +您可以在[配置文件](/docs/zh-cn/config)中将 `share` 选项设置为 `"disabled"`，完全禁用分享功能： ```json title="opencode.json" { @@ -124,4 +124,4 @@ OpenCode 支持三种分享模式，用于控制对话的共享方式： - **限制**为仅通过 SSO 身份验证的用户可用 - **自托管**在您自己的基础设施上 -[了解更多](/docs/enterprise)关于在您的组织中使用 OpenCode 的信息。 +[了解更多](/docs/zh-cn/enterprise)关于在您的组织中使用 OpenCode 的信息。 diff --git a/packages/web/src/content/docs/zh-cn/tools.mdx b/packages/web/src/content/docs/zh-cn/tools.mdx index 1a58eece5d37..0348c9990f1a 100644 --- a/packages/web/src/content/docs/zh-cn/tools.mdx +++ b/packages/web/src/content/docs/zh-cn/tools.mdx @@ -3,9 +3,9 @@ title: 工具 description: 管理 LLM 可以使用的工具。 --- -工具允许 LLM 在您的代码库中执行操作。OpenCode 自带一组内置工具，您也可以通过[自定义工具](/docs/custom-tools)或 [MCP 服务器](/docs/mcp-servers)来扩展它。 +工具允许 LLM 在您的代码库中执行操作。OpenCode 自带一组内置工具，您也可以通过[自定义工具](/docs/zh-cn/custom-tools)或 [MCP 服务器](/docs/zh-cn/mcp-servers)来扩展它。 -默认情况下，所有工具都是**启用**的，且无需权限即可运行。您可以通过[权限](/docs/permissions)来控制工具的行为。 +默认情况下，所有工具都是**启用**的，且无需权限即可运行。您可以通过[权限](/docs/zh-cn/permissions)来控制工具的行为。 --- @@ -35,7 +35,7 @@ description: 管理 LLM 可以使用的工具。 } ``` -[了解更多](/docs/permissions)关于配置权限的内容。 +[了解更多](/docs/zh-cn/permissions)关于配置权限的内容。 --- @@ -170,7 +170,7 @@ description: 管理 LLM 可以使用的工具。 支持的操作包括 `goToDefinition`、`findReferences`、`hover`、`documentSymbol`、`workspaceSymbol`、`goToImplementation`、`prepareCallHierarchy`、`incomingCalls` 和 `outgoingCalls`。 -要配置项目可用的 LSP 服务器，请参阅 [LSP 服务器](/docs/lsp)。 +要配置项目可用的 LSP 服务器，请参阅 [LSP 服务器](/docs/zh-cn/lsp)。 --- @@ -197,7 +197,7 @@ description: 管理 LLM 可以使用的工具。 ### skill -加载一个[技能](/docs/skills)（即 `SKILL.md` 文件）并在对话中返回其内容。 +加载一个[技能](/docs/zh-cn/skills)（即 `SKILL.md` 文件）并在对话中返回其内容。 ```json title="opencode.json" {4} { @@ -226,7 +226,7 @@ description: 管理 LLM 可以使用的工具。 创建和更新任务列表以跟踪复杂操作的进度。LLM 使用此工具来组织多步骤任务。 :::note -该工具默认对子代理禁用，但您可以手动启用。[了解更多](/docs/agents/#permissions) +该工具默认对子代理禁用，但您可以手动启用。[了解更多](/docs/zh-cn/agents/#permissions) ::: --- @@ -310,7 +310,7 @@ OPENCODE_ENABLE_EXA=1 opencode 自定义工具允许您定义 LLM 可以调用的自定义函数。这些函数在您的配置文件中定义，可以执行任意代码。 -[了解更多](/docs/custom-tools)关于创建自定义工具的内容。 +[了解更多](/docs/zh-cn/custom-tools)关于创建自定义工具的内容。 --- @@ -318,7 +318,7 @@ OPENCODE_ENABLE_EXA=1 opencode MCP（Model Context Protocol）服务器允许您集成外部工具和服务，包括数据库访问、API 集成和第三方服务。 -[了解更多](/docs/mcp-servers)关于配置 MCP 服务器的内容。 +[了解更多](/docs/zh-cn/mcp-servers)关于配置 MCP 服务器的内容。 --- diff --git a/packages/web/src/content/docs/zh-cn/troubleshooting.mdx b/packages/web/src/content/docs/zh-cn/troubleshooting.mdx index 3f22cbf89576..a8aa919a76e5 100644 --- a/packages/web/src/content/docs/zh-cn/troubleshooting.mdx +++ b/packages/web/src/content/docs/zh-cn/troubleshooting.mdx @@ -138,7 +138,7 @@ OpenCode Desktop 可以启动自己的本地服务器（默认行为），也可 ### Windows: 常见性能问题 -如果你在 Windows 上遇到性能缓慢、文件访问问题或终端问题，请尝试使用 [WSL (Windows Subsystem for Linux)](/docs/windows-wsl)。WSL 提供了一个 Linux 环境，能更好地与 OpenCode 的功能兼容。 +如果你在 Windows 上遇到性能缓慢、文件访问问题或终端问题，请尝试使用 [WSL (Windows Subsystem for Linux)](/docs/zh-cn/windows-wsl)。WSL 提供了一个 Linux 环境，能更好地与 OpenCode 的功能兼容。 --- @@ -236,7 +236,7 @@ OpenCode Desktop 仅在以下情况下显示系统通知： 要解决此问题： -1. 首先，按照[提供商指南](/docs/providers)验证你的提供商是否已正确设置 +1. 首先，按照[提供商指南](/docs/zh-cn/providers)验证你的提供商是否已正确设置 2. 如果问题仍然存在，请尝试清除已存储的配置： ```bash diff --git a/packages/web/src/content/docs/zh-cn/tui.mdx b/packages/web/src/content/docs/zh-cn/tui.mdx index 8b0a4085b004..a2df06790ad6 100644 --- a/packages/web/src/content/docs/zh-cn/tui.mdx +++ b/packages/web/src/content/docs/zh-cn/tui.mdx @@ -63,7 +63,7 @@ How is auth handled in @packages/functions/src/api/index.ts? /help ``` -大多数命令还支持以 `ctrl+x` 作为前导键的快捷键，其中 `ctrl+x` 是默认前导键。[了解更多](/docs/keybinds)。 +大多数命令还支持以 `ctrl+x` 作为前导键的快捷键，其中 `ctrl+x` 是默认前导键。[了解更多](/docs/zh-cn/keybinds)。 以下是所有可用的斜杠命令： @@ -153,7 +153,7 @@ How is auth handled in @packages/functions/src/api/index.ts? ### init -创建或更新 `AGENTS.md` 文件。[了解更多](/docs/rules)。 +创建或更新 `AGENTS.md` 文件。[了解更多](/docs/zh-cn/rules)。 ```bash frame="none" /init @@ -219,7 +219,7 @@ How is auth handled in @packages/functions/src/api/index.ts? ### share -分享当前会话。[了解更多](/docs/share)。 +分享当前会话。[了解更多](/docs/zh-cn/share)。 ```bash frame="none" /share @@ -275,7 +275,7 @@ How is auth handled in @packages/functions/src/api/index.ts? ### unshare -取消分享当前会话。[了解更多](/docs/share#un-sharing)。 +取消分享当前会话。[了解更多](/docs/zh-cn/share#un-sharing)。 ```bash frame="none" /unshare @@ -388,8 +388,8 @@ How is auth handled in @packages/functions/src/api/index.ts? ### 选项 -- `theme` - 设置 UI 主题。[了解更多](/docs/themes)。 -- `keybinds` - 自定义键盘快捷键。[了解更多](/docs/keybinds)。 +- `theme` - 设置 UI 主题。[了解更多](/docs/zh-cn/themes)。 +- `keybinds` - 自定义键盘快捷键。[了解更多](/docs/zh-cn/keybinds)。 - `leader_timeout` - 控制按下 leader key 后 OpenCode 等待后续按键的时间。默认为 `2000`。 - `scroll_acceleration.enabled` - 启用 macOS 风格的滚动加速，让滚动更平滑自然。启用后，快速滚动时速度会增加，慢速移动时仍保持精确。**此设置优先于 `scroll_speed`，启用时会覆盖它。** - `scroll_speed` - 控制使用滚动命令时 TUI 的滚动速度（最小值：`0.001`，支持小数）。默认为 `3`。**注意：如果 `scroll_acceleration.enabled` 设置为 `true`，则此设置会被忽略。** diff --git a/packages/web/src/content/docs/zh-cn/web.mdx b/packages/web/src/content/docs/zh-cn/web.mdx index 5b5a31653f28..c01415870ab7 100644 --- a/packages/web/src/content/docs/zh-cn/web.mdx +++ b/packages/web/src/content/docs/zh-cn/web.mdx @@ -22,14 +22,14 @@ opencode web ::: :::tip[Windows 用户] -为获得最佳体验，建议从 [WSL](/docs/windows-wsl) 而非 PowerShell 运行 `opencode web`。这可以确保正确的文件系统访问和终端集成。 +为获得最佳体验，建议从 [WSL](/docs/zh-cn/windows-wsl) 而非 PowerShell 运行 `opencode web`。这可以确保正确的文件系统访问和终端集成。 ::: --- ## 配置 -你可以通过命令行标志或[配置文件](/docs/config)来配置 Web 服务器。 +你可以通过命令行标志或[配置文件](/docs/zh-cn/config)来配置 Web 服务器。 ### 端口 diff --git a/packages/web/src/content/docs/zh-cn/windows-wsl.mdx b/packages/web/src/content/docs/zh-cn/windows-wsl.mdx index 853011acee23..23b26ededc9f 100644 --- a/packages/web/src/content/docs/zh-cn/windows-wsl.mdx +++ b/packages/web/src/content/docs/zh-cn/windows-wsl.mdx @@ -23,7 +23,7 @@ WSL 提供更出色的文件系统性能、完整的终端支持，以及与 Ope 2. **在 WSL 中安装 OpenCode** - WSL 设置完成后，打开 WSL 终端，使用任一[安装方式](/docs/)安装 OpenCode。 + WSL 设置完成后，打开 WSL 终端，使用任一[安装方式](/docs/zh-cn/)安装 OpenCode。 ```bash curl -fsSL https://opencode.ai/install | bash diff --git a/packages/web/src/content/docs/zh-cn/zen.mdx b/packages/web/src/content/docs/zh-cn/zen.mdx index 0e6a2a2b0738..c7e002d71935 100644 --- a/packages/web/src/content/docs/zh-cn/zen.mdx +++ b/packages/web/src/content/docs/zh-cn/zen.mdx @@ -98,7 +98,7 @@ OpenCode Zen 的工作方式与 OpenCode 中的任何其他提供商相同。 | Nemotron 3 Super Free | nemotron-3-super-free | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | | DeepSeek V4 Flash Free | deepseek-v4-flash-free | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` | -在你的 OpenCode 配置中，[模型 ID](/docs/config/#models) 使用 `opencode/` 格式。例如，对于 GPT 5.5，你需要在配置中使用 `opencode/gpt-5.5`。 +在你的 OpenCode 配置中，[模型 ID](/docs/zh-cn/config/#models) 使用 `opencode/` 格式。例如，对于 GPT 5.5，你需要在配置中使用 `opencode/gpt-5.5`。 --- @@ -169,7 +169,7 @@ https://opencode.ai/zen/v1/models | GPT 5 Codex | $1.07 | $8.50 | $0.107 | - | | GPT 5 Nano | $0.05 | $0.40 | $0.005 | - | -你可能会在使用记录中看到 _Claude Haiku 3.5_。这是一个[低成本模型](/docs/config/#models)，用于生成会话标题。 +你可能会在使用记录中看到 _Claude Haiku 3.5_。这是一个[低成本模型](/docs/zh-cn/config/#models)，用于生成会话标题。 :::note 信用卡手续费按成本转嫁（每笔交易 4.4% + $0.30）；除此之外我们不会额外收费。