docs: improve zh-cn and zh-tw documentation translations (#13942)

This commit is contained in:
chenmi
2026-02-17 06:06:39 -06:00
committed by GitHub
parent 8d0a303af4
commit 4fd3141ab5
68 changed files with 4624 additions and 4518 deletions
@@ -1,21 +1,21 @@
---
title: 指令
description: 為重複任務建立自定義指令。
description: 為重複任務建立自訂指令。
---
自定義指令允許您指定在 TUI 中執行該指令時要執行的提示。
自訂指令允許您指定一個提示詞,當在 TUI 中執行該指令時會執行這個提示詞。
```bash frame="none"
/my-command
```
除了 `/init`、`/undo`、`/redo`、`/share`、`/help` 等內建指令之外,還有自定義指令。 [了解更多](/docs/tui#commands)。
自訂指令是 `/init`、`/undo`、`/redo`、`/share`、`/help` 等內建指令之外的補充。[了解更多](/docs/tui#commands)。
---
## 建立指令檔案
在 `commands/` 目錄中建立 markdown 檔案來定義自定義指令。
在 `commands/` 目錄中建立 markdown 檔案來定義自訂指令。
建立 `.opencode/commands/test.md`:
@@ -30,7 +30,7 @@ Run the full test suite with coverage report and show any failures.
Focus on the failing tests and suggest fixes.
```
frontmatter 定義指令屬性。內容成為範本。
frontmatter 定義指令屬性,內容則成為範本。
透過輸入 `/` 後跟指令名稱來使用該指令。
@@ -42,13 +42,13 @@ frontmatter 定義指令屬性。內容成為範本。
## 設定
您 可以透過 opencode 設定或透過在 `commands/` 目錄中建立 markdown 檔案來新增自定義指令。
您可以透過 OpenCode 設定或在 `commands/` 目錄中建立 markdown 檔案來新增自訂指令。
---
### JSON
在 opencode [設定](/docs/config) 中使用 `command` 選項:
在 OpenCode [設定](/docs/config)中使用 `command` 選項:
```json title="opencode.jsonc" {4-12}
{
@@ -67,7 +67,7 @@ frontmatter 定義指令屬性。內容成為範本。
}
```
現在您可以在 TUI 中執行此指令:
現在您可以在 TUI 中執行這個指令:
```bash frame="none"
/test
@@ -77,10 +77,10 @@ frontmatter 定義指令屬性。內容成為範本。
### Markdown
您也可以使用 Markdown 檔案定義指令。將它們放入:
您還可以使用 markdown 檔案定義指令。將它們放在:
- 全域:`~/.config/opencode/commands/`
- 每個專案:`.opencode/commands/`
- 專案層級:`.opencode/commands/`
```markdown title="~/.config/opencode/commands/test.md"
---
@@ -93,7 +93,7 @@ Run the full test suite with coverage report and show any failures.
Focus on the failing tests and suggest fixes.
```
Markdown 檔名成為指令名。例如,`test.md` 讓您執行:
markdown 檔案名稱即為指令名稱。例如,`test.md` 允許您執行:
```bash frame="none"
/test
@@ -101,15 +101,15 @@ Markdown 檔名成為指令名。例如,`test.md` 讓您執行:
---
## 提示設定
## 提示詞設定
自定義指令的提示支援幾個特殊的預留位置和語法。
自訂指令的提示詞支援多種特殊佔位符和語法。
---
### 參數 (Arguments)
### 參數
使用 `$ARGUMENTS` 預留位置將參數傳遞給指令。
使用 `$ARGUMENTS` 佔位符向指令傳遞參數。
```md title=".opencode/commands/component.md"
---
@@ -120,20 +120,20 @@ Create a new React component named $ARGUMENTS with TypeScript support.
Include proper typing and basic structure.
```
使用參數執行指令:
帶參數執行指令:
```bash frame="none"
/component Button
```
`$ARGUMENTS` 將替換為 `Button`。
`$ARGUMENTS` 將被替換為 `Button`。
您也可以使用位置參數存取各個參數:
您還可以使用位置參數存取各個參數:
- `$1` - 第一個參數
- `$2` - 第二個參數
- `$3` - 第三個參數
- 等等...
- 以此類推...
例如:
@@ -152,19 +152,19 @@ with the following content: $3
/create-file config.json src "{ \"key\": \"value\" }"
```
這取代了:
替換結果為:
- `$1` 與 `config.json`
- `$2` 與 `src`
- `$3` 與 `{ "key": "value" }`
- `$1` 替換為 `config.json`
- `$2` 替換為 `src`
- `$3` 替換為 `{ "key": "value" }`
---
### Shell 輸出
使用 _!`command`_ 將 [bash 指令](/docs/tui#bash-commands) 輸出注入到提示中。
使用 _!`command`_ 將 [bash 指令](/docs/tui#bash-commands)輸出注入到提示詞中。
例如,要建立分析測試覆蓋率的自定義指令:
例如,建立一個分析測試覆蓋率的自訂指令:
```md title=".opencode/commands/analyze-coverage.md"
---
@@ -190,13 +190,13 @@ Recent git commits:
Review these changes and suggest any improvements.
```
指令在專案的根目錄中執行,其輸出成為提示的一部分。
指令在專案的根目錄中執行,其輸出會成為提示詞的一部分。
---
### 檔案參考
### 檔案參照
使用 `@` 後跟檔名將檔案包含在指令中。
使用 `@` 後跟檔案名稱在指令中參照檔案。
```md title=".opencode/commands/review-component.md"
---
@@ -207,19 +207,19 @@ Review the component in @src/components/Button.tsx.
Check for performance issues and suggest improvements.
```
檔案內容會自動包含在提示中。
檔案內容會自動包含在提示詞中。
---
## 選項
讓我們詳細看看設定選項。
讓我們詳細了解各設定選項。
---
### 範本 (Template)
### Template
`template` 選項定義執行指令時將發送到 LLM 的提示。
`template` 選項定義執行指令時傳送給 LLM 的提示詞。
```json title="opencode.json"
{
@@ -235,9 +235,9 @@ Check for performance issues and suggest improvements.
---
### 描述 (Description)
### Description
使用 `description` 選項提供指令功能的簡要描述。
使用 `description` 選項提供指令功能的簡要說明。
```json title="opencode.json"
{
@@ -249,15 +249,15 @@ Check for performance issues and suggest improvements.
}
```
當您輸入指令時,這將在 TUI 中顯示為描述。
當您輸入指令時,這將在 TUI 中顯示為說明。
---
### 代理 (Agent)
### Agent
使用 `agent` 設定可選擇指定哪個 [代理](/docs/agents) 應執行此指令。
如果這是 [子代理](/docs/agents/#subagents),該指令將預設觸發子代理呼叫。
要禁用此行為,請將 `subtask` 設定為 `false`。
使用 `agent` 設定可選擇指定由哪個[代理](/docs/agents)執行此指令。
如果這是一個[子代理](/docs/agents/#subagents),該指令預設會觸發子代理呼叫。
要停用此行為,請將 `subtask` 設定為 `false`。
```json title="opencode.json"
{
@@ -269,15 +269,15 @@ Check for performance issues and suggest improvements.
}
```
這是一個**可選**設定選項。如果未指定,則預設為您當前的代理。
這是一個**可選的**設定選項。如果未指定,預設使用您當前的代理。
---
### 子任務 (Subtask)
### Subtask
使用 `subtask` 布林值強制指令觸發 [子代理](/docs/agents/#subagents) 呼叫。
如果您希望指令不污染您的主要上下文並且將**強制**代理充當子代理,那麼這非常有用,
即使 `mode` 在 [代理](/docs/agents) 設定上設定為 `primary`。
使用 `subtask` 布林值強制指令觸發[子代理](/docs/agents/#subagents)呼叫。
如果您希望指令不污染主要上下文,這會很有用,它會**強制**代理作為子代理執行,
即使[代理](/docs/agents)設定中的 `mode` 設定為 `primary`。
```json title="opencode.json"
{
@@ -289,11 +289,11 @@ Check for performance issues and suggest improvements.
}
```
這是一個**可選**設定選項。
這是一個**可選的**設定選項。
---
### 模型 (Model)
### Model
使用 `model` 設定覆寫此指令的預設模型。
@@ -307,16 +307,16 @@ Check for performance issues and suggest improvements.
}
```
這是一個**可選**設定選項。
這是一個**可選的**設定選項。
---
### 內建
## 內建指令
opencode 包含 `/init`、`/undo`、`/redo`、`/share`、`/help` 等內建指令; [了解更多](/docs/tui#commands)。
OpenCode 包含多個內建指令,如 `/init`、`/undo`、`/redo`、`/share`、`/help`;[了解更多](/docs/tui#commands)。
:::note
自定義指令可以覆寫內建指令。
自訂指令可以覆寫內建指令。
:::
如果您定義同名的自定義指令,它將覆寫內建指令。
如果您定義了同名的自訂指令,它將覆寫內建指令。