wip(docs): i18n (#12681)

packages/web/src/content/docs/zh-tw/commands.mdx

@@ -0,0 +1,323 @@
+---
+title: 命令
+description: 為重複任務創建自定義命令。
+---
+
+自定義命令允許您指定在 TUI 中執行該命令時要運行的提示。
+
+```bash frame="none"
+/my-command
+```
+
+除了`/init`、`/undo`、`/redo`、`/share`、`/help` 等內置命令之外，還有自定義命令。 [了解更多](/docs/tui#commands)。
+
+---
+
+## 創建命令文件
+
+在`commands/`目錄中創建markdown文件來定義自定義命令。
+
+創建`.opencode/commands/test.md`：
+
+```md title=".opencode/commands/test.md"
+---
+description: Run tests with coverage
+agent: build
+model: anthropic/claude-3-5-sonnet-20241022
+---
+
+Run the full test suite with coverage report and show any failures.
+Focus on the failing tests and suggest fixes.
+```
+
+frontmatter 定義命令屬性。內容成為模板。
+
+通過鍵入 `/` 後跟命令名稱來使用該命令。
+
+```bash frame="none"
+"/test"
+```
+
+---
+
+## 配置
+
+您可以通過 OpenCode 配置或通過在 `commands/` 目錄中創建 markdown 文件來添加自定義命令。
+
+---
+
+### JSON
+
+在 OpenCode [配置](/docs/config) 中使用 `command` 選項：
+
+```json title="opencode.jsonc" {4-12}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "command": {
+    // This becomes the name of the command
+    "test": {
+      // This is the prompt that will be sent to the LLM
+      "template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes.",
+      // This is shown as the description in the TUI
+      "description": "Run tests with coverage",
+      "agent": "build",
+      "model": "anthropic/claude-3-5-sonnet-20241022"
+    }
+  }
+}
+```
+
+現在您可以在 TUI 中運行此命令：
+
+```bash frame="none"
+/test
+```
+
+---
+
+### 降價
+
+您還可以使用 Markdown 文件定義命令。將它們放入：
+
+- 全球：`~/.config/opencode/commands/`
+- 每個項目：`.opencode/commands/`
+
+```markdown title="~/.config/opencode/commands/test.md"
+---
+description: Run tests with coverage
+agent: build
+model: anthropic/claude-3-5-sonnet-20241022
+---
+
+Run the full test suite with coverage report and show any failures.
+Focus on the failing tests and suggest fixes.
+```
+
+Markdown 文件名成為命令名。例如，`test.md` 讓
+你運行：
+
+```bash frame="none"
+/test
+```
+
+---
+
+## 提示配置
+
+自定義命令的提示支持幾個特殊的佔位符和語法。
+
+---
+
+### 論據
+
+使用 `$ARGUMENTS` 佔位符將參數傳遞給命令。
+
+```md title=".opencode/commands/component.md"
+---
+description: Create a new component
+---
+
+Create a new React component named $ARGUMENTS with TypeScript support.
+Include proper typing and basic structure.
+```
+
+使用參數運行命令：
+
+```bash frame="none"
+/component Button
+```
+
+`$ARGUMENTS` 將替換為 `Button`。
+
+您還可以使用位置參數訪問各個參數：
+
+- `$1` - 第一個參數
+- `$2` - 第二個參數
+- `$3` - 第三個參數
+- 等等...
+
+例如：
+
+```md title=".opencode/commands/create-file.md"
+---
+description: Create a new file with content
+---
+
+Create a file named $1 in the directory $2
+with the following content: $3
+```
+
+運行命令：
+
+```bash frame="none"
+/create-file config.json src "{ \"key\": \"value\" }"
+```
+
+這取代了：
+
+- `$1` 與`config.json`
+- `$2` 與`src`
+- `$3` 與`{ "key": "value" }`
+
+---
+
+### 外殼輸出
+
+使用 _!`command`_ 將 [bash命令](/docs/tui#bash-commands) 輸出注入到提示符中。
+
+例如，要創建分析測試覆蓋率的自定義命令：
+
+```md title=".opencode/commands/analyze-coverage.md"
+---
+description: Analyze test coverage
+---
+
+Here are the current test results:
+!`npm test`
+
+Based on these results, suggest improvements to increase coverage.
+```
+
+或者查看最近的更改：
+
+```md title=".opencode/commands/review-changes.md"
+---
+description: Review recent changes
+---
+
+Recent git commits:
+!`git log --oneline -10`
+
+Review these changes and suggest any improvements.
+```
+
+命令在項目的根目錄中運行，其輸出成為提示的一部分。
+
+---
+
+### 文件參考
+
+使用 `@` 後跟文件名將文件包含在命令中。
+
+```md title=".opencode/commands/review-component.md"
+---
+description: Review component
+---
+
+Review the component in @src/components/Button.tsx.
+Check for performance issues and suggest improvements.
+```
+
+文件內容會自動包含在提示中。
+
+---
+
+## 選項
+
+讓我們詳細看看配置選項。
+
+---
+
+### 模板
+
+`template` 選項定義執行命令時將發送到 LLM 的提示。
+
+```json title="opencode.json"
+{
+  "command": {
+    "test": {
+      "template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes."
+    }
+  }
+}
+```
+
+這是一個**必需的**配置選項。
+
+---
+
+### 描述
+
+使用 `description` 選項提供命令功能的簡要描述。
+
+```json title="opencode.json"
+{
+  "command": {
+    "test": {
+      "description": "Run tests with coverage"
+    }
+  }
+}
+```
+
+當您鍵入命令時，這將在 TUI 中顯示為描述。
+
+---
+
+### 代理人
+
+使用`agent` 配置可選擇指定哪個[代理人](/docs/agents) 應執行此命令。
+如果這是 [子代理](/docs/agents/#subagents) 該命令將默認觸發子代理調用。
+要禁用此行為，請將`subtask` 設置為`false`。
+
+```json title="opencode.json"
+{
+  "command": {
+    "review": {
+      "agent": "plan"
+    }
+  }
+}
+```
+
+這是一個**可選**配置選項。如果未指定，則默認為您當前的代理。
+
+---
+
+### 子任務
+
+使用`subtask` 布爾值強制命令觸發[子代理](/docs/agents/#subagents) 調用。
+如果您希望命令不污染您的主要上下文並且將**強制**代理充當子代理，那麼這非常有用，
+即使`mode` 在[代理人](/docs/agents) 配置上設置為`primary`。
+
+```json title="opencode.json"
+{
+  "command": {
+    "analyze": {
+      "subtask": true
+    }
+  }
+}
+```
+
+這是一個**可選**配置選項。
+
+---
+
+### 模型
+
+使用 `model` 配置覆蓋此命令的默認模型。
+
+```json title="opencode.json"
+{
+  "command": {
+    "analyze": {
+      "model": "anthropic/claude-3-5-sonnet-20241022"
+    }
+  }
+}
+```
+
+這是一個**可選**配置選項。
+
+---
+
+## 內建
+
+opencode包含`/init`、`/undo`、`/redo`、`/share`、`/help`等內置命令； [了解更多](/docs/tui#commands)。
+
+:::note
+自定義命令可以覆蓋內置命令。
+:::
+
+如果您定義同名的自定義命令，它將覆蓋內置命令。