a2ui 0.9项目升级1.0，需要同时修改消息协议、catalog定义和客户端渲染器，不能只把版本字符串替换为1.0。先选择已经支持1.0的渲染器，再按官方迁移表调整字段，最后用创建界面、更新数据及用户操作的完整流程验证。

A2UI 0.9项目升级1.0的迁移方法

更新消息版本及MIME类型

流式JSON消息的version字段改为1.0，传输层MIME类型由application/json+a2ui改为application/a2ui+json。createSurface中的theme字段已移除，初始components、dataModel及metadata.extensions可直接放在创建消息中；不要继续依赖旧theme结构。

A2UI 0.9项目升级1.0的迁移方法

调整Catalog和组件元字段

Catalog定义需要明确protocolVersion为1.0，省略时按旧0.9处理。函数定义改为按函数名组织的对象。组件上的catalogId、metadata、accessibility和checks等协议混入字段改为@catalogId、@metadata、@accessibility和@checks，组件自身的id与component保持原名，不能将业务属性全部机械加上@。

按调用方向检查交互

检查客户端事件、双向函数调用及对应结果或错误返回。一个界面使用多个Catalog时，按组件的归属提供@catalogId，并确认客户端注册了相应实现。旧0.9消息与1.0消息不能未经适配混发。

完成后用同一业务数据检查界面创建、组件更新、数据绑定、按钮事件和错误处理。Jetpack Compose和Lynx等尚未支持1.0的实现，应保留对应旧协议路径，等待匹配版本后再迁移该客户端。