chore(i18n): refresh zh-CN translations

2026-05-03 23:46:47 +00:00 · 2026-05-03 23:46:47 +00:00 · 330945deeb
commit 330945deeb
parent 7250f9ef67
1 changed files with 107 additions and 69 deletions
--- a/docs/zh-CN/plugins/building-plugins.md
+++ b/docs/zh-CN/plugins/building-plugins.md
@ -2,28 +2,32 @@
 read_when:
    - 你想创建一个新的 OpenClaw 插件
    - 你需要一份插件开发快速开始指南
-    - 你正在向 OpenClaw 添加新的渠道、提供商、工具或其他能力
+    - 你正在为 OpenClaw 添加新的渠道、提供商、工具或其他能力
 sidebarTitle: Getting Started
 summary: 几分钟内创建你的第一个 OpenClaw 插件
 title: 构建插件
 x-i18n:
-    generated_at: "2026-05-02T19:10:40Z"
+    generated_at: "2026-05-03T23:45:54Z"
    model: gpt-5.5
    provider: openai
-    source_hash: b42170b40094f89a63b1497c08ec31e397931dd536bd6faeeb8bc3c123ae45d1
+    source_hash: 3e6c55c551629da54b3f150ce6299694186fe4434cfd7978a2d43d175d33a5d9
    source_path: plugins/building-plugins.md
    workflow: 16
 ---

-插件为 OpenClaw 扩展新能力：渠道、模型提供商、语音、实时转写、实时语音、媒体理解、图像生成、视频生成、网页获取、Web 搜索、智能体工具，或它们的任意组合。
+插件通过新能力扩展 OpenClaw：渠道、模型提供商、语音、实时转写、实时语音、媒体理解、图像生成、视频生成、网页抓取、Web 搜索、智能体工具，或这些能力的任意组合。

-你不需要把你的插件添加到 OpenClaw 仓库。发布到 [ClawHub](/zh-CN/tools/clawhub)，用户可通过 `openclaw plugins install clawhub:<package-name>` 安装。在发布切换期间，裸包规格仍会从 npm 安装。
+你不需要把你的插件加入 OpenClaw 仓库。发布到
+[ClawHub](/zh-CN/tools/clawhub)，用户可通过
+`openclaw plugins install clawhub:<package-name>` 安装。在发布切换期间，裸包规格仍会从 npm 安装。

-## 前提条件
+## 前置条件

 - Node >= 22 和一个包管理器（npm 或 pnpm）
 - 熟悉 TypeScript（ESM）
- 对于仓库内插件：已克隆仓库并完成 `pnpm install`。源码检出插件开发仅支持 pnpm，因为 OpenClaw 会从 `extensions/*` 工作区包加载内置插件。
+- 对于仓库内插件：已克隆仓库并完成 `pnpm install`。源码
+  checkout 插件开发仅支持 pnpm，因为 OpenClaw 会从 `extensions/*` 工作区包加载内置
+  插件。

 ## 哪种插件？

@ -32,18 +36,21 @@ x-i18n:
    将 OpenClaw 连接到消息平台（Discord、IRC 等）
  </Card>
  <Card title="提供商插件" icon="cpu" href="/zh-CN/plugins/sdk-provider-plugins">
-    添加模型提供商（LLM、代理或自定义端点）
+    添加一个模型提供商（LLM、代理或自定义端点）
  </Card>
  <Card title="工具 / 钩子插件" icon="wrench" href="/zh-CN/plugins/hooks">
    注册智能体工具、事件钩子或服务 — 继续阅读下文
  </Card>
 </CardGroup>

-对于无法保证在新手引导/设置运行时已安装的渠道插件，请使用 `openclaw/plugin-sdk/channel-setup` 中的 `createOptionalChannelSetupSurface(...)`。它会生成一组设置适配器 + 向导，说明安装要求，并且在插件安装前对真实配置写入采取失败关闭策略。
+对于无法保证在新手引导/设置运行时已安装的渠道插件，请使用
+`openclaw/plugin-sdk/channel-setup` 中的 `createOptionalChannelSetupSurface(...)`。
+它会生成一组设置适配器 + 向导，用于告知安装要求，并且在插件安装之前对真实配置写入采取失败关闭策略。

 ## 快速开始：工具插件

