fix(docs): locale translations for nav elements and headings

This commit is contained in:
Adam
2026-02-11 18:51:27 -06:00
parent 8eea53a41e
commit aea68c386a
484 changed files with 12718 additions and 11212 deletions

View File

@@ -1,15 +1,15 @@
---
title: 簡介
description: 開始使用 opencode。
description: 開始使用 OpenCode。
---
import { Tabs, TabItem } from "@astrojs/starlight/components"
import config from "../../../../config.mjs"
export const console = config.console
[**OpenCode**](/) 是一個開源 AI 碼代理。它可用作基於 terminal 的介面、桌面應用程式或 IDE 擴
[**OpenCode**](/) 是一個開源 AI 程式碼代理。它可用作基於終端機的介面、桌面應用程式或 IDE 擴充功能
![具有 opencode 主題的 OpenCode TUI](../../../assets/lander/screenshot.png)
![具有 OpenCode 主題的 OpenCode TUI](../../../assets/lander/screenshot.png)
讓我們開始吧。
@@ -17,27 +17,27 @@ export const console = config.console
#### 先決條件
要在 terminal 中使用 OpenCode您需要
要在終端機中使用 OpenCode您需要
1. 現代 terminal 模擬器,例如:
1. 現代終端機模擬器,例如:
- [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 鑰。
2. 您想要使用的 LLM 供商的 API 鑰。
---
## 安裝
安裝 OpenCode 最簡單的方法是過安裝腳本
安裝 OpenCode 最簡單的方法是過安裝指令碼
```bash
curl -fsSL https://opencode.ai/install | bash
```
可以使用以下令安裝
可以使用以下令安裝:
- **使用 Node.js**
@@ -89,17 +89,17 @@ curl -fsSL https://opencode.ai/install | bash
#### Windows
:::tip[Recommended: Use WSL]
為了在 Windows 上獲得最佳體驗,我們建議使用[適用於 Linux 的 Windows 子系統 (WSL)](/docs/windows-wsl)。它提供了更好的能並與 OpenCode 的功能完全容。
:::tip[建議:使用 WSL]
為了在 Windows 上獲得最佳體驗,我們建議使用[適用於 Linux 的 Windows 子系統 (WSL)](/docs/windows-wsl)。它提供了更好的能並與 OpenCode 的功能完全容。
:::
- **使用Chocolatey**
- **使用 Chocolatey**
```bash
choco install opencode
```
- **使用Scoop**
- **使用 Scoop**
```bash
scoop install opencode
@@ -111,7 +111,7 @@ curl -fsSL https://opencode.ai/install | bash
npm install -g opencode-ai
```
- **使用Mise**
- **使用 Mise**
```bash
mise use -g github:anomalyco/opencode
@@ -123,29 +123,28 @@ 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) 獲取二進製文件
您還可以從 [Releases](https://github.com/anomalyco/opencode/releases) 獲取二進位檔案
---
## 配置
## 設定
借助 OpenCode您可以通過配置 API 鑰來使用任何 LLM 供商。
借助 OpenCode您可以透過設定 API 鑰來使用任何 LLM 供商。
如果您不熟悉使用 LLM 供商,我們建議使用[OpenCode Zen](/docs/zen)。
這是經過 OpenCode 測試和驗證的精選模型列表
團隊。
如果您不熟悉使用 LLM 供商,我們建議使用 [OpenCode Zen](/docs/zen)。
這是經過 OpenCode 團隊測試和驗證的精選模型列表
1. 在 TUI 中行 `/connect` 令,選擇 opencode然後前往 [opencode.ai/auth](https://opencode.ai/auth)。
1. 在 TUI 中行 `/connect` 令,選擇 opencode然後前往 [opencode.ai/auth](https://opencode.ai/auth)。
```txt
/connect
```
2. 登錄,添加您的帳單詳細信息,然後復制您的 API 鑰。
2. 登入,新增您的帳單詳細資訊,然後複製您的 API 鑰。
3. 貼您的 API 鑰。
3. 貼您的 API 鑰。
```txt
┌ API key
@@ -154,50 +153,45 @@ curl -fsSL https://opencode.ai/install | bash
└ enter
```
或者,您可以選擇其他供商之一。 [了解更多](/docs/providers#directory)。
或者,您可以選擇其他供商之一。[了解更多](/docs/providers#directory)。
---
## 初始化
現在您已經配置了提供商,您可以導航到一個項目
你想繼續工作。
現在您已經設定了供應商,您可以導航到一個您想繼續工作的專案。
```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。
您應該將專案的 `AGENTS.md` 檔案提交到 Git。
:::
這有助於 OpenCode 理解項目結構和編碼模式
用過的。
這有助於 OpenCode 理解專案結構和使用的編碼模式
---
## 用法
您現在已準備好使用 OpenCode 來處理您的項目。請隨意詢問
任何事物!
您現在已準備好使用 OpenCode 來處理您的專案。請隨意詢問任何事物!
如果您不熟悉使用 AI 碼代理,以下是一些可能會有所幫助的示例
幫助。
如果您不熟悉使用 AI 程式碼代理,以下是一些可能會有所幫助的範例。
---
@@ -206,7 +200,7 @@ opencode
您可以用 OpenCode 向您解釋程式碼庫。
:::tip
使用`@`鍵模糊搜索工程中的文件
使用`@`鍵模糊搜尋專案中的檔案
:::
```txt frame="none" "@packages/functions/src/api/index.ts"
@@ -217,14 +211,13 @@ How is authentication handled in @packages/functions/src/api/index.ts
---
### 添加功能
### 新增功能
您可以用 OpenCode 向您的項目添加新功能。不過我們首先建議要求它制定一個計
您可以用 OpenCode 向您的專案新增新功能。不過我們首先建議要求它制定一個計
1. **制定計**
1. **制定計**
OpenCode 有一個*計模式*,該模式禁用其進行更改和
相反,建議*如何*實現該功能。
OpenCode 有一個*計模式*,該模式禁用其進行變更,而是建議*如何*實作該功能。
使用 **Tab** 鍵切換到它。您會在右下角看到一個指示符。
@@ -240,17 +233,15 @@ 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 提供大量上下文和例,以幫助其理解您的想法。
:::
2. **迭代計**
2. **迭代計**
一旦它為您提供了計,您可以提供饋或添加更多詳細信息
一旦它為您提供了計,您可以提供饋或新增更多詳細資訊
```txt frame="none"
We'd like to design this new screen using a design I've used before.
@@ -258,16 +249,14 @@ How is authentication handled in @packages/functions/src/api/index.ts
```
:::tip
像拖放到 terminal 中以將其添加到提示中。
像拖放到終端機中以將其新增到提示中。
:::
OpenCode 可以掃描您提供的任何像並將其添加到提示中。可以
通過將圖像拖放到 terminal 中來完成此操作。
OpenCode 可以掃描您提供的任何像並將其新增到提示中。可以透過將影像拖放到終端機中來完成此操作。
3. **建功能**
3. **建功能**
一旦您對計感到滿意,請切換回*建模式*
再次按 **Tab** 鍵。
一旦您對計感到滿意,請切換回*建模式*,再次按 **Tab** 鍵。
```bash frame="none"
<TAB>
@@ -283,8 +272,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"
We need to add authentication to the /settings route. Take a look at how this is
@@ -292,28 +280,25 @@ 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?
```
但你意識到這不是你想要的。您**可以撤**更改
使用 `/undo` 命令。
但你意識到這不是你想要的。您**可以撤**變更,使用 `/undo` 指令。
```bash frame="none"
/undo
```
OpenCode 現在將復您所做的更改並顯示您的原始消息
再次。
OpenCode 現在將復您所做的變更並再次顯示您的原始訊息。
```txt frame="none" "@packages/functions/src/api/index.ts"
Can you refactor the function in @packages/functions/src/api/index.ts?
@@ -322,10 +307,10 @@ Can you refactor the function in @packages/functions/src/api/index.ts?
從這裡您可以調整提示並要求 OpenCode 重試。
:::tip
您可以多次行 `/undo` 以撤多項更
您可以多次行 `/undo` 以撤多項更。
:::
或者您**可以使用 `/redo` 令重做**更
或者您**可以使用 `/redo` 令重做**更。
```bash frame="none"
/redo
@@ -335,25 +320,24 @@ Can you refactor the function in @packages/functions/src/api/index.ts?
## 分享
您與 OpenCode 的對話可以[與您的
團隊](/docs/share)。
您與 OpenCode 的對話可以[與您的團隊分享](/docs/share)。
```bash frame="none"
/share
```
這將創建當前對話的連結並將其複製到剪貼
這將建立目前對話的連結並將其複製到剪貼簿
:::note
默認情況下不享對話。
預設情況下不享對話。
:::
這是帶有 OpenCode 的[例對話](https://opencode.ai/s/4XP1fce5)。
這是帶有 OpenCode 的[例對話](https://opencode.ai/s/4XP1fce5)。
---
## 定制
## 自訂
就是這樣!您現在已經是使用 OpenCode 的專家了。
要使其成為您自己的,我們建議 [選擇一個主題](/docs/themes)、[自定義按鍵綁定](/docs/keybinds)、[配置程式碼格式化程](/docs/formatters)、[建自定義令](/docs/commands) 或使用 [OpenCode 配置](/docs/config)。
要使其成為您自己的,我們建議 [選擇一個主題](/docs/themes)、[自按鍵綁定](/docs/keybinds)、[設定程式碼格式化程](/docs/formatters)、[建自定義令](/docs/commands) 或使用 [OpenCode 設定](/docs/config)。