fix(docs): locale markdown issues

This commit is contained in:
Adam
2026-02-09 13:55:55 -06:00
parent d9b4535d64
commit 274bb948e7
213 changed files with 1776 additions and 1789 deletions

View File

@@ -5,7 +5,7 @@ description: 在任何 ACP 兼容编辑器中使用 OpenCode。
OpenCode 支持[代理客户端协议](https://agentclientprotocol.com) 或 (ACP),允许您直接在兼容的编辑器和 IDE 中使用它。
:::提示
:::tip
有关支持 ACP 的编辑器和工具的列表,请查看[非加太进度进度报告](https://zed.dev/blog/acp-progress-report#available-now)。
:::
@@ -144,7 +144,7 @@ require("codecompanion").setup({
OpenCode 通过 ACP 的工作方式与在终端中的工作方式相同。支持所有功能:
:::笔记
:::note
目前不支持某些内置斜杠命令,例如 `/undo` 和 `/redo`。
:::

View File

@@ -5,7 +5,7 @@ description: 配置和使用專門的代理。
代理是專門的人工智能助手,可以針對特定任務和工作流程進行配置。它們允許您創建具有自定義提示、模型和工具訪問權限的專用工具。
:::提示
:::tip
使用計劃代理來分析代碼並審查建議,而無需進行任何代碼更改。
:::
@@ -23,7 +23,7 @@ OpenCode有两种类型的代理主代理和次代理。
主要代理是与您直接交互的主要助手。您可以使用 **Tab** 键或您配置的 `switch_agent` 键绑定循环浏览它们。这些代理处理您的主要对话。工具访问是通过权限配置的 - 例如,“构建”启用了所有工具,而“计划”则受到限制。
:::提示
:::tip
您可以在会话期间使用 **Tab** 键在主要代理之间进行切换。
:::
@@ -301,7 +301,7 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代
當達到限制時,代理會收到特殊的系統提示,指示其響應其工作摘要和建議的剩餘任務。
:::警告
:::caution
旧版 `maxSteps` 字段已废弃。请改用`steps`。
:::
@@ -345,7 +345,7 @@ Markdown 文件名成为代理名称。例如,`review.md` 创建`review` 代
使用 `model` 配置此代理的模型。对于使用针对不同任务优化的不同模型很有用。例如,更快的规划模型、更强大的实施模型。
:::提示
:::tip
如果您不指定模型,主代理将使用[全局配置的模型](/docs/config#models),而子代理将使用调用子代理的主代理的模型。
:::
@@ -385,7 +385,7 @@ OpenCode配置中的模型ID使用格式`provider/model-id`。例如,如果您
}
```
:::笔记
:::note
特定於代理的配置會覆蓋全局配置。
:::
@@ -557,7 +557,7 @@ Only analyze code and suggest changes.
這僅影響自動完成菜單中的用戶可見性。如果權限允許,模型仍然可以通過任務工具調用隱藏代理。
:::笔记
:::note
仅适用于`mode: subagent`代理。
:::
@@ -586,11 +586,11 @@ Only analyze code and suggest changes.
当设置为`deny`时,子代理社区任务工具描述中因此完全删除,模型不会尝试调用它。
:::提示
:::tip
规则按顺序评估,**最后匹配的规则触发**。在上面的示例中,`orchestrator-planner` 匹配`*`(拒绝)和`orchestrator-*`(允许),但由于`orchestrator-*` 位于`*` 之后,因此结果为`allow`。
:::
:::提示
:::tip
用戶始終可以通過 `@` 自動完成菜單直接調用任何子代理,即使代理的任務權限會拒絕它。
:::
@@ -656,7 +656,7 @@ Only analyze code and suggest changes.
這些附加選項是特定於型號和提供商的。檢查提供商的文檔以獲取可用參數。
:::提示
:::tip
运行 `opencode models` 查看可用模型的列表。
:::
@@ -696,7 +696,7 @@ opencode agent create
以下是一些您可能會覺得有用的示例代理。
:::提示
:::tip
您有想要分享的经纪人吗? [提交 PR](https://github.com/anomalyco/opencode)。
:::

View File

@@ -296,8 +296,8 @@ opencode models anthropic
#### 旗幟
| 旗幟 | 描述 |
| ----------- | ---------------------------------------- | ------------ |
| `--refresh` | 来自 models.dev | 刷新模型存储 |
| ----------- | ---------------------------------------- |
| `--refresh` | models.dev 刷新模型缓存 |
| `--verbose` | 使用更详细的模型输出(包括成本等元数据) |
使用`--refresh`标志来更新服务器的模型列表。当新模型已添加到提供程序并且您希望在OpenCode中查看它们时这非常有用。
@@ -585,12 +585,12 @@ opencode CLI采用以下全局标志。
這些環境變量啟用可能會更改或刪除的實驗性功能。
| 變量 | 類型 | 描述 |
| ----------------------------------------------- | ---- | ----------------------------------- | --- |
| ----------------------------------------------- | ---- | ----------------------------------- |
| `OPENCODE_EXPERIMENTAL` | 布尔 | 实现所有实验性功能 |
| `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | 布尔 | 新增图标发现 |
| `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | 布尔 | 在 TUI 中禁用选择时复制 |
| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | 数量 | bash 命令的默认超时(以毫秒为单位) |
| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | 数量 | LLM 响应的最大输出令牌 | LLM |
| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | 数量 | LLM 响应的最大输出令牌 |
| `OPENCODE_EXPERIMENTAL_FILEWATCHER` | 布尔 | 为整个目录启用文件观察器 |
| `OPENCODE_EXPERIMENTAL_OXFMT` | 布尔 | 启用 oxfmt 清理程序 |
| `OPENCODE_EXPERIMENTAL_LSP_TOOL` | 布尔 | 实现实验性 LSP 工具 |

View File

@@ -316,7 +316,7 @@ Check for performance issues and suggest improvements.
opencode包含`/init`、`/undo`、`/redo`、`/share`、`/help`等内置命令;【了解更多](/docs/tui#commands)。
:::笔记
:::note
自定義命令可以覆蓋內置命令。
:::

View File

@@ -28,7 +28,7 @@ OpenCode 支持 **JSON** 和 **JSONC**(带注释的 JSON格式。
您可以將配置放置在幾個不同的位置,它們有一個
不同的優先順序。
:::笔记
:::note
配置文件**合併在一起**,而不是替換。
:::
@@ -51,7 +51,7 @@ OpenCode 支持 **JSON** 和 **JSONC**(带注释的 JSON格式。
這意味著項目配置可以覆蓋全局默認值,全局配置可以覆蓋遠程組織默認值。
:::笔记
:::note
`.opencode` 和`~/.config/opencode` 目录对子目录使用**复数名称**`agents/`、`commands/`、`modes/`、`plugins/`、`skills/`、`tools/` 和`themes/`。为了坚固兼容,还支持单数名称(例如`agent/`)。
:::
@@ -105,7 +105,7 @@ OpenCode 支持 **JSON** 和 **JSONC**(带注释的 JSON格式。
在项目根目录中添加`opencode.json`。项目配置在标准配置文件中具有最高优先级 - 它覆盖全局配置和远程配置。
:::提示
:::tip
將項目特定配置放在項目的根目錄中。
:::
@@ -291,7 +291,7 @@ Amazon Bedrock 支持 AWS 特定配置:
- `profile` - 来自 `~/.aws/credentials` 的 AWS 命名配置文件(默认为 `AWS_PROFILE` env var
- `endpoint` - VPC 终端节点的自定义节点 URL。这是使用 AWS 特定术语的通用 `baseURL` 选项的别名。如果两者都指定,`endpoint` 优先。
:::笔记
:::note
承载令牌(`AWS_BEARER_TOKEN_BEDROCK` 或`/connect`)优先于基于配置文件的身份验证。详情请参见【认证优先级](/docs/providers#authentication-precedence)。
:::
@@ -576,7 +576,7 @@ Error 500 (Server Error)!!1500.Thats an error.There was an error. Please try
}
```
:::笔记
:::note
`disabled_providers` 优先于`enabled_providers`。
:::
@@ -601,7 +601,7 @@ Error 500 (Server Error)!!1500.Thats an error.There was an error. Please try
当您想要限制 OpenCode 仅使用特定的提供程序而不是一一禁止它们时,这非常有用。
:::笔记
:::note
`disabled_providers` 优先于`enabled_providers`。
:::
@@ -620,7 +620,7 @@ Error 500 (Server Error)!!1500.Thats an error.There was an error. Please try
}
```
:::警告
:::caution
實驗選項不穩定。它們可能會更改或被刪除,恕不另行通知。
:::

View File

@@ -5,7 +5,7 @@ description: 使用 OpenCode 构建的项目和集成。
基于 OpenCode 的社区项目集合。
:::笔记
:::note
想要将您的 OpenCode 相关项目添加到此列表中吗?提交 PR。
:::
@@ -16,8 +16,8 @@ description: 使用 OpenCode 构建的项目和集成。
## 插件
| 名稱 | 描述 |
| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | --------------------------------- |
| [Opencode-Daytona](https://github.com/jamesmurdza/daytona/blob/main/guides/typescript/opencode/README.md) | 在隔离的 Daytona 沙箱中自动运行 OpenCode 会话 | 使用 git 同步和实时预览 |
| --------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| [Opencode-Daytona](https://github.com/jamesmurdza/daytona/blob/main/guides/typescript/opencode/README.md) | 在隔离的 Daytona 沙箱中自动运行 OpenCode 会话,并使用 git 同步和实时预览 |
| [opencode-helicone-会话](https://github.com/H2Shami/opencode-helicone-session) | 自动注入 Helicone 会话标头以进行请求包 |
| [打开代码类型注入](https://github.com/nick-vi/opencode-type-inject) | 使用查找工具将 TypeScript/Svelte 类型自动注入到文件读取中 |
| [opencode-openai-codex-auth](https://github.com/numman-ali/opencode-openai-codex-auth) | 使用您的 ChatGPT Plus/Pro 订阅而不是 API 积分 |
@@ -33,7 +33,7 @@ description: 使用 OpenCode 构建的项目和集成。
| [opencode-md-表清理程序](https://github.com/franlol/opencode-md-table-formatter/tree/main) | 清理法学大师生成的降价表 |
| [开放代码变形快速应用](https://github.com/JRedeker/opencode-morph-fast-apply) | 使用Morph Fast Apply API和取消编辑标记将代码编辑速度提高10倍 |
| [哦我的开放代码](https://github.com/code-yeongyu/oh-my-opencode) | 后台代理、预构建的LSP/AST/MCP工具、精选代理、兼容Claude代码 |
| [开放代码通知器](https://github.com/panta82/opencode-notificator) | OpenCode 会话的桌面通知和声音警报 | OpenCode 会话的桌面通知和声音警报 |
| [开放代码通知器](https://github.com/panta82/opencode-notificator) | OpenCode 会话的桌面通知和声音警报 |
| [开放代码通知程序](https://github.com/mohak34/opencode-notifier) | 针对权限、完成和错误事件的桌面通知和声音警报 |
| [opencode-zellij-namer](https://github.com/24601/opencode-zellij-namer) | 基于 OpenCode 上下文的 AI 支持的自动 Zellij 会话命名 |
| [开放代码技巧](https://github.com/zenobi-us/opencode-skillful) | 允许OpenCode代理通过技能发现和注入失败延迟加载提示 |

View File

@@ -8,7 +8,7 @@ export const email = `mailto:${config.email}`
OpenCode Enterprise 适用于希望确保其代码和数据永远不会离开其基础设施的组织。它可以通过使用与 SSO 和内部 AI 网关集成的集中方式配置来实现此目的。
:::笔记
:::note
OpenCode 不存储您的任何代码或上下文数据。
:::
@@ -154,7 +154,7 @@ npm login --registry=https://your-company.jfrog.io/api/npm/npm-virtual/
这将创建带有身份验证详细信息的 `~/.npmrc`。 OpenCode 会自动
拿起這個。
:::警告
:::caution
在运行 OpenCode 之前,您必须登录灌木丛。
:::

View File

@@ -12,10 +12,10 @@ description: OpenCode 使用特定于语言的清理程序。
OpenCode附带了多个适用于流行语言和框架的内置初始化程序。下面是格式化程序、支持的文件扩展名以及所需的命令或配置选项的列表。
| 格式化程序 | 擴展 | 要求 |
| ------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | ----------------------- |
| ------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| 政府 | .go | `gofmt` 命令可用 |
| 混合 | .ex、.exs、.eex、.heex、.leex、.neex、.sface | `mix` 命令可用 |
| 更漂亮 | .js、.jsx、.ts、.tsx、.html、.css、.md、.json、.yaml 和 [更多的](https://prettier.io/docs/en/index.html) | `package.json` | `prettier` 依赖关系 |
| 更漂亮 | .js、.jsx、.ts、.tsx、.html、.css、.md、.json、.yaml 和 [更多的](https://prettier.io/docs/en/index.html) | `package.json` 中有 `prettier` 依赖 |
| 生物群系 | .js、.jsx、.ts、.tsx、.html、.css、.md、.json、.yaml 和 [更多的](https://biomejs.dev/) | `biome.json(c)` 配置文件 |
| 之字形 | .zig、.zon | `zig` 命令可用 |
| clang 格式 | .c、.cpp、.h、.hpp、.ino 和 [更多的](https://clang.llvm.org/docs/ClangFormat.html) | `.clang-format` 配置文件 |
@@ -34,8 +34,8 @@ OpenCode附带了多个适用于流行语言和框架的内置初始化程序。
| 微光 | .gleam | `gleam` 命令可用 |
| 尼克斯夫MTT | .nix | `nixfmt` 命令可用 |
| sfmt | .sh、.bash | `shfmt` 命令可用 |
| 品脱 | .php | `composer.json` | `laravel/pint` 依赖关系 |
| oxfmt实验 | .js、.jsx、.ts、.tsx | `package.json` [实验环境指标](/docs/cli/#experimental) | `oxfmt` 依赖关系 |
| 品脱 | .php | `composer.json` 中有 `laravel/pint` 依赖 |
| oxfmt实验 | .js、.jsx、.ts、.tsx | `package.json` 中有 `oxfmt` 依赖并启用[实验环境变量标记](/docs/cli/#experimental) |
| 奥尔莫鲁 | .hs | `ormolu` 命令可用 |
因此,如果您的项目的`package.json`或`prettier`OpenCode将自动使用它。

View File

@@ -64,7 +64,7 @@ OpenCode 与您的 GitLab 工作流程集成。
OpenCode 在您的 GitLab CI/CD 管道中运行,您需要进行以下设置:
:::提示
:::tip
查看[**GitLab 文档**](https://docs.gitlab.com/user/duo_agent_platform/agent_assistant/) 获取最新说明。
:::
@@ -160,7 +160,7 @@ OpenCode 在您的 GitLab CI/CD 管道中运行,您需要进行以下设置:
以下是如何在 GitLab 中使用 OpenCode 的一些示例。
:::提示
:::tip
您可以配置使用 `@opencode` 不同的触发主板。
:::

View File

@@ -182,7 +182,7 @@ opencode
这涉及 OpenCode 分析您的项目并在以下位置创建 `AGENTS.md` 文件
項目根。
:::提示
:::tip
您应该将项目的 `AGENTS.md` 文件提交到 Git。
:::
@@ -205,7 +205,7 @@ opencode
您可以要求 OpenCode 向您解释代码库。
:::提示
:::tip
使用`@`鍵模糊搜索工程中的文件。
:::
@@ -321,7 +321,7 @@ Can you refactor the function in @packages/functions/src/api/index.ts?
您可以从这里调整提示并要求 OpenCode 重试。
:::提示
:::tip
您可以多次运行 `/undo` 以取消消减更改。
:::
@@ -344,7 +344,7 @@ Can you refactor the function in @packages/functions/src/api/index.ts?
這將創建當前對話的鏈接並將其複製到剪貼板。
:::笔记
:::note
默認情況下不共享對話。
:::

View File

@@ -48,7 +48,7 @@ OpenCode附带了多种适用于流行语言的内置LSP服务器
当检测到上述文件扩展名之一并且满足要求时LSP服务器将自动启用。
:::笔记
:::note
您可以通过将`OPENCODE_DISABLE_LSP_DOWNLOAD`环境变量设置为`true`来取消自动LSP服务器下载。
:::
@@ -126,7 +126,7 @@ OpenCode附带了多种适用于流行语言的内置LSP服务器
}
```
:::笔记
:::note
初始化选项因 LSP 服务器而异。检查 LSP 服务器的文档以获得可用选项。
:::

View File

@@ -13,7 +13,7 @@ description: 添加本地和远程MCP工具。
当您使用 MCP 服务器时,它会添加到上下文中。如果您有很多工具,这会很快增加。因此,我们建议您选择使用哪些 MCP 服务器。
:::提示
:::tip
MCP服务器会添加到您的上下文中因此您需要小心启用哪些服务器。
:::
@@ -153,9 +153,9 @@ use the mcp_everything tool to add the number 3 and 4
#### 選項
| 選項 | 類型 | 必填 | 描述 |
| --------- | ------ | ------ | -------------------------------------------------------------- | -------------------- |
| --------- | ------ | ------ | -------------------------------------------------------------- |
| `type` | 字符串 | 是 | MCP 服务器连接类型,必须是`"remote"`。 |
| | `url` | 字符串 | 是 | 远程MCP服务器的URL。 |
| `url` | 字符串 | 是 | 远程 MCP 服务器的 URL。 |
| `enabled` | 布尔 | | 在启动时启用或禁用MCP 服务器。 |
| `headers` | 对象 | | 随请求一起发送的标头。 |
| `oauth` | 对象 | | OAuth 身份验证。请参阅下面的配置[开放认证](#oauth) 部分。 |
@@ -268,7 +268,7 @@ opencode mcp logout my-oauth-server
| 選項 | 類型 | 描述 |
| -------------- | -------- | --------------------------------------------------- |
| `oauth` | 对象\| | OAuth 配置对象,或 `false` 以取消 OAuth 自动检测。 |
| `oauth` | 对象 \| `false` | OAuth 配置对象,或 `false` 以取消 OAuth 自动检测。 |
| `clientId` | 字符串 | OAuth 客户端 ID。如果未提供将尝试动态客户端注册。 |
| `clientSecret` | 字符串 | OAuth客户端密钥如果需要授权服务器。 |
| `scope` | 字符串 | 授权期间请求的 OAuth 范围。 |
@@ -383,7 +383,7 @@ glob 模式使用简单的正则表达式 globbing 模式:
- `?` 恰好匹配一個字符
- 所有其他字符均按字面意思匹配
:::笔记
:::note
MCP服务器工具以名称服务器作为出口进行注册要因此禁用服务器的所有工具只需使用
```

View File

@@ -29,7 +29,7 @@ OpenCode 使用[人工智能软件开发工具包](https://ai-sdk.dev/) 和[模
那裡有很多型號,每週都會有新型號問世。
:::提示
:::tip
考慮使用我們推薦的模型之一。
:::
@@ -164,7 +164,7 @@ OpenCode 附带了许多重大的默认变体:
- `low` - 降低工作量/代幣預算
- `high` - 更高的努力/代幣預算
:::提示
:::tip
該列表並不全面。許多其他提供商也有內置的默認值。
:::

View File

@@ -3,7 +3,7 @@ title: 模式
description: 不同的模式適用於不同的用例。
---
:::警告
:::caution
现在通过opencode配置中的`agent`选项配置模式。这
`mode` 选项现已废弃。 [了解更多](/docs/agents)。
:::

View File

@@ -22,7 +22,7 @@ export HTTP_PROXY=http://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1
```
:::警告
:::caution
TUI 与本地 HTTP 服务器通信。您必须绕过此连接的代理以防止路由循环。
:::
@@ -38,7 +38,7 @@ TUI 与本地 HTTP 服务器通信。您必须绕过此连接的代理以防止
export HTTPS_PROXY=http://username:password@proxy.example.com:8080
```
:::警告
:::caution
避免對密碼進行硬編碼。使用環境變量或安全憑證存儲。
:::

View File

@@ -185,7 +185,7 @@ OpenCode权限由工具名称和一些安全防护措施决定
您可以覆盖每个代理的权限。代理权限与全局​​配置合并,代理规则优先。 [了解更多](/docs/agents#permissions)关于代理权限。
:::笔记
:::note
有关更详细的模式匹配示例,请参见上面的 [粒度规则(对象语法)](#granular-rules-object-syntax) 部分。
:::
@@ -232,6 +232,6 @@ permission:
Only analyze code and suggest changes.
```
:::提示
:::tip
对参数的命令使用模式匹配。 `"grep *"` 允许 `grep pattern file.txt`,而 `"grep"` 单独会阻止它。像 `git status` 这样的命令适用于默认行为,但在传递参数时需要显式许可(如 `"git status *"`)。
:::

View File

@@ -234,7 +234,7 @@ export const NotificationPlugin = async ({ project, client, $, directory, worktr
我们在 macOS 上使用 `osascript` AppleScript。这里我们用它运行来发送通知。
:::笔记
:::note
如果您使用 OpenCode 桌面应用程序,它可以在响应准备就绪或会话错误时自动发送系统通知。
:::

View File

@@ -53,7 +53,7 @@ in `~/.local/share/opencode/auth.json`.
OpenCode Zen 是OpenCode团队提供的模型列表这些模型已被
经测试和验证可与OpenCode良好配合。 [了解更多](/docs/zen)。
:::提示
:::tip
如果您是新手,我们建议您从 OpenCode Zen 开始。
:::
@@ -89,7 +89,7 @@ OpenCode Zen 是OpenCode团队提供的模型列表这些模型已被
讓我們詳細瞭解一些提供商。如果您想將提供商新增到
列表请随时开启PR。
:::笔记
:::note
在这里没有看到成功?提交 PR。
:::
@@ -229,7 +229,7 @@ OpenCode Zen 是OpenCode团队提供的模型列表这些模型已被
/models
```
:::笔记
:::note
对于自定义推理配置文件,请在按键中使用模型并提供程序名称,并将 `id` 属性设置为 arn。这确保了正确的快取
```json title="opencode.json"
@@ -278,7 +278,7 @@ OpenCode Zen 是OpenCode团队提供的模型列表这些模型已被
/models
```
:::信息
:::info
Using your Claude Pro/Max subscription in OpenCode is not officially supported by [Anthropic](https://anthropic.com).
:::
@@ -292,7 +292,7 @@ Using your Claude Pro/Max subscription in OpenCode is not officially supported b
### 天蓝色 OpenAI
:::笔记
:::note
如果遇到“抱歉,但我无法协助该请求”错误,请尝试将 Azure 资源中的内容筛选器从 **DefaultV2** 更改为 **Default**。
:::
@@ -677,7 +677,7 @@ GitLab Duo 通过 GitLab 的人工代理提供具有本机工具呼叫功能的
- **duo-chat-sonnet-4-5** - 大多数工作流程的平衡失败
- **duo-chat-opus-4-5** - 最有能力进行复杂分析
:::笔记
:::note
如果您不愿意也可以指定“GITLAB_TOKEN”环境变量
将令牌存储在opencode身份验证存储中。
:::
@@ -721,7 +721,7 @@ export GITLAB_AI_GATEWAY_URL=https://ai-gateway.company.com
export GITLAB_TOKEN=glpat-...
```
:::笔记
:::note
您的 GitLab 管理员必须启用以下功能:
1. [Duo Agent Platform](https://docs.gitlab.com/user/gitlab_duo/turn_on_off/) for the user, group, or instance
@@ -788,7 +788,7 @@ Customize through `opencode.json`:
相当于您的 GitHub Copilot 订阅与 opencode 一起使用:
:::笔记
:::note
某些型号可能需要 [Pro+
订阅](https://github.com/features/copilot/plans)使用。
@@ -853,7 +853,7 @@ Google Vertex AI 与 OpenCode 结合使用:
export VERTEX_LOCATION=global
```
:::提示
:::tip
The `global` region improves availability and reduces errors at no extra cost. Use regional endpoints (e.g., `us-central1`) for data residency requirements. [Learn more](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-partner-models#regional_and_global_endpoints)
:::
@@ -1222,7 +1222,7 @@ IO.NET提供了17种针对各种例子进行优化的模型
您可以使用 Ollama 配置 opencode 本地模型。
:::提示
:::tip
Ollama can automatically configure itself for OpenCode. See the [Ollama integration docs](https://docs.ollama.com/integrations/opencode) for details.
:::
@@ -1254,7 +1254,7 @@ Ollama can automatically configure itself for OpenCode. See the [Ollama integrat
- `options.baseURL` 是本地服务器器的端点。
- `models` 是型号 ID 以及配置的对应映射。型号名称将显示在型号选择列表中。
:::提示
:::tip
如果工具暂停,请尝试增加 Ollama 中的 `num_ctx`。从 16k - 32k 左右开始。
:::
@@ -1748,7 +1748,7 @@ Vercel AI Gateway 可以让您跨统一端点访问来自 OpenAI、Anthropic、G
要新增 `/connect` 命令中未列出的任何 **OpenAI 相容**提供程式:
:::提示
:::tip
您可以将任何 OpenAI 相容的提供方案与 opencode 一起使用。大多数人工现代智慧工厂都提供 OpenAI 相容 API。
:::

View File

@@ -11,7 +11,7 @@ description: 設置開放代碼的自定義指令。
要创建新的`AGENTS.md`文件您可以在opencode中运行`/init`命令。
:::提示
:::tip
您应该将项目的 `AGENTS.md` 文件提交到 Git。
:::
@@ -175,6 +175,6 @@ Read the following file immediately as it's relevant to all workflows: @rules/ge
- 保持 AGENTS.md 简洁,同时参考详细指南
- 确保opencode仅在特定任务需要时加载文件
:::提示
:::tip
对于 monorepos 或具有共享标准的项目,使用 `opencode.json` 和 glob 模式(如 `packages/*/AGENTS.md`)比手动指令更易于维护。
:::

View File

@@ -284,8 +284,8 @@ await client.session.prompt({
### 檔案
| 方法 | 描述 | 回應 |
| ------------------------- | -------------------- | ------------------------------------------------------------------ | -------------- |
| `find.text({ query })` | 搜索档案中文字 | `path`、`lines`、`line_number`、`absolute_offset`、`submatches` | 与像团队的匹配 |
| ------------------------- | -------------------- | ------------------------------------------------------------------ |
| `find.text({ query })` | 搜索档案中文字 | 具有 `path`、`lines`、`line_number`、`absolute_offset`、`submatches` 的匹配对象数组 |
| `find.files({ query })` | 按名称查询档案和目录 | `string[]`(路径) |
| `find.symbols({ query })` | 查詢工作區符號 | <a href={typesUrl}><code>符號[]</code></a> |
| `file.read({ query })` | 读取档案 | `{ type: "raw" \| "patch", content: string }` |

View File

@@ -50,7 +50,7 @@ When you run `opencode` it starts a TUI and a server. Where the TUI is the
与服务器器对话的客户端。服务器器公开 OpenAPI 3.1 规范
该端点还用于生成 [SDK](/docs/sdk)。
:::提示
:::tip
使用opencode服务器以程序设计方式与opencode交互。
:::
@@ -275,8 +275,8 @@ opencode服务器公开以下API。
### 活動
| 方法 | 路徑 | 描述 | 回應 |
| ----- | ---------------------------------------------- | ------------------ | -------- | -------------------- |
| `GET` | 第一个事件是`server.connected`后是巴士事件 | 服务器传送的事件流 | `/event` | 服务器传送的事件流。 |
| ----- | -------- | ------------------------------------------------------------------- | -------------------- |
| `GET` | `/event` | 服务器发送事件流。第一个事件是 `server.connected`后是总线事件。 | 服务器发送事件流。 |
---

View File

@@ -5,7 +5,7 @@ description: 分享您的 OpenCode 对话。
OpenCode 的共享功能允许您建立指向 OpenCode 对话的公共链接,以便您可以与蓝牙进行战斗或从其他人那里获得帮助。
:::笔记
:::note
任何知道連結的人都可以公開訪問共享對話。
:::

View File

@@ -94,7 +94,7 @@ This tool allows the LLM to run terminal commands like `npm install`, `git statu
使用它允许 LLM 创建新文件。如果现有文件已经存在,将会覆盖它们。
:::笔记
:::note
`write`工具由`edit`许可权控制,该许可权主题所有文件修改(`edit`、`write`、`patch`、`multiedit`)。
:::
@@ -172,7 +172,7 @@ This tool allows the LLM to run terminal commands like `npm install`, `git statu
与您配置的LSP服务器交互通知计划码智慧功能例如定义、引用、悬停资讯和呼叫层次结构。
:::笔记
:::note
This tool is only available when `OPENCODE_EXPERIMENTAL_LSP_TOOL=true` (or `OPENCODE_EXPERIMENTAL=true`).
:::
@@ -206,7 +206,7 @@ To configure which LSP servers are available for your project, see [LSP Servers]
該工具將補丁檔案應用到您的程式碼庫。對於應用來自各種來源的差異和補丁很有用。
:::笔记
:::note
`patch`工具由`edit`许可权控制,该许可权主题所有文件修改(`edit`、`write`、`patch`、`multiedit`)。
:::
@@ -242,7 +242,7 @@ To configure which LSP servers are available for your project, see [LSP Servers]
建立和更新任务列表以跟踪复杂操作期间的详细信息。LLM 使用它来组织多步骤任务。
:::笔记
:::note
默认情况下,子代理取消此工具,但您可以手动启用它。 [了解更多](/docs/agents/#permissions)
:::
@@ -263,7 +263,7 @@ To configure which LSP servers are available for your project, see [LSP Servers]
读取当前完成待办事项列表状态。由 LLM 用于跟踪哪些任务待处理或已已。
:::笔记
:::note
默认情况下,子代理取消此工具,但您可以手动启用它。 [了解更多](/docs/agents/#permissions)
:::
@@ -290,7 +290,7 @@ To configure which LSP servers are available for your project, see [LSP Servers]
在網路上搜尋資訊。
:::笔记
:::note
仅当使用 OpenCode 提供或 `OPENCODE_ENABLE_EXA` 程序环境变量设置为任何真值(例如 `true` 或 `1`)时,此工具才可用。
要在启动 OpenCode 时启用:
@@ -314,7 +314,7 @@ OPENCODE_ENABLE_EXA=1 opencode
不需要 API 金钥匙 — 该工具消耗身份验证即可直接连线到 Exa AI 的托管 MCP 服务。
:::提示
:::tip
当您需要查询资讯(发现)时,请使用 `websearch`;当您需要从特定 URL 检索内容(搜索)时,请使用 `webfetch`。
:::

View File

@@ -31,7 +31,7 @@ Give me a quick summary of the codebase.
您可以使用 `@` 在訊息中引用檔案。這會在當前工作目錄中進行模糊檔案搜尋。
:::提示
:::tip
您還可以使用 `@` 來引用訊息中的檔案。
:::
@@ -191,7 +191,7 @@ Create or update `AGENTS.md` file. [Learn more](/docs/rules).
删除之前重做消除的讯息。仅在使用`/undo`后可用。
:::提示
:::tip
任何檔案更改也將被恢復。
:::
@@ -246,7 +246,7 @@ Create or update `AGENTS.md` file. [Learn more](/docs/rules).
切换对话中 thinking/reasoning 块的可视性。启用后,您可以看到支持增强套件思维的模型的推理过程。
:::笔记
:::note
该命令仅控制是否**显示** - 不启用或取消模型的推理功能。要切换实际推理功能,请使用 `ctrl+t` 回圈切换模型变体。
:::
@@ -260,7 +260,7 @@ Create or update `AGENTS.md` file. [Learn more](/docs/rules).
撤消對話中的最後一條訊息。刪除最近的使用者訊息、所有後續響應以及任何檔案更改。
:::提示
:::tip
所做的任何檔案更改也將被恢復。
:::
@@ -345,7 +345,7 @@ Create or update `AGENTS.md` file. [Learn more](/docs/rules).
- `notepad` - Windows 文章书
- `subl` - 崇高文字
:::笔记
:::note
一些编辑器如 VS Code 需要以 `--wait` 标志启动。
:::

View File

@@ -17,7 +17,7 @@ opencode web
这将在 `127.0.0.1` 上启动一个具有随机可用端口的本地服务器,并自动在默认浏览器中开启 OpenCode。
:::警告
:::caution
如果未设置`OPENCODE_SERVER_PASSWORD`,服务器将不安全。这对于本地使用来说很好,但应该针对网路访问进行设置。
:::

View File

@@ -9,7 +9,7 @@ export const email = `mailto:${config.email}`
Error 500 (Server Error)!!1500.Thats an error.There was an error. Please try again later.Thats all we know.
:::笔记
:::note
OpenCode Zen 目前处于一个测试阶段。
:::
@@ -25,7 +25,7 @@ Zen 的工作方式与 OpenCode 中的任何其他提供程序相同。您登入
這些模型可以很好地用作編碼代理。此外,大多數提供商都
配置非常不同;所以你會得到截然不同的效能和質量。
:::提示
:::tip
我们测试了一组与 OpenCode 配合良好的模型并提供方案。
:::
@@ -152,7 +152,7 @@ https://opencode.ai/zen/v1/models
您可能会在您的使用历史记录中注意到*Claude Haiku 3.5*。这是一个[低成本模型](/docs/config/#models),用于生成会话标题。
:::笔记
:::note
信用卡費用按成本轉嫁4.4% + 每筆交易 0.30 美元);除此之外我們不收取任何費用。
:::
@@ -204,7 +204,7 @@ https://opencode.ai/zen/v1/models
Zen 对团队也很有效。您可以参与第三方、角色、策划
您的團隊使用的模型等等。
:::笔记
:::note
作為測試版的一部分,工作空間目前對團隊免費。
:::