@neurocode-ai/web 1.18.8

package/src/content/docs/zh-cn/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-cn/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-cn/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-cn/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` 占位符**会被替换为待格式化文件的路径。