Codex Local
@@ -138,3 +138,26 @@ powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\smoke-firmware-rol
|
||||
A/B启动确认批次在OpenAPI 0.62.0下扩展可选回执阶段，不增加旧设备必填字段或主状态枚举。启用设备先将制品写入非活动分区并持久化启动尝试，再依次上报`staging`、`reboot_pending`和`boot_verifying`；健康通过才提交成功，健康失败或超时则恢复旧分区并提交`FAILED/rolled_back`及回退版本。云端将三类中间阶段保持为`INSTALLING`，同时保留完整`last_result`供页面展示。低强度验证只执行定向Go用例、前端类型/生产构建和一次B分区启动失败自动回A分区的纵向冒烟，不把模拟结果作为真实Bootloader验收。详细协议见[设备A/B分区固件升级与启动确认协议](device-firmware-ab-protocol.md)。
|
||||
|
||||
OpenAPI 0.63.0和V38进一步为每台固件分配保存去重的阶段事件。直接命令ACK与批量遥测补交在更新命令/分配的同一事务内写入事件，重复结果摘要通过SHA-256唯一键保持幂等；批次详情按设备返回完整时间线，页面显示云端接收时间、阶段、命令状态和稳定结果码。`cmd/firmware-conformance`可把该时间线与设备侧Bootloader/分区证据进行离线一致性校验，详细格式和15项检查见[固件真机联调一致性证据采集与校验说明](firmware-conformance-evidence.md)。
|
||||
|
||||
## 9. 维护端租户级固件管理
|
||||
|
||||
V46和OpenAPI 0.74.0在保留家庭端固件历史及设备下载协议的前提下，引入维护端租户级固件制品与OTA批次。维护端创建的`firmware_release.household_id`和`firmware_rollout.household_id`为空，`created_source=OPS`；家庭端已有记录继续使用原家庭范围，二者共享租户、型号、硬件版本和业务版本唯一性，避免同一租户发布相互冲突的活动制品。
|
||||
|
||||
维护中心“固件管理”页面支持选择客户组织、登记或吊销可信公钥、浏览器计算SHA-256后直传私有对象、恢复中断上传、完成签名校验、暂停、恢复、退役和人工下载。人工下载与设备下载都只签发短期私有地址；人工下载额外记录`ops.firmware.release.download`审计事件，设备下载继续要求设备身份、目标批次、版本状态和分配状态全部通过。
|
||||
|
||||
维护端接口使用`X-Tenant-Id`固定客户组织边界：
|
||||
|
||||
| 方法与路径 | 用途 |
|
||||
|---|---|
|
||||
| `GET/POST /api/v1/ops/firmware-signing-keys` | 查询或登记租户可信公钥 |
|
||||
| `POST /api/v1/ops/firmware-signing-keys/revoke` | 在引用保护通过后吊销公钥 |
|
||||
| `GET/POST /api/v1/ops/firmware-releases` | 查询租户固件台账或创建租户级上传记录 |
|
||||
| `POST /api/v1/ops/firmware-releases/{id}/upload-session` | 恢复未完成的私有上传 |
|
||||
| `POST /api/v1/ops/firmware-releases/{id}/finalize` | 校验对象和签名并发布版本 |
|
||||
| `POST /api/v1/ops/firmware-releases/{id}/pause` | 暂停版本分发和关联在途批次 |
|
||||
| `POST /api/v1/ops/firmware-releases/{id}/resume` | 恢复版本分发，不自动恢复旧批次 |
|
||||
| `POST /api/v1/ops/firmware-releases/{id}/retire` | 永久退役版本 |
|
||||
| `GET /api/v1/ops/firmware-releases/{id}/download` | 获取带摘要、签名和过期时间的短期人工下载地址 |
|
||||
| `GET/POST /api/v1/ops/firmware-rollouts` | 查询OTA批次或按兼容设备和灰度比例创建升级批次 |
|
||||
| `GET /api/v1/ops/firmware-rollouts/{id}` | 查询逐设备下载、安装和确认进度 |
|
||||
| `POST /api/v1/ops/firmware-rollouts/{id}/pause` | 暂停批次并取消尚未投递的升级命令 |
|
||||
|
||||
Reference in New Issue
Block a user