mirror of
https://github.com/anomalyco/opencode.git
synced 2026-05-02 02:36:52 +00:00
fix(docs): locale translations for nav elements and headings
This commit is contained in:
@@ -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 擴充功能。
|
||||
|
||||

|
||||

|
||||
|
||||
讓我們開始吧。
|
||||
|
||||
@@ -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)。
|
||||
|
||||
Reference in New Issue
Block a user