客户端合规性检查清单

此检查清单不具规范性。如果措辞不同，以完整规范为准。

插件加载器

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

发现与隔离

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

MCP 支持

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

版本控制

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