-本演练会创建一个注册智能体工具的最小插件。渠道和提供商插件有上面链接的专门指南。
+本 walkthrough 会创建一个注册智能体工具的最小插件。渠道
+和提供商插件有上方链接的专门指南。

 <Steps>
  <Step title="创建包和清单">
@ -86,7 +93,12 @@ x-i18n:
    ```
    </CodeGroup>

-    每个插件都需要清单，即使没有配置也是如此。运行时注册的工具必须列在 `contracts.tools` 中，这样 OpenClaw 才能在不加载每个插件运行时的情况下发现所属插件。插件还应有意声明 `activation.onStartup`。此示例将其设为 `true`。完整架构请参阅 [清单](/zh-CN/plugins/manifest)。规范的 ClawHub 发布片段位于 `docs/snippets/plugin-publish/`。
+    每个插件都需要一个清单，即使没有配置也是如此。运行时注册的工具
+    必须列在 `contracts.tools` 中，这样 OpenClaw 才能在不加载每个插件运行时的情况下发现所属
+    插件。插件还应有意声明
+    `activation.onStartup`。本示例将其设为 `true`。完整 schema 请参阅
+    [清单](/zh-CN/plugins/manifest)。规范的 ClawHub
+    发布代码片段位于 `docs/snippets/plugin-publish/`。

  </Step>

@ -114,11 +126,13 @@ x-i18n:
    });
    ```

-    `definePluginEntry` 用于非渠道插件。对于渠道，请使用 `defineChannelPluginEntry` — 参阅 [渠道插件](/zh-CN/plugins/sdk-channel-plugins)。完整入口点选项请参阅 [入口点](/zh-CN/plugins/sdk-entrypoints)。
+    `definePluginEntry` 用于非渠道插件。对于渠道，请使用
+    `defineChannelPluginEntry` — 参阅 [渠道插件](/zh-CN/plugins/sdk-channel-plugins)。
+    如需完整入口点选项，请参阅 [入口点](/zh-CN/plugins/sdk-entrypoints)。

  </Step>

-  <Step title="测试并发布">
+  <Step title="测试和发布">

    **外部插件：** 使用 ClawHub 验证并发布，然后安装：

@ -128,9 +142,10 @@ x-i18n:
    openclaw plugins install clawhub:@myorg/openclaw-my-plugin
    ```

-    在发布切换期间，像 `@myorg/openclaw-my-plugin` 这样的裸包规格会从 npm 安装。当你希望使用 ClawHub 解析时，请使用 `clawhub:`。
+    像 `@myorg/openclaw-my-plugin` 这样的裸包规格会在发布切换期间从 npm 安装。
+    当你希望使用 ClawHub 解析时，请使用 `clawhub:`。

-    **仓库内插件：** 放在内置插件工作区树下 — 会自动发现。
+    **仓库内插件：** 放在内置插件工作区树下 — 会被自动发现。

    ```bash
    pnpm test -- <bundled-plugin-root>/my-plugin/
@ -147,7 +162,7 @@ x-i18n:
 | ---------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------- |
 | 文本推理（LLM）        | `api.registerProvider(...)`                      | [提供商插件](/zh-CN/plugins/sdk-provider-plugins)                                     |
 | CLI 推理后端           | `api.registerCliBackend(...)`                    | [CLI 后端](/zh-CN/gateway/cli-backends)                                               |
