mirror of
https://gitea.toothfairyai.com/ToothFairyAI/tf_code.git
synced 2026-04-10 02:39:56 +00:00
fix(docs): locale translations
This commit is contained in:
@@ -61,7 +61,7 @@ $ opencode upgrade 0.15.31
|
||||
- 文件搜索
|
||||
- 文件關閉
|
||||
- 文件列表
|
||||
- 應用程序幫助
|
||||
- 應用程式幫助
|
||||
- 項目初始化
|
||||
- 工具詳細信息
|
||||
- 思維塊
|
||||
|
||||
@@ -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` 的項目特定規則
|
||||
|
||||
@@ -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)。
|
||||
:::
|
||||
|
||||
---
|
||||
|
||||
@@ -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(代理客戶端協議)服務器。
|
||||
啟動 ACP(Agent 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 服務器下載 |
|
||||
|
||||
@@ -75,7 +75,7 @@ frontmatter 定義命令屬性。內容成為模板。
|
||||
|
||||
---
|
||||
|
||||
### 降價
|
||||
### Markdown
|
||||
|
||||
您還可以使用 Markdown 文件定義命令。將它們放入:
|
||||
|
||||
|
||||
@@ -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` 優先考慮向後兼容性。
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -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) | 用於增強工作流程的配置、提示、代理和插件 |
|
||||
|
||||
@@ -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>
|
||||
|
||||
|
||||
@@ -3,7 +3,7 @@ title: 格式化程序
|
||||
description: opencode 使用特定於語言的格式化程序。
|
||||
---
|
||||
|
||||
使用特定於語言的格式化程序編寫或編輯文件後,opencode 會自動格式化文件。這可確保生成的代碼遵循項目的代碼風格。
|
||||
使用特定於語言的格式化程序編寫或編輯文件後,opencode 會自動格式化文件。這可確保生成的程式碼遵循項目的程式碼風格。
|
||||
|
||||
---
|
||||
|
||||
@@ -50,7 +50,7 @@ opencode 附帶了多個適用於流行語言和框架的內置格式化程序
|
||||
2. 對文件運行適當的格式化程序命令。
|
||||
3. 自動應用格式更改。
|
||||
|
||||
此過程在後台進行,確保無需任何手動步驟即可維護您的代碼樣式。
|
||||
此過程在後台進行,確保無需任何手動步驟即可維護您的程式碼樣式。
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -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.That’s an error.There was an error. Please try again later.That’s all we know.
|
||||
|
||||
- **查看特定代碼行**
|
||||
- **查看特定程式碼行**
|
||||
|
||||
直接在 PR 的“文件”選項卡中的代碼行上留下評論。 opencode 自動檢測文件、行號和差異上下文以提供精確的響應。
|
||||
直接在 PR 的“文件”選項卡中的程式碼行上留下評論。 opencode 自動檢測文件、行號和差異上下文以提供精確的響應。
|
||||
|
||||
```
|
||||
[Comment on specific lines in Files tab]
|
||||
@@ -314,7 +314,7 @@ jobs:
|
||||
|
||||
Error 500 (Server Error)!!1500.That’s an error.There was an error. Please try again later.That’s all we know.
|
||||
- 正在審查的確切文件
|
||||
- 具體代碼行
|
||||
- 具體程式碼行
|
||||
- 周圍的 diff 上下文
|
||||
- 行號信息
|
||||
|
||||
|
||||
@@ -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` 命令
|
||||
|
||||
@@ -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 擴展。
|
||||
|
||||

|
||||
|
||||
@@ -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)。
|
||||
|
||||
@@ -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或打開新選項卡。
|
||||
|
||||
@@ -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` 依賴項已安裝 |
|
||||
|
||||
@@ -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}
|
||||
{
|
||||
|
||||
@@ -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` - 最大思維預算
|
||||
|
||||
@@ -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 和讀取工具的調查
|
||||
- **文檔模式**:使用文件操作但不使用系統命令的文檔編寫
|
||||
|
||||
|
||||
@@ -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) 關於代理權限。
|
||||
|
||||
|
||||
@@ -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)。
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -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.That’s an error.There was an error. Please try again later.That’s 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 端點。
|
||||
|
||||
@@ -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 僅在特定任務需要時加載文件
|
||||
|
||||
|
||||
@@ -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> |
|
||||
|
||||
@@ -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
|
||||
|
||||
| 方法 | 路徑 | 描述 | 回應 |
|
||||
| ----- | -------- | ------------------ | ------------------------------------------ |
|
||||
|
||||
@@ -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默認使用手動共享模式。會話不會自動共享,但您可以
|
||||
- 僅共享不包含敏感信息的對話。
|
||||
- 分享之前查看對話內容。
|
||||
- 協作完成後取消共享對話。
|
||||
- 避免與專有代碼或機密數據共享對話。
|
||||
- 避免與專有程式碼或機密數據共享對話。
|
||||
- 對於敏感項目,完全禁用共享。
|
||||
|
||||
---
|
||||
|
||||
@@ -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的默認背景顏色
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -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) 關於創建自定義工具。
|
||||
|
||||
|
||||
@@ -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 會話下啟動。
|
||||
|
||||
---
|
||||
|
||||
### Windows:WebView2 運行時
|
||||
|
||||
在 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 更改的兼容性問題。
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -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 編輯器
|
||||
|
||||
@@ -3,13 +3,13 @@ title: 網絡
|
||||
description: 在瀏覽器中使用 opencode。
|
||||
---
|
||||
|
||||
opencode 可以在瀏覽器中作為 Web 應用程序運行,無需終端即可提供同樣強大的 AI 編碼體驗。
|
||||
opencode 可以在瀏覽器中作為 Web 應用程式運行,無需terminal即可提供同樣強大的 AI 編碼體驗。
|
||||
|
||||

|
||||
|
||||
## 入門
|
||||
|
||||
通過運行以下命令啟動 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,共享相同的會話和狀態。
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -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 瀏覽器使用。
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -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 一起使用。
|
||||
|
||||
Reference in New Issue
Block a user