---
title: 客户端扩展
description: 添加客户端自有行为，而不扩大 Agent Plugins 的可移植核心。
---

# 客户端扩展



客户端扩展允许特定客户端定义额外的清单数据、文件和行为。Agent Plugins 不保留中央注册表；各命名空间使用反向域名标识符来避免冲突。

## 清单数据 [#清单数据]

将客户端专属数据放在 `plugin.json` 的 `extensions` 下：

```json title="plugin.json"
{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "example-plugin",
  "extensions": {
    "com.example.client": {
      "setting": true
    }
  }
}
```

每个扩展值都是对象。客户端会忽略未实现的命名空间，且不验证其中的内容。

## 扩展目录 [#扩展目录]

客户端自有文件放在顶层目录中，该目录的名称必须与命名空间完全一致：

```text
example-plugin/
├── plugin.json
├── skills/
└── com.example.client/
    └── hooks/
        └── hooks.json
```

客户端可以使用清单数据、扩展目录，或同时使用两者。命名空间所有者定义其内容、验证规则、相互关系和失败行为。

客户端扩展不是可移植的 Agent Plugins 组件。其他客户端可以忽略这些扩展，而不影响合规性。


---

Source: [content/docs/plugin-authors/client-extensions.mdx](https://github.com/agentplugins/agent-plugins-site/blob/237bbf575f5843214923419f9d0933852662f4f3/content/docs/plugin-authors/client-extensions.mdx)
Source commit: 237bbf575f5843214923419f9d0933852662f4f3

---

For a semantic overview of all documentation, see [/zh/sitemap.md](/zh/sitemap.md)

For an index of all available documentation, see [/zh/llms.txt](/zh/llms.txt)