feat: expand companion platform, device controls, and memoir workflows
ci / verify (push) Canceled after 0s
ci / verify (push) Canceled after 0s
Add customer and operator login, BLE provisioning, device fleet controls, call memory, memoir generation, and refreshed family and maintenance portals. Include API contracts, migrations, firmware sources, tests, assets, and deployment documentation.
This commit is contained in:
@@ -1,7 +1,9 @@
|
||||
# 设备 API 兼容性约定
|
||||
|
||||
> 2026-09-18 更新:小程序支持先添加设备到账号、后创建家庭和老人。设备端 BLE 与 ble-bind 的五个火山字段保持不变,具体变化见 [账号优先流程](device-account-first-20260918.md)。
|
||||
|
||||
> 当前设备接口主版本:`/device/v2`
|
||||
> 当前接口契约:OpenAPI 0.78.0
|
||||
> 当前接口契约:OpenAPI 0.79.0
|
||||
> 适用对象:云端 API、终端固件、模拟终端和设备联调工具
|
||||
|
||||
## 1. 兼容目标
|
||||
@@ -84,3 +86,12 @@ CI在拉取请求中以目标分支OpenAPI为基线执行破坏性变更检查
|
||||
## 首次接入协议隔离
|
||||
|
||||
`ONBOARDING-1.2-SAAS` 仅适用于生产登记为 `physical_confirm` 的新设备,不依靠固件版本猜测协议。工装写入该契约标识、物理编号、raw32字节认证密钥和版本。新设备调用 `/device/v3/agent-sessions`;同一路径新旧认证由已登记身份区分,认证失败不降级。旧 `/device/v2/conversations` 创建不向新设备开放。新设备恢复出厂前须授权解绑,重置响应不含旧claim码。
|
||||
|
||||
|
||||
## CALL-MEMORY-1.1 并行协议与迁移门禁
|
||||
|
||||
OpenAPI 0.79.0 新增 `/api/v1/device/calls/*`,复用 ONBOARDING-1.1 DEVREQ1 身份,使用 CALL-MEMORY-1.1 契约;可选 contract_version 声明不匹配时拒绝。旧 `/device/v2`、`/device/v3` 不会被静默解释为新协议。
|
||||
|
||||
关键记忆变更或授权撤回后,主体 privacy_epoch 提升,旧 v3 新会话返回 `426 CALL_MEMORY_PROTOCOL_REQUIRED`;旧活动会话进入清理。新会话必须通过独立清单和首次 heartbeat 授权,不能依靠 session_updated 续租。设备回报 SDK 停止只证明本地 SDK 状态;远端 UNKNOWN 仍需可核验证据。
|
||||
|
||||
当前板卡仍在旧 v3/WS 链路,只完成本地音频与快速重拨修复;完整 RTC 客户端和实机核验见 [实施记录](./CALL-MEMORY-1.1实施记录.md)。新固件尚未完成前,禁止把该版本按老设备无感兼容升级发布。
|
||||
|
||||
Reference in New Issue
Block a user