---
title: 客户端合规性检查清单
description: 检查 Agent Plugins 1.0.0 客户端必须具备的最低行为。
type: reference
---

# 客户端合规性检查清单



此检查清单不具规范性。如果措辞不同，以[完整规范](/zh/specification)为准。

## 插件加载器 [#插件加载器]

* [ ] 从目录加载插件，并强制执行经过文件系统解析的包边界。
* [ ] 根据 `$schema` 选择本地支持的清单规则；加载过程中不要获取 Schema。
* [ ] 验证封闭的 `plugin.json` Schema，以及必需的 `$schema` 和 `name` 字段。
* [ ] 报告并忽略未知顶层字段。
* [ ] 忽略不是对象的 `extensions` 字段和未实现的扩展命名空间。
* [ ] 在发现组件前拒绝其他致命清单违规。

## 发现与隔离 [#发现与隔离]

* [ ] 仅从固定位置发现支持的组件类型。
* [ ] 将缺失的组件位置视为有效的缺省状态。
* [ ] 按规定边界隔离无效的组件类型、技能和 MCP 条目。
* [ ] 忽略不支持的组件类型，并至少支持技能或 MCP 服务器中的一种。

## MCP 支持 [#mcp-支持]

* [ ] 如果实现 MCP，至少支持 stdio 和 Streamable HTTP 中的一种；建议两者都支持。
* [ ] 首次尝试连接时，使用各服务器条目声明的传输方式。
* [ ] 分别验证封闭的顶层文档和每个服务器条目。
* [ ] 将 stdio 命令解析为单个可执行文件标记。
* [ ] 提供 `PLUGIN_ROOT` 和专用且持久的 `PLUGIN_DATA` 目录。
* [ ] 只展开两个已定义的占位符，且仅在 `args`、`env` 值和 `cwd` 中展开。
* [ ] 强制执行工作目录包含约束和远程 URL/标头要求。
* [ ] 某个独立 MCP 服务器失败后，继续加载。

## 版本控制 [#版本控制]

* [ ] 要求 `plugin.json` 和 `mcp.json` 中的 Agent Plugins 版本一致。
* [ ] 绝不将已发布的规范 Schema 标识符重新分配给不同内容。
* [ ] 根据本地支持的兼容性策略，允许插件继续面向旧版本。


---

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