fix(docs): locale translations

This commit is contained in:
Adam
2026-02-10 13:59:14 -06:00
committed by opencode
parent fbc41475b4
commit fd5531316f
282 changed files with 4973 additions and 5314 deletions

View File

@@ -1,9 +1,9 @@
---
title: ACP 支持
description: 在任何 ACP 兼容編輯器中使用 opencode。
description: 在任何 ACP 兼容編輯器中使用 OpenCode。
---
opencode 支持 [Agent Client Protocol](https://agentclientprotocol.com) 或 (ACP),允許您直接在兼容的編輯器和 IDE 中使用它。
OpenCode 支持 [Agent Client Protocol](https://agentclientprotocol.com) 或 (ACP),允許您直接在兼容的編輯器和 IDE 中使用它。
:::tip
有關支持 ACP 的編輯器和工具的列表,請查看[ACP progress report](https://zed.dev/blog/acp-progress-report#available-now)。
@@ -15,9 +15,9 @@ ACP 是一種開放協議,用於標準化程式碼編輯器和 AI 編碼代理
## 配置
要通過 ACP 使用 opencode請將編輯器配置為運行 `opencode acp` 命令。
要通過 ACP 使用 OpenCode請將編輯器配置為運行 `opencode acp` 命令。
該命令將 opencode 作為 ACP 兼容的子進程啟動,通過 stdio 通過 JSON-RPC 與您的編輯器進行通信。
該命令將 OpenCode 作為 ACP 兼容的子進程啟動,通過 stdio 通過 JSON-RPC 與您的編輯器進行通信。
以下是支持 ACP 的流行編輯器的示例。
@@ -86,9 +86,9 @@ ACP 是一種開放協議,用於標準化程式碼編輯器和 AI 編碼代理
---
### Avante
### Avante.nvim
添加到您的[Avante](https://github.com/yetone/avante.nvim)配置:
添加到您的[Avante.nvim](https://github.com/yetone/avante.nvim)配置:
```lua
{
@@ -121,7 +121,7 @@ ACP 是一種開放協議,用於標準化程式碼編輯器和 AI 編碼代理
### CodeCompanion.nvim
要將 opencode 用作 [CodeCompanion.nvim](https://github.com/olimorris/CodeCompanion.nvim) 中的 ACP 代理,請將以下內容添加到 Neovim 配置中:
要將 OpenCode 用作 [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim) 中的 ACP 代理,請將以下內容添加到 Neovim 配置中:
```lua
require("codecompanion").setup({
@@ -136,13 +136,13 @@ require("codecompanion").setup({
})
```
此配置將 CodeCompanion 設置為使用 opencode 作為聊天的 ACP 代理。
此配置將 CodeCompanion 設置為使用 OpenCode 作為聊天的 ACP 代理。
如果您需要傳遞環境變量(如 `OPENCODE_API_KEY`),請參閱 CodeCompanion.nvim 文檔中的 [配置適配器:環境變量](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) 了解完整詳細信息。
## 支持
opencode 通過 ACP 的工作方式與在 terminal 中的工作方式相同。支持所有功能:
OpenCode 通過 ACP 的工作方式與在 terminal 中的工作方式相同。支持所有功能:
:::note
目前不支持某些內置斜杠命令,例如 `/undo` 和 `/redo`。
@@ -150,7 +150,7 @@ opencode 通過 ACP 的工作方式與在 terminal 中的工作方式相同。
- 內置工具文件操作、terminal 命令等)
- 自定義工具和斜杠命令
- 在 opencode 配置中配置的 MCP 服務器
- 在 OpenCode 配置中配置的 MCP 服務器
- `AGENTS.md` 的項目特定規則
- 自定義格式化程序和 linter
- 代理和權限系統

View File

@@ -542,7 +542,7 @@ Only analyze code and suggest changes.
### 隱
使用 `hidden: true` 從 `@` 自動完成菜單隱藏子代理。對於只能由其他代理通過任務工具以編程方式調用的內部子代理很有用。
使用 `@` 從 `hidden: true` 自動完成菜單隱藏子代理。對於只能由其他代理通過任務工具以編程方式調用的內部子代理很有用。
```json title="opencode.json"
{

View File

@@ -5,13 +5,13 @@ description: opencode CLI 選項和命令。
import { Tabs, TabItem } from "@astrojs/starlight/components"
默認情況下,opencode CLI 在不帶任何參數運行時啟動[途易](/docs/tui)。
默認情況下,OpenCode CLI 在不帶任何參數運行時啟動[TUI](/docs/tui)。
```bash
opencode
```
但它也接受本頁記錄的命令。這允許您以編程方式與 opencode 交互。
但它也接受本頁記錄的命令。這允許您以編程方式與 OpenCode 交互。
```bash
opencode run "Explain how closures work in JavaScript"
@@ -21,15 +21,15 @@ opencode run "Explain how closures work in JavaScript"
### tui
啟動 opencode terminal用戶介面
啟動 OpenCode TUI
```bash
opencode [project]
```
#### 旗
#### 旗
| 旗 | | 描述 |
| 旗 | 簡寫 | 描述 |
| ------------ | ---- | --------------------------------------------------------- |
| `--continue` | `-c` | 繼續上一期 |
| `--session` | `-s` | 會話 ID 繼續 |
@@ -44,13 +44,13 @@ opencode [project]
## 命令
opencode CLI 還具有以下命令。
OpenCode CLI 還具有以下命令。
---
### agent
管理 opencode 代理。
管理 OpenCode 代理。
```bash
opencode agent [command]
@@ -60,13 +60,13 @@ opencode agent [command]
### attach
將terminal連接到通過 `serve` 或 `web` 命令啟動的已運行的 opencode 後端服務器。
terminal 連接到通過 `serve` 或 `web` 命令啟動的已運行的 OpenCode 後端服務器。
```bash
opencode attach [url]
```
這允許將 TUI 與遠程 opencode 後端一起使用。例如:
這允許將 TUI 與遠程 OpenCode 後端一起使用。例如:
```bash
# Start the backend server for web/mobile access
@@ -76,9 +76,9 @@ opencode web --port 4096 --hostname 0.0.0.0
opencode attach http://10.20.30.40:4096
```
#### 旗
#### 旗
| 旗 | | 描述 |
| 旗 | 簡寫 | 描述 |
| ----------- | ---- | ------------------- |
| `--dir` | | 啟動 TUI 的工作目錄 |
| `--session` | `-s` | 會話 ID 繼續 |
@@ -119,13 +119,13 @@ opencode auth [command]
#### login
opencode 由 [models.dev](https://models.dev) 上的提供商列表提供支持,因此您可以使用 `opencode auth login` 為您想要使用的任何提供商配置 API 密鑰。它存儲在`~/.local/share/opencode/auth.json` 中。
OpenCode 由 [Models.dev](https://models.dev) 上的提供商列表提供支持,因此您可以使用 `opencode auth login` 為您想要使用的任何提供商配置 API 密鑰。它存儲在`~/.local/share/opencode/auth.json` 中。
```bash
opencode auth login
```
opencode 啟動時,它會從憑據文件加載提供商。如果您的環境中定義了任何鍵或項目中的 `.env` 文件。
OpenCode 啟動時,它會從憑據文件加載提供商。如果您的環境中定義了任何鍵或項目中的 `.env` 文件。
---
@@ -301,7 +301,7 @@ opencode models anthropic
| `--refresh` | 從 models.dev 刷新模型緩存 |
| `--verbose` | 使用更詳細的模型輸出(包括成本等元數據) |
使用`--refresh`標誌來更新緩存的模型列表。當新模型已添加到提供商並且您希望在 opencode 中查看它們時,這非常有用。
使用`--refresh`標誌來更新緩存的模型列表。當新模型已添加到提供商並且您希望在 OpenCode 中查看它們時,這非常有用。
```bash
opencode models --refresh
@@ -530,9 +530,9 @@ opencode upgrade v0.1.48
#### 旗幟
| 旗 | | 描述 |
| 旗 | 簡寫 | 描述 |
| ---------- | ---- | ------------------------------------------ |
| `--method` | `-m` | 使用的安裝方法;捲曲、npm、pnpm、bun、brew |
| `--method` | `-m` | 使用的安裝方法;curl、npm、pnpm、bun、brew |
---
@@ -553,32 +553,32 @@ opencode CLI 採用以下全局標誌。
可以使用環境變量配置 opencode。
| 變量 | 類型 | 描述 |
| ------------------------------------- | ------ | ---------------------------------------- |
| `OPENCODE_AUTO_SHARE` | 布爾 | 自動共享會話 |
| `OPENCODE_GIT_BASH_PATH` | 字符串 | Windows 上 Git Bash 可執行文件的路徑 |
| `OPENCODE_CONFIG` | 字符串 | 配置文件路徑 |
| `OPENCODE_CONFIG_DIR` | 字符串 | 配置目錄的路徑 |
| `OPENCODE_CONFIG_CONTENT` | 字符串 | 內聯 json 配置內容 |
| `OPENCODE_DISABLE_AUTOUPDATE` | 布爾 | 禁用自動更新檢查 |
| `OPENCODE_DISABLE_PRUNE` | 布爾 | 禁用舊數據的修剪 |
| `OPENCODE_DISABLE_TERMINAL_TITLE` | 布爾 | 禁用自動terminal標題更新 |
| `OPENCODE_PERMISSION` | 字符串 | 內聯 json 權限配置 |
| `OPENCODE_DISABLE_DEFAULT_PLUGINS` | 布爾 | 禁用默認插件 |
| `OPENCODE_DISABLE_LSP_DOWNLOAD` | 布爾 | 禁用自動 LSP 服務器下載 |
| `OPENCODE_ENABLE_EXPERIMENTAL_MODELS` | 布爾 | 啟用實驗模型 |
| `OPENCODE_DISABLE_AUTOCOMPACT` | 布爾 | 禁用自動上下文壓縮 |
| `OPENCODE_DISABLE_CLAUDE_CODE` | 布爾 | 禁止從`.claude`讀取(提示+技巧) |
| `OPENCODE_DISABLE_CLAUDE_CODE_PROMPT` | 布爾 | 禁用讀取`~/.claude/CLAUDE.md` |
| `OPENCODE_DISABLE_CLAUDE_CODE_SKILLS` | 布爾 | 禁用加載`.claude/skills` |
| `OPENCODE_DISABLE_MODELS_FETCH` | 布爾 | 禁用從遠程源獲取模型 |
| `OPENCODE_FAKE_VCS` | 字符串 | 用於測試目的的假 VCS 提供商 |
| `OPENCODE_DISABLE_FILETIME_CHECK` | 布爾 | 禁用文件時間檢查以進行優化 |
| `OPENCODE_CLIENT` | 字符串 | 客戶端標識符(默認為`cli` |
| `OPENCODE_ENABLE_EXA` | 布爾 | 啟用 Exa 網絡搜索工具 |
| `OPENCODE_SERVER_PASSWORD` | 字符串 | 為 `serve`/`web` 啟用基本身份驗證 |
| `OPENCODE_SERVER_USERNAME` | 字符串 | 覆蓋基本身份驗證用戶名(默認`opencode` |
| `OPENCODE_MODELS_URL` | 字符串 | 用於獲取模型配置的自定義 URL |
| 變量 | 類型 | 描述 |
| ------------------------------------- | ------- | ---------------------------------------- |
| `OPENCODE_AUTO_SHARE` | boolean | 自動共享會話 |
| `OPENCODE_GIT_BASH_PATH` | string | Windows 上 Git Bash 可執行文件的路徑 |
| `OPENCODE_CONFIG` | string | 配置文件路徑 |
| `OPENCODE_CONFIG_DIR` | string | 配置目錄的路徑 |
| `OPENCODE_CONFIG_CONTENT` | string | 內聯 json 配置內容 |
| `OPENCODE_DISABLE_AUTOUPDATE` | boolean | 禁用自動更新檢查 |
| `OPENCODE_DISABLE_PRUNE` | boolean | 禁用舊數據的修剪 |
| `OPENCODE_DISABLE_TERMINAL_TITLE` | boolean | 禁用自動 terminal 標題更新 |
| `OPENCODE_PERMISSION` | string | 內聯 json 權限配置 |
| `OPENCODE_DISABLE_DEFAULT_PLUGINS` | boolean | 禁用默認插件 |
| `OPENCODE_DISABLE_LSP_DOWNLOAD` | boolean | 禁用自動 LSP 服務器下載 |
| `OPENCODE_ENABLE_EXPERIMENTAL_MODELS` | boolean | 啟用實驗模型 |
| `OPENCODE_DISABLE_AUTOCOMPACT` | boolean | 禁用自動上下文壓縮 |
| `OPENCODE_DISABLE_CLAUDE_CODE` | boolean | 禁止從`.claude`讀取(提示+技巧) |
| `OPENCODE_DISABLE_CLAUDE_CODE_PROMPT` | boolean | 禁用讀取`~/.claude/CLAUDE.md` |
| `OPENCODE_DISABLE_CLAUDE_CODE_SKILLS` | boolean | 禁用加載`.claude/skills` |
| `OPENCODE_DISABLE_MODELS_FETCH` | boolean | 禁用從遠程源獲取模型 |
| `OPENCODE_FAKE_VCS` | string | 用於測試目的的假 VCS 提供商 |
| `OPENCODE_DISABLE_FILETIME_CHECK` | boolean | 禁用文件時間檢查以進行優化 |
| `OPENCODE_CLIENT` | string | 客戶端標識符(默認為`cli` |
| `OPENCODE_ENABLE_EXA` | boolean | 啟用 Exa 網絡搜索工具 |
| `OPENCODE_SERVER_PASSWORD` | string | 為 `serve`/`web` 啟用基本身份驗證 |
| `OPENCODE_SERVER_USERNAME` | string | 覆蓋基本身份驗證用戶名(默認`opencode` |
| `OPENCODE_MODELS_URL` | string | 用於獲取模型配置的自定義 URL |
---
@@ -586,18 +586,18 @@ opencode CLI 採用以下全局標誌。
這些環境變量啟用可能會更改或刪除的實驗性功能。
| 變量 | 類型 | 描述 |
| ----------------------------------------------- | ---- | ----------------------------------- |
| `OPENCODE_EXPERIMENTAL` | 布爾 | 啟用所有實驗性功能 |
| `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | 布爾 | 啟用圖標發現 |
| `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | 布爾 | 在 TUI 中禁用選擇時復制 |
| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | 數量 | bash 命令的默認超時(以毫秒為單位) |
| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | 數量 | LLM 響應的最大輸出令牌 |
| `OPENCODE_EXPERIMENTAL_FILEWATCHER` | 布爾 | 為整個目錄啟用文件觀察器 |
| `OPENCODE_EXPERIMENTAL_OXFMT` | 布爾 | 啟用 oxfmt 格式化程序 |
| `OPENCODE_EXPERIMENTAL_LSP_TOOL` | 布爾 | 啟用實驗性 LSP 工具 |
| `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | 布爾 | 禁用文件觀察器 |
| `OPENCODE_EXPERIMENTAL_EXA` | 布爾 | 啟用實驗性 Exa 功能 |
| `OPENCODE_EXPERIMENTAL_LSP_TY` | 布爾 | 啟用實驗性 LSP 類型檢查 |
| `OPENCODE_EXPERIMENTAL_MARKDOWN` | 布爾 | 啟用實驗性 Markdown 功能 |
| `OPENCODE_EXPERIMENTAL_PLAN_MODE` | 布爾 | 啟用計劃模式 |
| 變量 | 類型 | 描述 |
| ----------------------------------------------- | ------- | ----------------------------------- |
| `OPENCODE_EXPERIMENTAL` | boolean | 啟用所有實驗性功能 |
| `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | boolean | 啟用圖標發現 |
| `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | boolean | 在 TUI 中禁用選擇時復制 |
| `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | number | bash 命令的默認超時(以毫秒為單位) |
| `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | number | LLM 響應的最大輸出令牌 |
| `OPENCODE_EXPERIMENTAL_FILEWATCHER` | boolean | 為整個目錄啟用文件觀察器 |
| `OPENCODE_EXPERIMENTAL_OXFMT` | boolean | 啟用 oxfmt 格式化程序 |
| `OPENCODE_EXPERIMENTAL_LSP_TOOL` | boolean | 啟用實驗性 LSP 工具 |
| `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | boolean | 禁用文件觀察器 |
| `OPENCODE_EXPERIMENTAL_EXA` | boolean | 啟用實驗性 Exa 功能 |
| `OPENCODE_EXPERIMENTAL_LSP_TY` | boolean | 啟用實驗性 LSP 類型檢查 |
| `OPENCODE_EXPERIMENTAL_MARKDOWN` | boolean | 啟用實驗性 Markdown 功能 |
| `OPENCODE_EXPERIMENTAL_PLAN_MODE` | boolean | 啟用計劃模式 |

View File

@@ -181,7 +181,7 @@ opencode run "Hello world"
### 伺服器
您可以通過`server` 選項為`opencode serve` `opencode web` 命令配置服務器設置。
您可以通過`opencode serve` 選項為`opencode web` 和`server` 命令配置服務器設置。
```json title="opencode.json"
{

View File

@@ -15,7 +15,7 @@ opencode 附帶了多個適用於流行語言和框架的內置格式化程序
| -------------------- | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| gofmt | .go | `gofmt` 命令可用 |
| mix | .ex, .exs, .eex, .heex, .leex, .neex, .sface | `mix` 命令可用 |
| prettier | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, 和 [更多](https://prettier.io/docs/en/index.html) | `package.json` 中有 `prettier` 依賴 |
| prettier | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, 和 [更多](https://prettier.io/docs/en/index.html) | `prettier` 中有 `package.json` 依賴 |
| biome | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml, 和 [更多](https://biomejs.dev/) | `biome.json(c)` 配置文件 |
| zig | .zig, .zon | `zig` 命令可用 |
| clang-format | .c, .cpp, .h, .hpp, .ino, 和 [更多](https://clang.llvm.org/docs/ClangFormat.html) | `.clang-format` 配置文件 |
@@ -34,11 +34,11 @@ opencode 附帶了多個適用於流行語言和框架的內置格式化程序
| gleam | .gleam | `gleam` 命令可用 |
| nixfmt | .nix | `nixfmt` 命令可用 |
| shfmt | .sh, .bash | `shfmt` 命令可用 |
| pint | .php | `composer.json` 中有 `laravel/pint` 依賴 |
| oxfmt (Experimental) | .js, .jsx, .ts, .tsx | `package.json` 中有 `oxfmt` 依賴且啟用[實驗環境變量旗標](/docs/cli/#experimental) |
| pint | .php | `laravel/pint` 中有 `composer.json` 依賴 |
| oxfmt (Experimental) | .js, .jsx, .ts, .tsx | `oxfmt` 中有 `package.json` 依賴且啟用[實驗環境變量旗標](/docs/cli/#experimental) |
| ormolu | .hs | `ormolu` 命令可用 |
因此,如果您的項目的`package.json`中有`prettier`opencode將自動使用它。
因此,如果您的項目的`prettier`中有`package.json`opencode將自動使用它。
---

View File

@@ -37,7 +37,7 @@ opencode github install
2. **添加工作流程**
將以下工作流程文件添加到存儲庫中的 `.github/workflows/opencode.yml` 中。確保在`env`中設置適當的`model`和所需的API密鑰。
將以下工作流程文件添加到存儲庫中的 `.github/workflows/opencode.yml` 中。確保在`model`中設置適當的`env`和所需的API密鑰。
```yml title=".github/workflows/opencode.yml" {24,26}
name: opencode

View File

@@ -1,27 +1,27 @@
---
title: 集成開發環境
description: VS Code、Cursor 和其他 IDE 的 opencode 擴展
title: IDE
description: VS Code、Cursor 和其他 IDE 的 OpenCode 擴展
---
opencode 與 VS Code、Cursor 或任何支持terminal的 IDE 集成。只需在 terminal中運行 `opencode` 即可開始。
OpenCode 與 VS Code、Cursor 或任何支持 terminal 的 IDE 集成。只需在 terminal 中運行 `opencode` 即可開始。
---
## 用法
- **快速啟動**:使用 `Cmd+Esc` (Mac) 或 `Ctrl+Esc` (Windows/Linux) 在拆分terminal視圖中打開 opencode或者聚焦現有terminal會話如果已有terminal會話正在運行
- **新會話**:使用 `Cmd+Shift+Esc` (Mac) 或 `Ctrl+Shift+Esc` (Windows/Linux) 啟動新的 opencode terminal會話即使該會話已打開。您還可以單擊 UI 中的 opencode 按鈕。
- **上下文感知**:自動與 opencode 共享您當前的選擇或選項卡。
- **快速啟動**:使用 `Cmd+Esc` (Mac) 或 `Ctrl+Esc` (Windows/Linux) 在拆分 terminal 視圖中打開 OpenCode或者聚焦現有 terminal 會話(如果已有 terminal 會話正在運行)。
- **新會話**:使用 `Cmd+Shift+Esc` (Mac) 或 `Ctrl+Shift+Esc` (Windows/Linux) 啟動新的 OpenCode terminal 會話,即使該會話已打開。您還可以單擊 UI 中的 OpenCode 按鈕。
- **上下文感知**:自動與 OpenCode 共享您當前的選擇或選項卡。
- **文件引用快捷方式**:使用`Cmd+Option+K` (Mac) 或`Alt+Ctrl+K` (Linux/Windows) 插入文件引用。例如,`@File#L37-42`。
---
## 安裝
要在 VS Code 和 Cursor、Windsurf、VSCodium 等流行分支上安裝 opencode
要在 VS Code 和 Cursor、Windsurf、VSCodium 等流行分支上安裝 OpenCode
1. 打開 VS 程式碼
2. 打開集成terminal
1. 打開 VS Code
2. 打開集成 terminal
3. 運行 `opencode` - 擴展會自動安裝
另一方面,如果您想在從 TUI 運行 `/editor` 或 `/export` 時使用自己的 IDE則需要設置 `export EDITOR="code --wait"`。 [了解更多](/docs/tui/#editor-setup)。
@@ -30,7 +30,7 @@ opencode 與 VS Code、Cursor 或任何支持terminal的 IDE 集成。只需在
### 手動安裝
在擴展市場中搜索 **opencode**,然後單擊 **安裝**。
在擴展市場中搜索 **OpenCode**,然後單擊 **安裝**。
---
@@ -38,11 +38,11 @@ opencode 與 VS Code、Cursor 或任何支持terminal的 IDE 集成。只需在
如果擴展無法自動安裝:
- 確保您在集成terminal中運行`opencode`。
- 確保您在集成 terminal 中運行`opencode`。
- 確認您的 IDE 的 CLI 已安裝:
- 對於 VS 程式碼`code` 命令
- 對於光標`cursor` 命令
- 對於風帆衝浪`windsurf` 命令
- 對於 VS Code`code` 命令
- 對於 Cursor`cursor` 命令
- 對於 Windsurf`windsurf` 命令
- 對於 VSCodium`codium` 命令
- 如果沒有,請運行 `Cmd+Shift+P` (Mac) 或 `Ctrl+Shift+P` (Windows/Linux) 並蒐索“Shell Command: Install 'code' command in PATH”或適用於您的 IDE 的等效命令)
- 確保 VS Code 有權安裝擴展

View File

@@ -7,9 +7,9 @@ import { Tabs, TabItem } from "@astrojs/starlight/components"
import config from "../../../../config.mjs"
export const console = config.console
[**opencode**](/) 是一個開源AI編碼代理。它可用作基於 terminal 的介面、桌面應用程式或 IDE 擴展。
[**OpenCode**](/) 是一個開源 AI 編碼代理。它可用作基於 terminal 的介面、桌面應用程式或 IDE 擴展。
![具有 opencode 主題的 opencode TUI](../../../assets/lander/screenshot.png)
![具有 opencode 主題的 OpenCode TUI](../../../assets/lander/screenshot.png)
讓我們開始吧。
@@ -17,9 +17,9 @@ export const console = config.console
#### 先決條件
要在 terminal中使用 opencode您需要
要在 terminal 中使用 OpenCode您需要
1. 現代terminal模擬器例如
1. 現代 terminal 模擬器,例如:
- [WezTerm](https://wezterm.org),跨平台
- [Alacritty](https://alacritty.org),跨平台
- [Ghostty](https://ghostty.org)Linux 和 macOS
@@ -31,7 +31,7 @@ export const console = config.console
## 安裝
安裝 opencode 最簡單的方法是通過安裝腳本。
安裝 OpenCode 最簡單的方法是通過安裝腳本。
```bash
curl -fsSL https://opencode.ai/install | bash
@@ -79,7 +79,7 @@ curl -fsSL https://opencode.ai/install | bash
brew install anomalyco/tap/opencode
```
> 我們建議使用 opencode Tap 來獲取最新版本。官方 `brew install opencode` 公式由 Homebrew 團隊維護,更新頻率較低。
> 我們建議使用 OpenCode tap 來獲取最新版本。官方 `brew install opencode` formula 由 Homebrew 團隊維護,更新頻率較低。
- **在 Arch Linux 上使用 Paru**
@@ -90,7 +90,7 @@ curl -fsSL https://opencode.ai/install | bash
#### Windows
:::tip[Recommended: Use WSL]
為了在 Windows 上獲得最佳體驗,我們建議使用[適用於 Linux 的 Windows 子系統 (WSL)](/docs/windows-wsl)。它提供了更好的性能並與 opencode 的功能完全兼容。
為了在 Windows 上獲得最佳體驗,我們建議使用[適用於 Linux 的 Windows 子系統 (WSL)](/docs/windows-wsl)。它提供了更好的性能並與 OpenCode 的功能完全兼容。
:::
- **使用Chocolatey**
@@ -123,7 +123,7 @@ curl -fsSL https://opencode.ai/install | bash
docker run -it --rm ghcr.io/anomalyco/opencode
```
目前正在支持使用 Bun 在 Windows 上安裝 opencode。
目前正在支持使用 Bun 在 Windows 上安裝 OpenCode。
您還可以從[Releases](https://github.com/anomalyco/opencode/releases) 獲取二進製文件。
@@ -131,10 +131,10 @@ curl -fsSL https://opencode.ai/install | bash
## 配置
借助 opencode您可以通過配置 API 密鑰來使用任何 LLM 提供商。
借助 OpenCode您可以通過配置 API 密鑰來使用任何 LLM 提供商。
如果您不熟悉使用 LLM 提供商,我們建議使用[OpenCode Zen](/docs/zen)。
這是經過 opencode 測試和驗證的精選模型列表
這是經過 OpenCode 測試和驗證的精選模型列表
團隊。
1. 在 TUI 中運行 `/connect` 命令,選擇 opencode然後前往 [opencode.ai/auth](https://opencode.ai/auth)。
@@ -167,33 +167,33 @@ curl -fsSL https://opencode.ai/install | bash
cd /path/to/project
```
並運行 opencode。
並運行 OpenCode。
```bash
opencode
```
接下來,通過運行以下命令來初始化項目的 opencode。
接下來,通過運行以下命令來初始化項目的 OpenCode。
```bash frame="none"
/init
```
這將使 opencode 分析您的項目並在以下位置創建 `AGENTS.md` 文件
這將使 OpenCode 分析您的項目並在以下位置創建 `AGENTS.md` 文件
項目根。
:::tip
您應該將項目的 `AGENTS.md` 文件提交到 Git。
:::
這有助於 opencode 理解項目結構和編碼模式
這有助於 OpenCode 理解項目結構和編碼模式
用過的。
---
## 用法
您現在已準備好使用 opencode 來處理您的項目。請隨意詢問
您現在已準備好使用 OpenCode 來處理您的項目。請隨意詢問
任何事物!
如果您不熟悉使用 AI 編碼代理,以下是一些可能會有所幫助的示例
@@ -203,7 +203,7 @@ opencode
### 提出問題
您可以要求 opencode 向您解釋程式碼庫。
您可以用 OpenCode 向您解釋程式碼庫。
:::tip
使用`@`鍵模糊搜索工程中的文件。
@@ -219,11 +219,11 @@ How is authentication handled in @packages/functions/src/api/index.ts
### 添加功能
您可以要求 opencode 向您的項目添加新功能。不過我們首先建議要求它制定一個計劃。
您可以用 OpenCode 向您的項目添加新功能。不過我們首先建議要求它制定一個計劃。
1. **制定計劃**
opencode 有一個*計劃模式*,該模式禁用其進行更改和
OpenCode 有一個*計劃模式*,該模式禁用其進行更改和
相反,建議*如何*實現該功能。
使用 **Tab** 鍵切換到它。您會在右下角看到一個指示符。
@@ -240,11 +240,11 @@ How is authentication handled in @packages/functions/src/api/index.ts
From this screen, the user can undelete a note or permanently delete it.
```
您需要為 opencode 提供足夠的詳細信息以了解您想要的內容。它有幫助
您需要為 OpenCode 提供足夠的詳細信息以了解您想要的內容。它有幫助
就像與團隊中的初級開發人員交談一樣與它交談。
:::tip
opencode 提供大量上下文和示例,以幫助其理解您的內容
OpenCode 提供大量上下文和示例,以幫助其理解您的內容
想。
:::
@@ -258,11 +258,11 @@ How is authentication handled in @packages/functions/src/api/index.ts
```
:::tip
將圖像拖放到terminal中以將其添加到提示中。
將圖像拖放到 terminal 中以將其添加到提示中。
:::
opencode 可以掃描您提供的任何圖像並將其添加到提示中。你可以
通過將圖像拖放到terminal中來完成此操作。
OpenCode 可以掃描您提供的任何圖像並將其添加到提示中。你可以
通過將圖像拖放到 terminal 中來完成此操作。
3. **構建功能**
@@ -283,7 +283,7 @@ How is authentication handled in @packages/functions/src/api/index.ts
### 做出改變
對於更直接的更改,您可以要求 opencode 直接構建它
對於更直接的更改,您可以要求 OpenCode 直接構建它
無需先審查計劃。
```txt frame="none" "@packages/functions/src/settings.ts" "@packages/functions/src/notes.ts"
@@ -292,14 +292,14 @@ handled in the /notes route in @packages/functions/src/notes.ts and implement
the same logic in @packages/functions/src/settings.ts
```
您需要確保提供大量詳細信息,以便 opencode 做出正確的決定
您需要確保提供大量詳細信息,以便 OpenCode 做出正確的決定
變化。
---
### 撤消更改
假設您要求 opencode 進行一些更改。
假設您要求 OpenCode 進行一些更改。
```txt frame="none" "@packages/functions/src/api/index.ts"
Can you refactor the function in @packages/functions/src/api/index.ts?
@@ -312,14 +312,14 @@ Can you refactor the function in @packages/functions/src/api/index.ts?
/undo
```
opencode 現在將恢復您所做的更改並顯示您的原始消息
OpenCode 現在將恢復您所做的更改並顯示您的原始消息
再次。
```txt frame="none" "@packages/functions/src/api/index.ts"
Can you refactor the function in @packages/functions/src/api/index.ts?
```
從這裡您可以調整提示並要求 opencode 重試。
從這裡您可以調整提示並要求 OpenCode 重試。
:::tip
您可以多次運行 `/undo` 以撤消多項更改。
@@ -335,7 +335,7 @@ Can you refactor the function in @packages/functions/src/api/index.ts?
## 分享
您與 opencode 的對話可以[與您的
您與 OpenCode 的對話可以[與您的
團隊](/docs/share)。
```bash frame="none"
@@ -348,12 +348,12 @@ Can you refactor the function in @packages/functions/src/api/index.ts?
默認情況下不共享對話。
:::
這是帶有 opencode 的[示例對話](https://opencode.ai/s/4XP1fce5)。
這是帶有 OpenCode 的[示例對話](https://opencode.ai/s/4XP1fce5)。
---
## 定制
就是這樣!您現在已經是使用 opencode 的專家了。
就是這樣!您現在已經是使用 OpenCode 的專家了。
要使其成為您自己的,我們建議 [選擇一個主題](/docs/themes)、[自定義按鍵綁定](/docs/keybinds)、[配置程式碼格式化程序](/docs/formatters)、[創建自定義命令](/docs/commands) 或使用 [opencode配置](/docs/config)。
要使其成為您自己的,我們建議 [選擇一個主題](/docs/themes)、[自定義按鍵綁定](/docs/keybinds)、[配置程式碼格式化程序](/docs/formatters)、[創建自定義命令](/docs/commands) 或使用 [OpenCode 配置](/docs/config)。

View File

@@ -182,7 +182,7 @@ opencode 附帶了多種適用於流行語言的內置 LSP 服務器:
PHP Intelephense 通過許可證密鑰提供高級功能。您可以通過將(僅)密鑰放入位於以下位置的文本文件中來提供許可證密鑰:
- 在 macOS/Linux 上:`$HOME/intelephense/licence.txt`
- 在 Windows 上:`%USERPROFILE%/intelephense/licence.txt`
- 在 macOS/Linux 上:`$HOME/intelephense/license.txt`
- 在 Windows 上:`%USERPROFILE%/intelephense/license.txt`
該文件應僅包含許可證密鑰,不包含其他內容。

View File

@@ -3,13 +3,13 @@ title: 型號
description: 配置LLM提供者和模型。
---
opencode 使用[AI SDK](https://ai-sdk.dev/) 和[models.dev](https://models.dev) 來支持**75+ LLM 提供商**,並且它支持運行本地模型。
OpenCode 使用[AI SDK](https://ai-sdk.dev/) 和[Models.dev](https://models.dev) 來支持**75+ LLM 提供商**,並且它支持運行本地模型。
---
## 供應商
默認情況下會預加載大多數流行的提供商。如果您已通過 `/connect` 命令添加了提供商的憑據,那麼它們將在您啟動 opencode 時可用。
默認情況下會預加載大多數流行的提供商。如果您已通過 `/connect` 命令添加了提供商的憑據,那麼它們將在您啟動 OpenCode 時可用。
了解有關[提供者](/docs/providers) 的更多信息。
@@ -35,21 +35,21 @@ opencode 使用[AI SDK](https://ai-sdk.dev/) 和[models.dev](https://models.dev)
然而,既擅長生成程式碼又擅長工具調用的只有少數。
以下是與 opencode 配合良好的幾個模型,排名不分先後。 (這不是詳盡的列表,也不一定是最新的):
以下是與 OpenCode 配合良好的幾個模型,排名不分先後。 (這不是詳盡的列表,也不一定是最新的):
- GPT 5.2
- GPT 5.1 法典
- 近距離工作4.5
- 克勞德十四行詩 4.5
- 極小極大M2.1
- 雙子座 3 專業版
- GPT 5.1 Codex
- Claude Opus 4.5
- Claude Sonnet 4.5
- Minimax M2.1
- Gemini 3 Pro
---
## 設置默認值
要將其中之一設置為默認模型,您可以在您的
opencode配置。
OpenCode 配置。
```json title="opencode.json" {3}
{
@@ -101,7 +101,7 @@ opencode配置。
```
在這裡,我們為兩個內置模型配置全局設置:`gpt-5`(通過 `openai` 提供商訪問時)和 `claude-sonnet-4-20250514`(通過 `anthropic` 提供商訪問時)。
內置提供商和型號名稱可以在[models.dev](https://models.dev) 上找到。
內置提供商和型號名稱可以在[Models.dev](https://models.dev) 上找到。
您還可以為您正在使用的任何代理配置這些選項。代理配置會覆蓋此處的所有全局選項。 [了解更多](/docs/agents/#additional)。
@@ -137,11 +137,11 @@ opencode配置。
## 變體
許多型號支持具有不同配置的多種變體。 opencode 附帶了流行提供商的內置默認變體。
許多型號支持具有不同配置的多種變體。OpenCode 附帶了流行提供商的內置默認變體。
### 內置變體
opencode 附帶了許多提供商的默認變體:
OpenCode 附帶了許多提供商的默認變體:
**Anthropic**
@@ -203,11 +203,11 @@ opencode 附帶了許多提供商的默認變體:
## 加載模型
opencode 啟動時,它會按以下優先順序檢查模型:
OpenCode 啟動時,它會按以下優先順序檢查模型:
1. `--model` 或 `-m` 命令行標誌。格式與配置文件中的相同:`provider_id/model_id`。
2. opencode 配置中的模型列表。
2. OpenCode 配置中的模型列表。
```json title="opencode.json"
{

File diff suppressed because it is too large Load Diff

View File

@@ -130,7 +130,7 @@ export OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 # Disable only .claude/skills
### 使用 opencode.json
推薦的方法是在`opencode.json`中使用`instructions`字段:
推薦的方法是在`instructions`中使用`opencode.json`字段:
```json title="opencode.json"
{

View File

@@ -25,7 +25,7 @@ opencode 搜索這些位置:
## 了解發現
對於項目本地路徑opencode 將從當前工作目錄開始,直到到達 git 工作樹。
它加載 `.opencode/` 中任何匹配的 `skills/*/SKILL.md` 以及一路上任何匹配的 `.claude/skills/*/SKILL.md` 或 `.agents/skills/*/SKILL.md`。
它加載 `skills/*/SKILL.md` 中任何匹配的 `.opencode/` 以及一路上任何匹配的 `.claude/skills/*/SKILL.md` 或 `.agents/skills/*/SKILL.md`。
全局定義也從`~/.config/opencode/skills/*/SKILL.md`、`~/.claude/skills/*/SKILL.md` 和`~/.agents/skills/*/SKILL.md` 加載。

View File

@@ -45,7 +45,7 @@ opencode Desktop 在後台運行本地 opencode 服務器(`opencode-cli` sidec
- 完全退出並重新啟動應用程式。
- 如果應用程式顯示錯誤屏幕,請單擊“**重新啟動**”並複制錯誤詳細信息。
- 僅限 macOS`opencode` 菜單 -> **重新加載 Webview**(如果 UI 為空白/凍結,則有幫助)。
- 僅限 macOS`OpenCode` 菜單 -> **重新加載 Webview**(如果 UI 為空白/凍結,則有幫助)。
---

View File

@@ -1,13 +1,13 @@
---
title: 途易
description: 使用 opencode terminal用戶介面。
title: TUI
description: 使用 OpenCode terminal 用戶介面。
---
import { Tabs, TabItem } from "@astrojs/starlight/components"
opencode 提供了一個交互式terminal介面或 TUI供您與LLM一起處理項目。
OpenCode 提供了一個交互式 terminal 介面或 TUI供您與 LLM 一起處理項目。
運行 opencode 會啟動當前目錄的 TUI。
運行 OpenCode 會啟動當前目錄的 TUI。
```bash
opencode
@@ -43,7 +43,7 @@ How is auth handled in @packages/functions/src/api/index.ts?
---
## bash 命令
## Bash 命令
以 `!` 開始一條消息以運行 shell 命令。
@@ -57,7 +57,7 @@ How is auth handled in @packages/functions/src/api/index.ts?
## 命令
使用 opencode TUI 時,您可以鍵入 `/` 後跟命令名稱來快速執行操作。例如:
使用 OpenCode TUI 時,您可以鍵入 `/` 後跟命令名稱來快速執行操作。例如:
```bash frame="none"
/help
@@ -71,7 +71,7 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x`
### connect
將提供商添加到 opencode。允許您從可用的提供商中進行選擇並添加其 API 密鑰。
將提供商添加到 OpenCode。允許您從可用的提供商中進行選擇並添加其 API 密鑰。
```bash frame="none"
/connect
@@ -117,7 +117,7 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x`
### exit
退出 opencode。 _別名_`/quit`、`/q`
退出 OpenCode。 _別名_`/quit`、`/q`
```bash frame="none"
/exit
@@ -336,12 +336,12 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x`
流行的編輯器選項包括:
- `code` - Visual Studio 程式碼
- `cursor` - 光標
- `windsurf` - 風帆衝浪
- `code` - Visual Studio Code
- `cursor` - Cursor
- `windsurf` - Windsurf
- `nvim` - Neovim 編輯器
- `vim` - 我來編輯
- `nano` - 納米編輯器
- `vim` - Vim 編輯
- `nano` - Nano 編輯器
- `notepad` - Windows 記事本
- `subl` - Sublime Text
@@ -355,7 +355,7 @@ Most commands also have keybind using `ctrl+x` as the leader key, where `ctrl+x`
## 配置
您可以通過 opencode 配置文件自定義 TUI 行為。
您可以通過 OpenCode 配置文件自定義 TUI 行為。
```json title="opencode.json"
{