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,23 +1,23 @@
---
title:
description: 為重複任務建自定義令。
title:
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`
`.opencode/commands/test.md`
```md title=".opencode/commands/test.md"
---
@@ -30,9 +30,9 @@ Run the full test suite with coverage report and show any failures.
Focus on the failing tests and suggest fixes.
```
frontmatter 定義令屬性。內容成為模板
frontmatter 定義令屬性。內容成為範本
通過鍵入 `/` 後跟令名稱來使用該令。
透過輸入 `/` 後跟令名稱來使用該令。
```bash frame="none"
"/test"
@@ -40,15 +40,15 @@ 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/`
- 全`~/.config/opencode/commands/`
- 每個專案`.opencode/commands/`
```markdown title="~/.config/opencode/commands/test.md"
---
@@ -93,8 +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
@@ -102,15 +101,15 @@ Markdown 文件名成為命令名。例如,`test.md` 讓
---
## 提示配置
## 提示設定
自定義令的提示支幾個特殊的佔位符和語法。
自定義令的提示支幾個特殊的預留位置和語法。
---
### 參數
### 參數 (Arguments)
使用 `$ARGUMENTS` 佔位符將參數傳遞給令。
使用 `$ARGUMENTS` 預留位置將參數傳遞給令。
```md title=".opencode/commands/component.md"
---
@@ -121,7 +120,7 @@ Create a new React component named $ARGUMENTS with TypeScript support.
Include proper typing and basic structure.
```
使用參數運行命令:
使用參數執行指令:
```bash frame="none"
/component Button
@@ -129,7 +128,7 @@ Include proper typing and basic structure.
`$ARGUMENTS` 將替換為 `Button`。
可以使用位置參數訪問各個參數:
可以使用位置參數存取各個參數:
- `$1` - 第一個參數
- `$2` - 第二個參數
@@ -147,7 +146,7 @@ Create a file named $1 in the directory $2
with the following content: $3
```
運行命令:
執行指令:
```bash frame="none"
/create-file config.json src "{ \"key\": \"value\" }"
@@ -155,17 +154,17 @@ with the following content: $3
這取代了:
- `$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"
---
@@ -178,7 +177,7 @@ Here are the current test results:
Based on these results, suggest improvements to increase coverage.
```
或者查看最近的更
或者查看最近的更:
```md title=".opencode/commands/review-changes.md"
---
@@ -191,13 +190,13 @@ Recent git commits:
Review these changes and suggest any improvements.
```
令在項目的根目錄中行,其輸出成為提示的一部分。
令在專案的根目錄中行,其輸出成為提示的一部分。
---
### 文件參考
### 檔案參考
使用 `@` 後跟文件名將文件包含在令中。
使用 `@` 後跟檔名將檔案包含在令中。
```md title=".opencode/commands/review-component.md"
---
@@ -208,19 +207,19 @@ Review the component in @src/components/Button.tsx.
Check for performance issues and suggest improvements.
```
文件內容會自動包含在提示中。
檔案內容會自動包含在提示中。
---
## 選項
讓我們詳細看看配置選項。
讓我們詳細看看設定選項。
---
### 模板
### 範本 (Template)
`template` 選項定義執行令時將發送到 LLM 的提示。
`template` 選項定義執行令時將發送到 LLM 的提示。
```json title="opencode.json"
{
@@ -232,13 +231,13 @@ Check for performance issues and suggest improvements.
}
```
這是一個**必需的**配置選項。
這是一個**必需的**設定選項。
---
### 描述
### 描述 (Description)
使用 `description` 選項提供令功能的簡要描述。
使用 `description` 選項提供令功能的簡要描述。
```json title="opencode.json"
{
@@ -250,15 +249,15 @@ Check for performance issues and suggest improvements.
}
```
當您鍵入命令時,這將在 TUI 中顯示為描述。
當您輸入指令時,這將在 TUI 中顯示為描述。
---
### 代理
### 代理 (Agent)
使用`agent` 配置可選擇指定哪個[代理](/docs/agents) 應執行此令。
如果這是 [子代理](/docs/agents/#subagents) 該命令將默認觸發子代理調用
要禁用此行為,請將`subtask` 設置為`false`。
使用 `agent` 設定可選擇指定哪個 [代理](/docs/agents) 應執行此令。
如果這是 [子代理](/docs/agents/#subagents),該指令將預設觸發子代理呼叫
要禁用此行為,請將 `subtask` 設定為 `false`。
```json title="opencode.json"
{
@@ -270,15 +269,15 @@ Check for performance issues and suggest improvements.
}
```
這是一個**可選**配置選項。如果未指定,則默認為您當前的代理。
這是一個**可選**設定選項。如果未指定,則預設為您當前的代理。
---
### 子任務
### 子任務 (Subtask)
使用`subtask` 布值強制令觸發[子代理](/docs/agents/#subagents) 調用
如果您希望令不污染您的主要上下文並且將**強制**代理充當子代理,那麼這非常有用,
即使`mode` 在[代理](/docs/agents) 配置上設置為`primary`。
使用 `subtask` 布值強制令觸發 [子代理](/docs/agents/#subagents) 呼叫
如果您希望令不污染您的主要上下文並且將**強制**代理充當子代理,那麼這非常有用,
即使 `mode` 在 [代理](/docs/agents) 設定上設定為 `primary`。
```json title="opencode.json"
{
@@ -290,13 +289,13 @@ Check for performance issues and suggest improvements.
}
```
這是一個**可選**配置選項。
這是一個**可選**設定選項。
---
### 模型
### 模型 (Model)
使用 `model` 配置覆蓋此命令的默認模型。
使用 `model` 設定覆寫此指令的預設模型。
```json title="opencode.json"
{
@@ -308,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
自定義令可以覆蓋內置命令。
自定義令可以覆寫內建指令。
:::
如果您定義同名的自定義令,它將覆蓋內置命令。
如果您定義同名的自定義令,它將覆寫內建指令。