@neurocode-ai/web 1.18.8

package/src/content/docs/zh-tw/custom-tools.mdx

@@ -0,0 +1,196 @@
+---
+title: 自訂工具
+description: 建立 LLM 可在 OpenCode 中呼叫的工具。
+---
+
+自訂工具是您建立的函式，LLM 可以在對話過程中呼叫它們。它們與 OpenCode 的[內建工具](/docs/tools)（如 `read`、`write` 和 `bash`）協同工作。
+
+---
+
+## 建立工具
+
+工具以 **TypeScript** 或 **JavaScript** 檔案的形式定義。不過，工具定義可以呼叫**任何語言**編寫的指令碼——TypeScript 或 JavaScript 僅用於工具定義本身。
+
+---
+
+### 位置
+
+工具可以在以下位置定義：
+
+- 本地定義：將工具檔案放在專案的 `.opencode/tools/` 目錄中。
+- 全域定義：將工具檔案放在 `~/.config/opencode/tools/` 中。
+
+---
+
+### 結構
+
+建立工具最簡單的方式是使用 `tool()` 輔助函式，它提供型別安全和參數校驗。
+
+```ts title=".opencode/tools/database.ts" {1}
+import { tool } from "@opencode-ai/plugin"
+
+export default tool({
+  description: "Query the project database",
+  args: {
+    query: tool.schema.string().describe("SQL query to execute"),
+  },
+  async execute(args) {
+    // Your database logic here
+    return `Executed query: ${args.query}`
+  },
+})
+```
+
+**檔案名稱**即為**工具名稱**。上面的範例建立了一個名為 `database` 的工具。
+
+---
+
+#### 單檔案多工具
+
+您也可以從單個檔案中匯出多個工具。每個匯出都會成為**一個獨立的工具**，命名格式為 **`<filename>_<exportname>`**：
+
+```ts title=".opencode/tools/math.ts"
+import { tool } from "@opencode-ai/plugin"
+
+export const add = tool({
+  description: "Add two numbers",
+  args: {
+    a: tool.schema.number().describe("First number"),
+    b: tool.schema.number().describe("Second number"),
+  },
+  async execute(args) {
+    return args.a + args.b
+  },
+})
+
+export const multiply = tool({
+  description: "Multiply two numbers",
+  args: {
+    a: tool.schema.number().describe("First number"),
+    b: tool.schema.number().describe("Second number"),
+  },
+  async execute(args) {
+    return args.a * args.b
+  },
+})
+```
+
+這會建立兩個工具：`math_add` 和 `math_multiply`。
+
+---
+
+#### 與內建工具名稱衝突
+
+自訂工具以工具名稱作為鍵值。如果自訂工具使用與內建工具相同的名稱，則自訂工具具有優先權。
+
+例如，此檔案將替換內建的 `bash` 工具：
+
+```ts title=".opencode/tools/bash.ts"
+import { tool } from "@opencode-ai/plugin"
+
+export default tool({
+  description: "Restricted bash wrapper",
+  args: {
+    command: tool.schema.string(),
+  },
+  async execute(args) {
+    return `blocked: ${args.command}`
+  },
+})
+```
+
+:::note
+除非您有意替換內建工具，否則請使用唯一的名稱。如果您想停用內建工具但不覆寫它，請使用[權限](/docs/permissions)。
+:::
+
+---
+
+### 參數
+
+您可以使用 `tool.schema`（即 [Zod](https://zod.dev)）來定義參數型別。
+
+```ts "tool.schema"
+args: {
+  query: tool.schema.string().describe("SQL query to execute")
+}
+```
+
+您也可以直接匯入 [Zod](https://zod.dev) 並回傳一個普通物件：
+
+```ts {6}
+import { z } from "zod"
+
+export default {
+  description: "Tool description",
+  args: {
+    param: z.string().describe("Parameter description"),
+  },
+  async execute(args, context) {
+    // Tool implementation
+    return "result"
+  },
+}
+```
+
+---
+
+### 上下文
+
+工具會接收當前工作階段的上下文資訊：
+
+```ts title=".opencode/tools/project.ts" {8}
+import { tool } from "@opencode-ai/plugin"
+
+export default tool({
+  description: "Get project information",
+  args: {},
+  async execute(args, context) {
+    // Access context information
+    const { agent, sessionID, messageID, directory, worktree } = context
+    return `Agent: ${agent}, Session: ${sessionID}, Message: ${messageID}, Directory: ${directory}, Worktree: ${worktree}`
+  },
+})
+```
+
+使用 `context.directory` 取得工作階段的工作目錄。
+使用 `context.worktree` 取得 git worktree 根目錄。
+
+---
+
+## 範例
+
+### 用 Python 編寫工具
+
+您可以使用任何語言編寫工具。以下範例展示了如何用 Python 實作兩數相加。
+
+首先，建立一個 Python 指令碼作為工具：
+
+```python title=".opencode/tools/add.py"
+import sys
+
+a = int(sys.argv[1])
+b = int(sys.argv[2])
+print(a + b)
+```
+
+然後建立呼叫該指令碼的工具定義：
+
+```ts title=".opencode/tools/python-add.ts" {10}
+import { tool } from "@opencode-ai/plugin"
+import path from "path"
+
+export default tool({
+  description: "Add two numbers using Python",
+  args: {
+    a: tool.schema.number().describe("First number"),
+    b: tool.schema.number().describe("Second number"),
+  },
+  async execute(args, context) {
+    const script = path.join(context.worktree, ".opencode/tools/add.py")
+    const result = await Bun.$`python3 ${script} ${args.a} ${args.b}`.text()
+    return result.trim()
+  },
+})
+```
+
+這裡我們使用 [`Bun.$`](https://bun.com/docs/runtime/shell) 工具函式來執行 Python 指令碼。

package/src/content/docs/zh-tw/ecosystem.mdx

@@ -0,0 +1,78 @@
+---
+title: 生態系統
+description: 基於 OpenCode 建置的專案與整合。
+---
+
+基於 OpenCode 建置的社群專案合集。
+
+:::note
+想將您的 OpenCode 相關專案新增到此列表中？歡迎提交 PR。
+:::
+
+您還可以查看 [awesome-opencode](https://github.com/awesome-opencode/awesome-opencode) 和 [opencode.cafe](https://opencode.cafe)，這是一個聚合生態系統與社群資源的社群。
+
+---
+
+## 外掛程式
+
+| 名稱                                                                                               | 說明                                                                       |
+| -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
+| [opencode-daytona](https://github.com/daytonaio/daytona/tree/main/libs/opencode-plugin)            | 在隔離的 Daytona 沙箱中自動執行 OpenCode 工作階段，支援 git 同步和即時預覽 |
+| [opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session)                  | 自動注入 Helicone 工作階段標頭資訊，用於請求分組                           |
+| [opencode-type-inject](https://github.com/nick-vi/opencode-type-inject)                            | 透過搜尋工具自動將 TypeScript/Svelte 型別注入到檔案讀取中                  |
+| [opencode-openai-codex-auth](https://github.com/numman-ali/opencode-openai-codex-auth)             | 使用您的 ChatGPT Plus/Pro 訂閱替代 API 額度                                |
+| [opencode-gemini-auth](https://github.com/jenslys/opencode-gemini-auth)                            | 使用您現有的 Gemini 方案替代 API 計費                                      |
+| [opencode-antigravity-auth](https://github.com/NoeFabris/opencode-antigravity-auth)                | 使用 Antigravity 的免費模型替代 API 計費                                   |
+| [opencode-devcontainers](https://github.com/athal7/opencode-devcontainers)                         | 多分支開發容器隔離，支援淺層複製和自動分配連接埠                           |
+| [opencode-google-antigravity-auth](https://github.com/shekohex/opencode-google-antigravity-auth)   | Google Antigravity OAuth 外掛程式，支援 Google 搜尋及更強健的 API 處理     |
+| [opencode-dynamic-context-pruning](https://github.com/Tarquinen/opencode-dynamic-context-pruning)  | 透過修剪過時的工具輸出來最佳化 Token 使用                                  |
+| [opencode-vibeguard](https://github.com/inkdust2021/opencode-vibeguard)                            | 在呼叫 LLM 之前將秘密/PII 編輯為 VibeGuard 風格的預留位置；並在本地還原    |
+| [opencode-websearch-cited](https://github.com/ghoulr/opencode-websearch-cited.git)                 | 為受支援的供應商新增原生網頁搜尋支援，採用 Google grounded 風格            |
+| [opencode-pty](https://github.com/shekohex/opencode-pty.git)                                       | 使 AI 代理能夠在 PTY 中執行背景處理程序，並向其傳送互動式輸入              |
+| [opencode-shell-strategy](https://github.com/JRedeker/opencode-shell-strategy)                     | 非互動式 shell 指令說明——防止依賴 TTY 的操作導致卡住                       |
+| [opencode-wakatime](https://github.com/angristan/opencode-wakatime)                                | 使用 Wakatime 追蹤 OpenCode 的使用情況                                     |
+| [opencode-md-table-formatter](https://github.com/franlol/opencode-md-table-formatter/tree/main)    | 清理 LLM 生成的 Markdown 表格                                              |
+| [opencode-morph-plugin](https://github.com/morphllm/opencode-morph-plugin)                         | 透過 Morph 提供 Fast Apply 編輯、WarpGrep 程式碼搜尋和上下文壓縮           |
+| [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode)                                   | 背景代理、預建置的 LSP/AST/MCP 工具、精選代理，相容 Claude Code            |
+| [opencode-notificator](https://github.com/panta82/opencode-notificator)                            | OpenCode 工作階段的桌面通知和聲音提醒                                      |
+| [opencode-notifier](https://github.com/mohak34/opencode-notifier)                                  | 針對權限請求、任務完成和錯誤事件的桌面通知與聲音提醒                       |
+| [opencode-zellij-namer](https://github.com/24601/opencode-zellij-namer)                            | 基於 OpenCode 上下文的 AI 驅動自動 Zellij 工作階段命名                     |
+| [opencode-skillful](https://github.com/zenobi-us/opencode-skillful)                                | 允許 OpenCode 代理透過技能發現和注入按需延遲載入提示詞                     |
+| [opencode-supermemory](https://github.com/supermemoryai/opencode-supermemory)                      | 使用 Supermemory 實現跨工作階段的持久記憶                                  |
+| [@plannotator/opencode](https://github.com/backnotprop/plannotator/tree/main/apps/opencode-plugin) | 支援視覺化標註和私有/離線分享的互動式計畫審查                              |
+| [@openspoon/subtask2](https://github.com/spoons-and-mirrors/subtask2)                              | 將 OpenCode /commands 擴展為具有精細流程控制的強大編排系統                 |
+| [opencode-scheduler](https://github.com/different-ai/opencode-scheduler)                           | 使用 cron 語法透過 launchd (Mac) 或 systemd (Linux) 排程週期性任務         |
+| [micode](https://github.com/vtemian/micode)                                                        | 結構化的腦力激盪 → 計畫 → 實作工作流程，支援工作階段連續性                 |
+| [octto](https://github.com/vtemian/octto)                                                          | 用於 AI 腦力激盪的互動式瀏覽器 UI，支援多問題表單                          |
+| [opencode-background-agents](https://github.com/kdcokenny/opencode-background-agents)              | Claude Code 風格的背景代理，支援非同步委派和上下文持久化                   |
+| [opencode-notify](https://github.com/kdcokenny/opencode-notify)                                    | OpenCode 的原生作業系統通知——隨時了解任務完成情況                          |
+| [opencode-workspace](https://github.com/kdcokenny/opencode-workspace)                              | 捆綁式多代理編排套件——16 個元件，一次安裝                                  |
+| [opencode-worktree](https://github.com/kdcokenny/opencode-worktree)                                | OpenCode 的零摩擦 git worktree 管理                                        |
+| [opencode-sentry-monitor](https://github.com/stolinski/opencode-sentry-monitor)                    | 使用 Sentry AI Monitoring 追蹤與除錯您的 AI 代理                           |
+
+---
+
+## 專案
+
+| 名稱                                                                                       | 說明                                                          |
+| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------- |
+| [kimaki](https://github.com/remorses/kimaki)                                               | 用於控制 OpenCode 工作階段的 Discord 機器人，基於 SDK 建置    |
+| [opencode.nvim](https://github.com/NickvanDyke/opencode.nvim)                              | Neovim 外掛程式，提供編輯器感知的提示詞，基於 API 建置        |
+| [portal](https://github.com/hosenur/portal)                                                | 透過 Tailscale/VPN 使用的行動優先 OpenCode Web UI             |
+| [opencode plugin template](https://github.com/zenobi-us/opencode-plugin-template/)         | 用於建置 OpenCode 外掛程式的範本                              |
+| [opencode.nvim](https://github.com/sudo-tee/opencode.nvim)                                 | OpenCode 的 Neovim 前端——基於終端機的 AI 編碼代理             |
+| [ai-sdk-provider-opencode-sdk](https://github.com/ben-vargas/ai-sdk-provider-opencode-sdk) | Vercel AI SDK 供應商，用於透過 @opencode-ai/sdk 使用 OpenCode |
+| [OpenChamber](https://github.com/btriapitsyn/openchamber)                                  | OpenCode 的 Web / 桌面應用程式和 VS Code 擴充功能             |
+| [OpenCode-Obsidian](https://github.com/mtymek/opencode-obsidian)                           | 將 OpenCode 嵌入 Obsidian UI 的 Obsidian 外掛程式             |
+| [OpenWork](https://github.com/different-ai/openwork)                                       | Claude Cowork 的開源替代方案，由 OpenCode 驅動                |
+| [ocx](https://github.com/kdcokenny/ocx)                                                    | OpenCode 擴充功能管理器，支援可攜式的隔離設定                 |
+| [CodeNomad](https://github.com/NeuralNomadsAI/CodeNomad)                                   | OpenCode 的桌面、Web、行動和遠端用戶端應用程式                |
+
+---
+
+## 代理
+
+| 名稱                                                              | 說明                                           |
+| ----------------------------------------------------------------- | ---------------------------------------------- |
+| [Agentic](https://github.com/Cluster444/agentic)                  | 用於結構化開發的模組化 AI 代理和指令           |
+| [opencode-agents](https://github.com/darrenhinde/opencode-agents) | 用於增強工作流程的設定、提示詞、代理和外掛程式 |

package/src/content/docs/zh-tw/enterprise.mdx

@@ -0,0 +1,165 @@
+---
+title: 企業版
+description: 在您的組織中安全地使用 OpenCode。
+---
+
+import config from "../../../../config.mjs"
+export const email = `mailto:${config.email}`
+
+OpenCode 企業版面向希望確保程式碼和資料始終留在自有基礎架構內的組織。它透過集中式設定與您的 SSO 和內部 AI 閘道整合來實現這一目標。
+
+:::note
+OpenCode 不會儲存您的任何程式碼或上下文資料。
+:::
+
+開始使用 OpenCode 企業版：
+
+1. 在團隊內部進行試用。
+2. **<a href={email}>聯絡我們</a>**，討論定價和實作方案。
+
+---
+
+## 試用
+
+OpenCode 是開源的，不會儲存您的任何程式碼或上下文資料，因此您的開發人員可以直接[開始使用](/docs/)並進行試用。
+
+---
+
+### 資料處理
+
+**OpenCode 不會儲存您的程式碼或上下文資料。**所有處理均在本地完成，或透過直接 API 呼叫傳送至您的 AI 供應商。
+
+這意味著，只要您使用的是信任的供應商或內部 AI 閘道，就可以安全地使用 OpenCode。
+
+唯一需要注意的是可選的 `/share` 功能。
+
+---
+
+#### 分享對話
+
+如果使用者啟用了 `/share` 功能，對話及其關聯資料將被傳送到我們用於在 opencode.ai 上託管共享頁面的服務。
+
+資料目前透過我們 CDN 的邊緣網路提供服務，並快取在靠近使用者的邊緣節點上。
+
+我們建議您在試用期間停用此功能。
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "disabled"
+}
+```
+
+[了解更多關於分享的資訊](/docs/share)。
+
+---
+
+### 程式碼所有權
+
+**您擁有 OpenCode 生成的所有程式碼。**不存在任何授權限制或所有權聲明。
+
+---
+
+## 定價
+
+OpenCode 企業版採用按席位定價模型。如果您擁有自己的 LLM 閘道，我們不會對使用的 Token 收取費用。有關定價和實作方案的更多詳情，請**<a href={email}>聯絡我們</a>**。
+
+---
+
+## 部署
+
+完成試用並準備好在組織中使用 OpenCode 後，您可以**<a href={email}>聯絡我們</a>**，討論定價和實作方案。
+
+---
+
+### 集中式設定
+
+我們可以為您的整個組織設定 OpenCode 的統一集中式設定。
+
+該集中式設定可與您的 SSO 供應商整合，確保所有使用者僅存取您的內部 AI 閘道。
+
+---
+
+### SSO 整合
+
+透過集中式設定，OpenCode 可以與您組織的 SSO 供應商整合進行身分驗證。
+
+這使得 OpenCode 能夠透過您現有的身分管理系統取得內部 AI 閘道的憑證。
+
+---
+
+### 內部 AI 閘道
+
+透過集中式設定，OpenCode 還可以被設定為僅使用您的內部 AI 閘道。
+
+您還可以停用所有其他 AI 供應商，確保所有請求都經過組織核准的基礎架構。
+
+---
+
+### 自行託管
+
+雖然我們建議停用共享頁面以確保您的資料始終不會離開組織，但我們也可以幫助您在自己的基礎架構上自行託管這些頁面。
+
+此功能目前已列入我們的路線圖。如果您感興趣，請**<a href={email}>告訴我們</a>**。
+
+---
+
+## 常見問題
+
+<details>
+<summary>什麼是 OpenCode 企業版？</summary>
+
+OpenCode 企業版面向希望確保程式碼和資料始終留在自有基礎架構內的組織。它透過集中式設定與您的 SSO 和內部 AI 閘道整合來實現這一目標。
+
+</details>
+
+<details>
+<summary>如何開始使用 OpenCode 企業版？</summary>
+
+只需在團隊內部開始試用即可。OpenCode 預設不會儲存您的程式碼或上下文資料，因此可以輕鬆上手。
+
+然後**<a href={email}>聯絡我們</a>**，討論定價和實作方案。
+
+</details>
+
+<details>
+<summary>企業版定價如何運作？</summary>
+
+我們提供按席位的企業版定價。如果您擁有自己的 LLM 閘道，我們不會對使用的 Token 收取費用。如需了解更多詳情，請**<a href={email}>聯絡我們</a>**，取得根據您組織需求訂製的報價。
+
+</details>
+
+<details>
+<summary>我的資料在 OpenCode 企業版中是否安全？</summary>
+
+是的。OpenCode 不會儲存您的程式碼或上下文資料。所有處理均在本地完成，或透過直接 API 呼叫傳送至您的 AI 供應商。透過集中式設定和 SSO 整合，您的資料將安全地保留在組織的基礎架構內。
+
+</details>
+
+<details>
+<summary>我們可以使用自己的私有 NPM 註冊表嗎？</summary>
+
+OpenCode 透過 Bun 原生的 `.npmrc` 檔案支援來支援私有 npm 註冊表。如果您的組織使用私有註冊表（例如 JFrog Artifactory、Nexus 或類似產品），請確保開發人員在執行 OpenCode 之前已完成身分驗證。
+
+要設定私有註冊表的身分驗證：
+
+```bash
+npm login --registry=https://your-company.jfrog.io/api/npm/npm-virtual/
+```
+
+這會建立包含身分驗證資訊的 `~/.npmrc` 檔案。OpenCode 會自動識別並使用它。
+
+:::caution
+在執行 OpenCode 之前，您必須先登入私有註冊表。
+:::
+
+或者，您也可以手動設定 `.npmrc` 檔案：
+
+```bash title="~/.npmrc"
+registry=https://your-company.jfrog.io/api/npm/npm-virtual/
+//your-company.jfrog.io/api/npm/npm-virtual/:_authToken=${NPM_AUTH_TOKEN}
+```
+
+開發人員必須在執行 OpenCode 之前登入私有註冊表，以確保能夠從您的企業註冊表安裝套件。
+
+</details>

package/src/content/docs/zh-tw/formatters.mdx

@@ -0,0 +1,132 @@
+---
+title: 格式化器
+description: OpenCode 使用特定語言的格式化器。
+---
+
+OpenCode 會在檔案寫入或編輯後，自動使用特定語言的格式化器對其進行格式化。這確保了生成的程式碼遵循您專案的程式碼風格。
+
+---
+
+## 內建格式化器
+
+OpenCode 內建了多種適用於主流語言和框架的格式化器。下表列出了各格式化器、支援的副檔名以及所需的指令或設定選項。
+
+| 格式化器             | 副檔名                                                                                                | 要求                                                                                        |
+| -------------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
+| air                  | .R                                                                                                    | `air` 指令可用                                                                              |
+| biome                | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml 及[更多](https://biomejs.dev/)                   | `biome.json(c)` 設定檔                                                                      |
+| cargofmt             | .rs                                                                                                   | `cargo fmt` 指令可用                                                                        |
+| clang-format         | .c, .cpp, .h, .hpp, .ino 及[更多](https://clang.llvm.org/docs/ClangFormat.html)                       | `.clang-format` 設定檔                                                                      |
+| cljfmt               | .clj, .cljs, .cljc, .edn                                                                              | `cljfmt` 指令可用                                                                           |
+| dart                 | .dart                                                                                                 | `dart` 指令可用                                                                             |
+| dfmt                 | .d                                                                                                    | `dfmt` 指令可用                                                                             |
+| gleam                | .gleam                                                                                                | `gleam` 指令可用                                                                            |
+| gofmt                | .go                                                                                                   | `gofmt` 指令可用                                                                            |
+| htmlbeautifier       | .erb, .html.erb                                                                                       | `htmlbeautifier` 指令可用                                                                   |
+| ktlint               | .kt, .kts                                                                                             | `ktlint` 指令可用                                                                           |
+| mix                  | .ex, .exs, .eex, .heex, .leex, .neex, .sface                                                          | `mix` 指令可用                                                                              |
+| nixfmt               | .nix                                                                                                  | `nixfmt` 指令可用                                                                           |
+| ocamlformat          | .ml, .mli                                                                                             | `ocamlformat` 指令可用且存在 `.ocamlformat` 設定檔                                          |
+| ormolu               | .hs                                                                                                   | `ormolu` 指令可用                                                                           |
+| oxfmt (Experimental) | .js, .jsx, .ts, .tsx                                                                                  | `package.json` 中有 `oxfmt` 相依套件，且設定了[實驗性環境變數旗標](/docs/cli/#experimental) |
+| pint                 | .php                                                                                                  | `composer.json` 中有 `laravel/pint` 相依套件                                                |
+| prettier             | .js, .jsx, .ts, .tsx, .html, .css, .md, .json, .yaml 及[更多](https://prettier.io/docs/en/index.html) | `package.json` 中有 `prettier` 相依套件                                                     |
+| rubocop              | .rb, .rake, .gemspec, .ru                                                                             | `rubocop` 指令可用                                                                          |
+| ruff                 | .py, .pyi                                                                                             | `ruff` 指令可用且有相應設定                                                                 |
+| rustfmt              | .rs                                                                                                   | `rustfmt` 指令可用                                                                          |
+| shfmt                | .sh, .bash                                                                                            | `shfmt` 指令可用                                                                            |
+| standardrb           | .rb, .rake, .gemspec, .ru                                                                             | `standardrb` 指令可用                                                                       |
+| terraform            | .tf, .tfvars                                                                                          | `terraform` 指令可用                                                                        |
+| uv                   | .py, .pyi                                                                                             | `uv` 指令可用                                                                               |
+| zig                  | .zig, .zon                                                                                            | `zig` 指令可用                                                                              |
+
+因此，如果您的專案 `package.json` 中包含 `prettier`，OpenCode 會自動使用它進行格式化。
+
+---
+
+## 工作原理
+
+當 OpenCode 寫入或編輯檔案時，它會：
+
+1. 根據所有已啟用的格式化器檢查副檔名。
+2. 對檔案執行相應的格式化指令。
+3. 自動套用格式化變更。
+
+整個過程在背景完成，無需任何手動操作即可保持程式碼風格的一致性。
+
+---
+
+## 設定
+
+您可以透過 OpenCode 設定中的 `formatter` 部分自訂格式化器。
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "formatter": {}
+}
+```
+
+每個格式化器的設定支援以下屬性：
+
+| 屬性          | 型別     | 說明                         |
+| ------------- | -------- | ---------------------------- |
+| `disabled`    | boolean  | 設為 `true` 可停用該格式化器 |
+| `command`     | string[] | 執行格式化的指令             |
+| `environment` | object   | 執行格式化器時設定的環境變數 |
+| `extensions`  | string[] | 該格式化器處理的副檔名       |
+
+下面來看一些範例。
+
+---
+
+### 停用格式化器
+
+要全域停用**所有**格式化器，將 `formatter` 設為 `false`：
+
+```json title="opencode.json" {3}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "formatter": false
+}
+```
+
+要停用**特定**格式化器，將 `disabled` 設為 `true`：
+
+```json title="opencode.json" {5}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "formatter": {
+    "prettier": {
+      "disabled": true
+    }
+  }
+}
+```
+
+---
+
+### 自訂格式化器
+
+您可以透過指定指令、環境變數和副檔名來覆寫內建格式化器或新增新的格式化器：
+
+```json title="opencode.json" {4-14}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "formatter": {
+    "prettier": {
+      "command": ["npx", "prettier", "--write", "$FILE"],
+      "environment": {
+        "NODE_ENV": "development"
+      },
+      "extensions": [".js", ".ts", ".jsx", ".tsx"]
+    },
+    "custom-markdown-formatter": {
+      "command": ["deno", "fmt", "$FILE"],
+      "extensions": [".md"]
+    }
+  }
+}
+```
+
+指令中的 **`$FILE` 佔位符**會被替換為待格式化檔案的路徑。