---
title: 实现 Agent Plugins 客户端
description: 为 AI 智能体或开发工具实现可移植的 Agent Plugins 加载约定。
---

# 实现 Agent Plugins 客户端



合规客户端从目录加载 Agent Plugin，验证 `plugin.json`，并至少支持一种组件类型：技能或 MCP 服务器。

## 加载顺序 [#加载顺序]

1. 确定经过文件系统解析的插件根目录。
2. 在根目录找到 `plugin.json`，并使用 `$schema` 所选择的本地支持 Schema 进行验证。
3. 如有致命清单违规，拒绝插件；报告并忽略明确规定为非致命的问题。
4. 从固定位置发现客户端支持的各组件类型。
5. 对各组件类型或条目应用规定的失败边界。
6. 应用已实现的客户端扩展命名空间，并忽略其他命名空间。

客户端使用规范 Schema 标识符来选择本地验证和解释规则。加载插件时不获取 Schema。

## 可移植行为与客户端自有行为 [#可移植行为与客户端自有行为]

Agent Plugins 定义包结构、验证、发现、MCP 配置、插件变量和失败隔离。以下内容不在其规定范围内：

* 安装源、注册表或市场
* 启用、更新或缓存的用户体验
* 权限提示、信任策略或沙箱
* 如何向用户或模型展示技能
* 客户端扩展的内部行为

## 后续阅读 [#后续阅读]

* **[加载与发现](/zh/client-implementers/loading-and-discovery)**：验证清单、发现支持的组件并应用失败边界。
* **[MCP 运行时](/zh/client-implementers/mcp-runtime)**：将可移植 MCP 配置映射到 stdio 和 HTTP 连接。
* **[合规性检查清单](/zh/client-implementers/conformance)**：检查可移植客户端的最低要求。


---

Source: [content/docs/client-implementers/index.mdx](https://github.com/agentplugins/agent-plugins-site/blob/237bbf575f5843214923419f9d0933852662f4f3/content/docs/client-implementers/index.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)