Developer Preview 0.3.0.dev2：本页介绍未改变的 SDK 0.2.0 基础契约。统一适配器、可选模拟运动及当前安装命令请参阅快速开始和软件包内文档。未启用真实硬件或生产集成。

公共协议 1.0

SDK 0.2.0 保持 wire contract 1.0。入口：Manifest.parse、negotiate_version、validate_request、validate_response、parse_wire、CapabilityInterface、CertificationTestSuite（保留的本地检查名称）、PrecertificationSuite。包名 aicontinue_capabilities；schema 位于 aicontinue_capabilities/schemas.json。中文技术人工审核待完成。

三类适配器

• software：local_app 和/或 manufacturer_cloud，不允许 device 路由。厂商应用若必需，必须显式列为依赖。
• device：仅 device 路由。真实设备未来必须说明直接协议，不能假设已有厂商应用。
• hybrid：至少一个 device 路由，加一个 local_app 或 manufacturer_cloud 路由。能力、接收方、传输分别授权；本地许可不等于云许可。

所有路由 trust=untrusted，manifest 必须 synthetic_only=true。声明不是身份认证、设备证明、凭据或安全证据。manufacturer/product/runtime ref 是有界标签，不是 URL 或私有所有者身份。所有能力须被路由覆盖，路由不能添加未声明能力。Sensors 必须声明 sensor_types。主机选择路由；适配器必须拒绝未声明的路由，不得静默回退到其他路由。

请求字段严格为 version、invocation_ref、capability、operation、payload、route_id。响应字段严格为 version、invocation_ref、status、payload、error。version=1.0，invocation_ref 必须对应。规范 JSON 最大 32,768 UTF-8 字节。parse_wire 拒绝重复键、非法 UTF-8/JSON、非有限数值、超限输入。必须在传输边界调用 parse_wire，然后再校验 schema；不得使用会静默覆盖重复键的默认解析行为。禁止额外字段或操作。

成功为 status=ok、error=none，payload 符合 capability.operation。失败为 status=error、payload={}，error 仅允许 unsupported、unavailable、cancelled、timeout、invalid_request。不能返回调用栈、驱动原始错误、路径、密钥或自由元数据。

媒体限制

MicrophoneAudioInput.sample 每个 frames 单位恰好 80 样本/160 字节，frames=1..4，pcm16 单声道，采样率 16000/24000/48000 Hz，返回率必须与请求一致。这里 frames 是固定样本块，不是毫秒；时长为 80×frames/sample_rate 秒。合成参考示例输出数值全为 0 的 PCM 样本。实际硬件验收前必须说明 PCM 字节序；现有 wire 标识没有表达字节序，真实转换尚未验证。

SpeakerAudioOutput.play 接受 base64 编码的 PCM；base64 解码后的 PCM 必须非空、字节数为偶数且不超过 8192 字节，channels=1、codec=pcm16、同样采样率。成功仅为模拟接收，不证明已发声。Camera.snapshot 为 gray8，宽高 1..64，字节数恰好 width×height，返回尺寸和格式与请求一致。没有新增连续音频或视频流传输。

Display.present 仅 1..1024 字符文本，不可执行。UserControls.poll 仅有界事件枚举，不授权动作。Sensors.read 仅 temperature_celsius、battery_percent、acceleration_mps2；数值 -100..100，电量 0..100，标量或三轴形状必须匹配。Recording.start/stop/status 仅确认状态，retained_bytes=0，start 的 retention_seconds=1..300；没有真实存储。BasicDeviceStatus 和 ConnectivityEvents 仅状态读取/轮询，不是远程管理或任意命令。

生命周期

派发后的超时、取消、断线可能意味着远端结果未知，不可推断成功、自动重放或恢复迟到结果。重连须新 epoch 与新授权操作标识。真实集成在音频采样率变化时必须重新协商音频格式或重连。本 kit 不拥有 Core 或会话权限；生产集成仍待审核。

通用 JSON Schema 校验不能替代跨消息关联、invocation 绑定、manifest 路由校验及权限检查，必须使用运行时校验。没有新增 shell、URL 抓取、文件访问、通用 RPC、运动、定位、机器人或车辆能力。