-| 渠道 / 消息传递        | `api.registerChannel(...)`                       | [渠道插件](/zh-CN/plugins/sdk-channel-plugins)                                        |
+| 渠道 / 消息            | `api.registerChannel(...)`                       | [渠道插件](/zh-CN/plugins/sdk-channel-plugins)                                        |
 | 语音（TTS/STT）        | `api.registerSpeechProvider(...)`                | [提供商插件](/zh-CN/plugins/sdk-provider-plugins#step-5-add-extra-capabilities)       |
 | 实时转写               | `api.registerRealtimeTranscriptionProvider(...)` | [提供商插件](/zh-CN/plugins/sdk-provider-plugins#step-5-add-extra-capabilities)       |
 | 实时语音               | `api.registerRealtimeVoiceProvider(...)`         | [提供商插件](/zh-CN/plugins/sdk-provider-plugins#step-5-add-extra-capabilities)       |
@ -155,43 +170,53 @@ x-i18n:
 | 图像生成               | `api.registerImageGenerationProvider(...)`       | [提供商插件](/zh-CN/plugins/sdk-provider-plugins#step-5-add-extra-capabilities)       |
 | 音乐生成               | `api.registerMusicGenerationProvider(...)`       | [提供商插件](/zh-CN/plugins/sdk-provider-plugins#step-5-add-extra-capabilities)       |
 | 视频生成               | `api.registerVideoGenerationProvider(...)`       | [提供商插件](/zh-CN/plugins/sdk-provider-plugins#step-5-add-extra-capabilities)       |
-| 网页获取               | `api.registerWebFetchProvider(...)`              | [提供商插件](/zh-CN/plugins/sdk-provider-plugins#step-5-add-extra-capabilities)       |
+| 网页抓取               | `api.registerWebFetchProvider(...)`              | [提供商插件](/zh-CN/plugins/sdk-provider-plugins#step-5-add-extra-capabilities)       |
 | Web 搜索               | `api.registerWebSearchProvider(...)`             | [提供商插件](/zh-CN/plugins/sdk-provider-plugins#step-5-add-extra-capabilities)       |
 | 工具结果中间件         | `api.registerAgentToolResultMiddleware(...)`     | [SDK 概览](/zh-CN/plugins/sdk-overview#registration-api)                              |
-| 智能体工具             | `api.registerTool(...)`                          | 下文                                                                            |
+| 智能体工具             | `api.registerTool(...)`                          | 下方                                                                            |
 | 自定义命令             | `api.registerCommand(...)`                       | [入口点](/zh-CN/plugins/sdk-entrypoints)                                              |
 | 插件钩子               | `api.on(...)`                                    | [插件钩子](/zh-CN/plugins/hooks)                                                      |
 | 内部事件钩子           | `api.registerHook(...)`                          | [入口点](/zh-CN/plugins/sdk-entrypoints)                                              |
 | HTTP 路由              | `api.registerHttpRoute(...)`                     | [内部机制](/zh-CN/plugins/architecture-internals#gateway-http-routes)                 |
 | CLI 子命令             | `api.registerCli(...)`                           | [入口点](/zh-CN/plugins/sdk-entrypoints)                                              |

-完整注册 API 请参阅 [SDK 概览](/zh-CN/plugins/sdk-overview#registration-api)。
+如需完整注册 API，请参阅 [SDK 概览](/zh-CN/plugins/sdk-overview#registration-api)。

-当内置插件需要在模型看到输出之前异步重写工具结果时，可以使用 `api.registerAgentToolResultMiddleware(...)`。在 `contracts.agentToolResultMiddleware` 中声明目标运行时，例如 `["pi", "codex"]`。这是受信任的内置插件接口；外部插件应优先使用常规 OpenClaw 插件钩子，除非 OpenClaw 为此能力扩展出明确的信任策略。
+当内置插件需要在模型看到输出前异步重写工具结果时，可以使用
+`api.registerAgentToolResultMiddleware(...)`。请在
+`contracts.agentToolResultMiddleware` 中声明目标运行时，例如
+`["pi", "codex"]`。这是受信任的内置插件接口；外部
+插件应优先使用常规 OpenClaw 插件钩子，除非 OpenClaw 为此能力引入明确的信任策略。

-如果你的插件注册自定义 Gateway 网关 RPC 方法，请将它们保留在插件特定前缀下。核心管理命名空间（`config.*`、`exec.approvals.*`、`wizard.*`、`update.*`）保持保留，并始终解析为 `operator.admin`，即使插件请求更窄的作用域也是如此。
+如果你的插件注册自定义 Gateway 网关 RPC 方法，请将它们放在
+插件专属前缀下。核心管理员命名空间（`config.*`、
+`exec.approvals.*`、`wizard.*`、`update.*`）保持保留，并始终解析为
+`operator.admin`，即使插件请求更窄的作用域也是如此。

-需要牢记的钩子守卫语义：
+需要记住的钩子守卫语义：

- `before_tool_call`：`{ block: true }` 是终止性的，并会停止较低优先级的处理器。
- `before_tool_call`：`{ block: false }` 会被视为没有决策。
- `before_tool_call`：`{ requireApproval: true }` 会暂停智能体执行，并通过执行审批叠层、Telegram 按钮、Discord 交互，或任何渠道上的 `/approve` 命令提示用户审批。
- `before_install`：`{ block: true }` 是终止性的，并会停止较低优先级的处理器。
- `before_install`：`{ block: false }` 会被视为没有决策。
- `message_sending`：`{ cancel: true }` 是终止性的，并会停止较低优先级的处理器。
- `message_sending`：`{ cancel: false }` 会被视为没有决策。
- `message_received`：当你需要入站会话串/主题路由时，优先使用类型化的 `threadId` 字段。将 `metadata` 保留给渠道特定的额外信息。
- `message_sending`：优先使用类型化的 `replyToId` / `threadId` 路由字段，而不是渠道特定的元数据键。
+- `before_tool_call`：`{ block: true }` 是终止性结果，会停止较低优先级处理程序。
+- `before_tool_call`：`{ block: false }` 会被视为没有决定。
+- `before_tool_call`：`{ requireApproval: true }` 会暂停智能体执行，并通过 exec approval overlay、Telegram 按钮、Discord 交互或任意渠道上的 `/approve` 命令提示用户批准。
+- `before_install`：`{ block: true }` 是终止性结果，会停止较低优先级处理程序。
+- `before_install`：`{ block: false }` 会被视为没有决定。
+- `message_sending`：`{ cancel: true }` 是终止性结果，会停止较低优先级处理程序。
+- `message_sending`：`{ cancel: false }` 会被视为没有决定。
+- `message_received`：当你需要入站 thread/topic 路由时，优先使用类型化的 `threadId` 字段。将 `metadata` 保留给渠道特定的额外内容。
+- `message_sending`：优先使用类型化的 `replyToId` / `threadId` 路由字段，而不是渠道特定的 metadata 键。

-`/approve` 命令通过有界回退同时处理执行审批和插件审批：当找不到执行审批 ID 时，OpenClaw 会用同一 ID 通过插件审批重试。插件审批转发可以通过配置中的 `approvals.plugin` 独立配置。
+`/approve` 命令会通过有界回退同时处理 exec 和插件批准：当找不到 exec approval id 时，OpenClaw 会使用同一个 id 重试插件批准。插件批准转发可以通过配置中的 `approvals.plugin` 独立配置。

-如果自定义审批管线需要检测同一个有界回退场景，请优先使用 `openclaw/plugin-sdk/error-runtime` 中的 `isApprovalNotFoundError`，而不是手动匹配审批过期字符串。
+如果自定义批准管道需要检测同一个有界回退情况，
+请优先使用 `openclaw/plugin-sdk/error-runtime` 中的 `isApprovalNotFoundError`，
+而不是手动匹配批准过期字符串。

 示例和钩子参考请参阅 [插件钩子](/zh-CN/plugins/hooks)。

 ## 注册智能体工具

-工具是 LLM 可以调用的类型化函数。它们可以是必需的（始终可用），也可以是可选的（用户选择启用）：
+工具是 LLM 可以调用的类型化函数。它们可以是必需的（始终
+可用），也可以是可选的（用户选择加入）：

 ```typescript
 register(api) {
@ -220,19 +245,31 @@ register(api) {
 }
 ```

-每个通过 `api.registerTool(...)` 注册的工具也必须在插件清单中声明：
+每个通过 `api.registerTool(...)` 注册的工具都必须同时在
+插件清单中声明：

 ```json
 {
  "contracts": {
    "tools": ["my_tool", "workflow_tool"]
+  },
+  "toolMetadata": {
+    "workflow_tool": {
+      "optional": true
+    }
  }
 }
 ```

-OpenClaw 会从已注册工具捕获并缓存经过验证的描述符，因此插件不需要在清单中重复 `description` 或架构数据。清单契约只声明所有权和发现；执行仍会调用实时注册的工具实现。
+OpenClaw 会捕获并缓存来自已注册工具的已验证描述符，
+因此插件无需在清单中重复 `description` 或 schema 数据。该
+清单契约只声明所有权和设备发现；执行时仍会调用
+实际已注册的工具实现。
+对于使用 `api.registerTool(..., { optional: true })` 注册的工具，
+请设置 `toolMetadata.<tool>.optional: true`，这样 OpenClaw 可以避免加载该
+插件运行时，直到该工具被显式加入允许列表。

-用户可在配置中启用可选工具：
+用户在配置中启用可选工具：

 ```json5
 {
@ -240,16 +277,16 @@ OpenClaw 会从已注册工具捕获并缓存经过验证的描述符，因此
 }
 ```

- 工具名称不得与核心工具冲突（存在冲突的会被跳过）
- 注册对象格式错误的工具（包括缺少 `parameters`）会被跳过并在插件诊断中报告，而不是中断智能体运行
- 对有副作用或额外二进制要求的工具使用 `optional: true`
- 用户可以通过将插件 id 添加到 `tools.allow` 来启用某个插件的所有工具
+- 工具名称不得与核心工具冲突（冲突项会被跳过）
+- 注册对象格式错误的工具（包括缺少 `parameters`）会被跳过，并在插件诊断中报告，而不会中断智能体运行
+- 对有副作用或有额外二进制要求的工具使用 `optional: true`
+- 用户可以通过把插件 ID 添加到 `tools.allow` 来启用某个插件的所有工具

 ## 注册 CLI 命令

-插件可以使用 `api.registerCli` 添加根级 `openclaw` 命令组。为每个顶层命令根提供
-`descriptors`，这样 OpenClaw 就可以显示和路由
-该命令，而无需预先加载每个插件运行时。
+插件可以通过 `api.registerCli` 添加根级 `openclaw` 命令组。为每个顶级命令根提供
+`descriptors`，这样 OpenClaw 无需急切加载每个插件运行时，就可以显示并路由
+该命令。

 ```typescript
 register(api) {
@ -279,7 +316,7 @@ register(api) {
 }
 ```

-安装后，验证运行时注册并执行该命令：
+安装后，验证运行时注册并执行命令：

 ```bash
 openclaw plugins inspect demo-plugin --runtime --json
@ -298,42 +335,43 @@ import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
 import { ... } from "openclaw/plugin-sdk";
 ```

-完整的子路径参考见 [SDK 概览](/zh-CN/plugins/sdk-overview)。
+完整子路径参考请参阅 [SDK 概览](/zh-CN/plugins/sdk-overview)。

-在你的插件内，对内部导入使用本地 barrel 文件（`api.ts`、`runtime-api.ts`）——绝不要通过插件自己的 SDK 路径导入它本身。
+在你的插件内部，使用本地 barrel 文件（`api.ts`、`runtime-api.ts`）进行
+内部导入 — 不要通过插件自己的 SDK 路径导入自身。

-对于提供商插件，请将提供商特定的辅助工具保留在这些包根级
-barrel 中，除非该接口确实是通用的。当前内置示例：
+对于提供商插件，请把提供商特定 helper 保留在这些包根级
+barrel 中，除非该接缝确实是通用的。当前内置示例：

- Anthropic：Claude 流包装器以及 `service_tier` / beta 辅助工具
- OpenAI：提供商构建器、默认模型辅助工具、实时提供商
- OpenRouter：提供商构建器以及新手引导/配置辅助工具
+- Anthropic：Claude 流包装器和 `service_tier` / beta helper
+- OpenAI：提供商 builder、默认模型 helper、实时提供商
+- OpenRouter：提供商 builder 以及新手引导/配置 helper

-如果某个辅助工具只在一个内置提供商包内有用，请将它保留在该
-包根级接口上，而不是提升到 `openclaw/plugin-sdk/*` 中。
+如果某个 helper 只在一个内置提供商包内有用，请将其保留在该
+包根级接缝上，而不是提升到 `openclaw/plugin-sdk/*`。

-一些生成的 `openclaw/plugin-sdk/<bundled-id>` 辅助接口仍然存在，
-用于在有跟踪到的所有者使用情况时维护内置插件。请将这些视为
-保留接口，而不是新第三方插件的默认模式。
+某些生成的 `openclaw/plugin-sdk/<bundled-id>` helper 接缝仍然存在，
+用于有跟踪所有者用法的内置插件维护。请将这些视为保留表面，
+而不是新第三方插件的默认模式。

 ## 提交前检查清单

-<Check>**package.json** 包含正确的 `openclaw` 元数据</Check>
-<Check>**openclaw.plugin.json** 插件清单存在且有效</Check>
+<Check>**package.json** 具有正确的 `openclaw` 元数据</Check>
+<Check>**openclaw.plugin.json** 清单存在且有效</Check>
 <Check>入口点使用 `defineChannelPluginEntry` 或 `definePluginEntry`</Check>
 <Check>所有导入都使用聚焦的 `plugin-sdk/<subpath>` 路径</Check>
 <Check>内部导入使用本地模块，而不是 SDK 自导入</Check>
 <Check>测试通过（`pnpm test -- <bundled-plugin-root>/my-plugin/`）</Check>
 <Check>`pnpm check` 通过（仓库内插件）</Check>

-## Beta 版本测试
+## Beta 发布测试

-1. 关注 [openclaw/openclaw](https://github.com/openclaw/openclaw/releases) 上的 GitHub 发布标签，并通过 `Watch` > `Releases` 订阅。Beta 标签形如 `v2026.3.N-beta.1`。你也可以开启官方 OpenClaw X 账号 [@openclaw](https://x.com/openclaw) 的通知以接收发布公告。
-2. Beta 标签出现后，尽快使用它测试你的插件。稳定版发布前的窗口通常只有几个小时。
-3. 测试后，在 `plugin-forum` Discord 渠道中你的插件线程里发布 `all good` 或说明哪里坏了。如果你还没有线程，请创建一个。
-4. 如果有东西坏了，请打开或更新一个标题为 `Beta blocker: <plugin-name> - <summary>` 的 issue，并应用 `beta-blocker` 标签。将 issue 链接放到你的线程中。
-5. 打开一个指向 `main` 的 PR，标题为 `fix(<plugin-id>): beta blocker - <summary>`，并在 PR 和你的 Discord 线程中都链接该 issue。贡献者无法给 PR 打标签，因此标题是给维护者和自动化的 PR 侧信号。有 PR 的阻塞问题会被合并；没有 PR 的阻塞问题可能仍会随版本发布。维护者会在 beta 测试期间关注这些线程。
-6. 沉默即表示绿色通过。如果你错过窗口，你的修复很可能会进入下一个周期。
+1. 关注 [openclaw/openclaw](https://github.com/openclaw/openclaw/releases) 上的 GitHub 发布标签，并通过 `Watch` > `Releases` 订阅。Beta 标签形如 `v2026.3.N-beta.1`。你也可以为官方 OpenClaw X 账号 [@openclaw](https://x.com/openclaw) 开启通知，以接收发布公告。
+2. beta 标签一出现，就用它测试你的插件。稳定版发布前的窗口通常只有几个小时。
+3. 测试后，在 `plugin-forum` Discord 渠道中你的插件讨论串里发布 `all good` 或说明破损内容。如果你还没有讨论串，请创建一个。
+4. 如果有东西破损，请打开或更新标题为 `Beta blocker: <plugin-name> - <summary>` 的 issue，并应用 `beta-blocker` 标签。把 issue 链接放到你的讨论串里。
+5. 打开一个指向 `main` 的 PR，标题为 `fix(<plugin-id>): beta blocker - <summary>`，并在 PR 和你的 Discord 讨论串中链接该 issue。贡献者无法给 PR 加标签，因此标题是给维护者和自动化系统的 PR 侧信号。有 PR 的阻塞问题会被合并；没有 PR 的阻塞问题可能仍会随版本发布。维护者会在 beta 测试期间关注这些讨论串。
+6. 沉默即表示绿色。如果你错过窗口，你的修复很可能会进入下一个周期。

 ## 后续步骤

@ -347,18 +385,18 @@ barrel 中，除非该接口确实是通用的。当前内置示例：
  <Card title="SDK 概览" icon="book-open" href="/zh-CN/plugins/sdk-overview">
    导入映射和注册 API 参考
  </Card>
-  <Card title="运行时辅助工具" icon="settings" href="/zh-CN/plugins/sdk-runtime">
+  <Card title="运行时 helper" icon="settings" href="/zh-CN/plugins/sdk-runtime">
    通过 api.runtime 使用 TTS、搜索、子智能体
  </Card>
  <Card title="测试" icon="test-tubes" href="/zh-CN/plugins/sdk-testing">
    测试工具和模式
  </Card>
  <Card title="插件清单" icon="file-json" href="/zh-CN/plugins/manifest">
-    完整清单架构参考
+    完整清单 schema 参考
  </Card>
 </CardGroup>

-## 相关内容
+## 相关

 - [插件架构](/zh-CN/plugins/architecture) — 内部架构深度解析
 - [SDK 概览](/zh-CN/plugins/sdk-overview) — 插件 SDK 参考