A2UI Renderer 生态
Renderer 负责校验 A2UI 消息、维护 Surface 状态、把获准的 Catalog 条目映射为原生组件，并把用户操作发回 Agent。Transport 与 Rendering 是两项独立职责。
官方维护的 Renderer
| Renderer | 平台 | v0.9.1 | 说明 |
|---|---|---|---|
@a2ui/react | React Web | 稳定 | 基于 @a2ui/web_core 的官方 Renderer |
@a2ui/lit | Web Components | 稳定 | 框架无关的 Web 方案 |
@a2ui/angular | Angular Web | 稳定 | Angular Service 与 Component Host 集成 |
| Flutter GenUI | 移动、桌面、Web | 稳定 | 原生 Flutter Widget，Transport 由应用负责 |
官方 SwiftUI 与 Jetpack Compose Renderer 仍处于规划或建设阶段。仓库中的初始实现不能写成稳定发布版。
重要社区 Renderer
| 项目 | 平台 | 兼容性 | 独特价值 |
|---|---|---|---|
| AGenUI | iOS、Android、HarmonyOS | v0.9 | 共享 C++ Core、三端原生引擎、Studio 与生成 Skill |
| Lynx GenUI | 移动、Web、桌面 | v0.9 | ReactLynx Runtime 与 Catalog 工具 |
| A2UI-Swift | Apple 全平台 | v0.8–v0.9.1 | 共享 Core 支持 SwiftUI、UIKit、AppKit |
| a2ui-vue | Vue 3 | v0.8/v0.9 分支 | Composition API 与 TypeScript |
| Bote A2UI | React Web | v0.8/v0.9 | Playground、图表/表格预设与自定义组件工具 |
| a2ui-ink | 终端 | v0.9 | 基于 Ink 的交互式 CLI 渲染 |
| generative-mui | React + MUI | v0.9 | 继承宿主 ThemeProvider、图表与运行时组件 |
社区项目不能等同于官方维护包。采用前应检查最近提交、协议版本、测试覆盖、许可证、发布产物、无障碍行为和安全模型。
选型标准
- 选择应用原生框架，不要只为复用 Renderer 引入 WebView。
- 新生产项目要求明确支持 v0.9.1。
- Web 框架优先基于
@a2ui/web_core，除非有明确理由重写协议状态层。 - 验证双向绑定、增量更新、Action 路由、Schema 校验和未知组件行为。
- 用真实生产组件测试自定义 Catalog，而不是只跑 Basic Catalog Demo。
- 在目标设备上测量长列表、图片加载、流式更新频率和内存。