A2UI SDK 实现指南（分阶段执行）
该技能为需要在新编程语言或 UI 框架中实现 A2UI Core SDK、Framework Adapter 或 Agent/Inference SDK 的 AI 代理或贡献者，提供专家级指令与执行顺序。
一、Core State SDK 阶段 若构建新的 Core SDK（如 Rust、Swift、Go 或 C++），须按以下阶段执行：
阶段 1：上下文与 Schema 摄取 仔细审阅：blueprints/modules/a2ui_core.blueprint.md（状态与消息结构）、specification/v1_0/json/common_types.json（动态绑定 schema）、specification/v1_0/json/server_to_client.json（消息信封）、specification/v1_0/catalogs/basic/catalog.json（目标组件目录）。
阶段 2：技术架构规划 编写详细的本地架构提案，涵盖：依赖选择（Schema 库与 Observable/Reactive 库，响应式库须同时支持离散事件订阅与有状态、类信号的数据流，如 BehaviorSubject/Signal）；组件 API（在该语言中如何定义 ComponentApi 接口）；绑定策略（如何组织抽象 Core Binder 层）。在写代码前停止并取得人工评审批准。
阶段 3：核心模型层 实现与框架无关的数据与处理器层：Observables 与 Signals（多播响应式流，具备清晰退订机制以防泄漏）；协议结构（严格类型化的原生类/结构体表示 A2uiMessage 信封与客户端能力，含序列化/反序列化）；DataModel 与 JSON Pointer（相对/绝对路径解析、自动激活即自动推断中间段类型、路径变更的冒泡/级联通知）；核心状态模型（ComponentModel、SurfaceComponentsModel、SurfaceModel、SurfaceGroupModel）；上下文映射（DataContext 与 ComponentContext）；MessageProcessor（摄取传入消息并变更状态模型，生成 inlineCatalogs 客户端能力）。验证：为指针级联、JSON 反序列化/校验与消息分发编写全面单元测试。
阶段 4：基础 Basic Catalog 支持 引导支持 Basic Catalog：基础组件（为 Text、Row、Column、Button、TextField 定义纯 API schema 与 Binder）；基础函数（实现 formatString 解释 ${expression} 语法，支持递归 token 求值与响应式强制转换）。验证：确保底层数据路径发出通知时属性响应式更新。
阶段 5：完整 Basic Catalog 支持 为 basic/catalog.json 中所有其他组件定义完整 Binder；实现其余基础数学、逻辑与数组操作；验证严格类型强制转换规则并确保内存释放无缺陷。
二、Framework Adapter SDK 阶段 若构建新的 UI 框架适配器/渲染器（如 Flutter/Dart、SwiftUI、Jetpack Compose、Vue 或 Svelte），按以下顺序执行：
阶段 1：摄取与核心集成 审阅 blueprints/modules/a2ui_framework_adapter.blueprint.md（视图与渲染架构）、specification/v1_0/docs/basic_catalog_implementation_guide.md（间距、对齐与排版规范）。
阶段 2：架构方案 起草方案说明：组件注册表（如何动态解析与实例化组件）；Surface Widget（根画布如何从 root 开始挂载并递归布局树）；Observer/State 桥接（采用 Direct、预定义 Binders 或自动包装等哪种策略连接核心信号与原生视图）。停止并取得人工评审批准。
阶段 3：适配器与生命周期层 实现 ComponentImplementation 基类/特质；实现框架原生 Surface 入口 widget；实现订阅管理：仅在挂载时惰性订阅、处理路径稳定性更新、卸载时严格调用 dispose()。
阶段 4：引导 Basic Catalog 渲染 为 Text、Row、Column、Button、TextField 构建原生视觉元素，打包为第一个框架目录适配器，并验证响应式布局属性动态更新。
阶段 5：Gallery 应用里程碑 构建 Gallery App 作为测试场：左栏示例导航；中栏 Surface 预览、JSON 消息流与逐步交互式消息步进器；右栏实时数据模型检查面板与动作日志。加载 5 个基础验证示例：00_simple-text.json、00_row-layout.json、00_complex-layout.json、00_interactive-button.json、00_simple-login-form.json。停止并取得人工对 UI 与视觉渲染性能的评审批准。
阶段 6：完整目录支持 实现所有其余 widget（如 Card、Image、List 等）及 Checkable 等验证特质；更新 Gallery App 以支持 specification/v1_0/catalogs/basic/examples/ 中所有官方示例；运行视觉一致性与事件动作测试验证正确性。
限制：以上为面向实现者的分阶段流程指南，不包含具体安装命令、收费信息或独立产品功能说明；实际实现细节需依据所引用的蓝图与规范文件。