客户端扩展

添加客户端自有行为,而不扩大 Agent Plugins 的可移植核心。

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

清单数据

将客户端专属数据放在 plugin.jsonextensions 下:

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

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

扩展目录

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

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

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

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

译文与记录的源版本一致。

来源提交
237bbf575f5843214923419f9d0933852662f4f3
上次同步
2026年8月11日 08:30
规范仓库
规范仓库