UAP 客户端兼容性证据
当前版本与范围
CLI是当前发布的原生 CLI,新增由宿主管理生命周期的本地管理 API、只读客户端和配置目录发现,以及适用于用户与符合条件项目范围的 Pi 扩展、Skills 和 stdio/Streamable HTTP MCP。请参阅本地管理。各分发渠道的版本可能滞后,请先用 agentplugins version 确认。
自 CLI 0.1.94 起,未指定来源参数的 install 在当前目录存在普通 uap.toml 文件时自动选择项目;显式范围优先,不搜索父目录。即使没有 --locked,已有锁文件也会严格验证。显式项目范围从 0.1.93 起提供。安装器的发布证据不能证明每个原生客户端的运行行为,也不能替代标准创作工具的可执行文件发布验收。当前 npm/原生安装器不包含 agentplugins author;源码工具见构建指南。
| 检查层次 | 含义 |
|---|---|
| 包符合性 | 标准文件满足加载器和 schema 约定。 |
| 组件交付 | 适配器准备或安装其拥有的组件。 |
| 原生发现 | 特定客户端观察到预期组件。 |
| MCP 运行 | 记录中的进程或连接完成初始化及所测试调用。 |
| 认证和模型使用 | 只有明确执行过相应流程的证据才能证明。 |
项目交付通常保持 Prepared,因为仍可能需要信任、重新加载、明确配置或新会话。 ChatGPT 明确不支持原生项目安装。 请参阅逐客户端项目支持和 项目证据索引。
下列历史观察对应精确的安装器、客户端、平台和测试范围。结果不会自动延伸到当前发布版本、其他客户端版本、其他安装范围或未经测试的包。 UAP 是独立社区工具;这些是维护者进行的有限观察,不是厂商认证或通用的生产就绪保证。
Hermes 与 Antigravity:已发布的 CLI 支持
原生 CLI 0.1.110 包含 Hermes 和 Antigravity。UAP 会自动配置受支持的组件;请完成客户端安装结果中列出的后续操作。签名 Directory 中各包的目标资格仍须单独核实。安装不代表供应商身份验证已通过或运行时已激活。
0.1.110 · source 1b7d2db803dd5eea2d632d8f4e149b4d7bb4a48e.
Hermes Project MCP 仅在使用 UAP 已验证其捆绑清单的独立 Hermes 主程序发行版,并明确确认 UAP 项目会话后,才可作为 Prepared 配置使用。普通 Hermes 启动不会选择此 MCP 配置。从源码安装的 Hermes 主程序无法使用 Project MCP;请使用 User MCP 或仅安装 Project Skills。此主程序要求不限制从 Git 安装插件。Project Skills 仍需要信任和新会话。以下带日期的观察保留其历史范围。
历史生命周期证据 (2026-11-10–13):
0.1.108 (2026-11-13) · 43337036671 · 43454712919 · source 8c3cfa28e332c533b0cc0845739c0275730a4285.
Hermes 0.23.0:支持用户范围的 Skills 及由 UAP 管理的 stdio/Streamable HTTP MCP 配置;项目范围仅支持 Skills。项目 MCP 会被拒绝,不会转而修改用户配置。Linux x64、macOS arm64 和原生 Windows x64 均通过首次及重复添加、更新、修复、移除、未授信项目中的发现和 A/B 隔离测试:42813277862,UAP 提交为 a50c8a245f1c273efb3d171f4c54ed540475336a。每个操作系统上的四次回环 HTTP initialize/tools/list 交互证明了连接和工具发现,并未证明 tools/call、模型使用、身份验证或受信任的项目执行。不支持 SSE 和钩子。可移植命令映射为 Skills;若客户端无法强制显式调用,则不交付仅允许显式调用的命令。
后续原生验证 #884 通过官方旧版 run_agent.py 驱动程序和本地脚本化提供程序,证明 Hermes 0.23.0 在 Linux/macOS/Windows 上执行了 User stdio tools/call。默认 hermes chat、供应商身份验证和受信任项目执行仍未通过验证。
Antigravity:用户和项目范围内由 UAP 管理的原生插件包包含 Skills 及 stdio/Streamable HTTP MCP,状态仍为 Prepared。真实的 agy 1.5.3 在 Linux、macOS 和 Windows 上通过严格校验及隔离的 CLI import/list/uninstall:42804680737。这些 CLI 观察并未证明实际 IDE 中的发现或启用、MCP 启动、工具执行或身份验证;IDE 验证仍需单独完成。UAP 不会授予项目信任。
Pi 扩展、Skills 与 MCP
自 CLI 0.1.102 起,已发布的 CLI 支持使用 --target pi 安装兼容的 Agent Plugins 1.0 包,包括 Pi 原生扩展、Skills,以及 stdio 和 Streamable HTTP MCP。支持用户范围和符合条件的项目范围;不支持 MCP SSE 或通用 App 组件。项目扩展位于 .pi/extensions,Skills 位于 .pi/skills,由 UAP 管理的 MCP 配置位于 .pi/mcp.json。安装后仍可能需要信任项目、重新加载资源或创建新会话。
CLI 能安装某类组件,不表示签名 Directory 已经授权每个包使用 Pi。 截至 2026 年 11 月 9 日,37 项活跃 Directory 发布策略都尚未声明 pi 目标,因此通过短名称执行 add context7 --target pi 会正确拒绝。精确的 github:owner/repo@FULL_SHA//path 来源是不同的显式安装途径,仍须通过 CLI 验证,不能替代签名目录的授权。
项目 E2E 与真实 Pi 的 tools/call (#656) 证实了 Linux、macOS 和 Windows 上使用本地脚本模型的特定 Skills/MCP 场景。早期扩展验证仅覆盖 Linux;那是历史测试范围,不是当前适配器限制。成功写入文件并不证明 OAuth、远程模型权限或客户端实际激活。
历史证据索引
详细英文记录保留完整提交、哈希和限定条件。下表提供中文导读,链接指向原始运行和证据身份; 查看报告时应同时核对版本、平台和范围。
| 历史记录 | 覆盖与结果 | 来源 |
|---|---|---|
| 0.1.55 草稿,2026 年 9 月快照 | 两个独立验收范围,共 12 条原生客户端任务和 24 个顶层必需测试通过,无跳过;当时是未发布草稿,不是当前发布状态。 | 九任务运行、Linux amd64、固定生产者、精确元数据 |
| 已发布 0.1.53 | Linux arm64、macOS arm64、Windows amd64 上 Codex、Claude、OpenCode 的九任务与 18 个必需测试通过,无跳过。 | 运行 34166817934、精确身份、公开证据归档 |
| 0.1.53 的 Linux amd64 补充 | Ubuntu 24.04 托管环境,三个任务和六个必需测试通过;补充原始结果,不改写原始九任务证据。 | 运行 34195481283、精确身份 |
| 2026-09-07 源码构建快照 | Linux arm64,以及独立的 macOS/Windows 源码检查点;不是当时公开 0.1.51 二进制的运行结果。 | 身份记录、macOS/Windows 运行 |
0.1.55 的历史运行使用固定生产者的原始 npm 包、禁用安装脚本的离线 npm 安装、固定原生二进制冷启动, 以及在不提供验证用源码的情况下再次启动。离线归档一致性复核不是新的原生运行、实时草稿检查或新的证明验证。 原始日志和归档在披露审核前保持私有;公共元数据不能当作完整可重放日志。
固定客户端的原生观察
0.1.53 及上述历史草稿使用以下固定版本。生命周期包含安装、更新、同版本刷新、修复和移除。
| 客户端 | 记录中的通过范围 | 关键限制 |
|---|---|---|
| Codex 0.153.4 | stdio/HTTP、生命周期和脚本化技能上下文。 | Git 获取环节的测试不代表已验证通过公共 Git 安装的 MCP 在原生客户端中运行;SSE 不支持。 |
| Claude Code 2.1.263 | Linux/macOS 的 stdio/HTTP/技能生命周期;Windows 的 HTTP 和已安装技能生命周期。 | Windows 返回 managed_stdio_platform_unsupported;未建立 stdio 的 cwd/argv/env/data 行为。 |
| OpenCode 1.18.29 | 生命周期、独立的扩展 stdio/技能和工具名称冲突观察。 | 观察到的工具名碰撞仍未解决;opencode_tool_namespace_not_evaluated 是警告,不是唯一性证明。 |
OpenCode 的 JSON/JSONC 生命周期与全局 JSON stdio/技能正文测试是不同套件。 不能从 JSONC 生命周期推断 JSONC stdio 或正文运行覆盖。配置逻辑键不同不保证可调用工具名不同。 历史碰撞中 api/server 和 api server 同时存在时暴露一个 api_server_inspect_runtime 名称。
技能正文进入脚本化模型请求,证明的是观察到的上下文传递,不是模型理解或回答质量。 各客户端的 HTTP 头、重定向、失败矩阵和并发文件保护测试范围也不同;不要把一个客户端的观察复制为另一个客户端的结果。
原生运行不包括哪些证明
这些维护者运行使用真实固定版本客户端、临时配置和脚本化回环模型服务,并允许网络访问。 临时 HOME 与显式子进程环境不提供操作系统或进程隔离。 测试不证明真实模型质量、OAuth/登录、桌面应用、实际线上服务、独立采用或厂商认可。 六平台二进制构建或启动器检查也不能扩大原生客户端矩阵。
历史源码检查点与公开版本必须保持区分。源代码树、测试中的局部验证或归档哈希不能替代不同提交的重新运行。 旧失败记录仍是失败;后续通过可更新平台摘要,不能将旧记录改写为通过。
已发布项目范围与版本化观察
CLI 0.1.93 支持显式项目范围;上面的历史用户范围结果不能自动证明项目行为。 项目组件交付、所有权、原生发现与 MCP/模型运行分别报告。 ChatGPT 项目范围会被拒绝,其他客户端各有组件、准备步骤和版本要求。
VS Code 1.143.1 固定观察在未授予工作区信任的情况下, 验证独立 A/B 文件夹、A 的新启动和移除后的元数据。适配器返回 Prepared,并验证安装文件;这不能证明 MCP 启动、工具调用或模型执行。