docs: improve zh-cn and zh-tw documentation translations (#13942)
This commit is contained in:
@@ -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
|
||||
自定義指令可以覆寫內建指令。
|
||||
自訂指令可以覆寫內建指令。
|
||||
:::
|
||||
|
||||
如果您定義同名的自定義指令,它將覆寫內建指令。
|
||||
如果您定義了同名的自訂指令,它將覆寫內建指令。
|
||||
|
||||
Reference in New Issue
Block a user