diff options
| author | Adam <[email protected]> | 2026-02-10 13:59:14 -0600 |
|---|---|---|
| committer | opencode <[email protected]> | 2026-02-10 20:22:30 +0000 |
| commit | fd5531316f858b77274e26975796aec41ba5128c (patch) | |
| tree | 6337bc388da712e35b24e3bf6bdf903b21cecfa4 /packages/web/src/content/docs/zh-tw | |
| parent | fbc41475b403a23f004f63289b264c224b9d6b2f (diff) | |
| download | opencode-fd5531316f858b77274e26975796aec41ba5128c.tar.gz opencode-fd5531316f858b77274e26975796aec41ba5128c.zip | |
fix(docs): locale translations
Diffstat (limited to 'packages/web/src/content/docs/zh-tw')
| -rw-r--r-- | packages/web/src/content/docs/zh-tw/acp.mdx | 20 | ||||
| -rw-r--r-- | packages/web/src/content/docs/zh-tw/agents.mdx | 2 | ||||
| -rw-r--r-- | packages/web/src/content/docs/zh-tw/cli.mdx | 114 | ||||
| -rw-r--r-- | packages/web/src/content/docs/zh-tw/config.mdx | 2 | ||||
| -rw-r--r-- | packages/web/src/content/docs/zh-tw/formatters.mdx | 8 | ||||
| -rw-r--r-- | packages/web/src/content/docs/zh-tw/github.mdx | 2 | ||||
| -rw-r--r-- | packages/web/src/content/docs/zh-tw/ide.mdx | 28 | ||||
| -rw-r--r-- | packages/web/src/content/docs/zh-tw/index.mdx | 64 | ||||
| -rw-r--r-- | packages/web/src/content/docs/zh-tw/lsp.mdx | 4 | ||||
| -rw-r--r-- | packages/web/src/content/docs/zh-tw/models.mdx | 28 | ||||
| -rw-r--r-- | packages/web/src/content/docs/zh-tw/providers.mdx | 530 | ||||
| -rw-r--r-- | packages/web/src/content/docs/zh-tw/rules.mdx | 2 | ||||
| -rw-r--r-- | packages/web/src/content/docs/zh-tw/skills.mdx | 2 | ||||
| -rw-r--r-- | packages/web/src/content/docs/zh-tw/troubleshooting.mdx | 2 | ||||
| -rw-r--r-- | packages/web/src/content/docs/zh-tw/tui.mdx | 28 |
15 files changed, 416 insertions, 420 deletions
diff --git a/packages/web/src/content/docs/zh-tw/acp.mdx b/packages/web/src/content/docs/zh-tw/acp.mdx index 64e66518d..2bd3d3948 100644 --- a/packages/web/src/content/docs/zh-tw/acp.mdx +++ b/packages/web/src/content/docs/zh-tw/acp.mdx @@ -1,9 +1,9 @@ --- title: ACP 支持 -description: 在任何 ACP 兼容編輯器中使用 opencode。 +description: 在任何 ACP 兼容編輯器中使用 OpenCode。 --- -opencode 支持 [Agent Client Protocol](https://agentclientprotocol.com) 或 (ACP),允許您直接在兼容的編輯器和 IDE 中使用它。 +OpenCode 支持 [Agent Client Protocol](https://agentclientprotocol.com) 或 (ACP),允許您直接在兼容的編輯器和 IDE 中使用它。 :::tip 有關支持 ACP 的編輯器和工具的列表,請查看[ACP progress report](https://zed.dev/blog/acp-progress-report#available-now)。 @@ -15,9 +15,9 @@ ACP 是一種開放協議,用於標準化程式碼編輯器和 AI 編碼代理 ## 配置 -要通過 ACP 使用 opencode,請將編輯器配置為運行 `opencode acp` 命令。 +要通過 ACP 使用 OpenCode,請將編輯器配置為運行 `opencode acp` 命令。 -該命令將 opencode 作為 ACP 兼容的子進程啟動,通過 stdio 通過 JSON-RPC 與您的編輯器進行通信。 +該命令將 OpenCode 作為 ACP 兼容的子進程啟動,通過 stdio 通過 JSON-RPC 與您的編輯器進行通信。 以下是支持 ACP 的流行編輯器的示例。 @@ -86,9 +86,9 @@ ACP 是一種開放協議,用於標準化程式碼編輯器和 AI 編碼代理 --- -### Avante +### Avante.nvim -添加到您的[Avante](https://github.com/yetone/avante.nvim)配置: +添加到您的[Avante.nvim](https://github.com/yetone/avante.nvim)配置: ```lua { @@ -121,7 +121,7 @@ ACP 是一種開放協議,用於標準化程式碼編輯器和 AI 編碼代理 ### CodeCompanion.nvim -要將 opencode 用作 [CodeCompanion.nvim](https://github.com/olimorris/CodeCompanion.nvim) 中的 ACP 代理,請將以下內容添加到 Neovim 配置中: +要將 OpenCode 用作 [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim) 中的 ACP 代理,請將以下內容添加到 Neovim 配置中: ```lua require("codecompanion").setup({ @@ -136,13 +136,13 @@ require("codecompanion").setup({ }) ``` -此配置將 CodeCompanion 設置為使用 opencode 作為聊天的 ACP 代理。 +此配置將 CodeCompanion 設置為使用 OpenCode 作為聊天的 ACP 代理。 如果您需要傳遞環境變量(如 `OPENCODE_API_KEY`),請參閱 CodeCompanion.nvim 文檔中的 [配置適配器:環境變量](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) 了解完整詳細信息。 ## 支持 -opencode 通過 ACP 的工作方式與在 terminal 中的工作方式相同。支持所有功能: +OpenCode 通過 ACP 的工作方式與在 terminal 中的工作方式相同。支持所有功能: :::note 目前不支持某些內置斜杠命令,例如 `/undo` 和 `/redo`。 @@ -150,7 +150,7 @@ opencode 通過 ACP 的工作方式與在 terminal 中的工作方式相同。� - 內置工具(文件操作、terminal 命令等) - 自定義工具和斜杠命令 -- 在 opencode 配置中配置的 MCP 服務器 +- 在 OpenCode 配置中配置的 MCP 服務器 - `AGENTS.md` 的項目特定規則 - 自定義格式化程序和 linter - 代理和權限系統 diff --git a/packages/web/src/content/docs/zh-tw/agents.mdx b/packages/web/src/content/docs/zh-tw/agents.mdx index 7932f3d9a..7d7269503 100644 --- a/packages/web/src/content/docs/zh-tw/agents.mdx +++ b/packages/web/src/content/docs/zh-tw/agents.mdx @@ -542,7 +542,7 @@ Only analyze code and suggest changes. ### 隱 -使用 `hidden: true` 從 `@` 自動完成菜單隱藏子代理。對於只能由其他代理通過任務工具以編程方式調用的內部子代理很有用。 +使用 `@` 從 `hidden: true` 自動完成菜單隱藏子代理。對於只能由其他代理通過任務工具以編程方式調用的內部子代理很有用。 ```json title="opencode.json" { diff --git a/packages/web/src/content/docs/zh-tw/cli.mdx b/packages/web/src/content/docs/zh-tw/cli.mdx index 85912398c..2827be9dc 100644 --- a/packages/web/src/content/docs/zh-tw/cli.mdx +++ b/packages/web/src/content/docs/zh-tw/cli.mdx @@ -5,13 +5,13 @@ description: opencode CLI 選項和命令。 import { Tabs, TabItem } from "@astrojs/starlight/components" -默認情況下,opencode CLI 在不帶任何參數運行時啟動[途易](/docs/tui)。 +默認情況下,OpenCode CLI 在不帶任何參數運行時啟動[TUI](/docs/tui)。 ```bash opencode ``` -但它也接受本頁記錄的命令。這允許您以編程方式與 opencode 交互。 +但它也接受本頁記錄的命令。這允許您以編程方式與 OpenCode 交互。 ```bash opencode run "Explain how closures work in JavaScript" @@ -21,15 +21,15 @@ opencode run "Explain how closures work in JavaScript" ### tui -啟動 opencode terminal用戶介面。 +啟動 OpenCode TUI。 ```bash opencode [project] ``` -#### 旗幟 +#### 旗標 -| 旗幟 | 短 | 描述 | +| 旗標 | 簡寫 | 描述 | | ------------ | ---- | --------------------------------------------------------- | | `--continue` | `-c` | 繼續上一期 | | `--session` | `-s` | 會話 ID 繼續 | @@ -44,13 +44,13 @@ opencode [project] ## 命令 -opencode CLI 還具有以下命令。 +OpenCode CLI 還具有以下命令。 --- ### agent -管理 opencode 代理。 +管理 OpenCode 代理。 ```bash opencode agent [command] @@ -60,13 +60,13 @@ opencode agent [command] ### attach -將terminal連接到通過 `serve` 或 `web` 命令啟動的已運行的 opencode 後端服務器。 +將 terminal 連接到通過 `serve` 或 `web` 命令啟動的已運行的 OpenCode 後端服務器。 ```bash opencode attach [url] ``` -這允許將 TUI 與遠程 opencode 後端一起使用。例如: +這允許將 TUI 與遠程 OpenCode 後端一起使用。例如: ```bash # Start the backend server for web/mobile access @@ -76,9 +76,9 @@ opencode web --port 4096 --hostname 0.0.0.0 opencode attach http://10.20.30.40:4096 ``` -#### 旗幟 +#### 旗標 -| 旗幟 | 短 | 描述 | +| 旗標 | 簡寫 | 描述 | | ----------- | ---- | ------------------- | | `--dir` | | 啟動 TUI 的工作目錄 | | `--session` | `-s` | 會話 ID 繼續 | @@ -119,13 +119,13 @@ opencode auth [command] #### login -opencode 由 [models.dev](https://models.dev) 上的提供商列表提供支持,因此您可以使用 `opencode auth login` 為您想要使用的任何提供商配置 API 密鑰。它存儲在`~/.local/share/opencode/auth.json` 中。 +OpenCode 由 [Models.dev](https://models.dev) 上的提供商列表提供支持,因此您可以使用 `opencode auth login` 為您想要使用的任何提供商配置 API 密鑰。它存儲在`~/.local/share/opencode/auth.json` 中。 ```bash opencode auth login ``` -當 opencode 啟動時,它會從憑據文件加載提供商。如果您的環境中定義了任何鍵或項目中的 `.env` 文件。 +當 OpenCode 啟動時,它會從憑據文件加載提供商。如果您的環境中定義了任何鍵或項目中的 `.env` 文件。 --- @@ -301,7 +301,7 @@ opencode models anthropic | `--refresh` | 從 models.dev 刷新模型緩存 | | `--verbose` | 使用更詳細的模型輸出(包括成本等元數據) | -使用`--refresh`標誌來更新緩存的模型列表。當新模型已添加到提供商並且您希望在 opencode 中查看它們時,這非常有用。 +使用`--refresh`標誌來更新緩存的模型列表。當新模型已添加到提供商並且您希望在 OpenCode 中查看它們時,這非常有用。 ```bash opencode models --refresh @@ -530,9 +530,9 @@ opencode upgrade v0.1.48 #### 旗幟 -| 旗幟 | 短 | 描述 | +| 旗標 | 簡寫 | 描述 | | ---------- | ---- | ------------------------------------------ | -| `--method` | `-m` | 使用的安裝方法;捲曲、npm、pnpm、bun、brew | +| `--method` | `-m` | 使用的安裝方法;curl、npm、pnpm、bun、brew | --- @@ -553,32 +553,32 @@ opencode CLI 採用以下全局標誌。 可以使用環境變量配置 opencode。 -| 變量 | 類型 | 描述 | -| ------------------------------------- | ------ | ---------------------------------------- | -| `OPENCODE_AUTO_SHARE` | 布爾 | 自動共享會話 | -| `OPENCODE_GIT_BASH_PATH` | 字符串 | Windows 上 Git Bash 可執行文件的路徑 | -| `OPENCODE_CONFIG` | 字符串 | 配置文件路徑 | -| `OPENCODE_CONFIG_DIR` | 字符串 | 配置目錄的路徑 | -| `OPENCODE_CONFIG_CONTENT` | 字符串 | 內聯 json 配置內容 | -| `OPENCODE_DISABLE_AUTOUPDATE` | 布爾 | 禁用自動更新檢查 | -| `OPENCODE_DISABLE_PRUNE` | 布爾 | 禁用舊數據的修剪 | -| `OPENCODE_DISABLE_TERMINAL_TITLE` | 布爾 | 禁用自動terminal標題更新 | -| `OPENCODE_PERMISSION` | 字符串 | 內聯 json 權限配置 | -| `OPENCODE_DISABLE_DEFAULT_PLUGINS` | 布爾 | 禁用默認插件 | -| `OPENCODE_DISABLE_LSP_DOWNLOAD` | 布爾 | 禁用自動 LSP 服務器下載 | -| `OPENCODE_ENABLE_EXPERIMENTAL_MODELS` | 布爾 | 啟用實驗模型 | -| `OPENCODE_DISABLE_AUTOCOMPACT` | 布爾 | 禁用自動上下文壓縮 | -| `OPENCODE_DISABLE_CLAUDE_CODE` | 布爾 | 禁止從`.claude`讀取(提示+技巧) | -| `OPENCODE_DISABLE_CLAUDE_CODE_PROMPT` | 布爾 | 禁用讀取`~/.claude/CLAUDE.md` | -| `OPENCODE_DISABLE_CLAUDE_CODE_SKILLS` | 布爾 | 禁用加載`.claude/skills` | -| `OPENCODE_DISABLE_MODELS_FETCH` | 布爾 | 禁用從遠程源獲取模型 | -| `OPENCODE_FAKE_VCS` | 字符串 | 用於測試目的的假 VCS 提供商 | -| `OPENCODE_DISABLE_FILETIME_CHECK` | 布爾 | 禁用文件時間檢查以進行優化 | -| `OPENCODE_CLIENT` | 字符串 | 客戶端標識符(默認為`cli`) | -| `OPENCODE_ENABLE_EXA` | 布爾 | 啟用 Exa 網絡搜索工具 | -| `OPENCODE_SERVER_PASSWORD` | 字符串 | 為 `serve`/`web` 啟用基本身份驗證 | -| `OPENCODE_SERVER_USERNAME` | 字符串 | 覆蓋基本身份驗證用戶名(默認`opencode`) | -| `OPENCODE_MODELS_URL` | 字符串 | 用於獲取模型配置的自定義 URL | +| 變量 | 類型 | 描述 | +| ------------------------------------- | ------- | ---------------------------------------- | +| `OPENCODE_AUTO_SHARE` | boolean | 自動共享會話 | +| `OPENCODE_GIT_BASH_PATH` | string | Windows 上 Git Bash 可執行文件的路徑 | +| `OPENCODE_CONFIG` | string | 配置文件路徑 | +| `OPENCODE_CONFIG_DIR` | string | 配置目錄的路徑 | +| `OPENCODE_CONFIG_CONTENT` | string | 內聯 json 配置內容 | +| `OPENCODE_DISABLE_AUTOUPDATE` | boolean | 禁用自動更新檢查 | +| `OPENCODE_DISABLE_PRUNE` | boolean | 禁用舊數據的修剪 | +| `OPENCODE_DISABLE_TERMINAL_TITLE` | boolean | 禁用自動 terminal 標題更新 | +| `OPENCODE_PERMISSION` | string | 內聯 json 權限配置 | +| `OPENCODE_DISABLE_DEFAULT_PLUGINS` | boolean | 禁用默認插件 | +| `OPENCODE_DISABLE_LSP_DOWNLOAD` | boolean | 禁用自動 LSP 服務器下載 | +| `OPENCODE_ENABLE_EXPERIMENTAL_MODELS` | boolean | 啟用實驗模型 | +| `OPENCODE_DISABLE_AUTOCOMPACT` | boolean | 禁用自動上下文壓縮 | +| `OPENCODE_DISABLE_CLAUDE_CODE` | boolean | 禁止從`.claude`讀取(提示+技巧) | +| `OPENCODE_DISABLE_CLAUDE_CODE_PROMPT` | boolean | 禁用讀取`~/.claude/CLAUDE.md` | +| `OPENCODE_DISABLE_CLAUDE_CODE_SKILLS` | boolean | 禁用加載`.claude/skills` | +| `OPENCODE_DISABLE_MODELS_FETCH` | boolean | 禁用從遠程源獲取模型 | +| `OPENCODE_FAKE_VCS` | string | 用於測試目的的假 VCS 提供商 | +| `OPENCODE_DISABLE_FILETIME_CHECK` | boolean | 禁用文件時間檢查以進行優化 | +| `OPENCODE_CLIENT` | string | 客戶端標識符(默認為`cli`) | +| `OPENCODE_ENABLE_EXA` | boolean | 啟用 Exa 網絡搜索工具 | +| `OPENCODE_SERVER_PASSWORD` | string | 為 `serve`/`web` 啟用基本身份驗證 | +| `OPENCODE_SERVER_USERNAME` | string | 覆蓋基本身份驗證用戶名(默認`opencode`) | +| `OPENCODE_MODELS_URL` | string | 用於獲取模型配置的自定義 URL | --- @@ -586,18 +586,18 @@ 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 響應的最大輸出令牌 | -| `OPENCODE_EXPERIMENTAL_FILEWATCHER` | 布爾 | 為整個目錄啟用文件觀察器 | -| `OPENCODE_EXPERIMENTAL_OXFMT` | 布爾 | 啟用 oxfmt 格式化程序 | -| `OPENCODE_EXPERIMENTAL_LSP_TOOL` | 布爾 | 啟用實驗性 LSP 工具 | -| `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | 布爾 | 禁用文件觀察器 | -| `OPENCODE_EXPERIMENTAL_EXA` | 布爾 | 啟用實驗性 Exa 功能 | -| `OPENCODE_EXPERIMENTAL_LSP_TY` | 布爾 | 啟用實驗性 LSP 類型檢查 | -| `OPENCODE_EXPERIMENTAL_MARKDOWN` | 布爾 | 啟用實驗性 Markdown 功能 | -| `OPENCODE_EXPERIMENTAL_PLAN_MODE` | 布爾 | 啟用計劃模式 | +| 變量 | 類型 | 描述 | +| ----------------------------------------------- | ------- | ----------------------------------- | +| `OPENCODE_EXPERIMENTAL` | boolean | 啟用所有實驗性功能 | +| `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | boolean | 啟用圖標發現 | +| `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | boolean | 在 TUI 中禁用選擇時復制 | +| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | number | bash 命令的默認超時(以毫秒為單位) | +| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | number | LLM 響應的最大輸出令牌 | +| `OPENCODE_EXPERIMENTAL_FILEWATCHER` | boolean | 為整個目錄啟用文件觀察器 | +| `OPENCODE_EXPERIMENTAL_OXFMT` | boolean | 啟用 oxfmt 格式化程序 | +| `OPENCODE_EXPERIMENTAL_LSP_TOOL` | boolean | 啟用實驗性 LSP 工具 | +| `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | boolean | 禁用文件觀察器 | +| `OPENCODE_EXPERIMENTAL_EXA` | boolean | 啟用實驗性 Exa 功能 | +| `OPENCODE_EXPERIMENTAL_LSP_TY` | boolean | 啟用實驗性 LSP 類型檢查 | +| `OPENCODE_EXPERIMENTAL_MARKDOWN` | boolean | 啟用實驗性 Markdown 功能 | +| `OPENCODE_EXPERIMENTAL_PLAN_MODE` | boolean | 啟用計劃模式 | diff --git a/packages/web/src/content/docs/zh-tw/config.mdx b/packages/web/src/content/docs/zh-tw/config.mdx index 66d119b26..ba3b1cd69 100644 --- a/packages/web/src/content/docs/zh-tw/config.mdx +++ b/packages/web/src/content/docs/zh-tw/config.mdx @@ -181,7 +181,7 @@ opencode run "Hello world" ### 伺服器 -您可以通過`server` 選項為`opencode serve` 和`opencode web` 命令配置服務器設置。 +您可以通過`opencode serve` 選項為`opencode web` 和`server` 命令配置服務器設置。 ```json title="opencode.json" { diff --git a/packages/web/src/content/docs/zh-tw/formatters.mdx b/packages/web/src/content/docs/zh-tw/formatters.mdx index 5834652b3..b47fb3470 100644 --- a/packages/web/src/content/docs/zh-tw/formatters.mdx +++ b/packages/web/src/content/docs/zh-tw/formatters.mdx @@ -15,7 +15,7 @@ opencode 附帶了多個適用於流行語言和框架的內置格式化程序� | -------------------- | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | | gofmt | .go | `gofmt` 命令可用 | | mix | .ex, .exs, .eex, .heex, .leex, .neex, .sface | `mix` 命令可用 | -| prettier | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, 和 [更多](https://prettier.io/docs/en/index.html) | `package.json` 中有 `prettier` 依賴 | +| prettier | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, 和 [更多](https://prettier.io/docs/en/index.html) | `prettier` 中有 `package.json` 依賴 | | biome | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, 和 [更多](https://biomejs.dev/) | `biome.json(c)` 配置文件 | | zig | .zig, .zon | `zig` 命令可用 | | clang-format | .c, .cpp, .h, .hpp, .ino, 和 [更多](https://clang.llvm.org/docs/ClangFormat.html) | `.clang-format` 配置文件 | @@ -34,11 +34,11 @@ opencode 附帶了多個適用於流行語言和框架的內置格式化程序� | gleam | .gleam | `gleam` 命令可用 | | nixfmt | .nix | `nixfmt` 命令可用 | | shfmt | .sh, .bash | `shfmt` 命令可用 | -| pint | .php | `composer.json` 中有 `laravel/pint` 依賴 | -| oxfmt (Experimental) | .js, .jsx, .ts, .tsx | `package.json` 中有 `oxfmt` 依賴且啟用[實驗環境變量旗標](/docs/cli/#experimental) | +| pint | .php | `laravel/pint` 中有 `composer.json` 依賴 | +| oxfmt (Experimental) | .js, .jsx, .ts, .tsx | `oxfmt` 中有 `package.json` 依賴且啟用[實驗環境變量旗標](/docs/cli/#experimental) | | ormolu | .hs | `ormolu` 命令可用 | -因此,如果您的項目的`package.json`中有`prettier`,opencode將自動使用它。 +因此,如果您的項目的`prettier`中有`package.json`,opencode將自動使用它。 --- diff --git a/packages/web/src/content/docs/zh-tw/github.mdx b/packages/web/src/content/docs/zh-tw/github.mdx index 19b8b2ece..ccee14109 100644 --- a/packages/web/src/content/docs/zh-tw/github.mdx +++ b/packages/web/src/content/docs/zh-tw/github.mdx @@ -37,7 +37,7 @@ opencode github install 2. **添加工作流程** - 將以下工作流程文件添加到存儲庫中的 `.github/workflows/opencode.yml` 中。確保在`env`中設置適當的`model`和所需的API密鑰。 + 將以下工作流程文件添加到存儲庫中的 `.github/workflows/opencode.yml` 中。確保在`model`中設置適當的`env`和所需的API密鑰。 ```yml title=".github/workflows/opencode.yml" {24,26} name: opencode diff --git a/packages/web/src/content/docs/zh-tw/ide.mdx b/packages/web/src/content/docs/zh-tw/ide.mdx index fc8304aa8..d40c71a97 100644 --- a/packages/web/src/content/docs/zh-tw/ide.mdx +++ b/packages/web/src/content/docs/zh-tw/ide.mdx @@ -1,27 +1,27 @@ --- -title: 集成開發環境 -description: VS Code、Cursor 和其他 IDE 的 opencode 擴展 +title: IDE +description: VS Code、Cursor 和其他 IDE 的 OpenCode 擴展 --- -opencode 與 VS Code、Cursor 或任何支持terminal的 IDE 集成。只需在 terminal中運行 `opencode` 即可開始。 +OpenCode 與 VS Code、Cursor 或任何支持 terminal 的 IDE 集成。只需在 terminal 中運行 `opencode` 即可開始。 --- ## 用法 -- **快速啟動**:使用 `Cmd+Esc` (Mac) 或 `Ctrl+Esc` (Windows/Linux) 在拆分terminal視圖中打開 opencode,或者聚焦現有terminal會話(如果已有terminal會話正在運行)。 -- **新會話**:使用 `Cmd+Shift+Esc` (Mac) 或 `Ctrl+Shift+Esc` (Windows/Linux) 啟動新的 opencode terminal會話,即使該會話已打開。您還可以單擊 UI 中的 opencode 按鈕。 -- **上下文感知**:自動與 opencode 共享您當前的選擇或選項卡。 +- **快速啟動**:使用 `Cmd+Esc` (Mac) 或 `Ctrl+Esc` (Windows/Linux) 在拆分 terminal 視圖中打開 OpenCode,或者聚焦現有 terminal 會話(如果已有 terminal 會話正在運行)。 +- **新會話**:使用 `Cmd+Shift+Esc` (Mac) 或 `Ctrl+Shift+Esc` (Windows/Linux) 啟動新的 OpenCode terminal 會話,即使該會話已打開。您還可以單擊 UI 中的 OpenCode 按鈕。 +- **上下文感知**:自動與 OpenCode 共享您當前的選擇或選項卡。 - **文件引用快捷方式**:使用`Cmd+Option+K` (Mac) 或`Alt+Ctrl+K` (Linux/Windows) 插入文件引用。例如,`@File#L37-42`。 --- ## 安裝 -要在 VS Code 和 Cursor、Windsurf、VSCodium 等流行分支上安裝 opencode: +要在 VS Code 和 Cursor、Windsurf、VSCodium 等流行分支上安裝 OpenCode: -1. 打開 VS 程式碼 -2. 打開集成terminal +1. 打開 VS Code +2. 打開集成 terminal 3. 運行 `opencode` - 擴展會自動安裝 另一方面,如果您想在從 TUI 運行 `/editor` 或 `/export` 時使用自己的 IDE,則需要設置 `export EDITOR="code --wait"`。 [了解更多](/docs/tui/#editor-setup)。 @@ -30,7 +30,7 @@ opencode 與 VS Code、Cursor 或任何支持terminal的 IDE 集成。只需在 ### 手動安裝 -在擴展市場中搜索 **opencode**,然後單擊 **安裝**。 +在擴展市場中搜索 **OpenCode**,然後單擊 **安裝**。 --- @@ -38,11 +38,11 @@ opencode 與 VS Code、Cursor 或任何支持terminal的 IDE 集成。只需在 如果擴展無法自動安裝: -- 確保您在集成terminal中運行`opencode`。 +- 確保您在集成 terminal 中運行`opencode`。 - 確認您的 IDE 的 CLI 已安裝: - - 對於 VS 程式碼:`code` 命令 - - 對於光標:`cursor` 命令 - - 對於風帆衝浪:`windsurf` 命令 + - 對於 VS Code:`code` 命令 + - 對於 Cursor:`cursor` 命令 + - 對於 Windsurf:`windsurf` 命令 - 對於 VSCodium:`codium` 命令 - 如果沒有,請運行 `Cmd+Shift+P` (Mac) 或 `Ctrl+Shift+P` (Windows/Linux) 並蒐索“Shell Command: Install 'code' command in PATH”(或適用於您的 IDE 的等效命令) - 確保 VS Code 有權安裝擴展 diff --git a/packages/web/src/content/docs/zh-tw/index.mdx b/packages/web/src/content/docs/zh-tw/index.mdx index 8c4f6f038..1b5eb76c6 100644 --- a/packages/web/src/content/docs/zh-tw/index.mdx +++ b/packages/web/src/content/docs/zh-tw/index.mdx @@ -7,9 +7,9 @@ import { Tabs, TabItem } from "@astrojs/starlight/components" import config from "../../../../config.mjs" export const console = config.console -[**opencode**](/) 是一個開源AI編碼代理。它可用作基於 terminal 的介面、桌面應用程式或 IDE 擴展。 +[**OpenCode**](/) 是一個開源 AI 編碼代理。它可用作基於 terminal 的介面、桌面應用程式或 IDE 擴展。 - + 讓我們開始吧。 @@ -17,9 +17,9 @@ export const console = config.console #### 先決條件 -要在 terminal中使用 opencode,您需要: +要在 terminal 中使用 OpenCode,您需要: -1. 現代terminal模擬器,例如: +1. 現代 terminal 模擬器,例如: - [WezTerm](https://wezterm.org),跨平台 - [Alacritty](https://alacritty.org),跨平台 - [Ghostty](https://ghostty.org),Linux 和 macOS @@ -31,7 +31,7 @@ export const console = config.console ## 安裝 -安裝 opencode 最簡單的方法是通過安裝腳本。 +安裝 OpenCode 最簡單的方法是通過安裝腳本。 ```bash curl -fsSL https://opencode.ai/install | bash @@ -79,7 +79,7 @@ curl -fsSL https://opencode.ai/install | bash brew install anomalyco/tap/opencode ``` - > 我們建議使用 opencode Tap 來獲取最新版本。官方 `brew install opencode` 公式由 Homebrew 團隊維護,更新頻率較低。 + > 我們建議使用 OpenCode tap 來獲取最新版本。官方 `brew install opencode` formula 由 Homebrew 團隊維護,更新頻率較低。 - **在 Arch Linux 上使用 Paru** @@ -90,7 +90,7 @@ curl -fsSL https://opencode.ai/install | bash #### Windows :::tip[Recommended: Use WSL] -為了在 Windows 上獲得最佳體驗,我們建議使用[適用於 Linux 的 Windows 子系統 (WSL)](/docs/windows-wsl)。它提供了更好的性能並與 opencode 的功能完全兼容。 +為了在 Windows 上獲得最佳體驗,我們建議使用[適用於 Linux 的 Windows 子系統 (WSL)](/docs/windows-wsl)。它提供了更好的性能並與 OpenCode 的功能完全兼容。 ::: - **使用Chocolatey** @@ -123,7 +123,7 @@ curl -fsSL https://opencode.ai/install | bash docker run -it --rm ghcr.io/anomalyco/opencode ``` -目前正在支持使用 Bun 在 Windows 上安裝 opencode。 +目前正在支持使用 Bun 在 Windows 上安裝 OpenCode。 您還可以從[Releases](https://github.com/anomalyco/opencode/releases) 獲取二進製文件。 @@ -131,10 +131,10 @@ curl -fsSL https://opencode.ai/install | bash ## 配置 -借助 opencode,您可以通過配置 API 密鑰來使用任何 LLM 提供商。 +借助 OpenCode,您可以通過配置 API 密鑰來使用任何 LLM 提供商。 如果您不熟悉使用 LLM 提供商,我們建議使用[OpenCode Zen](/docs/zen)。 -這是經過 opencode 測試和驗證的精選模型列表 +這是經過 OpenCode 測試和驗證的精選模型列表 團隊。 1. 在 TUI 中運行 `/connect` 命令,選擇 opencode,然後前往 [opencode.ai/auth](https://opencode.ai/auth)。 @@ -167,33 +167,33 @@ curl -fsSL https://opencode.ai/install | bash cd /path/to/project ``` -並運行 opencode。 +並運行 OpenCode。 ```bash opencode ``` -接下來,通過運行以下命令來初始化項目的 opencode。 +接下來,通過運行以下命令來初始化項目的 OpenCode。 ```bash frame="none" /init ``` -這將使 opencode 分析您的項目並在以下位置創建 `AGENTS.md` 文件 +這將使 OpenCode 分析您的項目並在以下位置創建 `AGENTS.md` 文件 項目根。 :::tip 您應該將項目的 `AGENTS.md` 文件提交到 Git。 ::: -這有助於 opencode 理解項目結構和編碼模式 +這有助於 OpenCode 理解項目結構和編碼模式 用過的。 --- ## 用法 -您現在已準備好使用 opencode 來處理您的項目。請隨意詢問 +您現在已準備好使用 OpenCode 來處理您的項目。請隨意詢問 任何事物! 如果您不熟悉使用 AI 編碼代理,以下是一些可能會有所幫助的示例 @@ -203,7 +203,7 @@ opencode ### 提出問題 -您可以要求 opencode 向您解釋程式碼庫。 +您可以用 OpenCode 向您解釋程式碼庫。 :::tip 使用`@`鍵模糊搜索工程中的文件。 @@ -219,11 +219,11 @@ How is authentication handled in @packages/functions/src/api/index.ts ### 添加功能 -您可以要求 opencode 向您的項目添加新功能。不過我們首先建議要求它制定一個計劃。 +您可以用 OpenCode 向您的項目添加新功能。不過我們首先建議要求它制定一個計劃。 1. **制定計劃** - opencode 有一個*計劃模式*,該模式禁用其進行更改和 + OpenCode 有一個*計劃模式*,該模式禁用其進行更改和 相反,建議*如何*實現該功能。 使用 **Tab** 鍵切換到它。您會在右下角看到一個指示符。 @@ -240,11 +240,11 @@ How is authentication handled in @packages/functions/src/api/index.ts From this screen, the user can undelete a note or permanently delete it. ``` - 您需要為 opencode 提供足夠的詳細信息以了解您想要的內容。它有幫助 + 您需要為 OpenCode 提供足夠的詳細信息以了解您想要的內容。它有幫助 就像與團隊中的初級開發人員交談一樣與它交談。 :::tip - 為 opencode 提供大量上下文和示例,以幫助其理解您的內容 + 為 OpenCode 提供大量上下文和示例,以幫助其理解您的內容 想。 ::: @@ -258,11 +258,11 @@ How is authentication handled in @packages/functions/src/api/index.ts ``` :::tip - 將圖像拖放到terminal中以將其添加到提示中。 + 將圖像拖放到 terminal 中以將其添加到提示中。 ::: - opencode 可以掃描您提供的任何圖像並將其添加到提示中。你可以 - 通過將圖像拖放到terminal中來完成此操作。 + OpenCode 可以掃描您提供的任何圖像並將其添加到提示中。你可以 + 通過將圖像拖放到 terminal 中來完成此操作。 3. **構建功能** @@ -283,7 +283,7 @@ How is authentication handled in @packages/functions/src/api/index.ts ### 做出改變 -對於更直接的更改,您可以要求 opencode 直接構建它 +對於更直接的更改,您可以要求 OpenCode 直接構建它 無需先審查計劃。 ```txt frame="none" "@packages/functions/src/settings.ts" "@packages/functions/src/notes.ts" @@ -292,14 +292,14 @@ handled in the /notes route in @packages/functions/src/notes.ts and implement the same logic in @packages/functions/src/settings.ts ``` -您需要確保提供大量詳細信息,以便 opencode 做出正確的決定 +您需要確保提供大量詳細信息,以便 OpenCode 做出正確的決定 變化。 --- ### 撤消更改 -假設您要求 opencode 進行一些更改。 +假設您要求 OpenCode 進行一些更改。 ```txt frame="none" "@packages/functions/src/api/index.ts" Can you refactor the function in @packages/functions/src/api/index.ts? @@ -312,14 +312,14 @@ Can you refactor the function in @packages/functions/src/api/index.ts? /undo ``` -opencode 現在將恢復您所做的更改並顯示您的原始消息 +OpenCode 現在將恢復您所做的更改並顯示您的原始消息 再次。 ```txt frame="none" "@packages/functions/src/api/index.ts" Can you refactor the function in @packages/functions/src/api/index.ts? ``` -從這裡您可以調整提示並要求 opencode 重試。 +從這裡您可以調整提示並要求 OpenCode 重試。 :::tip 您可以多次運行 `/undo` 以撤消多項更改。 @@ -335,7 +335,7 @@ Can you refactor the function in @packages/functions/src/api/index.ts? ## 分享 -您與 opencode 的對話可以[與您的 +您與 OpenCode 的對話可以[與您的 團隊](/docs/share)。 ```bash frame="none" @@ -348,12 +348,12 @@ Can you refactor the function in @packages/functions/src/api/index.ts? 默認情況下不共享對話。 ::: -這是帶有 opencode 的[示例對話](https://opencode.ai/s/4XP1fce5)。 +這是帶有 OpenCode 的[示例對話](https://opencode.ai/s/4XP1fce5)。 --- ## 定制 -就是這樣!您現在已經是使用 opencode 的專家了。 +就是這樣!您現在已經是使用 OpenCode 的專家了。 -要使其成為您自己的,我們建議 [選擇一個主題](/docs/themes)、[自定義按鍵綁定](/docs/keybinds)、[配置程式碼格式化程序](/docs/formatters)、[創建自定義命令](/docs/commands) 或使用 [opencode配置](/docs/config)。 +要使其成為您自己的,我們建議 [選擇一個主題](/docs/themes)、[自定義按鍵綁定](/docs/keybinds)、[配置程式碼格式化程序](/docs/formatters)、[創建自定義命令](/docs/commands) 或使用 [OpenCode 配置](/docs/config)。 diff --git a/packages/web/src/content/docs/zh-tw/lsp.mdx b/packages/web/src/content/docs/zh-tw/lsp.mdx index df351982d..5feea4db0 100644 --- a/packages/web/src/content/docs/zh-tw/lsp.mdx +++ b/packages/web/src/content/docs/zh-tw/lsp.mdx @@ -182,7 +182,7 @@ opencode 附帶了多種適用於流行語言的內置 LSP 服務器: PHP Intelephense 通過許可證密鑰提供高級功能。您可以通過將(僅)密鑰放入位於以下位置的文本文件中來提供許可證密鑰: -- 在 macOS/Linux 上:`$HOME/intelephense/licence.txt` -- 在 Windows 上:`%USERPROFILE%/intelephense/licence.txt` +- 在 macOS/Linux 上:`$HOME/intelephense/license.txt` +- 在 Windows 上:`%USERPROFILE%/intelephense/license.txt` 該文件應僅包含許可證密鑰,不包含其他內容。 diff --git a/packages/web/src/content/docs/zh-tw/models.mdx b/packages/web/src/content/docs/zh-tw/models.mdx index 195513ae1..09fdb7c72 100644 --- a/packages/web/src/content/docs/zh-tw/models.mdx +++ b/packages/web/src/content/docs/zh-tw/models.mdx @@ -3,13 +3,13 @@ title: 型號 description: 配置LLM提供者和模型。 --- -opencode 使用[AI SDK](https://ai-sdk.dev/) 和[models.dev](https://models.dev) 來支持**75+ LLM 提供商**,並且它支持運行本地模型。 +OpenCode 使用[AI SDK](https://ai-sdk.dev/) 和[Models.dev](https://models.dev) 來支持**75+ LLM 提供商**,並且它支持運行本地模型。 --- ## 供應商 -默認情況下會預加載大多數流行的提供商。如果您已通過 `/connect` 命令添加了提供商的憑據,那麼它們將在您啟動 opencode 時可用。 +默認情況下會預加載大多數流行的提供商。如果您已通過 `/connect` 命令添加了提供商的憑據,那麼它們將在您啟動 OpenCode 時可用。 了解有關[提供者](/docs/providers) 的更多信息。 @@ -35,21 +35,21 @@ opencode 使用[AI SDK](https://ai-sdk.dev/) 和[models.dev](https://models.dev) 然而,既擅長生成程式碼又擅長工具調用的只有少數。 -以下是與 opencode 配合良好的幾個模型,排名不分先後。 (這不是詳盡的列表,也不一定是最新的): +以下是與 OpenCode 配合良好的幾個模型,排名不分先後。 (這不是詳盡的列表,也不一定是最新的): - GPT 5.2 -- GPT 5.1 法典 -- 近距離工作4.5 -- 克勞德十四行詩 4.5 -- 極小極大M2.1 -- 雙子座 3 專業版 +- GPT 5.1 Codex +- Claude Opus 4.5 +- Claude Sonnet 4.5 +- Minimax M2.1 +- Gemini 3 Pro --- ## 設置默認值 要將其中之一設置為默認模型,您可以在您的 -opencode配置。 +OpenCode 配置。 ```json title="opencode.json" {3} { @@ -101,7 +101,7 @@ opencode配置。 ``` 在這裡,我們為兩個內置模型配置全局設置:`gpt-5`(通過 `openai` 提供商訪問時)和 `claude-sonnet-4-20250514`(通過 `anthropic` 提供商訪問時)。 -內置提供商和型號名稱可以在[models.dev](https://models.dev) 上找到。 +內置提供商和型號名稱可以在[Models.dev](https://models.dev) 上找到。 您還可以為您正在使用的任何代理配置這些選項。代理配置會覆蓋此處的所有全局選項。 [了解更多](/docs/agents/#additional)。 @@ -137,11 +137,11 @@ opencode配置。 ## 變體 -許多型號支持具有不同配置的多種變體。 opencode 附帶了流行提供商的內置默認變體。 +許多型號支持具有不同配置的多種變體。OpenCode 附帶了流行提供商的內置默認變體。 ### 內置變體 -opencode 附帶了許多提供商的默認變體: +OpenCode 附帶了許多提供商的默認變體: **Anthropic**: @@ -203,11 +203,11 @@ opencode 附帶了許多提供商的默認變體: ## 加載模型 -當 opencode 啟動時,它會按以下優先順序檢查模型: +當 OpenCode 啟動時,它會按以下優先順序檢查模型: 1. `--model` 或 `-m` 命令行標誌。格式與配置文件中的相同:`provider_id/model_id`。 -2. opencode 配置中的模型列表。 +2. OpenCode 配置中的模型列表。 ```json title="opencode.json" { diff --git a/packages/web/src/content/docs/zh-tw/providers.mdx b/packages/web/src/content/docs/zh-tw/providers.mdx index 2cefb395a..8c21f5cf1 100644 --- a/packages/web/src/content/docs/zh-tw/providers.mdx +++ b/packages/web/src/content/docs/zh-tw/providers.mdx @@ -1,31 +1,30 @@ --- -title: 供應商 -description: 使用 opencode 中的任何 LLM 提供商。 +title: 提供商 +description: 使用 OpenCode 中的任何 LLM 提供商。 --- import config from "../../../../config.mjs" export const console = config.console -opencode 使用[AI SDK](https://ai-sdk.dev/) 和[models.dev](https://models.dev) 來支持**75+ LLM 提供商**,並且它支持運行本地模型。 +OpenCode 使用 [AI SDK](https://ai-sdk.dev/) 和 [Models.dev](https://models.dev) 來支持 **75+ LLM 提供商**,並且它支持運行本地模型。 要添加提供商,您需要: 1. 使用 `/connect` 命令添加提供商的 API 密鑰。 -2. 在 opencode 配置中配置提供商。 +2. 在 OpenCode 配置中配置提供商。 --- -### 證書 +### 憑證 當您使用 `/connect` 命令添加提供商的 API 密鑰時,它們會被存儲 -在`~/.local/share/opencode/auth.json`。 +在 `~/.local/share/opencode/auth.json`。 --- ### 配置 -您可以通過 opencode 中的 `provider` 部分自定義提供商 -配置。 +您可以在 OpenCode 配置的 `provider` 部分自定義提供商。 --- @@ -50,8 +49,8 @@ opencode 使用[AI SDK](https://ai-sdk.dev/) 和[models.dev](https://models.dev) ## OpenCode Zen -OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 -經過測試和驗證,可以與 opencode 良好配合。 [了解更多](/docs/zen)。 +OpenCode Zen 是 OpenCode 團隊提供的模型列表,這些模型已被 +經過測試和驗證,可以與 OpenCode 良好配合。 [了解更多](/docs/zen)。 :::tip 如果您是新手,我們建議您從 OpenCode Zen 開始。 @@ -63,7 +62,7 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 /connect ``` -2. 登錄,添加您的帳單詳細信息,然後復制您的 API 密鑰。 +2. 登錄,添加您的帳單詳細信息,然後複製您的 API 密鑰。 3. 粘貼您的 API 密鑰。 @@ -74,13 +73,13 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 └ enter ``` -4. 在 TUI 中運行 `/models` 以查看我們推薦的型號列表。 +4. 在 TUI 中運行 `/models` 以查看我們推薦的模型列表。 ```txt /models ``` -它的工作方式與 opencode 中的任何其他提供商一樣,並且完全可以選擇使用。 +它的工作方式與 OpenCode 中的任何其他提供商一樣,並且完全可以選擇使用。 --- @@ -95,11 +94,11 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 --- -### 302.艾伊 +### 302.AI -1. 前往[302.AI控制台](https://302.ai/),創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [302.AI 控制台](https://302.ai/),創建一個帳戶並生成一個 API 密鑰。 -2. 運行`/connect`命令並蒐索**302.AI**。 +2. 運行 `/connect` 命令並搜尋 **302.AI**。 ```txt /connect @@ -114,7 +113,7 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 └ enter ``` -4. 執行`/models`命令選擇型號。 +4. 執行 `/models` 命令選擇模型。 ```txt /models @@ -122,11 +121,11 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 --- -### 亞馬遜基岩 +### Amazon Bedrock -要將 Amazon Bedrock 與 opencode 結合使用: +要將 Amazon Bedrock 與 OpenCode 結合使用: -1. 前往 Amazon Bedrock 控制台中的 **模型目錄** 並請求 +1. 前往 Amazon Bedrock 控制台中的 **Model catalog** 並請求 訪問您想要的模型。 :::tip @@ -176,9 +175,9 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 ``` **可用選項:** - - `region` - AWS 區域(例如`us-east-1`、`eu-west-1`) + - `region` - AWS 區域(例如 `us-east-1`、`eu-west-1`) - `profile` - 來自 `~/.aws/credentials` 的 AWS 命名配置文件 - - `endpoint` - VPC terminal節點的自定義terminal節點 URL(通用 `baseURL` 選項的別名) + - `endpoint` - 用於 VPC 端點的自定義端點 URL(通用 `baseURL` 選項的別名) :::tip 配置文件選項優先於環境變量。 @@ -186,7 +185,7 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 #### 高級:VPC 端點 - 如果您使用 Bedrock 的 VPC terminal節點: + 如果您使用 Bedrock 的 VPC 端點: ```json title="opencode.json" { @@ -204,33 +203,33 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 ``` :::note - `endpoint` 選項是通用 `baseURL` 選項的別名,使用 AWS 特定術語。如果同時指定`endpoint` 和`baseURL`,則`endpoint` 優先。 + `endpoint` 選項是通用 `baseURL` 選項的別名,使用 AWS 特定術語。如果同時指定 `endpoint` 和 `baseURL`,則 `endpoint` 優先。 ::: #### 認證方式 - - **`AWS_ACCESS_KEY_ID` / `AWS_SECRET_ACCESS_KEY`**:創建 IAM 用戶並在 AWS 控制台中生成訪問密鑰 - - **`AWS_PROFILE`**:使用`~/.aws/credentials` 中的命名配置文件。首先配置`aws configure --profile my-profile`或`aws sso login` + - **`AWS_ACCESS_KEY_ID` / `AWS_SECRET_ACCESS_KEY`**:創建 IAM 用戶並在 AWS Console 中生成訪問密鑰 + - **`AWS_PROFILE`**:使用 `~/.aws/credentials` 中的命名配置文件。首先配置 `aws configure --profile my-profile` 或 `aws sso login` - **`AWS_BEARER_TOKEN_BEDROCK`**:從 Amazon Bedrock 控制台生成長期 API 密鑰 - - **`AWS_WEB_IDENTITY_TOKEN_FILE` / `AWS_ROLE_ARN`**:適用於 EKS IRSA(服務賬戶的 IAM 角色)或具有 OIDC 聯合的其他 Kubernetes 環境。使用服務帳戶註釋時,這些環境變量由 Kubernetes 自動注入。 + - **`AWS_WEB_IDENTITY_TOKEN_FILE` / `AWS_ROLE_ARN`**:適用於 EKS IRSA(服務帳戶的 IAM 角色)或具有 OIDC 聯合的其他 Kubernetes 環境。使用服務帳戶註釋時,這些環境變量由 Kubernetes 自動注入。 #### 認證優先級 Amazon Bedrock 使用以下身份驗證優先級: - 1. **不記名令牌** - `AWS_BEARER_TOKEN_BEDROCK` 環境變量或來自 `/connect` 命令的令牌 - 2. **AWS 憑證鏈** - 配置文件、訪問密鑰、共享憑證、IAM 角色、Web 身份令牌 (EKS IRSA)、實例元數據 + 1. **Bearer Token** - `AWS_BEARER_TOKEN_BEDROCK` 環境變量或來自 `/connect` 命令的令牌 + 2. **AWS Credential Chain** - 配置文件、訪問密鑰、共享憑證、IAM 角色、Web 身份令牌 (EKS IRSA)、實例元數據 :::note - 設置不記名令牌(通過 `/connect` 或 `AWS_BEARER_TOKEN_BEDROCK`)時,它優先於所有 AWS 憑證方法(包括配置的配置文件)。 + 當設置 Bearer Token 時(通過 `/connect` 或 `AWS_BEARER_TOKEN_BEDROCK`),它優先於所有 AWS 憑證方法(包括配置的配置文件)。 ::: -3. 運行`/models`命令選擇所需的型號。 +3. 運行 `/models` 命令選擇所需的模型。 ```txt /models ``` :::note -對於自定義推理配置文件,請在密鑰中使用模型和提供商名稱,並將 `id` 屬性設置為 arn。這確保了正確的緩存: +對於自定義推理配置文件,請在鍵中使用模型和提供商名稱,並將 `id` 屬性設置為 arn。這確保了正確的緩存: ```json title="opencode.json" { @@ -279,34 +278,34 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 ``` :::info -[Anthropic](https://anthropic.com) 不正式支持在 opencode 中使用您的 Claude Pro/Max 訂閱。 +[Anthropic](https://anthropic.com) 不正式支持在 OpenCode 中使用您的 Claude Pro/Max 訂閱。 ::: ##### 使用 API 密鑰 -如果您沒有 Pro/Max 訂閱,您還可以選擇 **創建 API 密鑰**。它還會打開您的瀏覽器並要求您登錄 Anthropic 並為您提供一個可以粘貼到terminal 中的程式碼。 +如果您沒有 Pro/Max 訂閱,您還可以選擇 **Create an API Key**。它還會打開您的瀏覽器並要求您登錄 Anthropic 並為您提供一個可以粘貼到終端機中的代碼。 -或者,如果您已有 API 密鑰,則可以選擇 **手動輸入 API 密鑰** 並將其粘貼到您的terminal中。 +或者,如果您已有 API 密鑰,則可以選擇 **Manually enter API Key** 並將其粘貼到您的終端機中。 --- -### Azure 開放AI +### Azure OpenAI :::note -如果遇到“抱歉,但我無法協助該請求”錯誤,請嘗試將 Azure 資源中的內容篩選器從 **DefaultV2** 更改為 **Default**。 +如果遇到 "I'm sorry, but I cannot assist with that request" 錯誤,請嘗試將 Azure 資源中的內容篩選器從 **DefaultV2** 更改為 **Default**。 ::: -1. 轉到 [Azure 門戶](https://portal.azure.com/) 並創建 **Azure OpenAI** 資源。你需要: - - **資源名稱**:這將成為您的 API 端點 (`https://RESOURCE_NAME.openai.azure.com/`) 的一部分 - - **API 密鑰**:來自您的資源的 `KEY 1` 或 `KEY 2` +1. 轉到 [Azure portal](https://portal.azure.com/) 並創建 **Azure OpenAI** 資源。您需要: + - **Resource name**:這將成為您的 API 端點 (`https://RESOURCE_NAME.openai.azure.com/`) 的一部分 + - **API key**:來自您的資源的 `KEY 1` 或 `KEY 2` -2. 轉到[Azure AI Foundry](https://ai.azure.com/) 並部署模型。 +2. 轉到 [Azure AI Foundry](https://ai.azure.com/) 並部署模型。 :::note - 部署名稱必須與模型名稱匹配,opencode 才能正常工作。 + 部署名稱必須與模型名稱匹配,OpenCode 才能正常工作。 ::: -3. 運行 `/connect` 命令並蒐索 **Azure**。 +3. 運行 `/connect` 命令並搜尋 **Azure**。 ```txt /connect @@ -341,19 +340,19 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 --- -### Azure 認知服務 +### Azure Cognitive Services -1. 轉到 [Azure 門戶](https://portal.azure.com/) 並創建 **Azure OpenAI** 資源。你需要: - - **資源名稱**:這將成為您的 API 端點 (`https://AZURE_COGNITIVE_SERVICES_RESOURCE_NAME.cognitiveservices.azure.com/`) 的一部分 - - **API 密鑰**:來自您的資源的 `KEY 1` 或 `KEY 2` +1. 轉到 [Azure portal](https://portal.azure.com/) 並創建 **Azure OpenAI** 資源。您需要: + - **Resource name**:這將成為您的 API 端點 (`https://AZURE_COGNITIVE_SERVICES_RESOURCE_NAME.cognitiveservices.azure.com/`) 的一部分 + - **API key**:來自您的資源的 `KEY 1` 或 `KEY 2` -2. 轉到[Azure AI Foundry](https://ai.azure.com/) 並部署模型。 +2. 轉到 [Azure AI Foundry](https://ai.azure.com/) 並部署模型。 :::note - 部署名稱必須與模型名稱匹配,opencode 才能正常工作。 + 部署名稱必須與模型名稱匹配,OpenCode 才能正常工作。 ::: -3. 運行 `/connect` 命令並蒐索 **Azure 認知服務**。 +3. 運行 `/connect` 命令並搜尋 **Azure Cognitive Services**。 ```txt /connect @@ -390,9 +389,9 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 ### Baseten -1. 前往[Baseten](https://app.baseten.co/),創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [Baseten](https://app.baseten.co/),創建一個帳戶並生成一個 API 密鑰。 -2. 運行`/connect`命令並蒐索**Baseten**。 +2. 運行 `/connect` 命令並搜尋 **Baseten**。 ```txt /connect @@ -407,7 +406,7 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 └ enter ``` -4. 執行`/models`命令選擇型號。 +4. 執行 `/models` 命令選擇模型。 ```txt /models @@ -415,11 +414,11 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 --- -### 大腦 +### Cerebras -1. 前往[Cerebras Console](https://inference.cerebras.ai/),創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [Cerebras console](https://inference.cerebras.ai/),創建一個帳戶並生成一個 API 密鑰。 -2. 運行 `/connect` 命令並蒐索 **Cerebras**。 +2. 運行 `/connect` 命令並搜尋 **Cerebras**。 ```txt /connect @@ -434,7 +433,7 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 └ enter ``` -4. 運行`/models`命令選擇型號,如*Qwen 3 Coder 480B*。 +4. 運行 `/models` 命令選擇模型,如 _Qwen 3 Coder 480B_。 ```txt /models @@ -442,20 +441,20 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被 --- -### Cloudflare AI 網關 +### Cloudflare AI Gateway -Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthropic、Workers AI 等的模型。使用[統一計費](https://developers.cloudflare.com/ai-gateway/features/unified-billing/),您不需要為每個提供商提供單獨的 API 密鑰。 +Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthropic、Workers AI 等的模型。使用 [Unified Billing](https://developers.cloudflare.com/ai-gateway/features/unified-billing/),您不需要為每個提供商提供單獨的 API 密鑰。 -1. 前往[Cloudflare 儀表板](https://dash.cloudflare.com/),導航至 **AI** > **AI Gateway**,然後創建一個新網關。 +1. 前往 [Cloudflare dashboard](https://dash.cloudflare.com/),導航至 **AI** > **AI Gateway**,然後創建一個新網關。 -2. 將您的帳戶 ID 和網關 ID 設置為環境變量。 +2. 將您的 Account ID 和 Gateway ID 設置為環境變量。 ```bash title="~/.bash_profile" export CLOUDFLARE_ACCOUNT_ID=your-32-character-account-id export CLOUDFLARE_GATEWAY_ID=your-gateway-id ``` -3. 運行 `/connect` 命令並蒐索 **Cloudflare AI Gateway**。 +3. 運行 `/connect` 命令並搜尋 **Cloudflare AI Gateway**。 ```txt /connect @@ -476,13 +475,13 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro export CLOUDFLARE_API_TOKEN=your-api-token ``` -5. 執行`/models`命令選擇型號。 +5. 執行 `/models` 命令選擇模型。 ```txt /models ``` - 您還可以通過 opencode 配置添加模型。 + 您還可以通過 OpenCode 配置添加模型。 ```json title="opencode.json" { @@ -500,11 +499,11 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro --- -### 皮質 +### Cortecs -1. 前往[Cortecs 控制台](https://cortecs.ai/),創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [Cortecs console](https://cortecs.ai/),創建一個帳戶並生成一個 API 密鑰。 -2. 運行 `/connect` 命令並蒐索 **Cortecs**。 +2. 運行 `/connect` 命令並搜尋 **Cortecs**。 ```txt /connect @@ -519,7 +518,7 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro └ enter ``` -4. 運行`/models`命令選擇一個模型,如*Kimi K2 Instruct*。 +4. 運行 `/models` 命令選擇一個模型,如 _Kimi K2 Instruct_。 ```txt /models @@ -527,11 +526,11 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro --- -### 深度搜索 +### DeepSeek -1. 前往[DeepSeek 控制台](https://platform.deepseek.com/),創建一個帳戶,然後單擊“**創建新的 API 密鑰**”。 +1. 前往 [DeepSeek console](https://platform.deepseek.com/),創建一個帳戶,然後單擊 **Create new API key**。 -2. 運行`/connect`命令並蒐索**DeepSeek**。 +2. 運行 `/connect` 命令並搜尋 **DeepSeek**。 ```txt /connect @@ -554,11 +553,11 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro --- -### 深層基礎設施 +### Deep Infra -1. 前往[DeepInfra dashboard](https://deepinfra.com/dash),創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [Deep Infra dashboard](https://deepinfra.com/dash),創建一個帳戶並生成一個 API 密鑰。 -2. 運行 `/connect` 命令並蒐索 **Deep Infra**。 +2. 運行 `/connect` 命令並搜尋 **Deep Infra**。 ```txt /connect @@ -573,7 +572,7 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro └ enter ``` -4. 執行`/models`命令選擇型號。 +4. 執行 `/models` 命令選擇模型。 ```txt /models @@ -581,17 +580,17 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro --- -### 韌體 +### Firmware -1. 前往[Firmware dashboard](https://app.firmware.ai/signup),創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [Firmware dashboard](https://app.firmware.ai/signup),創建一個帳戶並生成一個 API 密鑰。 -2. 運行`/connect`命令並蒐索**固件**。 +2. 運行 `/connect` 命令並搜尋 **Firmware**。 ```txt /connect ``` -3. 輸入您的固件 API 密鑰。 +3. 輸入您的 Firmware API 密鑰。 ```txt ┌ API key @@ -600,7 +599,7 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro └ enter ``` -4. 執行`/models`命令選擇型號。 +4. 執行 `/models` 命令選擇模型。 ```txt /models @@ -608,11 +607,11 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro --- -### 煙花AI +### Fireworks AI -1. 前往[Fireworks AI 控制台](https://app.fireworks.ai/),創建一個帳戶,然後單擊“**創建 API 密鑰**”。 +1. 前往 [Fireworks AI console](https://app.fireworks.ai/),創建一個帳戶,然後單擊 **Create API Key**。 -2. 運行 `/connect` 命令並蒐索 **Fireworks AI**。 +2. 運行 `/connect` 命令並搜尋 **Fireworks AI**。 ```txt /connect @@ -627,7 +626,7 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro └ enter ``` -4. 運行`/models`命令選擇一個模型,如*Kimi K2 Instruct*。 +4. 運行 `/models` 命令選擇一個模型,如 _Kimi K2 Instruct_。 ```txt /models @@ -635,7 +634,7 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro --- -### 亞搏體育app二人組 +### GitLab Duo GitLab Duo 通過 GitLab 的 Anthropic 代理提供具有本機工具調用功能的 AI 驅動的代理聊天。 @@ -657,14 +656,14 @@ GitLab Duo 通過 GitLab 的 Anthropic 代理提供具有本機工具調用功� #### 使用 OAuth(推薦) - 選擇**OAuth**,您的瀏覽器將打開以進行授權。 + 選擇 **OAuth**,您的瀏覽器將打開以進行授權。 - #### 使用個人訪問令牌 - 1. 前往[GitLab 用戶設置 > 訪問令牌](https://gitlab.com/-/user_settings/personal_access_tokens) - 2. 單擊**添加新令牌** - 3. 名稱:`OpenCode`,範圍:`api` - 4. 複製令牌(以`glpat-`開頭) - 5. 在 terminal中輸入 + #### 使用 Personal Access Token + 1. 前往 [GitLab User Settings > Access Tokens](https://gitlab.com/-/user_settings/personal_access_tokens) + 2. 單擊 **Add new token** + 3. Name:`OpenCode`,Scopes:`api` + 4. 複製令牌(以 `glpat-` 開頭) + 5. 在終端機中輸入它 3. 運行 `/models` 命令以查看可用模型。 @@ -673,21 +672,20 @@ GitLab Duo 通過 GitLab 的 Anthropic 代理提供具有本機工具調用功� ``` 提供三種基於 Claude 的模型: - - **duo-chat-haiku-4-5**(默認)- 快速任務的快速響應 + - **duo-chat-haiku-4-5**(Default)- 快速任務的快速響應 - **duo-chat-sonnet-4-5** - 大多數工作流程的平衡性能 - **duo-chat-opus-4-5** - 最有能力進行複雜分析 :::note -如果您不想,也可以指定“GITLAB_TOKEN”環境變量 -將令牌存儲在 opencode auth 存儲中。 +如果您不想將令牌存儲在 OpenCode auth 存儲中,也可以指定 `GITLAB_TOKEN` 環境變量。 ::: -##### 自託管 GitLab +##### Self-Hosted GitLab -:::note[compliance 筆記] -opencode 使用小型模型來執行某些 AI 任務,例如生成會話標題。 -默認情況下,它配置為使用 gpt-5-nano,由 Zen 託管。鎖定 opencode -要僅使用您自己的 GitLab 託管實例,請將以下內容添加到您的 +:::note[compliance note] +OpenCode 使用小型模型來執行某些 AI 任務,例如生成會話標題。 +默認情況下,它配置為使用 gpt-5-nano,由 Zen 託管。若要鎖定 OpenCode +僅使用您自己的 GitLab 託管實例,請將以下內容添加到您的 `opencode.json` 文件。還建議禁用會話共享。 ```json @@ -724,19 +722,19 @@ export GITLAB_TOKEN=glpat-... :::note 您的 GitLab 管理員必須啟用以下功能: -1. [雙代理平台](https://docs.gitlab.com/user/gitlab_duo/turn_on_off/) 用於用戶、組或實例 -2. 功能標誌(通過 Rails 控制台): +1. [Duo Agent Platform](https://docs.gitlab.com/user/gitlab_duo/turn_on_off/) 用於用戶、組或實例 +2. Feature flags(通過 Rails console): - `agent_platform_claude_code` - `third_party_agents_enabled` ::: -##### 適用於自託管實例的 OAuth +##### OAuth for Self-Hosted instances -為了使 Oauth 適用於您的自託管實例,您需要創建 -一個新的應用程式(設置→應用程式) +為了使 OAuth 適用於您的自託管實例,您需要創建 +一個新的應用程式(Settings → Applications),使用 回調 URL `http://127.0.0.1:8080/callback` 和以下範圍: -- api(代表您訪問API) +- api(代表您訪問 API) - read_user(讀取您的個人信息) - read_repository(允許對存儲庫進行只讀訪問) @@ -748,9 +746,9 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here 更多文檔請參見 [opencode-gitlab-auth](https://www.npmjs.com/package/@gitlab/opencode-gitlab-auth) 主頁。 -##### 配置 +##### Configuration -通過`opencode.json`定制: +通過 `opencode.json` 定制: ```json title="opencode.json" { @@ -769,9 +767,9 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here } ``` -##### GitLab API 工具(可選,但強烈推薦) +##### GitLab API Tools(可選,但強烈推薦) -要訪問 GitLab 工具(合併請求、問題、管道、CI/CD 等): +要訪問 GitLab 工具(merge requests、issues、pipelines、CI/CD 等): ```json title="opencode.json" { @@ -784,24 +782,22 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here --- -### GitHub 副駕駛 +### GitHub Copilot -要將 GitHub Copilot 訂閱與 opencode 結合使用: +要將 GitHub Copilot 訂閱與 OpenCode 結合使用: :::note -某些型號可能需要 [Pro+ -訂閱](https://github.com/features/copilot/plans) 來使用。 - -某些模型需要在您的[GitHub Copilot 設置](https://docs.github.com/en/copilot/how-tos/use-ai-models/configure-access-to-ai-models#setup-for-individual-use) 中手動啟用。 +某些模型可能需要 [Pro+ +subscription](https://github.com/features/copilot/plans) 來使用。 ::: -1. 運行 `/connect` 命令並蒐索 GitHub Copilot。 +1. 運行 `/connect` 命令並搜尋 GitHub Copilot。 ```txt /connect ``` -2. 導航至[github.com/login/device](https://github.com/login/device) 並輸入程式碼。 +2. 導航至 [github.com/login/device](https://github.com/login/device) 並輸入代碼。 ```txt ┌ Login with GitHub Copilot @@ -813,7 +809,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here └ Waiting for authorization... ``` -3. 現在運行`/models`命令來選擇您想要的型號。 +3. 現在運行 `/models` 命令來選擇您想要的模型。 ```txt /models @@ -821,12 +817,12 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here --- -### 谷歌頂點AI +### Google Vertex AI -要將 Google Vertex AI 與 opencode 結合使用: +要將 Google Vertex AI 與 OpenCode 結合使用: 1. 前往 Google Cloud Console 中的 **Model Garden** 並檢查 - 您所在地區提供的型號。 + 您所在地區提供的模型。 :::note 您需要有一個啟用了 Vertex AI API 的 Google Cloud 項目。 @@ -834,9 +830,9 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here 2. 設置所需的環境變量: - `GOOGLE_CLOUD_PROJECT`:您的 Google Cloud 項目 ID - - `VERTEX_LOCATION`(可選):Vertex AI 的區域(默認為`global`) + - `VERTEX_LOCATION`(可選):Vertex AI 的區域(默認為 `global`) - 身份驗證(選擇一項): - - `GOOGLE_APPLICATION_CREDENTIALS`: Path to your service account JSON key file + - `GOOGLE_APPLICATION_CREDENTIALS`:Path to your service account JSON key file - Authenticate using gcloud CLI: `gcloud auth application-default login` 在運行 opencode 時設置它們。 @@ -854,10 +850,10 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here ``` :::tip -`global` 區域無需額外成本即可提高可用性並減少錯誤。使用區域端點(例如`us-central1`)來滿足數據駐留要求。 [了解更多](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-partner-models#regional_and_global_endpoints) +`global` 區域無需額外成本即可提高可用性並減少錯誤。使用區域端點(例如 `us-central1`)來滿足數據駐留要求。 [了解更多](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-partner-models#regional_and_global_endpoints) ::: -3. 運行`/models`命令選擇所需的型號。 +3. 運行 `/models` 命令選擇所需的模型。 ```txt /models @@ -865,11 +861,11 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here --- -### 格羅克 +### Groq -1. 前往[Groq Console](https://console.groq.com/),單擊“**創建 API 密鑰**”,然後復制密鑰。 +1. 前往 [Groq console](https://console.groq.com/),單擊 **Create API Key**,然後複製密鑰。 -2. 運行`/connect`命令並蒐索Groq。 +2. 運行 `/connect` 命令並搜尋 Groq。 ```txt /connect @@ -884,7 +880,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here └ enter ``` -4. 運行`/models`命令選擇您想要的。 +4. 運行 `/models` 命令選擇您想要的。 ```txt /models @@ -892,19 +888,19 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here --- -### 抱臉 +### Hugging Face -[Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try again later.That’s all we know.](https://huggingface.co/docs/inference-providers) 提供對超過 17 個提供商支持的開放模型的訪問。 +[Hugging Face Inference Providers](https://huggingface.co/docs/inference-providers) 提供對超過 17 個提供商支持的開放模型的訪問。 -1. 前往[Hugging Face settings](https://huggingface.co/settings/tokens/new?ownUserPermissions=inference.serverless.write&tokenType=fineGrained) 創建一個具有調用推理提供商權限的令牌。 +1. 前往 [Hugging Face settings](https://huggingface.co/settings/tokens/new?ownUserPermissions=inference.serverless.write&tokenType=fineGrained) 創建一個具有調用 Inference Providers 權限的令牌。 -2. 運行 `/connect` 命令並蒐索 **Hugging Face**。 +2. 運行 `/connect` 命令並搜尋 **Hugging Face**。 ```txt /connect ``` -3. 輸入您的擁抱臉標記。 +3. 輸入您的 Hugging Face 令牌。 ```txt ┌ API key @@ -923,11 +919,11 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here ### Helicone -[Helicone](https://helicone.ai) 是一個 LLM 可觀察性平台,可為您的 AI 應用程式提供日誌記錄、監控和分析。 Helicone AI Gateway 根據模型自動將您的請求路由到適當的提供商。 +[Helicone](https://helicone.ai) 是一個 LLM 可觀察性平台,可為您的 AI 應用程式提供日誌記錄、監控和分析。 The Helicone AI Gateway 根據模型自動將您的請求路由到適當的提供商。 -1. 前往[Helicone](https://helicone.ai),創建一個帳戶,並從您的儀表板生成 API 密鑰。 +1. 前往 [Helicone](https://helicone.ai),創建一個帳戶,並從您的儀表板生成 API 密鑰。 -2. 運行 `/connect` 命令並蒐索 **Helicone**。 +2. 運行 `/connect` 命令並搜尋 **Helicone**。 ```txt /connect @@ -942,19 +938,19 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here └ enter ``` -4. 執行`/models`命令選擇型號。 +4. 執行 `/models` 命令選擇模型。 ```txt /models ``` -有關更多提供商和高級功能(例如緩存和速率限制),請查看[Helicone docs](https://docs.helicone.ai)。 +有關更多提供商和高級功能(例如緩存和速率限制),請查看 [Helicone documentation](https://docs.helicone.ai)。 -#### 可選配置 +#### Optional Configs -如果您發現 Helicone 的功能或模型未通過opencode自動配置,您始終可以自行配置。 +如果您發現 Helicone 的功能或模型未通過 OpenCode 自動配置,您始終可以自行配置。 -這是[Helicone 的模型目錄](https://helicone.ai/models),您將需要它來獲取要添加的模型的 ID。 +這是 [Helicone's Model Directory](https://helicone.ai/models),您將需要它來獲取要添加的模型的 ID。 ```jsonc title="~/.config/opencode/opencode.jsonc" { @@ -980,7 +976,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here } ``` -#### 自定義標頭 +#### Custom Headers Helicone 支持緩存、用戶跟踪和會話管理等功能的自定義標頭。使用 `options.headers` 將它們添加到您的提供商配置中: @@ -1003,9 +999,9 @@ Helicone 支持緩存、用戶跟踪和會話管理等功能的自定義標頭� } ``` -##### 會話跟踪 +##### Session tracking -Helicone 的 [會議](https://docs.helicone.ai/features/sessions) 功能可讓您將相關的 LLM 請求分組在一起。使用 [opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session) 插件自動將每個 opencode 對話記錄為 Helicone 中的會話。 +Helicone 的 [Sessions](https://docs.helicone.ai/features/sessions) 功能可讓您將相關的 LLM 請求分組在一起。使用 [opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session) 插件自動將每個 OpenCode 對話記錄為 Helicone 中的會話。 ```bash npm install -g opencode-helicone-session @@ -1019,24 +1015,24 @@ npm install -g opencode-helicone-session } ``` -該插件將 `Helicone-Session-Id` 和 `Helicone-Session-Name` 標頭注入您的請求中。在 Helicone 的會話頁面中,您將看到每個 opencode 對話都列為單獨的會話。 +該插件將 `Helicone-Session-Id` 和 `Helicone-Session-Name` 標頭注入您的請求中。在 Helicone 的 Sessions 頁面中,您將看到每個 OpenCode 對話都列為單獨的會話。 -##### 常見 Helicone 接頭 +##### Common Helicone headers -| 標題 | 描述 | -| -------------------------- | ----------------------------------------------------- | -| `Helicone-Cache-Enabled` | 啟用響應緩存 (`true`/`false`) | -| `Helicone-User-Id` | 按用戶跟踪指標 | -| `Helicone-Property-[Name]` | 添加自定義屬性(例如`Helicone-Property-Environment`) | -| `Helicone-Prompt-Id` | 將請求與提示版本相關聯 | +| Header | Description | +| -------------------------- | ------------------------------------------------------ | +| `Helicone-Cache-Enabled` | 啟用響應緩存 (`true`/`false`) | +| `Helicone-User-Id` | 按用戶跟踪指標 | +| `Helicone-Property-[Name]` | 添加自定義屬性(例如 `Helicone-Property-Environment`) | +| `Helicone-Prompt-Id` | 將請求與提示版本相關聯 | -有關所有可用標頭,請參閱[Helicone 頭目錄](https://docs.helicone.ai/helicone-headers/header-directory)。 +有關所有可用標頭,請參閱 [Helicone Header Directory](https://docs.helicone.ai/helicone-headers/header-directory)。 --- -### 調用.cpp +### llama.cpp -您可以通過[llama.cpp 的](https://github.com/ggml-org/llama.cpp) llama-server實用程序配置opencode以使用本地模型 +您可以通過 [llama.cpp's](https://github.com/ggml-org/llama.cpp) llama-server 實用程序配置 OpenCode 以使用本地模型 ```json title="opencode.json" "llama.cpp" {5, 6, 8, 10-15} { @@ -1068,17 +1064,17 @@ npm install -g opencode-helicone-session - `npm` 指定用於此提供商的包。這裡,`@ai-sdk/openai-compatible` 用於任何 OpenAI 兼容的 API。 - `name` 是 UI 中提供商的顯示名稱。 - `options.baseURL` 是本地服務器的端點。 -- `models` 是模型 ID 與其配置的映射。型號名稱將顯示在型號選擇列表中。 +- `models` 是模型 ID 與其配置的映射。模型名稱將顯示在模型選擇列表中。 --- -### IO網絡 +### IO.NET IO.NET 提供了 17 種針對各種用例進行優化的模型: -1. 前往[IO.NET console](https://ai.io.net/),創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [IO.NET console](https://ai.io.net/),創建一個帳戶並生成一個 API 密鑰。 -2. 運行`/connect`命令並蒐索**IO.NET**。 +2. 運行 `/connect` 命令並搜尋 **IO.NET**。 ```txt /connect @@ -1093,7 +1089,7 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型: └ enter ``` -4. 執行`/models`命令選擇型號。 +4. 執行 `/models` 命令選擇模型。 ```txt /models @@ -1101,9 +1097,9 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型: --- -### LM工作室 +### LM Studio -您可以通過 LM Studio 配置 opencode 以使用本地模型。 +您可以通過 LM Studio 配置 OpenCode 以使用本地模型。 ```json title="opencode.json" "lmstudio" {5, 6, 8, 10-14} { @@ -1131,17 +1127,17 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型: - `npm` 指定用於此提供商的包。這裡,`@ai-sdk/openai-compatible` 用於任何 OpenAI 兼容的 API。 - `name` 是 UI 中提供商的顯示名稱。 - `options.baseURL` 是本地服務器的端點。 -- `models` 是模型 ID 與其配置的映射。型號名稱將顯示在型號選擇列表中。 +- `models` 是模型 ID 與其配置的映射。模型名稱將顯示在模型選擇列表中。 --- -### 登月AI +### Moonshot AI 要使用 Moonshot AI 中的 Kimi K2: -1. 前往[Moonshot AI console](https://platform.moonshot.ai/console),創建一個帳戶,然後單擊“**創建 API 密鑰**”。 +1. 前往 [Moonshot AI console](https://platform.moonshot.ai/console),創建一個帳戶,然後單擊 **Create API key**。 -2. 運行 `/connect` 命令並蒐索 **Moonshot AI**。 +2. 運行 `/connect` 命令並搜尋 **Moonshot AI**。 ```txt /connect @@ -1156,7 +1152,7 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型: └ enter ``` -4. 運行`/models`命令選擇*Kimi K2*。 +4. 運行 `/models` 命令選擇 _Kimi K2_。 ```txt /models @@ -1164,11 +1160,11 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型: --- -### 最小最大 +### MiniMax -1. 前往[MiniMax API 控制台](https://platform.minimax.io/login),創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [MiniMax API Console](https://platform.minimax.io/login),創建一個帳戶並生成一個 API 密鑰。 -2. 運行 `/connect` 命令並蒐索 **MiniMax**。 +2. 運行 `/connect` 命令並搜尋 **MiniMax**。 ```txt /connect @@ -1183,7 +1179,7 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型: └ enter ``` -4. 運行`/models`命令選擇型號,如*M2.1*。 +4. 運行 `/models` 命令選擇模型,如 _M2.1_。 ```txt /models @@ -1191,17 +1187,17 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型: --- -### Nebius 代幣工廠 +### Nebius Token Factory -1. 前往[Nebius 令牌工廠控制台](https://tokenfactory.nebius.com/),創建一個帳戶,然後單擊“**添加密鑰**”。 +1. 前往 [Nebius Token Factory console](https://tokenfactory.nebius.com/),創建一個帳戶,然後單擊 **Add Key**。 -2. 運行`/connect`命令並蒐索**Nebius令牌工廠**。 +2. 運行 `/connect` 命令並搜尋 **Nebius Token Factory**。 ```txt /connect ``` -3. 輸入您的 Nebius 令牌工廠 API 密鑰。 +3. 輸入您的 Nebius Token Factory API 密鑰。 ```txt ┌ API key @@ -1210,7 +1206,7 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型: └ enter ``` -4. 運行`/models`命令選擇一個模型,如*Kimi K2 Instruct*。 +4. 運行 `/models` 命令選擇一個模型,如 _Kimi K2 Instruct_。 ```txt /models @@ -1218,12 +1214,12 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型: --- -### 成為 +### Ollama -您可以通過 Ollama 配置 opencode 以使用本地模型。 +您可以通過 Ollama 配置 OpenCode 以使用本地模型。 :::tip -Ollama 可以自動為 opencode 配置自身。詳情請參閱[Ollama 集成文檔](https://docs.ollama.com/integrations/opencode)。 +Ollama 可以自動為 OpenCode 配置自身。詳情請參閱 [Ollama integration docs](https://docs.ollama.com/integrations/opencode)。 ::: ```json title="opencode.json" "ollama" {5, 6, 8, 10-14} @@ -1252,25 +1248,25 @@ Ollama 可以自動為 opencode 配置自身。詳情請參閱[Ollama 集成文� - `npm` 指定用於此提供商的包。這裡,`@ai-sdk/openai-compatible` 用於任何 OpenAI 兼容的 API。 - `name` 是 UI 中提供商的顯示名稱。 - `options.baseURL` 是本地服務器的端點。 -- `models` 是模型 ID 與其配置的映射。型號名稱將顯示在型號選擇列表中。 +- `models` 是模型 ID 與其配置的映射。模型名稱將顯示在模型選擇列表中。 :::tip -如果工具調用不起作用,請嘗試增加 Ollama 中的`num_ctx`。從 16k - 32k 左右開始。 +如果工具調用不起作用,請嘗試增加 Ollama 中的 `num_ctx`。從 16k - 32k 左右開始。 ::: --- -### 奧拉馬雲 +### Ollama Cloud -要將 Ollama Cloud 與 opencode 結合使用: +要將 Ollama Cloud 與 OpenCode 結合使用: -1. 前往[https://llama.com/](https://ollama.com/) 並登錄或創建帳戶。 +1. 前往 [https://ollama.com/](https://ollama.com/) 並登錄或創建帳戶。 -2. 導航到 **設置** > **密鑰**,然後單擊 **添加 API 密鑰** 以生成新的 API 密鑰。 +2. 導航到 **Settings** > **Keys**,然後單擊 **Add API Key** 以生成新的 API 密鑰。 -3. 複製 API 密鑰以在 opencode 中使用。 +3. 複製 API 密鑰以在 OpenCode 中使用。 -4. 運行 `/connect` 命令並蒐索 **Ollama Cloud**。 +4. 運行 `/connect` 命令並搜尋 **Ollama Cloud**。 ```txt /connect @@ -1285,13 +1281,13 @@ Ollama 可以自動為 opencode 配置自身。詳情請參閱[Ollama 集成文� └ enter ``` -6. **重要**:在opencode中使用雲模型之前,必須將模型信息拉取到本地: +6. **Important**:在 OpenCode 中使用雲模型之前,您必須將模型信息拉取到本地: ```bash ollama pull gpt-oss:20b-cloud ``` -7. 運行 `/models` 命令以選擇您的 Ollama Cloud 型號。 +7. 運行 `/models` 命令以選擇您的 Ollama Cloud 模型。 ```txt /models @@ -1299,9 +1295,9 @@ Ollama 可以自動為 opencode 配置自身。詳情請參閱[Ollama 集成文� --- -### 開放AI +### OpenAI -我們建議註冊[ChatGPT Plus 或 Pro](https://chatgpt.com/pricing)。 +我們建議註冊 [ChatGPT Plus or Pro](https://chatgpt.com/pricing)。 1. 註冊後,運行 `/connect` 命令並選擇 OpenAI。 @@ -1328,23 +1324,23 @@ Ollama 可以自動為 opencode 配置自身。詳情請參閱[Ollama 集成文� ##### 使用 API 密鑰 -如果您已有 API 密鑰,可以選擇 **手動輸入 API 密鑰** 並將其粘貼到您的terminal中。 +如果您已有 API 密鑰,可以選擇 **Manually enter API Key** 並將其粘貼到您的終端機中。 --- ### OpenCode Zen -OpenCode Zen 是 opencode 團隊提供的經過測試和驗證的模型列表。 [了解更多](/docs/zen)。 +OpenCode Zen 是 OpenCode 團隊提供的經過測試和驗證的模型列表。 [了解更多](/docs/zen)。 -1. 登錄 **<a href={console}>OpenCode Zen</a>** 並單擊 **創建 API 密鑰**。 +1. 登錄 **<a href={console}>OpenCode Zen</a>** 並單擊 **Create API Key**。 -2. 運行 `/connect` 命令並蒐索 **OpenCode Zen**。 +2. 運行 `/connect` 命令並搜尋 **OpenCode Zen**。 ```txt /connect ``` -3. 輸入您的 opencode API 密鑰。 +3. 輸入您的 OpenCode API 密鑰。 ```txt ┌ API key @@ -1353,7 +1349,7 @@ OpenCode Zen 是 opencode 團隊提供的經過測試和驗證的模型列表。 └ enter ``` -4. 運行`/models`命令選擇型號,如*Qwen 3 Coder 480B*。 +4. 運行 `/models` 命令選擇模型,如 _Qwen 3 Coder 480B_。 ```txt /models @@ -1361,11 +1357,11 @@ OpenCode Zen 是 opencode 團隊提供的經過測試和驗證的模型列表。 --- -### 開放路由器 +### OpenRouter -1. 前往[OpenRouter dashboard](https://openrouter.ai/settings/keys),單擊“**創建 API 密鑰**”,然後復制密鑰。 +1. 前往 [OpenRouter dashboard](https://openrouter.ai/settings/keys),單擊 **Create API Key**,然後複製密鑰。 -2. 運行`/connect`命令並蒐索OpenRouter。 +2. 運行 `/connect` 命令並搜尋 OpenRouter。 ```txt /connect @@ -1380,13 +1376,13 @@ OpenCode Zen 是 opencode 團隊提供的經過測試和驗證的模型列表。 └ enter ``` -4. OpenRouter默認預加載了多種型號,運行`/models`命令選擇您想要的型號。 +4. 許多 OpenRouter 模型是默認預加載的,運行 `/models` 命令選擇您想要的模型。 ```txt /models ``` - 您還可以通過 opencode 配置添加其他模型。 + 您還可以通過 OpenCode 配置添加其他模型。 ```json title="opencode.json" {6} { @@ -1401,7 +1397,7 @@ OpenCode Zen 是 opencode 團隊提供的經過測試和驗證的模型列表。 } ``` -5. 您還可以通過 opencode 配置自定義它們。這是指定提供商的示例 +5. 您還可以通過 OpenCode 配置自定義它們。這是指定提供商的示例 ```json title="opencode.json" { @@ -1425,17 +1421,17 @@ OpenCode Zen 是 opencode 團隊提供的經過測試和驗證的模型列表。 --- -### SAPAI核心 +### SAP AI Core SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、Meta、Mistral 和 AI21 的 40 多個模型的訪問。 -1. 轉到[SAP BTP 駕駛艙](https://account.hana.ondemand.com/),導航到 SAP AI Core 服務實例,然後創建服務密鑰。 +1. 轉到您的 [SAP BTP Cockpit](https://account.hana.ondemand.com/),導航到您的 SAP AI Core 服務實例,然後創建一個服務密鑰。 :::tip - 服務密鑰是一個包含`clientid`、`clientsecret`、`url` 和`serviceurls.AI_API_URL` 的JSON 對象。您可以在 BTP Cockpit 的 **服務** > **實例和訂閱** 下找到您的 AI Core 實例。 + 服務密鑰是一個包含 `clientid`、`clientsecret`、`url` 和 `serviceurls.AI_API_URL` 的 JSON 對象。您可以在 BTP Cockpit 的 **Services** > **Instances and Subscriptions** 下找到您的 AI Core 實例。 ::: -2. 運行 `/connect` 命令並蒐索 **SAP AI Core**。 +2. 運行 `/connect` 命令並搜尋 **SAP AI Core**。 ```txt /connect @@ -1450,7 +1446,7 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M └ enter ``` - 或者設置`AICORE_SERVICE_KEY`環境變量: + 或者設置 `AICORE_SERVICE_KEY` 環境變量: ```bash AICORE_SERVICE_KEY='{"clientid":"...","clientsecret":"...","url":"...","serviceurls":{"AI_API_URL":"..."}}' opencode @@ -1472,7 +1468,7 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M 這些設置是可選的,應根據您的 SAP AI Core 設置進行配置。 ::: -5. 運行 `/models` 命令從 40 多個可用型號中進行選擇。 +5. 運行 `/models` 命令從 40 多個可用模型中進行選擇。 ```txt /models @@ -1480,11 +1476,11 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M --- -### OVHcloud AI 端點 +### OVHcloud AI Endpoints -1. 前往[OVH雲面板](https://ovh.com/manager)。導航到 `Public Cloud` 部分,`AI & Machine Learning` > `AI Endpoints`,然後在 `API Keys` 選項卡中單擊 **創建新的 API 密鑰**。 +1. 前往 [OVHcloud panel](https://ovh.com/manager)。導航到 `Public Cloud` 部分,`AI & Machine Learning` > `AI Endpoints`,然後在 `API Keys` 選項卡中單擊 **Create a new API key**。 -2. 運行 `/connect` 命令並蒐索 **OVHcloud AI Endpoints**。 +2. 運行 `/connect` 命令並搜尋 **OVHcloud AI Endpoints**。 ```txt /connect @@ -1499,7 +1495,7 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M └ enter ``` -4. 運行`/models`命令選擇型號,如*gpt-oss-120b*。 +4. 運行 `/models` 命令選擇模型,如 _gpt-oss-120b_。 ```txt /models @@ -1507,13 +1503,13 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M --- -### 斯卡威 +### Scaleway -要將 [Scaleway 生成 API](https://www.scaleway.com/en/docs/generative-apis/) 與 opencode 一起使用: +要將 [Scaleway Generative APIs](https://www.scaleway.com/en/docs/generative-apis/) 與 OpenCode 一起使用: -1. 前往[Scaleway 控制台 IAM 設置](https://console.scaleway.com/iam/api-keys) 生成新的 API 密鑰。 +1. 前往 [Scaleway Console IAM settings](https://console.scaleway.com/iam/api-keys) 生成新的 API 密鑰。 -2. 運行 `/connect` 命令並蒐索 **Scaleway**。 +2. 運行 `/connect` 命令並搜尋 **Scaleway**。 ```txt /connect @@ -1528,7 +1524,7 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M └ enter ``` -4. 運行`/models`命令選擇模型,如*devstral-2-123b-instruct-2512*或*gpt-oss-120b*。 +4. 運行 `/models` 命令選擇模型,如 _devstral-2-123b-instruct-2512_ 或 _gpt-oss-120b_。 ```txt /models @@ -1536,11 +1532,11 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M --- -### 一起AI +### Together AI -1. 前往[Together AI console](https://api.together.ai),創建一個帳戶,然後單擊“**添加密鑰**”。 +1. 前往 [Together AI console](https://api.together.ai),創建一個帳戶,然後單擊 **Add Key**。 -2. 運行 `/connect` 命令並蒐索 **Together AI**。 +2. 運行 `/connect` 命令並搜尋 **Together AI**。 ```txt /connect @@ -1555,7 +1551,7 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M └ enter ``` -4. 運行`/models`命令選擇一個模型,如*Kimi K2 Instruct*。 +4. 運行 `/models` 命令選擇一個模型,如 _Kimi K2 Instruct_。 ```txt /models @@ -1563,11 +1559,11 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M --- -### 威尼斯AI +### Venice AI -1. 前往[Venice AI console](https://venice.ai),創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [Venice AI console](https://venice.ai),創建一個帳戶並生成一個 API 密鑰。 -2. 運行`/connect`命令並蒐索**Venice AI**。 +2. 運行 `/connect` 命令並搜尋 **Venice AI**。 ```txt /connect @@ -1582,7 +1578,7 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M └ enter ``` -4. 運行`/models`命令選擇型號,如*Llama 3.3 70B*。 +4. 運行 `/models` 命令選擇模型,如 _Llama 3.3 70B_。 ```txt /models @@ -1590,13 +1586,13 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M --- -### VercelAI網關 +### Vercel AI Gateway -Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、Google、xAI 等的模型。型號按標價提供,不加價。 +Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、Google、xAI 等的模型。模型按標價提供,不加價。 -1. 前往[Vercel dashboard](https://vercel.com/),導航至 **AI Gateway** 選項卡,然後單擊 **API 密鑰** 以創建新的 API 密鑰。 +1. 前往 [Vercel dashboard](https://vercel.com/),導航至 **AI Gateway** 選項卡,然後單擊 **API keys** 以創建新的 API 密鑰。 -2. 運行 `/connect` 命令並蒐索 **Vercel AI Gateway**。 +2. 運行 `/connect` 命令並搜尋 **Vercel AI Gateway**。 ```txt /connect @@ -1611,13 +1607,13 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G └ enter ``` -4. 執行`/models`命令選擇型號。 +4. 執行 `/models` 命令選擇模型。 ```txt /models ``` -您還可以通過 opencode 配置自定義模型。以下是指定提供者路由順序的示例。 +您還可以通過 OpenCode 配置自定義模型。以下是指定提供者路由順序的示例。 ```json title="opencode.json" { @@ -1638,19 +1634,19 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G 一些有用的路由選項: -| 選項 | 描述 | -| ------------------- | ---------------------------- | -| `order` | 提供者嘗試順序 | -| `only` | 限制特定提供商 | -| `zeroDataRetention` | 僅使用零數據保留政策的提供商 | +| Option | Description | +| ------------------- | ---------------------------------------------------- | +| `order` | Provider sequence to try | +| `only` | Restrict to specific providers | +| `zeroDataRetention` | Only use providers with zero data retention policies | --- -### 人工智慧 +### xAI -1. 前往[xAI控制台](https://console.x.ai/),創建一個帳戶並生成一個 API 密鑰。 +1. 前往 [xAI console](https://console.x.ai/),創建一個帳戶並生成一個 API 密鑰。 -2. 運行`/connect`命令並蒐索**xAI**。 +2. 運行 `/connect` 命令並搜尋 **xAI**。 ```txt /connect @@ -1665,7 +1661,7 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G └ enter ``` -4. 運行`/models`命令選擇一個模型,如*Grok Beta*。 +4. 運行 `/models` 命令選擇一個模型,如 _Grok Beta_。 ```txt /models @@ -1673,17 +1669,17 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G --- -### 扎艾 +### Z.AI -1. 前往[Z.AI API控制台](https://z.ai/manage-apikey/apikey-list),創建一個帳戶,然後單擊“**創建新的 API 密鑰**”。 +1. 前往 [Z.AI API console](https://z.ai/manage-apikey/apikey-list),創建一個帳戶,然後單擊 **Create a new API key**。 -2. 運行`/connect`命令並蒐索**Z.AI**。 +2. 運行 `/connect` 命令並搜尋 **Z.AI**。 ```txt /connect ``` - 如果您訂閱了 **GLM 編碼計劃**,請選擇 **Z.AI 編碼計劃**。 + 如果您訂閱了 **GLM Coding Plan**,請選擇 **Z.AI Coding Plan**。 3. 輸入您的 Z.AI API 密鑰。 @@ -1694,7 +1690,7 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G └ enter ``` -4. 運行`/models`命令選擇*GLM-4.7*等模型。 +4. 運行 `/models` 命令選擇 _GLM-4.7_ 等模型。 ```txt /models @@ -1702,11 +1698,11 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G --- -### 多路復用器 +### ZenMux -1. 前往[ZenMux 儀表板](https://zenmux.ai/settings/keys),單擊“**創建 API 密鑰**”,然後復制密鑰。 +1. 前往 [ZenMux dashboard](https://zenmux.ai/settings/keys),單擊 **Create API Key**,然後複製密鑰。 -2. 運行`/connect`命令並蒐索ZenMux。 +2. 運行 `/connect` 命令並搜尋 ZenMux。 ```txt /connect @@ -1727,7 +1723,7 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G /models ``` - 您還可以通過 opencode 配置添加其他模型。 + 您還可以通過 OpenCode 配置添加其他模型。 ```json title="opencode.json" {6} { @@ -1744,15 +1740,15 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G --- -## 定制提供商 +## Custom provider -要添加 `/connect` 命令中未列出的任何 **OpenAI 兼容** 提供商: +要添加 `/connect` 命令中未列出的任何 **OpenAI-compatible** 提供商: :::tip -您可以將任何與 OpenAI 兼容的提供商與 opencode 結合使用。大多數現代AI提供商都提供與 OpenAI 兼容的 API。 +您可以將任何與 OpenAI 兼容的提供商與 OpenCode 結合使用。大多數現代 AI 提供商都提供與 OpenAI 兼容的 API。 ::: -1. 運行 `/connect` 命令並向下滾動到 **其他**。 +1. 運行 `/connect` 命令並向下滾動到 **Other**。 ```bash $ /connect @@ -1819,8 +1815,8 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G 以下是配置選項: - **npm**:要使用的 AI SDK 包,`@ai-sdk/openai-compatible` 用於 OpenAI 兼容提供商 - - **名稱**:UI 中的顯示名稱。 - - **型號**:可用型號。 + - **name**:UI 中的顯示名稱。 + - **models**:可用模型。 - **options.baseURL**:API 端點 URL。 - **options.apiKey**:如果不使用身份驗證,可以選擇設置 API 密鑰。 - **options.headers**:可選擇設置自定義標頭。 @@ -1831,9 +1827,9 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G --- -##### 例子 +##### Example -以下是設置`apiKey`、`headers` 和模型`limit` 選項的示例。 +以下是設置 `apiKey`、`headers` 和模型 `limit` 選項的示例。 ```json title="opencode.json" {9,11,17-20} { @@ -1865,25 +1861,25 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G 配置詳情: -- **apiKey**:使用`env`變量語法[了解更多](/docs/config#env-vars)設置。 -- ** headers **:隨每個請求發送的自定義標頭。 +- **apiKey**:使用 `env` 變量語法 [了解更多](/docs/config#env-vars) 設置。 +- **headers**:隨每個請求發送的自定義標頭。 - **limit.context**:模型接受的最大輸入標記。 - **limit.output**:模型可以生成的最大令牌。 -`limit` 字段允許 opencode 了解您還剩下多少上下文。標準提供商會自動從 models.dev 中提取這些內容。 +`limit` 字段允許 OpenCode 了解您還剩下多少上下文。標準提供商會自動從 models.dev 中提取這些內容。 --- -## 故障排除 +## Troubleshooting 如果您在配置提供商時遇到問題,請檢查以下內容: -1. **檢查身份驗證設置**:運行 `opencode auth list` 以查看憑據是否 +1. **Check the auth setup**:運行 `opencode auth list` 以查看憑據是否 提供商的配置已添加到您的配置中。 這不適用於 Amazon Bedrock 等依賴環境變量進行身份驗證的提供商。 -2. 對於自定義提供商,請檢查 opencode 配置並: - - 確保 `/connect` 命令中使用的提供商 ID 與 opencode 配置中的 ID 匹配。 +2. 對於自定義提供商,請檢查 OpenCode 配置並: + - 確保 `/connect` 命令中使用的提供商 ID 與 OpenCode 配置中的 ID 匹配。 - 正確的 npm 包用於提供商。例如,對 Cerebras 使用 `@ai-sdk/cerebras`。對於所有其他 OpenAI 兼容提供商,請使用 `@ai-sdk/openai-compatible`。 - 檢查 `options.baseURL` 字段中使用了正確的 API 端點。 diff --git a/packages/web/src/content/docs/zh-tw/rules.mdx b/packages/web/src/content/docs/zh-tw/rules.mdx index 52494777c..218fd3c78 100644 --- a/packages/web/src/content/docs/zh-tw/rules.mdx +++ b/packages/web/src/content/docs/zh-tw/rules.mdx @@ -130,7 +130,7 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills ### 使用 opencode.json -推薦的方法是在`opencode.json`中使用`instructions`字段: +推薦的方法是在`instructions`中使用`opencode.json`字段: ```json title="opencode.json" { diff --git a/packages/web/src/content/docs/zh-tw/skills.mdx b/packages/web/src/content/docs/zh-tw/skills.mdx index 977d0c76e..eb608fb0b 100644 --- a/packages/web/src/content/docs/zh-tw/skills.mdx +++ b/packages/web/src/content/docs/zh-tw/skills.mdx @@ -25,7 +25,7 @@ opencode 搜索這些位置: ## 了解發現 對於項目本地路徑,opencode 將從當前工作目錄開始,直到到達 git 工作樹。 -它加載 `.opencode/` 中任何匹配的 `skills/*/SKILL.md` 以及一路上任何匹配的 `.claude/skills/*/SKILL.md` 或 `.agents/skills/*/SKILL.md`。 +它加載 `skills/*/SKILL.md` 中任何匹配的 `.opencode/` 以及一路上任何匹配的 `.claude/skills/*/SKILL.md` 或 `.agents/skills/*/SKILL.md`。 全局定義也從`~/.config/opencode/skills/*/SKILL.md`、`~/.claude/skills/*/SKILL.md` 和`~/.agents/skills/*/SKILL.md` 加載。 diff --git a/packages/web/src/content/docs/zh-tw/troubleshooting.mdx b/packages/web/src/content/docs/zh-tw/troubleshooting.mdx index 7398f1a92..8293f41d0 100644 --- a/packages/web/src/content/docs/zh-tw/troubleshooting.mdx +++ b/packages/web/src/content/docs/zh-tw/troubleshooting.mdx @@ -45,7 +45,7 @@ opencode Desktop 在後台運行本地 opencode 服務器(`opencode-cli` sidec - 完全退出並重新啟動應用程式。 - 如果應用程式顯示錯誤屏幕,請單擊“**重新啟動**”並複制錯誤詳細信息。 -- 僅限 macOS:`opencode` 菜單 -> **重新加載 Webview**(如果 UI 為空白/凍結,則有幫助)。 +- 僅限 macOS:`OpenCode` 菜單 -> **重新加載 Webview**(如果 UI 為空白/凍結,則有幫助)。 --- diff --git a/packages/web/src/content/docs/zh-tw/tui.mdx b/packages/web/src/content/docs/zh-tw/tui.mdx index 449245258..b64ada84c 100644 --- a/packages/web/src/content/docs/zh-tw/tui.mdx +++ b/packages/web/src/content/docs/zh-tw/tui.mdx @@ -1,13 +1,13 @@ --- -title: 途易 -description: 使用 opencode terminal用戶介面。 +title: TUI +description: 使用 OpenCode terminal 用戶介面。 --- import { Tabs, TabItem } from "@astrojs/starlight/components" -opencode 提供了一個交互式terminal介面或 TUI,供您與LLM一起處理項目。 +OpenCode 提供了一個交互式 terminal 介面或 TUI,供您與 LLM 一起處理項目。 -運行 opencode 會啟動當前目錄的 TUI。 +運行 OpenCode 會啟動當前目錄的 TUI。 ```bash opencode @@ -43,7 +43,7 @@ How is auth handled in @packages/functions/src/api/index.ts? --- -## bash 命令 +## Bash 命令 以 `!` 開始一條消息以運行 shell 命令。 @@ -57,7 +57,7 @@ How is auth handled in @packages/functions/src/api/index.ts? ## 命令 -使用 opencode TUI 時,您可以鍵入 `/` 後跟命令名稱來快速執行操作。例如: +使用 OpenCode TUI 時,您可以鍵入 `/` 後跟命令名稱來快速執行操作。例如: ```bash frame="none" /help @@ -71,7 +71,7 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` ### connect -將提供商添加到 opencode。允許您從可用的提供商中進行選擇並添加其 API 密鑰。 +將提供商添加到 OpenCode。允許您從可用的提供商中進行選擇並添加其 API 密鑰。 ```bash frame="none" /connect @@ -117,7 +117,7 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` ### exit -退出 opencode。 _別名_:`/quit`、`/q` +退出 OpenCode。 _別名_:`/quit`、`/q` ```bash frame="none" /exit @@ -336,12 +336,12 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` 流行的編輯器選項包括: -- `code` - Visual Studio 程式碼 -- `cursor` - 光標 -- `windsurf` - 風帆衝浪 +- `code` - Visual Studio Code +- `cursor` - Cursor +- `windsurf` - Windsurf - `nvim` - Neovim 編輯器 -- `vim` - 我來編輯了 -- `nano` - 納米編輯器 +- `vim` - Vim 編輯器 +- `nano` - Nano 編輯器 - `notepad` - Windows 記事本 - `subl` - Sublime Text @@ -355,7 +355,7 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x` ## 配置 -您可以通過 opencode 配置文件自定義 TUI 行為。 +您可以通過 OpenCode 配置文件自定義 TUI 行為。 ```json title="opencode.json" { |
