A2UI 版本状态

这是 HiA2UI 的版本真相页，用于严格区分生产规范与候选设计，避免把草案能力误写成稳定功能。

状态速览

最终状态以 A2UI 官方站和规范仓库 a2ui-project/a2ui 为准。

v0.9.1 改了什么

v0.9.1 是面向兼容性的 v0.9 小版本：

• MIME 类型统一为 application/a2ui+json，application/json+a2ui 已属于旧口径。
• surfaceId 只需在当前活动 Surface 中唯一；删除 Surface 后可以重用该 ID。
• 当前 Schema 同时接受 v0.9 与 v0.9.1 负载。

集成边界必须进行版本协商。客户端只声明 v0.8 时，即使 Agent 能生成 v0.9，也不能直接发送 v0.9 消息。

各版本消息模型

v0.8

旧版生命周期使用：

• surfaceUpdate
• dataModelUpdate
• beginRendering
• deleteSurface

v0.9 与 v0.9.1

稳定系列使用：

• createSurface
• updateComponents
• updateDataModel
• deleteSurface

同时加入自定义 Catalog、客户端函数、模块化 Schema、校验错误和 Renderer 到 Agent 的数据同步。详见消息参考。

v1.0 候选版

下列能力必须放在明确的版本路由后测试：

• 使用 actionId 与 actionResponse 实现同步操作响应。
• 使用 callFunction 与 functionResponse 让 Agent 调用 Renderer 函数。
• 一个 Surface 混用多个兼容 Catalog 的组件和函数。
• 在 createSurface 中直接携带初始组件和数据。
• 通过 allowedParents 与 allowedChildren 声明组件组合约束。
• 用 agent 与 renderer 取代容易混淆的 server/client 术语。

完整差异见官方 v1.0 演进指南。

生产选型规则

1. 先确认目标 Renderer 真正支持的版本。
2. 新生产项目默认选择 v0.9.1；宿主产品强制要求 v0.8 时除外。
3. 在 v1.0 正式稳定前，为其建立独立兼容路径。
4. Catalog 必须版本化，所有外部消息必须先校验再渲染。
5. 没有协商出兼容版本时，保留文本降级响应。

已知产品边界

Gemini Enterprise 当前文档仍说明其注册 A2A Agent 的 A2UI 支持版本为 v0.8。这是宿主产品限制，并不代表 A2UI 整体仍停留在 v0.8。部署前请阅读 Google 产品集成指南。

来源政策

HiA2UI 的版本结论只依据官方规范、演进指南、包注册表和已合并的上游变更。候选能力明确标注候选，社区实现明确标注社区维护。