summaryrefslogtreecommitdiffhomepage
path: root/packages/web/src/content/docs/zh-tw/custom-tools.mdx
diff options
context:
space:
mode:
Diffstat (limited to 'packages/web/src/content/docs/zh-tw/custom-tools.mdx')
-rw-r--r--packages/web/src/content/docs/zh-tw/custom-tools.mdx50
1 files changed, 25 insertions, 25 deletions
diff --git a/packages/web/src/content/docs/zh-tw/custom-tools.mdx b/packages/web/src/content/docs/zh-tw/custom-tools.mdx
index e55e01da2..29db4675e 100644
--- a/packages/web/src/content/docs/zh-tw/custom-tools.mdx
+++ b/packages/web/src/content/docs/zh-tw/custom-tools.mdx
@@ -1,30 +1,30 @@
---
-title: 定制工具
-description: 創建LLM可以在opencode中調用的工具。
+title: 自定義工具
+description: 建立 LLM 可以在 opencode 中呼叫的工具。
---
-自定義工具是您創建的函數,LLM 可以在對話期間調用。它們與 opencode 的 [內置工具](/docs/tools) 一起工作,例如 `read`、`write` 和 `bash`。
+自定義工具是您建立的函式,LLM 可以在對話期間呼叫。它們與 opencode 的 [內建工具](/docs/tools) 一起工作,例如 `read`、`write` 和 `bash`。
---
-## 創建工具
+## 建立工具
-工具定義為 **TypeScript** 或 **JavaScript** 文件。但是,工具定義可以調用用 **任何語言** 編寫的腳本 - TypeScript 或 JavaScript 僅用於工具定義本身。
+工具定義為 **TypeScript** 或 **JavaScript** 檔案。但是,工具定義可以呼叫用 **任何語言** 編寫的指令碼 - TypeScript 或 JavaScript 僅用於工具定義本身。
---
-### 地點
+### 位置
它們可以定義為:
-- 通過將它們放在項目的 `.opencode/tools/` 目錄中來本地進行。
-- 或者在全局範圍內,將它們放置在 `~/.config/opencode/tools/` 中。
+- 透過將它們放在專案的 `.opencode/tools/` 目錄中來本地進行。
+- 或者在全域範圍內,將它們放置在 `~/.config/opencode/tools/` 中。
---
### 結構
-創建工具的最簡單方法是使用 `tool()` 幫助程序,它提供類型安全和驗證。
+建立工具的最簡單方法是使用 `tool()` 輔助程式,它提供類型安全和驗證。
```ts title=".opencode/tools/database.ts" {1}
import { tool } from "@opencode-ai/plugin"
@@ -41,13 +41,13 @@ export default tool({
})
```
-**文件名**成為**工具名稱**。以上創建了一個 `database` 工具。
+**檔名**成為**工具名稱**。以上建立了一個 `database` 工具。
---
-#### 每個文件多個工具
+#### 每個檔案多個工具
-您還可以從單個文件導出多個工具。每個導出都會成為**一個單獨的工具**,名稱為**`<filename>_<exportname>`**:
+您也可以從單個檔案匯出多個工具。每個匯出都會成為**一個單獨的工具**,名稱為 **`<filename>_<exportname>`**:
```ts title=".opencode/tools/math.ts"
import { tool } from "@opencode-ai/plugin"
@@ -75,13 +75,13 @@ export const multiply = tool({
})
```
-這將創建兩個工具:`math_add` 和`math_multiply`。
+這將建立兩個工具:`math_add` 和 `math_multiply`。
---
-### 論據
+### 參數 (Arguments)
-您可以使用`tool.schema`(即[佐德](https://zod.dev))來定義參數類型。
+您可以使用 `tool.schema`(即 [Zod](https://zod.dev))來定義參數類型。
```ts "tool.schema"
args: {
@@ -89,7 +89,7 @@ args: {
}
```
-您還可以直接導入[佐德](https://zod.dev)並返回一個普通對象:
+您也可以直接匯入 [Zod](https://zod.dev) 並返回一個一般物件:
```ts {6}
import { z } from "zod"
@@ -108,9 +108,9 @@ export default {
---
-### 情境
+### 上下文 (Context)
-工具接收有關當前會話的上下文:
+工具接收有關當前工作階段的上下文:
```ts title=".opencode/tools/project.ts" {8}
import { tool } from "@opencode-ai/plugin"
@@ -126,18 +126,18 @@ export default tool({
})
```
-使用 `context.directory` 作為會話工作目錄。
+使用 `context.directory` 作為工作階段工作目錄。
使用 `context.worktree` 作為 git 工作樹根。
---
-## 示例
+## 範例
-### 用Python編寫一個工具
+### 用 Python 編寫一個工具
-您可以用任何您想要的語言編寫工具。下面是一個使用 Python 將兩個數字相加的示例。
+您可以用任何您想要的語言編寫工具。下面是一個使用 Python 將兩個數字相加的範例。
-首先,將該工具創建為 Python 腳本:
+首先,將該工具建立為 Python 指令碼:
```python title=".opencode/tools/add.py"
import sys
@@ -147,7 +147,7 @@ b = int(sys.argv[2])
print(a + b)
```
-然後創建調用它的工具定義:
+然後建立呼叫它的工具定義:
```ts title=".opencode/tools/python-add.ts" {10}
import { tool } from "@opencode-ai/plugin"
@@ -167,4 +167,4 @@ export default tool({
})
```
-這裡我們使用 [`Bun.$`](https://bun.com/docs/runtime/shell) 實用程序來運行 Python 腳本。
+這裡我們使用 [`Bun.$`](https://bun.com/docs/runtime/shell) 公用程式來執行 Python 指令碼。