fix(docs): locale translations

This commit is contained in:
Adam
2026-02-10 07:11:13 -06:00
parent 19ad7ad809
commit 4c4e30cd71
351 changed files with 3744 additions and 3765 deletions

View File

@@ -61,7 +61,7 @@ $ opencode upgrade 0.15.31
- 文件搜索
- 文件關閉
- 文件列表
- 應用程幫助
- 應用程幫助
- 項目初始化
- 工具詳細信息
- 思維塊

View File

@@ -3,13 +3,13 @@ title: ACP 支持
description: 在任何 ACP 兼容編輯器中使用 opencode。
---
opencode 支持 [代理客戶端協議](https://agentclientprotocol.com) 或 (ACP),允許您直接在兼容的編輯器和 IDE 中使用它。
opencode 支持 [Agent Client Protocol](https://agentclientprotocol.com) 或 (ACP),允許您直接在兼容的編輯器和 IDE 中使用它。
:::tip
有關支持 ACP 的編輯器和工具的列表,請查看[非加太進程進度報告](https://zed.dev/blog/acp-progress-report#available-now)。
有關支持 ACP 的編輯器和工具的列表,請查看[ACP progress report](https://zed.dev/blog/acp-progress-report#available-now)。
:::
ACP 是一種開放協議,用於標準化碼編輯器和 AI 編碼代理之間的通信。
ACP 是一種開放協議,用於標準化程式碼編輯器和 AI 編碼代理之間的通信。
---
@@ -23,9 +23,9 @@ ACP 是一種開放協議,用於標準化代碼編輯器和 AI 編碼代理之
---
### 澤德
### Zed
添加到您的[澤德](https://zed.dev)配置(`~/.config/zed/settings.json`)
添加到您的[Zed](https://zed.dev)配置(`~/.config/zed/settings.json`)
```json title="~/.config/zed/settings.json"
{
@@ -86,9 +86,9 @@ ACP 是一種開放協議,用於標準化代碼編輯器和 AI 編碼代理之
---
### 前衛
### Avante
添加到您的[前衛](https://github.com/yetone/avante.nvim)配置:
添加到您的[Avante](https://github.com/yetone/avante.nvim)配置:
```lua
{
@@ -119,9 +119,9 @@ ACP 是一種開放協議,用於標準化代碼編輯器和 AI 編碼代理之
---
### 代碼伴侶.nvim
### CodeCompanion.nvim
要將 opencode 用作 [代碼伴侶.nvim](https://github.com/olimorris/CodeCompanion.nvim) 中的 ACP 代理,請將以下內容添加到 Neovim 配置中:
要將 opencode 用作 [CodeCompanion.nvim](https://github.com/olimorris/CodeCompanion.nvim) 中的 ACP 代理,請將以下內容添加到 Neovim 配置中:
```lua
require("codecompanion").setup({
@@ -142,13 +142,13 @@ require("codecompanion").setup({
## 支持
opencode 通過 ACP 的工作方式與在終端中的工作方式相同。支持所有功能:
opencode 通過 ACP 的工作方式與在 terminal 中的工作方式相同。支持所有功能:
:::note
目前不支持某些內置斜杠命令,例如 `/undo` 和 `/redo`。
:::
- 內置工具(文件操作、終端命令等)
- 內置工具(文件操作、terminal 命令等)
- 自定義工具和斜杠命令
- 在 opencode 配置中配置的 MCP 服務器
- `AGENTS.md` 的項目特定規則

View File

@@ -1,12 +1,12 @@
---
title: 代理商
title: Agents
description: 配置和使用專門的代理。
---
代理是專門的人工智能助手,可以針對特定任務和工作流程進行配置。它們允許您創建具有自定義提示、模型和工具訪問權限的專用工具。
代理是專門的AI助手,可以針對特定任務和工作流程進行配置。它們允許您創建具有自定義提示、模型和工具訪問權限的專用工具。
:::tip
使用計劃代理來分析碼並審查建議,而無需進行任何碼更改。
使用計劃代理來分析程式碼並審查建議,而無需進行任何程式碼更改。
:::
您可以在會話期間在代理之間切換,或使用 `@` 提及來調用它們。
@@ -64,7 +64,7 @@ _模式_`primary`
- `file edits`:所有寫入、修補和編輯
- `bash`:所有 bash 命令
當您希望 LLM 分析碼、建議更改或創建計劃而不對碼庫進行任何實際修改時,此代理非常有用。
當您希望 LLM 分析程式碼、建議更改或創建計劃而不對程式碼庫進行任何實際修改時,此代理非常有用。
---
@@ -80,7 +80,7 @@ _模式_`subagent`
_模式_`subagent`
用於探索碼庫的快速只讀代理。無法修改文件。當您需要按模式快速查找文件、搜索碼中的關鍵字或回答有關碼庫的問題時,請使用此功能。
用於探索程式碼庫的快速只讀代理。無法修改文件。當您需要按模式快速查找文件、搜索程式碼中的關鍵字或回答有關程式碼庫的問題時,請使用此功能。
---
@@ -177,7 +177,7 @@ _模式_`primary`
---
### 降價
### Markdown
您還可以使用 Markdown 文件定義代理。將它們放入:
@@ -255,7 +255,7 @@ Markdown 文件名成為代理名稱。例如,`review.md` 創建`review` 代
溫度值的範圍通常為 0.0 到 1.0
- **0.0-0.2**:非常集中且確定的響應,非常適合碼分析和規劃
- **0.0-0.2**:非常集中且確定的響應,非常適合程式碼分析和規劃
- **0.3-0.5**:具有一定創造力的平衡響應,適合一般開發任務
- **0.6-1.0**:更有創意和多樣化的反應,有助於頭腦風暴和探索
@@ -598,7 +598,7 @@ Only analyze code and suggest changes.
### 顏色
使用 `color` 選項自定義代理在 UI 中的視覺外觀。這會影響代理在面中的顯示方式。
使用 `color` 選項自定義代理在 UI 中的視覺外觀。這會影響代理在面中的顯示方式。
使用有效的十六進制顏色(例如`#FF5733`)或主題顏色:`primary`、`secondary`、`accent`、`success`、`warning`、`error`、`info`。
@@ -637,7 +637,7 @@ Only analyze code and suggest changes.
### 額外的
您在代理配置中指定的任何其他選項都將作為模型選項**直接**傳遞給提供程序。這允許您使用特定於提供商的功能和參數。
您在代理配置中指定的任何其他選項都將作為模型選項**直接**傳遞給提供。這允許您使用特定於提供商的功能和參數。
例如,使用 OpenAI 的推理模型,您可以控制推理工作:
@@ -686,7 +686,7 @@ opencode agent create
- **構建代理**:啟用所有工具的完整開發工作
- **規劃代理**:分析規劃,不做改動
- **審查代理**:具有隻讀訪問權限和文檔工具的碼審查
- **審查代理**:具有隻讀訪問權限和文檔工具的程式碼審查
- **調試代理**:專注於啟用 bash 和讀取工具的調查
- **文檔代理**:使用文件操作但不使用系統命令的文檔編寫
@@ -697,7 +697,7 @@ opencode agent create
以下是一些您可能會覺得有用的示例代理。
:::tip
您有想要分享的經紀人嗎? [提交 PR](https://github.com/anomalyco/opencode)。
您有想要分享的代理嗎? [提交 PR](https://github.com/anomalyco/opencode)。
:::
---

View File

@@ -1,5 +1,5 @@
---
title: 命令行
title: 命令行
description: opencode CLI 選項和命令。
---
@@ -21,7 +21,7 @@ opencode run "Explain how closures work in JavaScript"
### tui
啟動 opencode 終端用戶面。
啟動 opencode terminal用戶面。
```bash
opencode [project]
@@ -60,7 +60,7 @@ opencode agent [command]
### attach
終端連接到通過 `serve` 或 `web` 命令啟動的已運行的 opencode 後端服務器。
terminal連接到通過 `serve` 或 `web` 命令啟動的已運行的 opencode 後端服務器。
```bash
opencode attach [url]
@@ -119,19 +119,19 @@ opencode auth [command]
#### login
opencode 由 [模型.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` 文件。
---
#### list
列出憑證文件中存儲的所有經過身份驗證的提供程序
列出憑證文件中存儲的所有經過身份驗證的提供
```bash
opencode auth list
@@ -147,7 +147,7 @@ opencode auth ls
#### logout
通過從憑據文件中清除提供程序,將您從提供程序中註銷。
通過從憑據文件中清除提供,將您從提供中註銷。
```bash
opencode auth logout
@@ -284,11 +284,11 @@ opencode mcp debug <name>
opencode models [provider]
```
此命令以 `provider/model` 格式顯示您配置的提供程序中可用的所有模型。
此命令以 `provider/model` 格式顯示您配置的提供中可用的所有模型。
這對於確定[你的配置](/docs/config/) 中使用的確切模型名稱很有用。
您可以選擇傳遞提供程序 ID 以按該提供程序篩選模型。
您可以選擇傳遞提供 ID 以按該提供篩選模型。
```bash
opencode models anthropic
@@ -301,7 +301,7 @@ opencode models anthropic
| `--refresh` | 從 models.dev 刷新模型緩存 |
| `--verbose` | 使用更詳細的模型輸出(包括成本等元數據) |
使用`--refresh`標誌來更新緩存的模型列表。當新模型已添加到提供程序並且您希望在 opencode 中查看它們時,這非常有用。
使用`--refresh`標誌來更新緩存的模型列表。當新模型已添加到提供並且您希望在 opencode 中查看它們時,這非常有用。
```bash
opencode models --refresh
@@ -450,13 +450,13 @@ opencode import https://opncd.ai/s/abc123
### web
使用 Web 面啟動無頭 opencode 服務器。
使用 Web 面啟動無頭 opencode 服務器。
```bash
opencode web
```
這將啟動 HTTP 服務器並打開 Web 瀏覽器以通過 Web 面訪問 opencode。設置`OPENCODE_SERVER_PASSWORD`以啟用HTTP基本身份驗證用戶名默認為`opencode`)。
這將啟動 HTTP 服務器並打開 Web 瀏覽器以通過 Web 面訪問 opencode。設置`OPENCODE_SERVER_PASSWORD`以啟用HTTP基本身份驗證用戶名默認為`opencode`)。
#### 旗幟
@@ -471,7 +471,7 @@ opencode web
### acp
啟動 ACP代理客戶端協議)服務器。
啟動 ACPAgent Client Protocol)服務器。
```bash
opencode acp
@@ -562,7 +562,7 @@ opencode CLI 採用以下全局標誌。
| `OPENCODE_CONFIG_CONTENT` | 字符串 | 內聯 json 配置內容 |
| `OPENCODE_DISABLE_AUTOUPDATE` | 布爾 | 禁用自動更新檢查 |
| `OPENCODE_DISABLE_PRUNE` | 布爾 | 禁用舊數據的修剪 |
| `OPENCODE_DISABLE_TERMINAL_TITLE` | 布爾 | 禁用自動終端標題更新 |
| `OPENCODE_DISABLE_TERMINAL_TITLE` | 布爾 | 禁用自動terminal標題更新 |
| `OPENCODE_PERMISSION` | 字符串 | 內聯 json 權限配置 |
| `OPENCODE_DISABLE_DEFAULT_PLUGINS` | 布爾 | 禁用默認插件 |
| `OPENCODE_DISABLE_LSP_DOWNLOAD` | 布爾 | 禁用自動 LSP 服務器下載 |

View File

@@ -75,7 +75,7 @@ frontmatter 定義命令屬性。內容成為模板。
---
### 降價
### Markdown
您還可以使用 Markdown 文件定義命令。將它們放入:

View File

@@ -95,7 +95,7 @@ opencode 支持 **JSON** 和 **JSONC**(帶註釋的 JSON格式。
### 全球的
將全局 opencode 配置放在 `~/.config/opencode/opencode.json` 中。使用全局配置來實現用戶範圍的首選項,例如主題、提供程序或按鍵綁定。
將全局 opencode 配置放在 `~/.config/opencode/opencode.json` 中。使用全局配置來實現用戶範圍的首選項,例如主題、提供或按鍵綁定。
全局配置覆蓋遠程組織默認值。
@@ -173,7 +173,7 @@ opencode run "Hello world"
- `scroll_acceleration.enabled` - 啟用 macOS 風格的滾動加速。 **優先於`scroll_speed`。 **
- `scroll_speed` - 自定義滾動速度倍增(默認值:`3`,最小值:`1`)。如果`scroll_acceleration.enabled` 是`true`,則忽略。
- `diff_style` - 控制差異渲染。 `"auto"` 適應終端寬度,`"stacked"` 始終顯示單列。
- `diff_style` - 控制差異渲染。 `"auto"` 適應terminal寬度,`"stacked"` 始終顯示單列。
[在此處了解有關使用 TUI 的更多信息](/docs/tui)。
@@ -228,7 +228,7 @@ opencode run "Hello world"
### 型號
您可以通過 `provider`、`model` 和 `small_model` 選項來配置要在 opencode 配置中使用的提供程序和模型。
您可以通過 `provider`、`model` 和 `small_model` 選項來配置要在 opencode 配置中使用的提供和模型。
```json title="opencode.json"
{
@@ -266,7 +266,7 @@ opencode run "Hello world"
#### 特定於提供商的選項
某些提供程序支持除通用`timeout` 和`apiKey` 設置之外的其他配置選項。
某些提供支持除通用`timeout` 和`apiKey` 設置之外的其他配置選項。
##### 亞馬遜基岩
@@ -289,7 +289,7 @@ Amazon Bedrock 支持 AWS 特定配置:
- `region` - Bedrock 的 AWS 區域(默認為 `AWS_REGION` env var 或 `us-east-1`
- `profile` - 來自 `~/.aws/credentials` 的 AWS 命名配置文件(默認為 `AWS_PROFILE` env var
- `endpoint` - VPC 終端節點的自定義終端節點 URL。這是使用 AWS 特定術語的通用 `baseURL` 選項的別名。如果兩者都指定,`endpoint` 優先。
- `endpoint` - VPC terminal節點的自定義terminal節點 URL。這是使用 AWS 特定術語的通用 `baseURL` 選項的別名。如果兩者都指定,`endpoint` 優先。
:::note
承載令牌(`AWS_BEARER_TOKEN_BEDROCK` 或`/connect`)優先於基於配置文件的身份驗證。詳情請參閱[認證優先級](/docs/providers#authentication-precedence)。
@@ -314,7 +314,7 @@ Amazon Bedrock 支持 AWS 特定配置:
---
### 代理商
### Agents
您可以通過 `agent` 選項為特定任務配置專用代理。
@@ -353,7 +353,7 @@ Amazon Bedrock 支持 AWS 特定配置:
默認代理必須是主代理(而不是子代理)。這可以是內置代理,例如`"build"`或`"plan"`,或者您定義的[定制代理](/docs/agents)。如果指定的代理不存在或者是子代理opencode 將回退到 `"build"` 並發出警告。
此設置適用於所有TUI、CLI (`opencode run`)、桌面應用程和 GitHub Action。
此設置適用於所有TUI、CLI (`opencode run`)、桌面應用程和 GitHub Action。
---
@@ -437,7 +437,7 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup
### 格式化程序
您可以通過`formatter`選項配置碼格式化程序。
您可以通過`formatter`選項配置程式碼格式化程序。
```json title="opencode.json"
{
@@ -567,7 +567,7 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup
### 殘疾服務提供者
您可以通過 `disabled_providers` 選項禁用自動加載的提供程序。當您想要阻止加載某些提供程序(即使其憑據可用)時,這非常有用。
您可以通過 `disabled_providers` 選項禁用自動加載的提供。當您想要阻止加載某些提供(即使其憑據可用)時,這非常有用。
```json title="opencode.json"
{
@@ -590,7 +590,7 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup
### 啟用的提供商
您可以通過 `enabled_providers` 選項指定提供商的允許列表。設置後,僅啟用指定的提供程序,所有其他提供程序將被忽略。
您可以通過 `enabled_providers` 選項指定提供商的允許列表。設置後,僅啟用指定的提供,所有其他提供將被忽略。
```json title="opencode.json"
{
@@ -599,13 +599,13 @@ opencode 將在啟動時自動下載任何新的更新。您可以使用 `autoup
}
```
當您想要限制 opencode 僅使用特定的提供程序而不是一一禁用它們時,這非常有用。
當您想要限制 opencode 僅使用特定的提供而不是一一禁用它們時,這非常有用。
:::note
`disabled_providers` 優先於`enabled_providers`。
:::
如果某個提供程序同時出現在`enabled_providers` 和`disabled_providers` 中,則`disabled_providers` 優先考慮向後兼容性。
如果某個提供同時出現在`enabled_providers` 和`disabled_providers` 中,則`disabled_providers` 優先考慮向後兼容性。
---

View File

@@ -9,7 +9,7 @@ description: 使用 opencode 構建的項目和集成。
想要將您的 opencode 相關項目添加到此列表中嗎?提交 PR。
:::
您還可以查看[很棒的opencode](https://github.com/awesome-opencode/awesome-opencode)和[opencode咖啡館](https://opencode.cafe),這是一個聚合生態系統和社區的社區。
您還可以查看[awesome-opencode](https://github.com/awesome-opencode/awesome-opencode)和[opencode.cafe](https://opencode.cafe),這是一個聚合生態系統和社區的社區。
---
@@ -17,60 +17,60 @@ description: 使用 opencode 構建的項目和集成。
| 名稱 | 描述 |
| --------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| [opencode-Daytona](https://github.com/jamesmurdza/daytona/blob/main/guides/typescript/opencode/README.md) | 使用 git 同步和實時預覽在隔離的 Daytona 沙箱中自動運行 opencode 會話 |
| [opencode-helicone-會話](https://github.com/H2Shami/opencode-helicone-session) | 自動注入 Helicone 會話標頭以進行請求分組 |
| [opencode類型注入](https://github.com/nick-vi/opencode-type-inject) | 使用查找工具將 TypeScript/Svelte 類型自動注入到文件讀取中 |
| [opencode-daytona](https://github.com/jamesmurdza/daytona/blob/main/guides/typescript/opencode/README.md) | 使用 git 同步和實時預覽在隔離的 Daytona 沙箱中自動運行 opencode 會話 |
| [opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session) | 自動注入 Helicone 會話標頭以進行請求分組 |
| [opencode-type-inject](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 積分 |
| [opencode-gemini-auth](https://github.com/jenslys/opencode-gemini-auth) | 使用您現有的 Gemini 計劃而不是 API 計費 |
| [opencode-反重力-auth](https://github.com/NoeFabris/opencode-antigravity-auth) | 使用 Antigravity 的免費模型代替 API 計費 |
| [opencode-devcontainers opencode開發容器](https://github.com/athal7/opencode-devcontainers) | 具有淺克隆和自動分配端口的多分支開發容器隔離 |
| [opencode-antigravity-auth](https://github.com/NoeFabris/opencode-antigravity-auth) | 使用 Antigravity 的免費模型代替 API 計費 |
| [opencode-devcontainers](https://github.com/athal7/opencode-devcontainers) | 具有淺克隆和自動分配端口的多分支開發容器隔離 |
| [opencode-google-antigravity-auth](https://github.com/shekohex/opencode-google-antigravity-auth) | Google Antigravity OAuth 插件,支持 Google 搜索和更強大的 API 處理 |
| [opencode-動態上下文修剪](https://github.com/Tarquinen/opencode-dynamic-context-pruning) | 通過修剪過時的工具輸出來優化代幣使用 |
| [opencode-websearch-引用](https://github.com/ghoulr/opencode-websearch-cited.git) | 為具有 Google 接地風格的受支持提供商添加本機網絡搜索支持 |
| [opencode-dynamic-context-pruning](https://github.com/Tarquinen/opencode-dynamic-context-pruning) | 通過修剪過時的工具輸出來優化代幣使用 |
| [opencode-websearch-cited](https://github.com/ghoulr/opencode-websearch-cited.git) | 為具有 Google 接地風格的受支持提供商添加本機網絡搜索支持 |
| [opencode-pty](https://github.com/shekohex/opencode-pty.git) | 使 AI 代理能夠在 PTY 中運行後台進程,並向其發送交互式輸入。 |
| [opencode-shell-策略](https://github.com/JRedeker/opencode-shell-strategy) | 非交互式 shell 命令說明 - 防止依賴 TTY 的操作掛起 |
| [opencode-shell-strategy](https://github.com/JRedeker/opencode-shell-strategy) | 非交互式 shell 命令說明 - 防止依賴 TTY 的操作掛起 |
| [opencode-wakatime](https://github.com/angristan/opencode-wakatime) | 使用 Wakatime 跟踪 opencode 使用情況 |
| [opencode-md-表格式化程序](https://github.com/franlol/opencode-md-table-formatter/tree/main) | 清理LLM生成的降價表 |
| [opencode變形快速應用](https://github.com/JRedeker/opencode-morph-fast-apply) | 使用 Morph Fast Apply API 和惰性編輯標記將碼編輯速度提高 10 倍 |
| [哦我的opencode](https://github.com/code-yeongyu/oh-my-opencode) | 後台代理、預構建的 LSP/AST/MCP 工具、精選代理、兼容 Claude 代碼 |
| [opencode通知器](https://github.com/panta82/opencode-notificator) | opencode 會話的桌面通知和聲音警報 |
| [opencode通知程序](https://github.com/mohak34/opencode-notifier) | 針對權限、完成和錯誤事件的桌面通知和聲音警報 |
| [opencode-md-table-formatter](https://github.com/franlol/opencode-md-table-formatter/tree/main) | 清理 LLM 生成的 Markdown 表格 |
| [opencode-morph-fast-apply](https://github.com/JRedeker/opencode-morph-fast-apply) | 使用 Morph Fast Apply API 和惰性編輯標記將程式碼編輯速度提高 10 倍 |
| [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) | 後台代理、預構建的 LSP/AST/MCP 工具、精選代理、兼容 Claude Code |
| [opencode-notificator](https://github.com/panta82/opencode-notificator) | opencode 會話的桌面通知和聲音警報 |
| [opencode-notifier](https://github.com/mohak34/opencode-notifier) | 針對權限、完成和錯誤事件的桌面通知和聲音警報 |
| [opencode-zellij-namer](https://github.com/24601/opencode-zellij-namer) | 基於 opencode 上下文的 AI 支持的自動 Zellij 會話命名 |
| [opencode熟練](https://github.com/zenobi-us/opencode-skillful) | 允許 opencode 代理通過技能發現和注入按需延遲加載提示 |
| [opencode超級內存](https://github.com/supermemoryai/opencode-supermemory) | 使用超級內存跨會話持久內存 |
| [@Plannotator/opencode](https://github.com/backnotprop/plannotator/tree/main/apps/opencode-plugin) | 具有視覺註釋和私人/離線共享的交互式計劃審查 |
| [@openspoon/子任務2](https://github.com/spoons-and-mirrors/subtask2) | 將opencode/命令擴展為具有精細流程控制的強大編排系統 |
| [opencode調度程序](https://github.com/different-ai/opencode-scheduler) | 使用帶有 cron 語法的 launchd (Mac) 或 systemd (Linux) 安排重複作業 |
| [微碼](https://github.com/vtemian/micode) | 結構化頭腦風暴 → 計劃 → 實施具有會議連續性的工作流程 |
| [奧克托](https://github.com/vtemian/octto) | 用於通過多問題形式進行 AI 頭腦風暴的交互式瀏覽器 UI |
| [opencode-後台代理](https://github.com/kdcokenny/opencode-background-agents) | 具有異步委託和上下文持久性的 Claude Code 風格後台代理 |
| [opencode通知](https://github.com/kdcokenny/opencode-notify) | opencode 的本機操作系統通知 了解任務何時完成 |
| [opencode工作區](https://github.com/kdcokenny/opencode-workspace) | 捆綁的多代理編排工具 16 個組件,一次安裝 |
| [opencode工作樹](https://github.com/kdcokenny/opencode-worktree) | opencode 的零摩擦 git 工作樹 |
| [opencode-skillful](https://github.com/zenobi-us/opencode-skillful) | 允許 opencode 代理通過技能發現和注入按需延遲加載提示 |
| [opencode-supermemory](https://github.com/supermemoryai/opencode-supermemory) | 使用超級內存跨會話持久內存 |
| [@plannotator/opencode](https://github.com/backnotprop/plannotator/tree/main/apps/opencode-plugin) | 具有視覺註釋和私人/離線共享的交互式計劃審查 |
| [@openspoon/subtask2](https://github.com/spoons-and-mirrors/subtask2) | 將opencode/命令擴展為具有精細流程控制的強大編排系統 |
| [opencode-scheduler](https://github.com/different-ai/opencode-scheduler) | 使用帶有 cron 語法的 launchd (Mac) 或 systemd (Linux) 安排重複作業 |
| [micode](https://github.com/vtemian/micode) | 結構化頭腦風暴 → 計劃 → 實施具有會議連續性的工作流程 |
| [octto](https://github.com/vtemian/octto) | 用於通過多問題形式進行 AI 頭腦風暴的交互式瀏覽器 UI |
| [opencode-background-agents](https://github.com/kdcokenny/opencode-background-agents) | 具有異步委託和上下文持久性的 Claude Code 風格後台代理 |
| [opencode-notify](https://github.com/kdcokenny/opencode-notify) | opencode 的本機操作系統通知 了解任務何時完成 |
| [opencode-workspace](https://github.com/kdcokenny/opencode-workspace) | 捆綁的多代理編排工具 16 個組件,一次安裝 |
| [opencode-worktree](https://github.com/kdcokenny/opencode-worktree) | opencode 的零摩擦 git 工作樹 |
---
## 專案
| 名稱 | 描述 |
| ------------------------------------------------------------------------------------------ | --------------------------------------------------------------- |
| [木牧](https://github.com/remorses/kimaki) | 用於控制 opencode 會話的 Discord 機器人,基於 SDK 構建 |
| [opencode.nvim](https://github.com/NickvanDyke/opencode.nvim) | Neovim 插件,用於編輯器感知提示,基於 API 構建 |
| [門戶網站](https://github.com/hosenur/portal) | 通過 Tailscale/VPN 實現 opencode 的移動優先 Web UI |
| [opencode插件模板](https://github.com/zenobi-us/opencode-plugin-template/) | 用於構建 opencode 插件的模板 |
| [opencode.nvim](https://github.com/sudo-tee/opencode.nvim) | Neovim opencode 前端 - 基於終端的 AI 編碼代理 |
| [ai-sdk-provider-opencode-sdk](https://github.com/ben-vargas/ai-sdk-provider-opencode-sdk) | Vercel AI SDK 提供程序,用於通過 @opencode-ai/sdk 使用 opencode |
| [開放室](https://github.com/btriapitsyn/openchamber) | opencode 的 Web/桌面應用程和 VS Code 擴展 |
| [opencode-Obsidian](https://github.com/mtymek/opencode-obsidian) | 在 Obsidian 的 UI 中嵌入 opencode 的 Obsidian 插件 |
| [開放式工作](https://github.com/different-ai/openwork) | Claude Cowork 的開源替代方案,由 opencode 提供支持 |
| [奧克斯](https://github.com/kdcokenny/ocx) | opencode 擴展管理器具有可移植、隔離的配置文件。 |
| [代碼游牧者](https://github.com/NeuralNomadsAI/CodeNomad) | opencode 的桌面、Web、移動和遠程客戶端應用程 |
| 名稱 | 描述 |
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------- |
| [kimaki](https://github.com/remorses/kimaki) | 用於控制 opencode 會話的 Discord 機器人,基於 SDK 構建 |
| [opencode.nvim](https://github.com/NickvanDyke/opencode.nvim) | Neovim 插件,用於編輯器感知提示,基於 API 構建 |
| [portal](https://github.com/hosenur/portal) | 通過 Tailscale/VPN 實現 opencode 的移動優先 Web UI |
| [opencode plugin template](https://github.com/zenobi-us/opencode-plugin-template/) | 用於構建 opencode 插件的模板 |
| [opencode.nvim](https://github.com/sudo-tee/opencode.nvim) | Neovim opencode 前端 - 基於 terminal 的 AI 編碼代理 |
| [ai-sdk-provider-opencode-sdk](https://github.com/ben-vargas/ai-sdk-provider-opencode-sdk) | Vercel AI SDK 提供,用於通過 @opencode-ai/sdk 使用 opencode |
| [OpenChamber](https://github.com/btriapitsyn/openchamber) | opencode 的 Web/桌面應用程和 VS Code 擴展 |
| [OpenCode-Obsidian](https://github.com/mtymek/opencode-obsidian) | 在 Obsidian 的 UI 中嵌入 opencode 的 Obsidian 插件 |
| [OpenWork](https://github.com/different-ai/openwork) | Claude Cowork 的開源替代方案,由 opencode 提供支持 |
| [ocx](https://github.com/kdcokenny/ocx) | opencode 擴展管理器具有可移植、隔離的配置文件。 |
| [CodeNomad](https://github.com/NeuralNomadsAI/CodeNomad) | opencode 的桌面、Web、移動和遠程客戶端應用程 |
---
## 代理商
## Agents
| 名稱 | 描述 |
| -------------------------------------------------------------- | ---------------------------------------- |
| [代理](https://github.com/Cluster444/agentic) | 用於結構化開發的模塊化人工智能代理和命令 |
| [opencode代理](https://github.com/darrenhinde/opencode-agents) | 用於增強工作流程的配置、提示、代理和插件 |
| 名稱 | 描述 |
| ----------------------------------------------------------------- | ---------------------------------------- |
| [Agentic](https://github.com/Cluster444/agentic) | 用於結構化開發的模塊化AI代理和命令 |
| [opencode-agents](https://github.com/darrenhinde/opencode-agents) | 用於增強工作流程的配置、提示、代理和插件 |

View File

@@ -6,10 +6,10 @@ description: 在您的組織中安全地使用 opencode。
import config from "../../../../config.mjs"
export const email = `mailto:${config.email}`
opencode Enterprise 適用於希望確保其碼和數據永遠不會離開其基礎設施的組織。它可以通過使用與 SSO 和內部 AI 網關集成的集中式配置來實現此目的。
opencode Enterprise 適用於希望確保其程式碼和數據永遠不會離開其基礎設施的組織。它可以通過使用與 SSO 和內部 AI 網關集成的集中式配置來實現此目的。
:::note
opencode 不存儲您的任何碼或上下文數據。
opencode 不存儲您的任何程式碼或上下文數據。
:::
要開始使用 opencode Enterprise
@@ -21,13 +21,13 @@ opencode 不存儲您的任何代碼或上下文數據。
## 審判
opencode 是開源的,不存儲您的任何碼或上下文數據,因此您的開發人員只需 [開始吧](/docs/) 並進行試用。
opencode 是開源的,不存儲您的任何程式碼或上下文數據,因此您的開發人員只需 [開始吧](/docs/) 並進行試用。
---
### 數據處理
**opencode 不會存儲您的碼或上下文數據。 ** 所有處理都在本地進行或通過直接 API 調用您的 AI 提供商。
**opencode 不會存儲您的程式碼或上下文數據。 ** 所有處理都在本地進行或通過直接 API 調用您的 AI 提供商。
這意味著只要您使用您信任的提供商或內部提供商
AI網關您可以安全使用opencode。
@@ -55,9 +55,9 @@ AI網關您可以安全使用opencode。
---
### 碼所有權
### 程式碼所有權
**您擁有 opencode 生成的所有碼。 ** 沒有許可限製或所有權聲明。
**您擁有 opencode 生成的所有程式碼。 ** 沒有許可限製或所有權聲明。
---
@@ -113,14 +113,14 @@ AI網關您可以安全使用opencode。
<details>
<summary>什麼是 opencode Enterprise </summary>
opencode Enterprise 適用於希望確保其碼和數據永遠不會離開其基礎設施的組織。它可以通過使用與 SSO 和內部 AI 網關集成的集中式配置來實現此目的。
opencode Enterprise 適用於希望確保其程式碼和數據永遠不會離開其基礎設施的組織。它可以通過使用與 SSO 和內部 AI 網關集成的集中式配置來實現此目的。
</details>
<details>
<summary>如何開始使用 opencode Enterprise </summary>
只需與您的團隊進行內部試用即可。 opencode 默認情況下不存儲您的碼或上下文數據,因此可以輕鬆上手。
只需與您的團隊進行內部試用即可。 opencode 默認情況下不存儲您的程式碼或上下文數據,因此可以輕鬆上手。
然後**<a href={email}>聯繫我們</a>**討論定價和實施選項。
@@ -136,7 +136,7 @@ opencode Enterprise 適用於希望確保其代碼和數據永遠不會離開其
<details>
<summary>opencode Enterprise 保證我的數據安全嗎? </summary>
是的。 opencode 不存儲您的碼或上下文數據。所有處理都在本地進行或通過直接 API 調用您的 AI 提供商。通過中央配置和 SSO 集成,您的數據在組織的基礎架構中保持安全。
是的。 opencode 不存儲您的程式碼或上下文數據。所有處理都在本地進行或通過直接 API 調用您的 AI 提供商。通過中央配置和 SSO 集成,您的數據在組織的基礎架構中保持安全。
</details>

View File

@@ -3,7 +3,7 @@ title: 格式化程序
description: opencode 使用特定於語言的格式化程序。
---
使用特定於語言的格式化程序編寫或編輯文件後opencode 會自動格式化文件。這可確保生成的碼遵循項目的碼風格。
使用特定於語言的格式化程序編寫或編輯文件後opencode 會自動格式化文件。這可確保生成的程式碼遵循項目的程式碼風格。
---
@@ -50,7 +50,7 @@ opencode 附帶了多個適用於流行語言和框架的內置格式化程序
2. 對文件運行適當的格式化程序命令。
3. 自動應用格式更改。
此過程在後台進行,確保無需任何手動步驟即可維護您的碼樣式。
此過程在後台進行,確保無需任何手動步驟即可維護您的程式碼樣式。
---

View File

@@ -23,7 +23,7 @@ opencode 與您的 GitHub 工作流程集成。在評論中提及`/opencode` 或
opencode github install
```
這將引導您完成安裝 GitHub 應用程、創建工作流程和設置機密。
這將引導您完成安裝 GitHub 應用程、創建工作流程和設置機密。
---
@@ -85,9 +85,9 @@ opencode github install
- `agent`: The agent to use.必須是一級代理。如果未找到,則從配置回退到 `default_agent` 或 `"build"`。
- `share`是否共享opencode會話。對於公共存儲庫默認為 **true**。
- `prompt`:可選的自定義提示以覆蓋默認行為。使用它來自定義 opencode 處理請求的方式。
- `token`:可選的 GitHub 訪問令牌用於執行創建評論、提交更改和打開拉取請求等操作。默認情況下opencode 使用來自 opencode GitHub 應用程的安裝訪問令牌,因此提交、評論和拉取請求顯示為來自應用程
- `token`:可選的 GitHub 訪問令牌用於執行創建評論、提交更改和打開拉取請求等操作。默認情況下opencode 使用來自 opencode GitHub 應用程的安裝訪問令牌,因此提交、評論和拉取請求顯示為來自應用程
或者,您可以使用 GitHub Action 運行程序的[內置`GITHUB_TOKEN`](https://docs.github.com/en/actions/tutorials/authenticate-with-github_token),而無需安裝 opencode GitHub 應用程。只需確保在您的工作流程中授予所需的權限:
或者,您可以使用 GitHub Action 運行程序的[內置`GITHUB_TOKEN`](https://docs.github.com/en/actions/tutorials/authenticate-with-github_token),而無需安裝 opencode GitHub 應用程。只需確保在您的工作流程中授予所需的權限:
```yaml
permissions:
@@ -108,7 +108,7 @@ opencode 可以由以下 GitHub 事件觸發:
| 事件類型 | 觸發者 | 詳情 |
| ----------------------------- | ---------------------------- | -------------------------------------------------------------------------------------------------- |
| `issue_comment` | 對問題或 PR 發表評論 | Mention `/opencode` or `/oc` in your comment. opencode 讀取上下文並可以創建分支、打開 PR 或回复。 |
| `pull_request_review_comment` | 對 PR 中的特定碼行進行評論 | 在檢查碼時提及`/opencode` 或`/oc`。 opencode receives file path, line numbers, and diff context. |
| `pull_request_review_comment` | 對 PR 中的特定程式碼行進行評論 | 在檢查程式碼時提及`/opencode` 或`/oc`。 opencode receives file path, line numbers, and diff context. |
| `issues` | 問題已打開或已編輯 | 創建或修改問題時自動觸發 opencode。需要 `prompt` 輸入。 |
| `pull_request` | PR 已開啟或已更新 | Automatically trigger opencode when PRs are opened, synchronized, or reopened.對於自動評論很有用。 |
| `schedule` | 基於 Cron 的計劃 | 按計劃運行 opencode。需要 `prompt` 輸入。輸出進入日誌和 PR沒有可評論的問題。 |
@@ -303,9 +303,9 @@ jobs:
Error 500 (Server Error)!!1500.Thats an error.There was an error. Please try again later.Thats all we know.
- **查看特定碼行**
- **查看特定程式碼行**
直接在 PR 的“文件”選項卡中的碼行上留下評論。 opencode 自動檢測文件、行號和差異上下文以提供精確的響應。
直接在 PR 的“文件”選項卡中的程式碼行上留下評論。 opencode 自動檢測文件、行號和差異上下文以提供精確的響應。
```
[Comment on specific lines in Files tab]
@@ -314,7 +314,7 @@ jobs:
Error 500 (Server Error)!!1500.Thats an error.There was an error. Please try again later.Thats all we know.
- 正在審查的確切文件
- 具體碼行
- 具體程式碼行
- 周圍的 diff 上下文
- 行號信息

View File

@@ -3,14 +3,14 @@ title: 集成開發環境
description: VS Code、Cursor 和其他 IDE 的 opencode 擴展
---
opencode 與 VS Code、Cursor 或任何支持終端的 IDE 集成。只需在終端中運行 `opencode` 即可開始。
opencode 與 VS Code、Cursor 或任何支持terminal的 IDE 集成。只需在 terminal中運行 `opencode` 即可開始。
---
## 用法
- **快速啟動**:使用 `Cmd+Esc` (Mac) 或 `Ctrl+Esc` (Windows/Linux) 在拆分終端視圖中打開 opencode或者聚焦現有終端會話(如果已有終端會話正在運行)。
- **新會話**:使用 `Cmd+Shift+Esc` (Mac) 或 `Ctrl+Shift+Esc` (Windows/Linux) 啟動新的 opencode 終端會話,即使該會話已打開。您還可以單擊 UI 中的 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`。
@@ -20,8 +20,8 @@ opencode 與 VS Code、Cursor 或任何支持終端的 IDE 集成。只需在終
要在 VS Code 和 Cursor、Windsurf、VSCodium 等流行分支上安裝 opencode
1. 打開 VS
2. 打開集成終端
1. 打開 VS 程式
2. 打開集成terminal
3. 運行 `opencode` - 擴展會自動安裝
另一方面,如果您想在從 TUI 運行 `/editor` 或 `/export` 時使用自己的 IDE則需要設置 `export EDITOR="code --wait"`。 [了解更多](/docs/tui/#editor-setup)。
@@ -38,9 +38,9 @@ opencode 與 VS Code、Cursor 或任何支持終端的 IDE 集成。只需在終
如果擴展無法自動安裝:
- 確保您在集成終端中運行`opencode`。
- 確保您在集成terminal中運行`opencode`。
- 確認您的 IDE 的 CLI 已安裝:
- 對於 VS 碼:`code` 命令
- 對於 VS 程式碼:`code` 命令
- 對於光標:`cursor` 命令
- 對於風帆衝浪:`windsurf` 命令
- 對於 VSCodium`codium` 命令

View File

@@ -7,7 +7,7 @@ import { Tabs, TabItem } from "@astrojs/starlight/components"
import config from "../../../../config.mjs"
export const console = config.console
[**opencode**](/) 是一個開源人工智能編碼代理。它可用作基於終端的界面、桌面應用程或 IDE 擴展。
[**opencode**](/) 是一個開源AI編碼代理。它可用作基於 terminal 的介面、桌面應用程或 IDE 擴展。
![具有 opencode 主題的 opencode TUI](../../../assets/lander/screenshot.png)
@@ -17,13 +17,13 @@ export const console = config.console
#### 先決條件
要在終端中使用 opencode您需要
要在 terminal中使用 opencode您需要
1. 現代終端模擬器,例如:
- [韋茲術語](https://wezterm.org),跨平台
- [阿拉克里蒂](https://alacritty.org),跨平台
- [幽靈般的](https://ghostty.org)Linux 和 macOS
- [貓咪](https://sw.kovidgoyal.net/kitty/)Linux 和 macOS
1. 現代terminal模擬器,例如:
- [WezTerm](https://wezterm.org),跨平台
- [Alacritty](https://alacritty.org),跨平台
- [Ghostty](https://ghostty.org)Linux 和 macOS
- [Kitty](https://sw.kovidgoyal.net/kitty/)Linux 和 macOS
2. 您想要使用的 LLM 提供商的 API 密鑰。
@@ -87,19 +87,19 @@ curl -fsSL https://opencode.ai/install | bash
paru -S opencode-bin
```
#### 視窗
#### Windows
:::tip[Recommended: Use WSL]
為了在 Windows 上獲得最佳體驗,我們建議使用[適用於 Linux 的 Windows 子系統 (WSL)](/docs/windows-wsl)。它提供了更好的性能並與 opencode 的功能完全兼容。
:::
- **使用巧克力**
- **使用Chocolatey**
```bash
choco install opencode
```
- **使用勺子**
- **使用Scoop**
```bash
scoop install opencode
@@ -111,7 +111,7 @@ curl -fsSL https://opencode.ai/install | bash
npm install -g opencode-ai
```
- **使用米塞**
- **使用Mise**
```bash
mise use -g github:anomalyco/opencode
@@ -125,7 +125,7 @@ curl -fsSL https://opencode.ai/install | bash
目前正在支持使用 Bun 在 Windows 上安裝 opencode。
您還可以從[發布](https://github.com/anomalyco/opencode/releases) 獲取二進製文件。
您還可以從[Releases](https://github.com/anomalyco/opencode/releases) 獲取二進製文件。
---
@@ -143,7 +143,7 @@ curl -fsSL https://opencode.ai/install | bash
/connect
```
2. 登錄,添加您的單詳細信息,然後復制您的 API 密鑰。
2. 登錄,添加您的單詳細信息,然後復制您的 API 密鑰。
3. 粘貼您的 API 密鑰。
@@ -160,7 +160,7 @@ curl -fsSL https://opencode.ai/install | bash
## 初始化
現在您已經配置了提供程序,您可以導航到一個項目
現在您已經配置了提供,您可以導航到一個項目
你想繼續工作。
```bash
@@ -203,7 +203,7 @@ opencode
### 提出問題
您可以要求 opencode 向您解釋碼庫。
您可以要求 opencode 向您解釋程式碼庫。
:::tip
使用`@`鍵模糊搜索工程中的文件。
@@ -213,7 +213,7 @@ opencode
How is authentication handled in @packages/functions/src/api/index.ts
```
如果您沒有處理碼庫的一部分,這會很有幫助。
如果您沒有處理程式碼庫的一部分,這會很有幫助。
---
@@ -258,11 +258,11 @@ How is authentication handled in @packages/functions/src/api/index.ts
```
:::tip
將圖像拖放到終端中以將其添加到提示中。
將圖像拖放到terminal中以將其添加到提示中。
:::
opencode 可以掃描您提供的任何圖像並將其添加到提示中。你可以
通過將圖像拖放到終端中來完成此操作。
通過將圖像拖放到terminal中來完成此操作。
3. **構建功能**
@@ -336,13 +336,13 @@ Can you refactor the function in @packages/functions/src/api/index.ts?
## 分享
您與 opencode 的對話可以[與您的
團隊](/docs/分享)。
團隊](/docs/share)。
```bash frame="none"
/share
```
這將創建當前對話的鏈接並將其複製到剪貼板。
這將創建當前對話的連結並將其複製到剪貼板。
:::note
默認情況下不共享對話。
@@ -356,4 +356,4 @@ Can you refactor the function in @packages/functions/src/api/index.ts?
就是這樣!您現在已經是使用 opencode 的專家了。
要使其成為您自己的,我們建議 [選擇一個主題](/docs/themes)、[自定義按鍵綁定](/docs/keybinds)、[配置碼格式化程序](/docs/formatters)、[創建自定義命令](/docs/commands) 或使用 [opencode配置](/docs/config)。
要使其成為您自己的,我們建議 [選擇一個主題](/docs/themes)、[自定義按鍵綁定](/docs/keybinds)、[配置程式碼格式化程序](/docs/formatters)、[創建自定義命令](/docs/commands) 或使用 [opencode配置](/docs/config)。

View File

@@ -107,7 +107,7 @@ opencode 有一個按鍵綁定列表,您可以通過 opencode 配置進行自
## 領袖鑰匙
opencode 對大多數按鍵綁定使用 `leader` 鍵。這可以避免終端中的衝突。
opencode 對大多數按鍵綁定使用 `leader` 鍵。這可以避免terminal 中的衝突。
默認情況下,`ctrl+x` 是主鍵,大多數操作要求您先按主鍵,然後再按快捷鍵。例如,要開始新會話,請先按`ctrl+x`,然後按`n`。
@@ -132,7 +132,7 @@ opencode 對大多數按鍵綁定使用 `leader` 鍵。這可以避免終端中
## 桌面提示快捷方式
opencode 桌面應用程提示輸入支持常見的 Readline/Emacs 風格的文本編輯快捷方式。這些是內置的,目前無法通過`opencode.json`進行配置。
opencode 桌面應用程提示輸入支持常見的 Readline/Emacs 風格的文本編輯快捷方式。這些是內置的,目前無法通過`opencode.json`進行配置。
| 快捷方式 | 行動 |
| -------- | ------------------------- |
@@ -154,9 +154,9 @@ opencode 桌面應用程序提示輸入支持常見的 Readline/Emacs 風格的
## Shift+Enter
默認情況下,某些終端不發送帶有 Enter 的修飾鍵。您可能需要將終端配置為發送 `Shift+Enter` 作為轉義序列。
默認情況下,某些terminal不發送帶有 Enter 的修飾鍵。您可能需要將terminal配置為發送 `Shift+Enter` 作為轉義序列。
### Windows 終端
### Windows terminal
打開您的`settings.json`
@@ -189,4 +189,4 @@ opencode 桌面應用程序提示輸入支持常見的 Readline/Emacs 風格的
]
```
保存文件並重新啟動 Windows 終端或打開新選項卡。
保存文件並重新啟動 Windows terminal或打開新選項卡。

View File

@@ -3,7 +3,7 @@ title: LSP服務器
description: opencode 與您的 LSP 服務器集成。
---
opencode 與您的語言服務器協議 (LSP) 集成,以幫助 LLM 與您的碼庫交互。它使用診斷向LLM提供反饋。
opencode 與您的語言服務器協議 (LSP) 集成,以幫助 LLM 與您的程式碼庫交互。它使用診斷向LLM提供反饋。
---
@@ -31,7 +31,7 @@ opencode 附帶了多種適用於流行語言的內置 LSP 服務器:
| lua-ls | .lua | 自動安裝 Lua 項目 |
| 尼克斯 | .nix | `nixd` 命令可用 |
| ocaml-lsp | .ml、.mli | `ocamllsp` 命令可用 |
| 奧克斯林特 | .ts、.tsx、.js、.jsx、.mjs、.cjs、.mts、.cts、.vue、.astro、.svelte | `oxlint` 項目中的依賴項 |
| ocx林特 | .ts、.tsx、.js、.jsx、.mjs、.cjs、.mts、.cts、.vue、.astro、.svelte | `oxlint` 項目中的依賴項 |
| php intelephense | php .php | PHP 項目的自動安裝 |
| 棱鏡 | .prisma | `prisma` 命令可用 |
| 皮賴特 | .py, .pyi | `pyright` 依賴項已安裝 |

View File

@@ -484,7 +484,7 @@ When you need to search docs, use `context7` tools.
### Vercel 的 Grep
添加 [Vercel 的 Grep](https://grep.app) MCP 服務器以搜索 GitHub 上的碼片段。
添加 [Vercel 的 Grep](https://grep.app) MCP 服務器以搜索 GitHub 上的程式碼片段。
```json title="opencode.json" {4-7}
{

View File

@@ -3,13 +3,13 @@ title: 型號
description: 配置LLM提供者和模型。
---
opencode 使用[人工智能軟件開發工具包](https://ai-sdk.dev/) 和[模型.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) 的更多信息。
@@ -33,7 +33,7 @@ opencode 使用[人工智能軟件開發工具包](https://ai-sdk.dev/) 和[模
考慮使用我們推薦的模型之一。
:::
然而,既擅長生成碼又擅長工具調用的只有少數。
然而,既擅長生成程式碼又擅長工具調用的只有少數。
以下是與 opencode 配合良好的幾個模型,排名不分先後。 (這不是詳盡的列表,也不一定是最新的):
@@ -100,8 +100,8 @@ opencode配置。
}
```
在這裡,我們為兩個內置模型配置全局設置:`gpt-5`(通過 `openai` 提供程序訪問時)和 `claude-sonnet-4-20250514`(通過 `anthropic` 提供程序訪問時)。
內置提供商和型號名稱可以在[模型.dev](https://models.dev) 上找到。
在這裡,我們為兩個內置模型配置全局設置:`gpt-5`(通過 `openai` 提供訪問時)和 `claude-sonnet-4-20250514`(通過 `anthropic` 提供訪問時)。
內置提供商和型號名稱可以在[models.dev](https://models.dev) 上找到。
您還可以為您正在使用的任何代理配置這些選項。代理配置會覆蓋此處的所有全局選項。 [了解更多](/docs/agents/#additional)。
@@ -143,7 +143,7 @@ opencode配置。
opencode 附帶了許多提供商的默認變體:
**人擇**
**Anthropic**
- `high` - 高思維預算(默認)
- `max` - 最大思維預算

View File

@@ -38,7 +38,7 @@ opencode 有兩種內置模式。
- `patch` - 無法應用補丁
- `bash` - 無法執行 shell 命令
當您希望 AI 分析碼、建議更改或創建計劃而不對碼庫進行任何實際修改時,此模式非常有用。
當您希望 AI 分析程式碼、建議更改或創建計劃而不對程式碼庫進行任何實際修改時,此模式非常有用。
---
@@ -46,7 +46,7 @@ opencode 有兩種內置模式。
您可以在會話期間使用 _Tab_ 鍵在模式之間切換。或者您配置的 `switch_mode` 鍵綁定。
另請參閱:[格式化程序](/docs/formatters) 有關碼格式配置的信息。
另請參閱:[格式化程序](/docs/formatters) 有關程式碼格式配置的信息。
---
@@ -83,7 +83,7 @@ opencode 有兩種內置模式。
}
```
### 降價配置
### Markdown 配置
您還可以使用 Markdown 文件定義模式。將它們放入:
@@ -151,7 +151,7 @@ Markdown 文件名成為模式名稱(例如,`review.md` 創建`review` 模
溫度值的範圍通常為 0.0 到 1.0
- **0.0-0.2**:非常集中且確定的響應,非常適合碼分析和規劃
- **0.0-0.2**:非常集中且確定的響應,非常適合程式碼分析和規劃
- **0.3-0.5**:具有一定創造力的平衡響應,適合一般開發任務
- **0.6-1.0**:更有創意和多樣化的反應,有助於頭腦風暴和探索
@@ -324,7 +324,7 @@ Priorities:
- **構建模式**:啟用所有工具的完整開發工作
- **計劃模式**:分析和計劃,無需更改
- **審閱模式**:使用只讀訪問權限和文檔工具進行碼審閱
- **審閱模式**:使用只讀訪問權限和文檔工具進行程式碼審閱
- **調試模式**:專注於啟用 bash 和讀取工具的調查
- **文檔模式**:使用文件操作但不使用系統命令的文檔編寫

View File

@@ -140,7 +140,7 @@ opencode 權限由工具名稱和一些安全防護措施決定:
- `lsp` — 運行 LSP 查詢(當前非粒度)
- `todoread`、`todowrite` — 讀取/更新待辦事項列表
- `webfetch` — 獲取 URL與 URL 匹配)
- `websearch`、`codesearch` — 網頁/碼搜索(與查詢匹配)
- `websearch`、`codesearch` — 網頁/程式碼搜索(與查詢匹配)
- `external_directory` — 當工具觸及項目工作目錄之外的路徑時觸發
- `doom_loop` — 當相同的工具調用使用相同的輸入重複 3 次時觸發
@@ -181,7 +181,7 @@ opencode 權限由工具名稱和一些安全防護措施決定:
---
## 代理商
## Agents
您可以覆蓋每個代理的權限。代理權限與全局​​配置合併,代理規則優先。 [了解更多](/docs/agents#permissions) 關於代理權限。

View File

@@ -119,7 +119,7 @@ export const MyPlugin = async ({ project, client, $, directory, worktree }) => {
- `directory`:當前工作目錄。
- `worktree`git 工作樹路徑。
- `client`:用於與 AI 交互的opencode SDK 客戶端。
- `$`Bun的[外殼API](https://bun.com/docs/runtime/shell)用於執行命令。
- `$`Bun的[shell API](https://bun.com/docs/runtime/shell)用於執行命令。
---
@@ -235,7 +235,7 @@ export const NotificationPlugin = async ({ project, client, $, directory, worktr
我們使用 `osascript` 在 macOS 上運行 AppleScript。這裡我們用它來發送通知。
:::note
如果您使用 opencode 桌面應用程,它可以在響應準備就緒或會話出錯時自動發送系統通知。
如果您使用 opencode 桌面應用程,它可以在響應準備就緒或會話出錯時自動發送系統通知。
:::
---
@@ -260,7 +260,7 @@ export const EnvProtection = async ({ project, client, $, directory, worktree })
### 注入環境變量
將環境變量注入所有 shell 執行AI 工具和用戶終端
將環境變量注入所有 shell 執行AI 工具和用戶 terminal
```javascript title=".opencode/plugins/inject-env.js"
export const InjectEnvPlugin = async () => {
@@ -327,7 +327,7 @@ export const MyPlugin = async ({ client }) => {
}
```
級別:`debug`、`info`、`warn`、`error`。詳情請參閱[SDK文檔](https://opencode.ai/docs/sdk)。
級別:`debug`、`info`、`warn`、`error`。詳情請參閱[SDK 文件](https://opencode.ai/docs/sdk)。
---

View File

@@ -6,12 +6,12 @@ description: 使用 opencode 中的任何 LLM 提供商。
import config from "../../../../config.mjs"
export const console = config.console
opencode 使用[人工智能軟件開發工具包](https://ai-sdk.dev/) 和[模型.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 配置中配置提供程序
1. 使用 `/connect` 命令添加提供的 API 密鑰。
2. 在 opencode 配置中配置提供
---
@@ -24,14 +24,14 @@ opencode 使用[人工智能軟件開發工具包](https://ai-sdk.dev/) 和[模
### 配置
您可以通過 opencode 中的 `provider` 部分自定義提供程序
您可以通過 opencode 中的 `provider` 部分自定義提供
配置。
---
#### 基本網址
您可以通過設置 `baseURL` 選項來自定義任何提供程序的基本 URL。這在使用代理服務或自定義端點時非常有用。
您可以通過設置 `baseURL` 選項來自定義任何提供的基本 URL。這在使用代理服務或自定義端點時非常有用。
```json title="opencode.json" {6}
{
@@ -63,7 +63,7 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被
/connect
```
2. 登錄,添加您的單詳細信息,然後復制您的 API 密鑰。
2. 登錄,添加您的單詳細信息,然後復制您的 API 密鑰。
3. 粘貼您的 API 密鑰。
@@ -80,7 +80,7 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被
/models
```
它的工作方式與 opencode 中的任何其他提供程序一樣,並且完全可以選擇使用。
它的工作方式與 opencode 中的任何其他提供一樣,並且完全可以選擇使用。
---
@@ -178,7 +178,7 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被
**可用選項:**
- `region` - AWS 區域(例如`us-east-1`、`eu-west-1`
- `profile` - 來自 `~/.aws/credentials` 的 AWS 命名配置文件
- `endpoint` - VPC 終端節點的自定義終端節點 URL通用 `baseURL` 選項的別名)
- `endpoint` - VPC terminal節點的自定義terminal節點 URL通用 `baseURL` 選項的別名)
:::tip
配置文件選項優先於環境變量。
@@ -186,7 +186,7 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被
#### 高級VPC 端點
如果您使用 Bedrock 的 VPC 終端節點:
如果您使用 Bedrock 的 VPC terminal節點:
```json title="opencode.json"
{
@@ -230,7 +230,7 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被
```
:::note
對於自定義推理配置文件,請在密鑰中使用模型和提供程序名稱,並將 `id` 屬性設置為 arn。這確保了正確的緩存
對於自定義推理配置文件,請在密鑰中使用模型和提供名稱,並將 `id` 屬性設置為 arn。這確保了正確的緩存
```json title="opencode.json"
{
@@ -252,7 +252,7 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被
---
### 人擇
### Anthropic
1. 註冊後,運行 `/connect` 命令並選擇 Anthropic。
@@ -279,18 +279,18 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被
```
:::info
[人擇](https://anthropic.com) 不正式支持在 opencode 中使用您的 Claude Pro/Max 訂閱。
[Anthropic](https://anthropic.com) 不正式支持在 opencode 中使用您的 Claude Pro/Max 訂閱。
:::
##### 使用 API 密鑰
如果您沒有 Pro/Max 訂閱,您還可以選擇 **創建 API 密鑰**。它還會打開您的瀏覽器並要求您登錄 Anthropic 並為您提供一個可以粘貼到終端中的代碼。
如果您沒有 Pro/Max 訂閱,您還可以選擇 **創建 API 密鑰**。它還會打開您的瀏覽器並要求您登錄 Anthropic 並為您提供一個可以粘貼到terminal 中的程式碼。
或者,如果您已有 API 密鑰,則可以選擇 **手動輸入 API 密鑰** 並將其粘貼到您的終端中。
或者,如果您已有 API 密鑰,則可以選擇 **手動輸入 API 密鑰** 並將其粘貼到您的terminal中。
---
### Azure 開放人工智能
### Azure 開放AI
:::note
如果遇到“抱歉,但我無法協助該請求”錯誤,請嘗試將 Azure 資源中的內容篩選器從 **DefaultV2** 更改為 **Default**。
@@ -300,7 +300,7 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被
- **資源名稱**:這將成為您的 API 端點 (`https://RESOURCE_NAME.openai.azure.com/`) 的一部分
- **API 密鑰**:來自您的資源的 `KEY 1` 或 `KEY 2`
2. 轉到[Azure 人工智能鑄造廠](https://ai.azure.com/) 並部署模型。
2. 轉到[Azure AI Foundry](https://ai.azure.com/) 並部署模型。
:::note
部署名稱必須與模型名稱匹配opencode 才能正常工作。
@@ -347,7 +347,7 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被
- **資源名稱**:這將成為您的 API 端點 (`https://AZURE_COGNITIVE_SERVICES_RESOURCE_NAME.cognitiveservices.azure.com/`) 的一部分
- **API 密鑰**:來自您的資源的 `KEY 1` 或 `KEY 2`
2. 轉到[Azure 人工智能鑄造廠](https://ai.azure.com/) 並部署模型。
2. 轉到[Azure AI Foundry](https://ai.azure.com/) 並部署模型。
:::note
部署名稱必須與模型名稱匹配opencode 才能正常工作。
@@ -388,9 +388,9 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被
---
### 巴吉度獵犬
### Baseten
1. 前往[巴吉度獵犬](https://app.baseten.co/),創建一個帳戶並生成一個 API 密鑰。
1. 前往[Baseten](https://app.baseten.co/),創建一個帳戶並生成一個 API 密鑰。
2. 運行`/connect`命令並蒐索**Baseten**。
@@ -417,7 +417,7 @@ OpenCode Zen 是 opencode 團隊提供的模型列表,這些模型已被
### 大腦
1. 前往[大腦控制台](https://inference.cerebras.ai/),創建一個帳戶並生成一個 API 密鑰。
1. 前往[Cerebras Console](https://inference.cerebras.ai/),創建一個帳戶並生成一個 API 密鑰。
2. 運行 `/connect` 命令並蒐索 **Cerebras**。
@@ -556,7 +556,7 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro
### 深層基礎設施
1. 前往[深度基礎設施儀表板](https://deepinfra.com/dash),創建一個帳戶並生成一個 API 密鑰。
1. 前往[DeepInfra dashboard](https://deepinfra.com/dash),創建一個帳戶並生成一個 API 密鑰。
2. 運行 `/connect` 命令並蒐索 **Deep Infra**。
@@ -583,7 +583,7 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro
### 韌體
1. 前往[固件儀表板](https://app.firmware.ai/signup),創建一個帳戶並生成一個 API 密鑰。
1. 前往[Firmware dashboard](https://app.firmware.ai/signup),創建一個帳戶並生成一個 API 密鑰。
2. 運行`/connect`命令並蒐索**固件**。
@@ -608,7 +608,7 @@ Cloudflare AI Gateway 讓您可以通過統一端點訪問來自 OpenAI、Anthro
---
### 煙花人工智能
### 煙花AI
1. 前往[Fireworks AI 控制台](https://app.fireworks.ai/),創建一個帳戶,然後單擊“**創建 API 密鑰**”。
@@ -664,7 +664,7 @@ GitLab Duo 通過 GitLab 的 Anthropic 代理提供具有本機工具調用功
2. 單擊**添加新令牌**
3. 名稱:`OpenCode`,範圍:`api`
4. 複製令牌(以`glpat-`開頭)
5. 在終端中輸入
5. 在 terminal中輸入
3. 運行 `/models` 命令以查看可用模型。
@@ -733,14 +733,14 @@ export GITLAB_TOKEN=glpat-...
##### 適用於自託管實例的 OAuth
為了使 Oauth 適用於您的自託管實例,您需要創建
一個新的應用程(設置→應用程
一個新的應用程(設置→應用程
回調 URL `http://127.0.0.1:8080/callback` 和以下範圍:
- api代表您訪問API
- read_user讀取您的個人信息
- read_repository允許對存儲庫進行只讀訪問
然後將應用程 ID 公開為環境變量:
然後將應用程 ID 公開為環境變量:
```bash
export GITLAB_OAUTH_CLIENT_ID=your_application_id_here
@@ -801,7 +801,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here
/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
@@ -821,7 +821,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here
---
### 谷歌頂點人工智能
### 谷歌頂點AI
要將 Google Vertex AI 與 opencode 結合使用:
@@ -867,7 +867,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here
### 格羅克
1. 前往[格羅克控制台](https://console.groq.com/),單擊“**創建 API 密鑰**”,然後復制密鑰。
1. 前往[Groq Console](https://console.groq.com/),單擊“**創建 API 密鑰**”,然後復制密鑰。
2. 運行`/connect`命令並蒐索Groq。
@@ -896,7 +896,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here
[Error 500 (Server Error)!!1500.Thats an error.There was an error. Please try again later.Thats all we know.](https://huggingface.co/docs/inference-providers) 提供對超過 17 個提供商支持的開放模型的訪問。
1. 前往[擁抱臉部設置](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) 創建一個具有調用推理提供權限的令牌。
2. 運行 `/connect` 命令並蒐索 **Hugging Face**。
@@ -921,11 +921,11 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here
---
### 螺旋錐
### Helicone
[螺旋錐](https://helicone.ai) 是一個 LLM 可觀察性平台,可為您的 AI 應用程提供日誌記錄、監控和分析。 Helicone AI Gateway 根據模型自動將您的請求路由到適當的提供商。
[Helicone](https://helicone.ai) 是一個 LLM 可觀察性平台,可為您的 AI 應用程提供日誌記錄、監控和分析。 Helicone AI Gateway 根據模型自動將您的請求路由到適當的提供商。
1. 前往[螺旋錐](https://helicone.ai),創建一個帳戶,並從您的儀表板生成 API 密鑰。
1. 前往[Helicone](https://helicone.ai),創建一個帳戶,並從您的儀表板生成 API 密鑰。
2. 運行 `/connect` 命令並蒐索 **Helicone**。
@@ -948,7 +948,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here
/models
```
有關更多提供程序和高級功能(例如緩存和速率限制),請查看[螺旋錐文檔](https://docs.helicone.ai)。
有關更多提供和高級功能(例如緩存和速率限制),請查看[Helicone docs](https://docs.helicone.ai)。
#### 可選配置
@@ -982,7 +982,7 @@ export GITLAB_OAUTH_CLIENT_ID=your_application_id_here
#### 自定義標頭
Helicone 支持緩存、用戶跟踪和會話管理等功能的自定義標頭。使用 `options.headers` 將它們添加到您的提供程序配置中:
Helicone 支持緩存、用戶跟踪和會話管理等功能的自定義標頭。使用 `options.headers` 將它們添加到您的提供配置中:
```jsonc title="~/.config/opencode/opencode.jsonc"
{
@@ -1005,7 +1005,7 @@ Helicone 支持緩存、用戶跟踪和會話管理等功能的自定義標頭
##### 會話跟踪
Helicone 的 [會議](https://docs.helicone.ai/features/sessions) 功能可讓您將相關的 LLM 請求分組在一起。使用 [opencode-helicone-會話](https://github.com/H2Shami/opencode-helicone-session) 插件自動將每個 opencode 對話記錄為 Helicone 中的會話。
Helicone 的 [會議](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
@@ -1036,7 +1036,7 @@ npm install -g opencode-helicone-session
### 調用.cpp
您可以通過[駱駝.cpp 的](https://github.com/ggml-org/llama.cpp) llama-server實用程序配置opencode以使用本地模型
您可以通過[llama.cpp 的](https://github.com/ggml-org/llama.cpp) llama-server實用程序配置opencode以使用本地模型
```json title="opencode.json" "llama.cpp" {5, 6, 8, 10-15}
{
@@ -1065,8 +1065,8 @@ npm install -g opencode-helicone-session
在這個例子中:
- `llama.cpp` 是自定義提供商 ID。這可以是您想要的任何字符串。
- `npm` 指定用於此提供程序的包。這裡,`@ai-sdk/openai-compatible` 用於任何 OpenAI 兼容的 API。
- `name` 是 UI 中提供程序的顯示名稱。
- `npm` 指定用於此提供的包。這裡,`@ai-sdk/openai-compatible` 用於任何 OpenAI 兼容的 API。
- `name` 是 UI 中提供的顯示名稱。
- `options.baseURL` 是本地服務器的端點。
- `models` 是模型 ID 與其配置的映射。型號名稱將顯示在型號選擇列表中。
@@ -1076,7 +1076,7 @@ npm install -g opencode-helicone-session
IO.NET 提供了 17 種針對各種用例進行優化的模型:
1. 前往[IO.NET控制台](https://ai.io.net/),創建一個帳戶並生成一個 API 密鑰。
1. 前往[IO.NET console](https://ai.io.net/),創建一個帳戶並生成一個 API 密鑰。
2. 運行`/connect`命令並蒐索**IO.NET**。
@@ -1128,18 +1128,18 @@ IO.NET 提供了 17 種針對各種用例進行優化的模型:
在這個例子中:
- `lmstudio` 是自定義提供商 ID。這可以是您想要的任何字符串。
- `npm` 指定用於此提供程序的包。這裡,`@ai-sdk/openai-compatible` 用於任何 OpenAI 兼容的 API。
- `name` 是 UI 中提供程序的顯示名稱。
- `npm` 指定用於此提供的包。這裡,`@ai-sdk/openai-compatible` 用於任何 OpenAI 兼容的 API。
- `name` 是 UI 中提供的顯示名稱。
- `options.baseURL` 是本地服務器的端點。
- `models` 是模型 ID 與其配置的映射。型號名稱將顯示在型號選擇列表中。
---
### 登月人工智能
### 登月AI
要使用 Moonshot AI 中的 Kimi K2
1. 前往[Moonshot 人工智能控制台](https://platform.moonshot.ai/console),創建一個帳戶,然後單擊“**創建 API 密鑰**”。
1. 前往[Moonshot AI console](https://platform.moonshot.ai/console),創建一個帳戶,然後單擊“**創建 API 密鑰**”。
2. 運行 `/connect` 命令並蒐索 **Moonshot AI**。
@@ -1249,8 +1249,8 @@ Ollama 可以自動為 opencode 配置自身。詳情請參閱[Ollama 集成文
在這個例子中:
- `ollama` 是自定義提供商 ID。這可以是您想要的任何字符串。
- `npm` 指定用於此提供程序的包。這裡,`@ai-sdk/openai-compatible` 用於任何 OpenAI 兼容的 API。
- `name` 是 UI 中提供程序的顯示名稱。
- `npm` 指定用於此提供的包。這裡,`@ai-sdk/openai-compatible` 用於任何 OpenAI 兼容的 API。
- `name` 是 UI 中提供的顯示名稱。
- `options.baseURL` 是本地服務器的端點。
- `models` 是模型 ID 與其配置的映射。型號名稱將顯示在型號選擇列表中。
@@ -1299,7 +1299,7 @@ Ollama 可以自動為 opencode 配置自身。詳情請參閱[Ollama 集成文
---
### 開放人工智能
### 開放AI
我們建議註冊[ChatGPT Plus 或 Pro](https://chatgpt.com/pricing)。
@@ -1328,7 +1328,7 @@ Ollama 可以自動為 opencode 配置自身。詳情請參閱[Ollama 集成文
##### 使用 API 密鑰
如果您已有 API 密鑰,可以選擇 **手動輸入 API 密鑰** 並將其粘貼到您的終端中。
如果您已有 API 密鑰,可以選擇 **手動輸入 API 密鑰** 並將其粘貼到您的terminal中。
---
@@ -1363,7 +1363,7 @@ OpenCode Zen 是 opencode 團隊提供的經過測試和驗證的模型列表。
### 開放路由器
1. 前往[OpenRouter儀表板](https://openrouter.ai/settings/keys),單擊“**創建 API 密鑰**”,然後復制密鑰。
1. 前往[OpenRouter dashboard](https://openrouter.ai/settings/keys),單擊“**創建 API 密鑰**”,然後復制密鑰。
2. 運行`/connect`命令並蒐索OpenRouter。
@@ -1425,7 +1425,7 @@ OpenCode Zen 是 opencode 團隊提供的經過測試和驗證的模型列表。
---
### SAP人工智能核心
### SAPAI核心
SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、Meta、Mistral 和 AI21 的 40 多個模型的訪問。
@@ -1536,9 +1536,9 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M
---
### 一起人工智能
### 一起AI
1. 前往[一起AI控制台](https://api.together.ai),創建一個帳戶,然後單擊“**添加密鑰**”。
1. 前往[Together AI console](https://api.together.ai),創建一個帳戶,然後單擊“**添加密鑰**”。
2. 運行 `/connect` 命令並蒐索 **Together AI**。
@@ -1563,9 +1563,9 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M
---
### 威尼斯人工智能
### 威尼斯AI
1. 前往[威尼斯人工智能控制台](https://venice.ai),創建一個帳戶並生成一個 API 密鑰。
1. 前往[Venice AI console](https://venice.ai),創建一個帳戶並生成一個 API 密鑰。
2. 運行`/connect`命令並蒐索**Venice AI**。
@@ -1590,11 +1590,11 @@ SAP AI Core 通過統一平台提供對 OpenAI、Anthropic、Google、Amazon、M
---
### Vercel人工智能網關
### VercelAI網關
Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、Google、xAI 等的模型。型號按標價提供,不加價。
1. 前往[維塞爾儀表板](https://vercel.com/),導航至 **AI Gateway** 選項卡,然後單擊 **API 密鑰** 以創建新的 API 密鑰。
1. 前往[Vercel dashboard](https://vercel.com/),導航至 **AI Gateway** 選項卡,然後單擊 **API 密鑰** 以創建新的 API 密鑰。
2. 運行 `/connect` 命令並蒐索 **Vercel AI Gateway**。
@@ -1746,10 +1746,10 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G
## 定制提供商
要添加 `/connect` 命令中未列出的任何 **OpenAI 兼容** 提供程序
要添加 `/connect` 命令中未列出的任何 **OpenAI 兼容** 提供
:::tip
您可以將任何與 OpenAI 兼容的提供程序與 opencode 結合使用。大多數現代人工智能提供商都提供與 OpenAI 兼容的 API。
您可以將任何與 OpenAI 兼容的提供與 opencode 結合使用。大多數現代AI提供商都提供與 OpenAI 兼容的 API。
:::
1. 運行 `/connect` 命令並向下滾動到 **其他**。
@@ -1827,7 +1827,7 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G
有關高級選項的更多信息,請參見下面的示例。
5. 運行 `/models` 命令,您的自定義提供程序和模型將出現在選擇列表中。
5. 運行 `/models` 命令,您的自定義提供和模型將出現在選擇列表中。
---
@@ -1883,7 +1883,7 @@ Vercel AI Gateway 可讓您通過統一端點訪問來自 OpenAI、Anthropic、G
這不適用於 Amazon Bedrock 等依賴環境變量進行身份驗證的提供商。
2. 對於自定義提供程序,請檢查 opencode 配置並:
- 確保 `/connect` 命令中使用的提供程序 ID 與 opencode 配置中的 ID 匹配。
- 正確的 npm 包用於提供程序。例如,對 Cerebras 使用 `@ai-sdk/cerebras`。對於所有其他 OpenAI 兼容提供商,請使用 `@ai-sdk/openai-compatible`。
2. 對於自定義提供,請檢查 opencode 配置並:
- 確保 `/connect` 命令中使用的提供 ID 與 opencode 配置中的 ID 匹配。
- 正確的 npm 包用於提供。例如,對 Cerebras 使用 `@ai-sdk/cerebras`。對於所有其他 OpenAI 兼容提供商,請使用 `@ai-sdk/openai-compatible`。
- 檢查 `options.baseURL` 字段中使用了正確的 API 端點。

View File

@@ -66,7 +66,7 @@ opencode 還支持從多個位置讀取 `AGENTS.md` 文件。這有不同的目
由於這未提交給 Git 或與您的團隊共享,因此我們建議使用它來指定 LLM 應遵循的任何個人規則。
### 克勞德碼兼容性
### 克勞德程式碼兼容性
對於從 Claude Code 遷移的用戶opencode 支持 Claude Code 的文件約定作為後備:
@@ -90,7 +90,7 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills
1. **本地文件**,從當前目錄向上遍歷(`AGENTS.md`,`CLAUDE.md`)
2. **全局文件** `~/.config/opencode/AGENTS.md`
3. **克勞德碼文件**位於`~/.claude/CLAUDE.md`(除非禁用)
3. **克勞德程式碼文件**位於`~/.claude/CLAUDE.md`(除非禁用)
第一個匹配的文件在每個類別中獲勝。例如,如果您同時擁有`AGENTS.md` 和`CLAUDE.md`,則僅使用`AGENTS.md`。同樣,`~/.config/opencode/AGENTS.md` 優先於`~/.claude/CLAUDE.md`。
@@ -171,7 +171,7 @@ Read the following file immediately as it's relevant to all workflows: @rules/ge
這種方法允許您:
- 創建模塊化、可重用的規則文件
- 通過符號鏈接或 git 子模塊在項目之間共享規則
- 通過符號連結或 git 子模塊在項目之間共享規則
- 保持 AGENTS.md 簡潔,同時參考詳細指南
- 確保 opencode 僅在特定任務需要時加載文件

View File

@@ -234,7 +234,7 @@ const { providers, default: defaults } = await client.config.providers()
| `session.create({ body })` | 創建會話 | 返回 <a href={typesUrl}><code>Session</code></a> |
| `session.delete({ path })` | 刪除會話 | 返回 `boolean` |
| `session.update({ path, body })` | 更新會話屬性 | 返回 <a href={typesUrl}><code>Session</code></a> |
| `session.init({ path, body })` | 分析應用程並創建`AGENTS.md` | 返回 `boolean` |
| `session.init({ path, body })` | 分析應用程並創建`AGENTS.md` | 返回 `boolean` |
| `session.abort({ path })` | 中止正在運行的會話 | 返回 `boolean` |
| `session.share({ path })` | 分享會 | 返回 <a href={typesUrl}><code>Session</code></a> |
| `session.unshare({ path })` | 取消共享會話 | 返回 <a href={typesUrl}><code>Session</code></a> |

View File

@@ -155,7 +155,7 @@ opencode 服務器公開以下 API。
| `PATCH` | `/session/:id` | 更新會話屬性 | 正文:`{ title? }`,返回 <a href={typesUrl}><code>Session</code></a> |
| `GET` | `/session/:id/children` | 獲取會話的子會話 | 返回 <a href={typesUrl}><code>Session[]</code></a> |
| `GET` | `/session/:id/todo` | 獲取會話的待辦事項列表 | 返回 <a href={typesUrl}><code>Todo[]</code></a> |
| `POST` | `/session/:id/init` | 分析應用程並創建`AGENTS.md` | 主體:`{ messageID, providerID, modelID }`,返回`boolean` |
| `POST` | `/session/:id/init` | 分析應用程並創建`AGENTS.md` | 主體:`{ messageID, providerID, modelID }`,返回`boolean` |
| `POST` | `/session/:id/fork` | 在消息中分叉現有會話 | 正文:`{ messageID? }`,返回 <a href={typesUrl}><code>Session</code></a> |
| `POST` | `/session/:id/abort` | 中止正在運行的會話 | 返回 `boolean` |
| `POST` | `/session/:id/share` | 分享會議 | 返回 <a href={typesUrl}><code>Session</code></a> |
@@ -230,7 +230,7 @@ opencode 服務器公開以下 API。
---
### 代理商
### Agents
| 方法 | 路徑 | 描述 | 回應 |
| ----- | -------- | ------------------ | ------------------------------------------ |

View File

@@ -3,10 +3,10 @@ title: 分享
description: 分享您的 opencode 對話。
---
opencode 的共享功能允許您創建 opencode 對話的公共鏈接,以便您可以與團隊成員協作或從其他人那裡獲得幫助。
opencode 的共享功能允許您創建 opencode 對話的公共連結,以便您可以與團隊成員協作或從其他人那裡獲得幫助。
:::note
任何知道鏈接的人都可以公開訪問共享對話。
任何知道連結的人都可以公開訪問共享對話。
:::
---
@@ -17,7 +17,7 @@ opencode 的共享功能允許您創建 opencode 對話的公共鏈接,以便
1. 為您的會話創建唯一的公共 URL
2. 將您的對話歷史記錄同步到我們的服務器
3. 通過可共享鏈接進行對話 — `opncd.ai/s/<share-id>`
3. 通過可共享連結進行對話 — `opncd.ai/s/<share-id>`
---
@@ -59,7 +59,7 @@ opencode默認使用手動共享模式。會話不會自動共享但您可以
}
```
啟用自動共享後,每個新對話都會自動共享並生成鏈接
啟用自動共享後,每個新對話都會自動共享並生成連結
---
@@ -86,7 +86,7 @@ opencode默認使用手動共享模式。會話不會自動共享但您可以
/unshare
```
這將刪除共享鏈接並刪除與對話相關的數據。
這將刪除共享連結並刪除與對話相關的數據。
---
@@ -112,7 +112,7 @@ opencode默認使用手動共享模式。會話不會自動共享但您可以
- 僅共享不包含敏感信息的對話。
- 分享之前查看對話內容。
- 協作完成後取消共享對話。
- 避免與專有碼或機密數據共享對話。
- 避免與專有程式碼或機密數據共享對話。
- 對於敏感項目,完全禁用共享。
---

View File

@@ -3,19 +3,19 @@ title: 主題
description: 選擇內置主題或定義您自己的主題。
---
使用 opencode您可以從多個內置主題之一中進行選擇使用適合您的終端主題的主題,或者定義您自己的自定義主題。
使用 opencode您可以從多個內置主題之一中進行選擇使用適合您的terminal主題的主題,或者定義您自己的自定義主題。
默認情況下opencode 使用我們自己的 `opencode` 主題。
---
## 終端要求
## terminal要求
為了使主題能夠正確顯示完整的調色板,您的終端必須支持**真彩色**24 位顏色)。大多數現代終端默認支持此功能,但您可能需要啟用它:
為了使主題能夠正確顯示完整的調色板,您的terminal必須支持**真彩色**24 位顏色)。大多數現代terminal默認支持此功能,但您可能需要啟用它:
- **檢查支持**:運行`echo $COLORTERM` - 它應該輸出`truecolor`或`24bit`
- **啟用真彩色**:在 shell 配置文件中設置環境變量 `COLORTERM=truecolor`
- **終端兼容性**:確保您的終端模擬器支持 24 位顏色(大多數現代終端,​​如 iTerm2、Alacritty、Kitty、Windows 終端和最新版本的 GNOME 終端都支持)
- **terminal兼容性**:確保您的terminal模擬器支持 24 位顏色(大多數現代terminal,​​如 iTerm2、Alacritty、Kitty、Windows terminal和最新版本的 GNOME terminal都支持)
如果沒有真彩色支持,主題的顏色精度可能會降低或回落到最接近的 256 色近似值。
@@ -27,17 +27,17 @@ opencode 附帶了幾個內置主題。
| 名稱 | 描述 |
| ---------------------- | ----------------------------------------------------------------- |
| `system` | 適應您終端的背景顏色 |
| `tokyonight` | 基於[東京之夜](https://github.com/folke/tokyonight.nvim)主題 |
| `everforest` | 基於[永福森林](https://github.com/sainnhe/everforest)主題 |
| `ayu` | 基於[香魚](https://github.com/ayu-theme)深色主題 |
| `catppuccin` | 基於[卡普布辛](https://github.com/catppuccin)主題 |
| `catppuccin-macchiato` | 基於[卡普布辛](https://github.com/catppuccin)主題 |
| `gruvbox` | 基於[礦箱](https://github.com/morhetz/gruvbox)主題 |
| `kanagawa` | 基於[神奈川](https://github.com/rebelot/kanagawa.nvim)主題 |
| `nord` | 基於[諾德](https://github.com/nordtheme/nord)主題 |
| `system` | 適應您terminal的背景顏色 |
| `tokyonight` | 基於[tokyonight](https://github.com/folke/tokyonight.nvim)主題 |
| `everforest` | 基於[everforest](https://github.com/sainnhe/everforest)主題 |
| `ayu` | 基於[ayu](https://github.com/ayu-theme)深色主題 |
| `catppuccin` | 基於[catppuccin](https://github.com/catppuccin)主題 |
| `catppuccin-macchiato` | 基於[catppuccin](https://github.com/catppuccin)主題 |
| `gruvbox` | 基於[gruvbox](https://github.com/morhetz/gruvbox)主題 |
| `kanagawa` | 基於[kanagawa](https://github.com/rebelot/kanagawa.nvim)主題 |
| `nord` | 基於[Nord](https://github.com/nordtheme/nord)主題 |
| `matrix` | 黑客風格黑底綠主題 |
| `one-dark` | 基於[原子一號](https://github.com/Th3Whit3Wolf/one-nvim) 深色主題 |
| `one-dark` | 基於[One Dark](https://github.com/Th3Whit3Wolf/one-nvim) 深色主題 |
此外,我們還在不斷添加新主題。
@@ -45,17 +45,17 @@ opencode 附帶了幾個內置主題。
## 系統主題
`system` 主題旨在自動適應您終端的配色方案。與使用固定顏色的傳統主題不同_system_ 主題:
`system` 主題旨在自動適應您terminal的配色方案。與使用固定顏色的傳統主題不同_system_ 主題:
- **生成灰度**:根據終端的背景顏色創建自定義灰度,確保最佳對比度。
- **使用 ANSI 顏色**:利用標準 ANSI 顏色 (0-15) 進行語法突出顯示和 UI 元素,尊重終端的調色板。
- **保留終端默認設置**:使用 `none` 作為文本和背景顏色,以保持終端的本機外觀。
- **生成灰度**:根據terminal的背景顏色創建自定義灰度,確保最佳對比度。
- **使用 ANSI 顏色**:利用標準 ANSI 顏色 (0-15) 進行語法突出顯示和 UI 元素,尊重terminal的調色板。
- **保留terminal默認設置**:使用 `none` 作為文本和背景顏色,以保持terminal的本機外觀。
系統主題適合以下用戶:
- 希望 opencode 與其終端的外觀相匹配
- 使用自定義終端配色方案
- 希望所有終端應用程具有一致的外觀
- 希望 opencode 與其terminal的外觀相匹配
- 使用自定義terminal配色方案
- 希望所有terminal應用程具有一致的外觀
---
@@ -119,7 +119,7 @@ vim .opencode/themes/my-theme.json
- **ANSI 顏色**`3` (0-255)
- **顏色參考**`"primary"` 或自定義定義
- **深色/淺色版本**`{"dark": "#000", "light": "#fff"}`
- **無顏色**`"none"` - 使用終端的默認顏色或透明
- **無顏色**`"none"` - 使用terminal的默認顏色或透明
---
@@ -129,12 +129,12 @@ vim .opencode/themes/my-theme.json
---
### 終端默認值
### terminal默認值
特殊值`"none"`可用於任何顏色以繼承終端的默認顏色。這對於創建與終端配色方案無縫融合的主題特別有用:
特殊值`"none"`可用於任何顏色以繼承terminal的默認顏色。這對於創建與terminal配色方案無縫融合的主題特別有用:
- `"text": "none"` - 使用終端的默認前景色
- `"background": "none"` - 使用終端的默認背景顏色
- `"text": "none"` - 使用terminal的默認前景色
- `"background": "none"` - 使用terminal的默認背景顏色
---

View File

@@ -3,7 +3,7 @@ title: 工具
description: 管理LLM可以使用的工具。
---
工具允許 LLM 在您的碼庫中執行操作。 opencode 附帶了一組內置工具,但您可以使用[定制工具](/docs/custom-tools) 或[MCP服務器](/docs/mcp-servers) 對其進行擴展。
工具允許 LLM 在您的程式碼庫中執行操作。 opencode 附帶了一組內置工具,但您可以使用[定制工具](/docs/custom-tools) 或[MCP服務器](/docs/mcp-servers) 對其進行擴展。
默認情況下,所有工具都是**啟用**並且不需要運行權限。您可以通過[權限](/docs/permissions)控制工具行為。
@@ -58,7 +58,7 @@ description: 管理LLM可以使用的工具。
}
```
該工具允許LLM運行 `npm install`、`git status` 等終端命令或任何其他 shell 命令。
該工具允許LLM運行 `npm install`、`git status` 等terminal 命令或任何其他 shell 命令。
---
@@ -75,7 +75,7 @@ description: 管理LLM可以使用的工具。
}
```
該工具通過替換精確的文本匹配來對文件執行精確編輯。這是LLM修改碼的主要方式。
該工具通過替換精確的文本匹配來對文件執行精確編輯。這是LLM修改程式碼的主要方式。
---
@@ -102,7 +102,7 @@ description: 管理LLM可以使用的工具。
### read
碼庫中讀取文件內容。
程式碼庫中讀取文件內容。
```json title="opencode.json" {4}
{
@@ -130,7 +130,7 @@ description: 管理LLM可以使用的工具。
}
```
在您的碼庫中快速進行內容搜索。支持完整的正則表達式語法和文件模式過濾。
在您的程式碼庫中快速進行內容搜索。支持完整的正則表達式語法和文件模式過濾。
---
@@ -170,7 +170,7 @@ description: 管理LLM可以使用的工具。
### lsp實驗性
與您配置的 LSP 服務器交互,以獲得碼智能功能,例如定義、引用、懸停信息和調用層次結構。
與您配置的 LSP 服務器交互,以獲得程式碼智能功能,例如定義、引用、懸停信息和調用層次結構。
:::note
該工具僅在`OPENCODE_EXPERIMENTAL_LSP_TOOL=true`(或`OPENCODE_EXPERIMENTAL=true`)時可用。
@@ -204,7 +204,7 @@ description: 管理LLM可以使用的工具。
}
```
該工具將補丁文件應用到您的碼庫。對於應用來自各種來源的差異和補丁很有用。
該工具將補丁文件應用到您的程式碼庫。對於應用來自各種來源的差異和補丁很有用。
:::note
`patch`工具由`edit`權限控制,該權限涵蓋所有文件修改(`edit`、`write`、`patch`、`multiedit`)。
@@ -291,7 +291,7 @@ description: 管理LLM可以使用的工具。
在網絡上搜索信息。
:::note
僅當使用 opencode 提供程序或 `OPENCODE_ENABLE_EXA` 環境變量設置為任何真值(例如 `true` 或 `1`)時,此工具才可用。
僅當使用 opencode 提供或 `OPENCODE_ENABLE_EXA` 環境變量設置為任何真值(例如 `true` 或 `1`)時,此工具才可用。
要在啟動 opencode 時啟用:
@@ -346,7 +346,7 @@ OPENCODE_ENABLE_EXA=1 opencode
## 定制工具
自定義工具可讓您定義LLM可以調用的自己的函數。這些是在您的配置文件中定義的並且可以執行任意碼。
自定義工具可讓您定義LLM可以調用的自己的函數。這些是在您的配置文件中定義的並且可以執行任意程式碼。
[了解更多](/docs/custom-tools) 關於創建自定義工具。

View File

@@ -22,7 +22,7 @@ description: 常見問題以及如何解決它們。
## 貯存
opencode 將會話數據和其他應用程數據存儲在磁盤上:
opencode 將會話數據和其他應用程數據存儲在磁盤上:
- **macOS/Linux**`~/.local/share/opencode/`
- **Windows**:按`WIN+R`並粘貼`%USERPROFILE%\.local\share\opencode`
@@ -30,28 +30,28 @@ opencode 將會話數據和其他應用程序數據存儲在磁盤上:
該目錄包含:
- `auth.json` - 身份驗證數據,例如 API 密鑰、OAuth 令牌
- `log/` - 應用程日誌
- `log/` - 應用程日誌
- `project/` - 項目特定數據,例如會話和消息數據
- 如果項目位於 Git 存儲庫中,則它存儲在 `./<project-slug>/storage/` 中
- 如果不是 Git 存儲庫,則存儲在 `./global/storage/` 中
---
## 桌面應用程
## 桌面應用程
opencode Desktop 在後台運行本地 opencode 服務器(`opencode-cli` sidecar。大多數問題是由行為不當的插件、損壞的緩存或錯誤的服務器設置引起的。
### 快速檢查
- 完全退出並重新啟動應用程
- 如果應用程顯示錯誤屏幕,請單擊“**重新啟動**”並複制錯誤詳細信息。
- 完全退出並重新啟動應用程
- 如果應用程顯示錯誤屏幕,請單擊“**重新啟動**”並複制錯誤詳細信息。
- 僅限 macOS`opencode` 菜單 -> **重新加載 Webview**(如果 UI 為空白/凍結,則有幫助)。
---
### 禁用插件
如果桌面應用程在啟動時崩潰、掛起或行為異常,請首先禁用插件。
如果桌面應用程在啟動時崩潰、掛起或行為異常,請首先禁用插件。
#### 檢查全局配置
@@ -72,7 +72,7 @@ opencode Desktop 在後台運行本地 opencode 服務器(`opencode-cli` sidec
#### 檢查插件目錄
opencode 還可以從磁盤加載本地插件。暫時將它們移開(或重命名文件夾)並重新啟動桌面應用程
opencode 還可以從磁盤加載本地插件。暫時將它們移開(或重命名文件夾)並重新啟動桌面應用程
- **全局插件**
- **macOS/Linux**`~/.config/opencode/plugins/`
@@ -80,7 +80,7 @@ opencode 還可以從磁盤加載本地插件。暫時將它們移開(或重
- **項目插件**(僅當您使用每個項目配置時)
- `<your-project>/.opencode/plugins/`
如果應用程再次開始工作,請一次重新啟用一個插件,以找出導致問題的插件。
如果應用程再次開始工作,請一次重新啟用一個插件,以找出導致問題的插件。
---
@@ -103,7 +103,7 @@ opencode 還可以從磁盤加載本地插件。暫時將它們移開(或重
opencode Desktop 可以啟動自己的本地服務器(默認)或連接到您配置的服務器 URL。
如果您看到 **“連接失敗”** 對話框(或者應用程永遠無法通過啟動屏幕),請檢查自定義服務器 URL。
如果您看到 **“連接失敗”** 對話框(或者應用程永遠無法通過啟動屏幕),請檢查自定義服務器 URL。
#### 清除桌面默認服務器 URL
@@ -111,11 +111,11 @@ opencode Desktop 可以啟動自己的本地服務器(默認)或連接到您
#### 從您的配置中刪除`server.port` / `server.hostname`
如果您的 `opencode.json(c)` 包含 `server` 部分,請將其暫時刪除並重新啟動桌面應用程
如果您的 `opencode.json(c)` 包含 `server` 部分,請將其暫時刪除並重新啟動桌面應用程
#### 檢查環境變量
如果您在環境中設置了 `OPENCODE_PORT`,桌面應用程將嘗試將該端口用於本地服務器。
如果您在環境中設置了 `OPENCODE_PORT`,桌面應用程將嘗試將該端口用於本地服務器。
- 取消設置`OPENCODE_PORT`(或選擇一個空閒端口)並重新啟動。
@@ -125,20 +125,20 @@ opencode Desktop 可以啟動自己的本地服務器(默認)或連接到您
在 Linux 上,某些 Wayland 設置可能會導致空白窗口或合成器錯誤。
- 如果您在 Wayland 上且應用程空白/崩潰,請嘗試使用 `OC_ALLOW_WAYLAND=1` 啟動。
- 如果您在 Wayland 上且應用程空白/崩潰,請嘗試使用 `OC_ALLOW_WAYLAND=1` 啟動。
- 如果這讓事情變得更糟,請將其刪除並嘗試在 X11 會話下啟動。
---
### WindowsWebView2 運行時
在 Windows 上opencode Desktop 需要 Microsoft Edge **WebView2 運行時**。如果應用程打開為空白窗口或無法啟動,請安裝/更新 WebView2然後重試。
在 Windows 上opencode Desktop 需要 Microsoft Edge **WebView2 運行時**。如果應用程打開為空白窗口或無法啟動,請安裝/更新 WebView2然後重試。
---
### Windows一般性能問題
如果您在 Windows 上遇到性能緩慢、文件訪問問題或終端問題,請嘗試使用[WSL適用於 Linux 的 Windows 子系統)](/docs/windows-wsl)。 WSL 提供了一個可以與 opencode 功能更加無縫協作的 Linux 環境。
如果您在 Windows 上遇到性能緩慢、文件訪問問題或terminal問題,請嘗試使用[WSL適用於 Linux 的 Windows 子系統)](/docs/windows-wsl)。 WSL 提供了一個可以與 opencode 功能更加無縫協作的 Linux 環境。
---
@@ -147,16 +147,16 @@ opencode Desktop 可以啟動自己的本地服務器(默認)或連接到您
opencode Desktop 僅在以下情況下顯示系統通知:
- 在您的操作系統設置中啟用 opencode 通知,並且
- 應用程窗口未聚焦。
- 應用程窗口未聚焦。
---
### 重置桌面應用程存儲(最後的手段)
### 重置桌面應用程存儲(最後的手段)
如果應用程無法啟動並且您無法從 UI 內部清除設置,請重置桌面應用程的保存狀態。
如果應用程無法啟動並且您無法從 UI 內部清除設置,請重置桌面應用程的保存狀態。
1. 退出 opencode Desktop。
2. 查找並刪除這些文件(它們位於 opencode Desktop 應用程數據目錄中):
2. 查找並刪除這些文件(它們位於 opencode Desktop 應用程數據目錄中):
- `opencode.settings.dat`(桌面默認服務器 URL
- `opencode.global.dat` 和 `opencode.workspace.*.dat`UI 狀態,如最近的服務器/項目)
@@ -198,7 +198,7 @@ opencode Desktop 僅在以下情況下顯示系統通知:
### opencode 無法啟動
1. 檢查日誌中是否有錯誤消息
2. 嘗試使用 `--print-logs` 運行以查看終端中的輸出
2. 嘗試使用 `--print-logs` 運行以查看terminal 中的輸出
3. 確保您擁有最新版本`opencode upgrade`
---
@@ -250,13 +250,13 @@ opencode Desktop 僅在以下情況下顯示系統通知:
---
### AI_APICallError 和提供程序包問題
### AI_APICallError 和提供商套件問題
如果您遇到 API 調用錯誤,這可能是由於過時的提供程序包造成的。 opencode 根據需要動態安裝提供程序包OpenAI、Anthropic、Google 等)並將其緩存在本地。
如果您遇到 API 調用錯誤,這可能是由於過時的提供商套件造成的。 opencode 根據需要動態安裝提供商套件OpenAI、Anthropic、Google 等)並將其緩存在本地。
要解決提供程序包問題:
要解決提供商套件問題:
1. 清除提供程序包緩存:
1. 清除提供商套件緩存:
```bash
rm -rf ~/.cache/opencode
@@ -264,9 +264,9 @@ opencode Desktop 僅在以下情況下顯示系統通知:
在 Windows 上,按 `WIN+R` 並刪除:`%USERPROFILE%\.cache\opencode`
2. 重新啟動 opencode 以重新安裝最新的提供程序包
2. 重新啟動 opencode 以重新安裝最新的提供商套件
這將強制 opencode 下載最新版本的提供程序包,這通常可以解決模型參數和 API 更改的兼容性問題。
這將強制 opencode 下載最新版本的提供商套件,這通常可以解決模型參數和 API 更改的兼容性問題。
---

View File

@@ -1,11 +1,11 @@
---
title: 途易
description: 使用 opencode 終端用戶面。
description: 使用 opencode terminal用戶面。
---
import { Tabs, TabItem } from "@astrojs/starlight/components"
opencode 提供了一個交互式終端界面或 TUI供您與LLM一起處理項目。
opencode 提供了一個交互式terminal介面或 TUI供您與LLM一起處理項目。
運行 opencode 會啟動當前目錄的 TUI。
@@ -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
@@ -336,7 +336,7 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x`
流行的編輯器選項包括:
- `code` - Visual Studio
- `code` - Visual Studio 程式
- `cursor` - 光標
- `windsurf` - 風帆衝浪
- `nvim` - Neovim 編輯器

View File

@@ -3,13 +3,13 @@ title: 網絡
description: 在瀏覽器中使用 opencode。
---
opencode 可以在瀏覽器中作為 Web 應用程運行,無需終端即可提供同樣強大的 AI 編碼體驗。
opencode 可以在瀏覽器中作為 Web 應用程運行,無需terminal即可提供同樣強大的 AI 編碼體驗。
![opencode Web - 新會話](../../../assets/web/web-homepage-new-session.png)
## 入門
通過運行以下命令啟動 Web 面:
通過運行以下命令啟動 Web 面:
```bash
opencode web
@@ -22,7 +22,7 @@ opencode web
:::
:::tip[Windows 用戶]
為了獲得最佳體驗,請從 [世界SL](/docs/windows-wsl) 而不是 PowerShell 運行 `opencode web`。這確保了正確的文件系統訪問和終端集成。
為了獲得最佳體驗,請從 [WSL](/docs/windows-wsl) 而不是 PowerShell 運行 `opencode web`。這確保了正確的檔案系統訪問和terminal集成。
:::
---
@@ -90,9 +90,9 @@ OPENCODE_SERVER_PASSWORD=secret opencode web
---
## 使用網絡
## 使用網絡
啟動後Web 面將提供對 opencode 會話的訪問。
啟動後Web 面將提供對 opencode 會話的訪問。
### 會議
@@ -108,9 +108,9 @@ OPENCODE_SERVER_PASSWORD=secret opencode web
---
## 連接終端
## 連接terminal
您可以將終端 TUI 連接到正在運行的 Web 服務器:
您可以將terminal TUI 連接到正在運行的 Web 服務器:
```bash
# Start the web server
@@ -120,7 +120,7 @@ opencode web --port 4096
opencode attach http://localhost:4096
```
這允許您同時使用 Web 面和終端,共享相同的會話和狀態。
這允許您同時使用 Web 面和terminal,共享相同的會話和狀態。
---

View File

@@ -8,7 +8,7 @@ import { Steps } from "@astrojs/starlight/components"
雖然 opencode 可以直接在 Windows 上執行,但為了獲得最佳體驗,我們建議使用 [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install)。WSL 提供了可與 opencode 功能順暢配合的 Linux 環境。
:::tip[為什麼要用 WSL]
WSL 提供更好的檔案系統效能、完整的終端支援,以及與 opencode 依賴之開發工具的相容性。
WSL 提供更好的檔案系統效能、完整的terminal支援,以及與 opencode 依賴之開發工具的相容性。
:::
---
@@ -23,7 +23,7 @@ WSL 提供更好的檔案系統效能、完整的終端支援,以及與 openco
2. **在 WSL 中安裝 opencode**
完成 WSL 設定後,打開 WSL 終端機,並使用其中一種[安裝方式](/docs/)安裝 opencode。
完成 WSL 設定後,打開 WSL terminal,並使用其中一種[安裝方式](/docs/)安裝 opencode。
```bash
curl -fsSL https://opencode.ai/install | bash
@@ -73,7 +73,7 @@ OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0
在 Windows 上取得最佳 Web 體驗:
1. **請在 WSL 終端機執行 `opencode web`**,而不是在 PowerShell 執行:
1. **請在 WSL terminal執行 `opencode web`**,而不是在 PowerShell 執行:
```bash
opencode web --hostname 0.0.0.0
@@ -81,7 +81,7 @@ OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0
2. **在 Windows 瀏覽器中開啟** `http://localhost:<port>`opencode 會輸出該 URL
從 WSL 執行 `opencode web` 可確保正確的檔案系統存取與終端整合,同時仍可由 Windows 瀏覽器使用。
從 WSL 執行 `opencode web` 可確保正確的檔案系統存取與terminal整合,同時仍可由 Windows 瀏覽器使用。
---

View File

@@ -13,7 +13,7 @@ OpenCode Zen 是 opencode 團隊提供的經過測試和驗證的模型列表。
OpenCode Zen 目前處於測試階段。
:::
Zen 的工作方式與 opencode 中的任何其他提供程序一樣。您登錄 OpenCode Zen 並獲取
Zen 的工作方式與 opencode 中的任何其他提供一樣。您登錄 OpenCode Zen 並獲取
您的 API 密鑰。它是**完全可選的**,您不需要使用它即可使用
opencode。
@@ -26,7 +26,7 @@ opencode。
配置非常不同;所以你會得到截然不同的性能和質量。
:::tip
我們測試了一組精選的與 opencode 配合良好的模型和提供程序
我們測試了一組精選的與 opencode 配合良好的模型和提供
:::
因此,如果您通過 OpenRouter 之類的東西使用模型,那麼您永遠無法
@@ -47,7 +47,7 @@ OpenCode Zen 是一個 AI 網關,可讓您訪問這些模型。
## 它是如何運作的
OpenCode Zen 的工作方式與 opencode 中的任何其他提供程序一樣。
OpenCode Zen 的工作方式與 opencode 中的任何其他提供一樣。
1. 您登錄 **<a href={console}>OpenCode Zen</a>**,添加您的帳單
詳細信息,然後復制您的 API 密鑰。
@@ -251,4 +251,4 @@ Zen 對團隊也很有效。您可以邀請隊友、分配角色、策劃
1. **對標**編碼代理的最佳模型/提供商。
2. 可以使用**最高質量**選項,而不是降低性能或轉向更便宜的提供商。
3. 通過按成本價銷售來傳遞任何**價格下跌**;所以唯一的加價就是支付我們的加工費。
4. 通過允許您將其與任何其他編碼代理一起使用,**無鎖定**。並且始終允許您將任何其他提供程序與 opencode 一起使用。
4. 通過允許您將其與任何其他編碼代理一起使用,**無鎖定**。並且始終允許您將任何其他提供與 opencode 一起使用。