fix(docs): locale markdown issues
This commit is contained in:
@@ -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`。
|
||||
:::
|
||||
|
||||
|
||||
@@ -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)。
|
||||
:::
|
||||
|
||||
|
||||
@@ -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 工具 |
|
||||
|
||||
@@ -316,7 +316,7 @@ Check for performance issues and suggest improvements.
|
||||
|
||||
opencode包含`/init`、`/undo`、`/redo`、`/share`、`/help`等内置命令;【了解更多](/docs/tui#commands)。
|
||||
|
||||
:::笔记
|
||||
:::note
|
||||
自定義命令可以覆蓋內置命令。
|
||||
:::
|
||||
|
||||
|
||||
@@ -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
|
||||
實驗選項不穩定。它們可能會更改或被刪除,恕不另行通知。
|
||||
:::
|
||||
|
||||
|
||||
@@ -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代理通过技能发现和注入失败延迟加载提示 |
|
||||
|
||||
@@ -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 之前,您必须登录灌木丛。
|
||||
:::
|
||||
|
||||
|
||||
@@ -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将自动使用它。
|
||||
|
||||
@@ -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` 不同的触发主板。
|
||||
:::
|
||||
|
||||
|
||||
@@ -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
|
||||
默認情況下不共享對話。
|
||||
:::
|
||||
|
||||
|
||||
@@ -48,7 +48,7 @@ OpenCode附带了多种适用于流行语言的内置LSP服务器:
|
||||
|
||||
当检测到上述文件扩展名之一并且满足要求时,LSP服务器将自动启用。
|
||||
|
||||
:::笔记
|
||||
:::note
|
||||
您可以通过将`OPENCODE_DISABLE_LSP_DOWNLOAD`环境变量设置为`true`来取消自动LSP服务器下载。
|
||||
:::
|
||||
|
||||
@@ -126,7 +126,7 @@ OpenCode附带了多种适用于流行语言的内置LSP服务器:
|
||||
}
|
||||
```
|
||||
|
||||
:::笔记
|
||||
:::note
|
||||
初始化选项因 LSP 服务器而异。检查 LSP 服务器的文档以获得可用选项。
|
||||
:::
|
||||
|
||||
|
||||
@@ -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服务器工具以名称服务器作为出口进行注册,要因此禁用服务器的所有工具,只需使用:
|
||||
|
||||
```
|
||||
|
||||
@@ -29,7 +29,7 @@ OpenCode 使用[人工智能软件开发工具包](https://ai-sdk.dev/) 和[模
|
||||
|
||||
那裡有很多型號,每週都會有新型號問世。
|
||||
|
||||
:::提示
|
||||
:::tip
|
||||
考慮使用我們推薦的模型之一。
|
||||
:::
|
||||
|
||||
@@ -164,7 +164,7 @@ OpenCode 附带了许多重大的默认变体:
|
||||
- `low` - 降低工作量/代幣預算
|
||||
- `high` - 更高的努力/代幣預算
|
||||
|
||||
:::提示
|
||||
:::tip
|
||||
該列表並不全面。許多其他提供商也有內置的默認值。
|
||||
:::
|
||||
|
||||
|
||||
@@ -3,7 +3,7 @@ title: 模式
|
||||
description: 不同的模式適用於不同的用例。
|
||||
---
|
||||
|
||||
:::警告
|
||||
:::caution
|
||||
现在通过opencode配置中的`agent`选项配置模式。这
|
||||
`mode` 选项现已废弃。 [了解更多](/docs/agents)。
|
||||
:::
|
||||
|
||||
@@ -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
|
||||
避免對密碼進行硬編碼。使用環境變量或安全憑證存儲。
|
||||
:::
|
||||
|
||||
|
||||
@@ -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 *"`)。
|
||||
:::
|
||||
|
||||
@@ -234,7 +234,7 @@ export const NotificationPlugin = async ({ project, client, $, directory, worktr
|
||||
|
||||
我们在 macOS 上使用 `osascript` AppleScript。这里我们用它运行来发送通知。
|
||||
|
||||
:::笔记
|
||||
:::note
|
||||
如果您使用 OpenCode 桌面应用程序,它可以在响应准备就绪或会话错误时自动发送系统通知。
|
||||
:::
|
||||
|
||||
|
||||
@@ -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。
|
||||
:::
|
||||
|
||||
|
||||
@@ -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`)比手动指令更易于维护。
|
||||
:::
|
||||
|
||||
@@ -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 }` |
|
||||
|
||||
@@ -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`,之后是总线事件。 | 服务器发送事件流。 |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -5,7 +5,7 @@ description: 分享您的 OpenCode 对话。
|
||||
|
||||
OpenCode 的共享功能允许您建立指向 OpenCode 对话的公共链接,以便您可以与蓝牙进行战斗或从其他人那里获得帮助。
|
||||
|
||||
:::笔记
|
||||
:::note
|
||||
任何知道連結的人都可以公開訪問共享對話。
|
||||
:::
|
||||
|
||||
|
||||
@@ -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`。
|
||||
:::
|
||||
|
||||
|
||||
@@ -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` 标志启动。
|
||||
:::
|
||||
|
||||
|
||||
@@ -17,7 +17,7 @@ opencode web
|
||||
|
||||
这将在 `127.0.0.1` 上启动一个具有随机可用端口的本地服务器,并自动在默认浏览器中开启 OpenCode。
|
||||
|
||||
:::警告
|
||||
:::caution
|
||||
如果未设置`OPENCODE_SERVER_PASSWORD`,服务器将不安全。这对于本地使用来说很好,但应该针对网路访问进行设置。
|
||||
:::
|
||||
|
||||
|
||||
@@ -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
|
||||
作為測試版的一部分,工作空間目前對團隊免費。
|
||||
:::
|
||||
|
||||
|
||||
Reference in New Issue
Block a user