跳到正文
生态 / HiA2UI 团队

A2UI React 渲染器现状:当前可用能力

说明官方 A2UI React 渲染器、Web Core、Catalog、迁移与社区替代方案的当前生产建议。

React 与其他平台渲染器连接到共享且经过校验的 A2UI 协议核心
更新于 2026/8/6 审校:HIA2UI 编辑组

早期的 Q1 发布追踪已成为历史。官方项目当前将 @a2ui/react 列为 v0.9.1 稳定线的维护渲染器,并通过 @a2ui/web_core 共享 Web 协议机制。

官方渲染器负责什么

渲染器接收经过校验的生命周期消息,维护 Surface 与 DataModel 状态,解析受控 Catalog 组件,并路由用户 Action。它不负责产品授权,也不会自动使任意远程内容变得安全。

采用前应同时固定渲染器和 Schema 版本,并以已安装包的公开 API 为准。面向 v0.8 或早期 v0.9 快照的示例可能使用过时消息名。

Catalog 所有权

React 应用继续拥有组件与设计令牌。Catalog 把协议定义映射到经过审核的 React 实现,这有利于主题与无障碍一致性;但每个实现仍需测试危险 URL、Markdown、导航、文件处理、焦点、键盘操作与不支持属性。

迁移自定义实现

在新旧实现通过同一组协议夹具前保留旧渲染器。对比 Surface 创建、增量更新、双向数据绑定、删除、重复投递、重连、Action 重放、不支持组件和降级 UI。版本转换应放在传输边界,不得把 v0.8 生命周期消息混入 v0.9.1 数据流。

社区渲染器在专用 Catalog 或平台适配方面仍有价值,但应根据发布、测试、协议兼容、维护、安全、无障碍与许可证证据评估,而不是依据框架热度。

参见最新渲染器矩阵客户端接入顺序生产安全清单

常见问题

官方 React 渲染器已经可用吗?

是。官方目录已将 React 渲染器列为 v0.9.1 稳定线的维护方案。

旧自定义解析器需要立即替换吗?

应先比较协议覆盖、测试、无障碍与安全行为,并在一致性测试保护下迁移。

一手来源

A2UIReact渲染器Web Corev0.9.1