diff options
| author | Adam <[email protected]> | 2026-02-09 13:55:55 -0600 |
|---|---|---|
| committer | Adam <[email protected]> | 2026-02-09 13:55:55 -0600 |
| commit | 274bb948e793c72d22d4e2d31e6b9559c6ff4d6c (patch) | |
| tree | 34d892e508c4af9387518d545dfd7ed4a875ff71 /packages/web/src/content/docs/zh-cn | |
| parent | d9b4535d643f6bdc5c6cec0aa2c020ab98f9180c (diff) | |
| download | opencode-274bb948e793c72d22d4e2d31e6b9559c6ff4d6c.tar.gz opencode-274bb948e793c72d22d4e2d31e6b9559c6ff4d6c.zip | |
fix(docs): locale markdown issues
Diffstat (limited to 'packages/web/src/content/docs/zh-cn')
26 files changed, 92 insertions, 92 deletions
diff --git a/packages/web/src/content/docs/zh-cn/acp.mdx b/packages/web/src/content/docs/zh-cn/acp.mdx index 9bcc0faad..20a377329 100644 --- a/packages/web/src/content/docs/zh-cn/acp.mdx +++ b/packages/web/src/content/docs/zh-cn/acp.mdx @@ -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`。 ::: diff --git a/packages/web/src/content/docs/zh-cn/agents.mdx b/packages/web/src/content/docs/zh-cn/agents.mdx index 75142d0cc..1630a07a5 100644 --- a/packages/web/src/content/docs/zh-cn/agents.mdx +++ b/packages/web/src/content/docs/zh-cn/agents.mdx @@ -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)。 ::: diff --git a/packages/web/src/content/docs/zh-cn/cli.mdx b/packages/web/src/content/docs/zh-cn/cli.mdx index 66acd04d7..f8c01063b 100644 --- a/packages/web/src/content/docs/zh-cn/cli.mdx +++ b/packages/web/src/content/docs/zh-cn/cli.mdx @@ -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 工具 | diff --git a/packages/web/src/content/docs/zh-cn/commands.mdx b/packages/web/src/content/docs/zh-cn/commands.mdx index a80aa9258..726afb2f3 100644 --- a/packages/web/src/content/docs/zh-cn/commands.mdx +++ b/packages/web/src/content/docs/zh-cn/commands.mdx @@ -316,7 +316,7 @@ Check for performance issues and suggest improvements. opencode包含`/init`、`/undo`、`/redo`、`/share`、`/help`等内置命令；【了解更多](/docs/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 12322a569..940b63781 100644 --- a/packages/web/src/content/docs/zh-cn/config.mdx +++ b/packages/web/src/content/docs/zh-cn/config.mdx @@ -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.That’s an error.There was an error. Please try } ``` -:::笔记 +:::note `disabled_providers` 优先于`enabled_providers`。 ::: @@ -601,7 +601,7 @@ Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try 当您想要限制 OpenCode 仅使用特定的提供程序而不是一一禁止它们时，这非常有用。 -:::笔记 +:::note `disabled_providers` 优先于`enabled_providers`。 ::: @@ -620,7 +620,7 @@ Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try } ``` -:::警告 +:::caution 實驗選項不穩定。它們可能會更改或被刪除，恕不另行通知。 ::: diff --git a/packages/web/src/content/docs/zh-cn/ecosystem.mdx b/packages/web/src/content/docs/zh-cn/ecosystem.mdx index 037d5d997..32083b390 100644 --- a/packages/web/src/content/docs/zh-cn/ecosystem.mdx +++ b/packages/web/src/content/docs/zh-cn/ecosystem.mdx @@ -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代理通过技能发现和注入失败延迟加载提示 | diff --git a/packages/web/src/content/docs/zh-cn/enterprise.mdx b/packages/web/src/content/docs/zh-cn/enterprise.mdx index eb28c3897..250010ede 100644 --- a/packages/web/src/content/docs/zh-cn/enterprise.mdx +++ b/packages/web/src/content/docs/zh-cn/enterprise.mdx @@ -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 之前，您必须登录灌木丛。 ::: diff --git a/packages/web/src/content/docs/zh-cn/formatters.mdx b/packages/web/src/content/docs/zh-cn/formatters.mdx index 12558851a..11279eee4 100644 --- a/packages/web/src/content/docs/zh-cn/formatters.mdx +++ b/packages/web/src/content/docs/zh-cn/formatters.mdx @@ -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将自动使用它。 diff --git a/packages/web/src/content/docs/zh-cn/gitlab.mdx b/packages/web/src/content/docs/zh-cn/gitlab.mdx index 1fb235b3e..05717793d 100644 --- a/packages/web/src/content/docs/zh-cn/gitlab.mdx +++ b/packages/web/src/content/docs/zh-cn/gitlab.mdx @@ -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` 不同的触发主板。 ::: diff --git a/packages/web/src/content/docs/zh-cn/index.mdx b/packages/web/src/content/docs/zh-cn/index.mdx index 49f3ce4de..8e31a13c9 100644 --- a/packages/web/src/content/docs/zh-cn/index.mdx +++ b/packages/web/src/content/docs/zh-cn/index.mdx @@ -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 默認情況下不共享對話。 ::: diff --git a/packages/web/src/content/docs/zh-cn/lsp.mdx b/packages/web/src/content/docs/zh-cn/lsp.mdx index 8cfaefbd0..786077fc3 100644 --- a/packages/web/src/content/docs/zh-cn/lsp.mdx +++ b/packages/web/src/content/docs/zh-cn/lsp.mdx @@ -48,7 +48,7 @@ OpenCode附带了多种适用于流行语言的内置LSP服务器： 当检测到上述文件扩展名之一并且满足要求时，LSP服务器将自动启用。 -:::笔记 +:::note 您可以通过将`OPENCODE_DISABLE_LSP_DOWNLOAD`环境变量设置为`true`来取消自动LSP服务器下载。 ::: @@ -126,7 +126,7 @@ OpenCode附带了多种适用于流行语言的内置LSP服务器： } ``` -:::笔记 +:::note 初始化选项因 LSP 服务器而异。检查 LSP 服务器的文档以获得可用选项。 ::: 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 b86f7a974..14ae0117a 100644 --- a/packages/web/src/content/docs/zh-cn/mcp-servers.mdx +++ b/packages/web/src/content/docs/zh-cn/mcp-servers.mdx @@ -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服务器工具以名称服务器作为出口进行注册，要因此禁用服务器的所有工具，只需使用： ``` diff --git a/packages/web/src/content/docs/zh-cn/models.mdx b/packages/web/src/content/docs/zh-cn/models.mdx index 100091b45..be707be61 100644 --- a/packages/web/src/content/docs/zh-cn/models.mdx +++ b/packages/web/src/content/docs/zh-cn/models.mdx @@ -29,7 +29,7 @@ OpenCode 使用[人工智能软件开发工具包](https://ai-sdk.dev/) 和[模� 那裡有很多型號，每週都會有新型號問世。 -:::提示 +:::tip 考慮使用我們推薦的模型之一。 ::: @@ -164,7 +164,7 @@ OpenCode 附带了许多重大的默认变体： - `low` - 降低工作量/代幣預算 - `high` - 更高的努力/代幣預算 -:::提示 +:::tip 該列表並不全面。許多其他提供商也有內置的默認值。 ::: diff --git a/packages/web/src/content/docs/zh-cn/modes.mdx b/packages/web/src/content/docs/zh-cn/modes.mdx index 1acb7556b..ee841cf13 100644 --- a/packages/web/src/content/docs/zh-cn/modes.mdx +++ b/packages/web/src/content/docs/zh-cn/modes.mdx @@ -3,7 +3,7 @@ title: 模式 description: 不同的模式適用於不同的用例。 --- -:::警告 +:::caution 现在通过opencode配置中的`agent`选项配置模式。这 `mode` 选项现已废弃。 [了解更多](/docs/agents)。 ::: diff --git a/packages/web/src/content/docs/zh-cn/network.mdx b/packages/web/src/content/docs/zh-cn/network.mdx index d00cfa5d6..92d412870 100644 --- a/packages/web/src/content/docs/zh-cn/network.mdx +++ b/packages/web/src/content/docs/zh-cn/network.mdx @@ -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:[email protected]:8080 ``` -:::警告 +:::caution 避免對密碼進行硬編碼。使用環境變量或安全憑證存儲。 ::: diff --git a/packages/web/src/content/docs/zh-cn/permissions.mdx b/packages/web/src/content/docs/zh-cn/permissions.mdx index c9dbd23a3..cdddd6534 100644 --- a/packages/web/src/content/docs/zh-cn/permissions.mdx +++ b/packages/web/src/content/docs/zh-cn/permissions.mdx @@ -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 *"`）。 ::: diff --git a/packages/web/src/content/docs/zh-cn/plugins.mdx b/packages/web/src/content/docs/zh-cn/plugins.mdx index e61e18dca..722a9a084 100644 --- a/packages/web/src/content/docs/zh-cn/plugins.mdx +++ b/packages/web/src/content/docs/zh-cn/plugins.mdx @@ -234,7 +234,7 @@ export const NotificationPlugin = async ({ project, client, $, directory, worktr 我们在 macOS 上使用 `osascript` AppleScript。这里我们用它运行来发送通知。 -:::笔记 +:::note 如果您使用 OpenCode 桌面应用程序，它可以在响应准备就绪或会话错误时自动发送系统通知。 ::: diff --git a/packages/web/src/content/docs/zh-cn/providers.mdx b/packages/web/src/content/docs/zh-cn/providers.mdx index 120984c29..149b0e3d3 100644 --- a/packages/web/src/content/docs/zh-cn/providers.mdx +++ b/packages/web/src/content/docs/zh-cn/providers.mdx @@ -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。 ::: diff --git a/packages/web/src/content/docs/zh-cn/rules.mdx b/packages/web/src/content/docs/zh-cn/rules.mdx index e4ae46a97..a9c6f7795 100644 --- a/packages/web/src/content/docs/zh-cn/rules.mdx +++ b/packages/web/src/content/docs/zh-cn/rules.mdx @@ -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`）比手动指令更易于维护。 ::: diff --git a/packages/web/src/content/docs/zh-cn/sdk.mdx b/packages/web/src/content/docs/zh-cn/sdk.mdx index c4ae75c23..67737ce16 100644 --- a/packages/web/src/content/docs/zh-cn/sdk.mdx +++ b/packages/web/src/content/docs/zh-cn/sdk.mdx @@ -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 }` | diff --git a/packages/web/src/content/docs/zh-cn/server.mdx b/packages/web/src/content/docs/zh-cn/server.mdx index 2083e6dd6..30ec6c3f6 100644 --- a/packages/web/src/content/docs/zh-cn/server.mdx +++ b/packages/web/src/content/docs/zh-cn/server.mdx @@ -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`，之后是总线事件。 | 服务器发送事件流。 | --- diff --git a/packages/web/src/content/docs/zh-cn/share.mdx b/packages/web/src/content/docs/zh-cn/share.mdx index c3ce2acef..6eb5c1fa4 100644 --- a/packages/web/src/content/docs/zh-cn/share.mdx +++ b/packages/web/src/content/docs/zh-cn/share.mdx @@ -5,7 +5,7 @@ description: 分享您的 OpenCode 对话。 OpenCode 的共享功能允许您建立指向 OpenCode 对话的公共链接，以便您可以与蓝牙进行战斗或从其他人那里获得帮助。 -:::笔记 +:::note 任何知道連結的人都可以公開訪問共享對話。 ::: diff --git a/packages/web/src/content/docs/zh-cn/tools.mdx b/packages/web/src/content/docs/zh-cn/tools.mdx index 1aee21cf6..8633fcf8e 100644 --- a/packages/web/src/content/docs/zh-cn/tools.mdx +++ b/packages/web/src/content/docs/zh-cn/tools.mdx @@ -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`。 ::: diff --git a/packages/web/src/content/docs/zh-cn/tui.mdx b/packages/web/src/content/docs/zh-cn/tui.mdx index dcaa0444f..5760b14bd 100644 --- a/packages/web/src/content/docs/zh-cn/tui.mdx +++ b/packages/web/src/content/docs/zh-cn/tui.mdx @@ -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` 标志启动。 ::: diff --git a/packages/web/src/content/docs/zh-cn/web.mdx b/packages/web/src/content/docs/zh-cn/web.mdx index 3a0bb9c4a..be64d8c03 100644 --- a/packages/web/src/content/docs/zh-cn/web.mdx +++ b/packages/web/src/content/docs/zh-cn/web.mdx @@ -17,7 +17,7 @@ opencode web 这将在 `127.0.0.1` 上启动一个具有随机可用端口的本地服务器，并自动在默认浏览器中开启 OpenCode。 -:::警告 +:::caution 如果未设置`OPENCODE_SERVER_PASSWORD`，服务器将不安全。这对于本地使用来说很好，但应该针对网路访问进行设置。 ::: diff --git a/packages/web/src/content/docs/zh-cn/zen.mdx b/packages/web/src/content/docs/zh-cn/zen.mdx index b3b347d76..e37f2127f 100644 --- a/packages/web/src/content/docs/zh-cn/zen.mdx +++ b/packages/web/src/content/docs/zh-cn/zen.mdx @@ -9,7 +9,7 @@ export const email = `mailto:${config.email}` Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try again later.That’s 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 作為測試版的一部分，工作空間目前對團隊免費。 ::: |