diff options
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.mdx | 50 |
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 指令碼。 |
