本页内容 按故障选择流程本地撤权必须先完成后台重置绑定换板与返修密钥轮换与离线撤销边界
CONSOLE / OPERATIONS

售后恢复

处理授权丢失、实物撤权、云端重置与换板,明确当前能力边界。

面向厂商售后和有权限的管理员。先确认实物、车辆/仪表身份及处理依据;普通用户能操作 APP 时,可先由本人在 APP 移除车辆。云端解绑成功和 APP 清除本机凭据,不证明离线终端已完成本地撤权;交付新用户前仍须验证下述实物清理与旧用户拒绝。

按故障选择流程

情况 当前处理方式
未激活的授权文件丢失 满足条件时重新下载原授权,见 产线签发
已激活设备,License 存储仍正常 保留 License;按实际故障修复固件/驱动或处理 owner 绑定
已激活设备的授权区已丢失/损坏,且无有效受控备份 当前没有自助重签或重新导出接口;停止交付并交签发团队核验
原车主不能配合解绑、二手转让或退货 先完成实物本地撤权,再执行下方云端重置,最后新用户近场绑定
更换仪表主板 新板使用自己的身份和授权,核对兼容型号并变更安装关系,不复制旧板授权

提交签发团队的材料限于设备 ID/SN、硬件标识、型号、授权状态、故障现象和维修凭证等非秘密信息。不要把 License、owner token 或私钥贴入普通工单。

本地撤权必须先完成

后台重置不会擦除离线仪表的 owner。由目标固件的受控售后流程清除本地旧用户授权,使运行中的 Wi-Fi/BLE 会话及缓存失效;重启后确认旧手机不能再认证或控车,同时设备 License 仍可正常验签。

P4 参考工程提供 factory_license_clear_owner(),它只清持久化 owner,不是完整运行期恢复出厂操作。参考 provision.py 没有售后清绑命令。固件尚未提供并验证本地重置路径时,此步骤无法仅靠后台完成,应先由固件负责人处理;不能提前勾选已清除。存储与会话要求见 持久化。

后台重置绑定

  1. 平台或对应厂商账号取得 vehicle:binding:reset,进入车辆列表。经销商不能执行。
  2. 找到仍有用户绑定的车辆,核对 VIN、车辆 ID 和安装仪表,点击「重置绑定」。
  3. 填写具体原因(1–500 字符)。仅在上一步真实完成后,确认“已收回实物,且原用户本地授权已清除”。
  4. 提交后刷新车辆详情,确认已无当前用户绑定。保留处理记录。
  5. 新用户在实物附近使用 APP 重新完成 PIN 与云端绑定;验证旧用户无法控车、新用户权限正常。

API 为 POST /api/v1/admin/vehicles/{vehicleId}/binding-reset。请求中的版本取自刚读取的车辆详情,不写死:

{
  "version": 12,
  "bindingVersion": 3,
  "reason": "已验明实物并完成本地撤权的退货处理",
  "terminalAuthorizationCleared": true
}

这是版本示意,不是可直接执行的数据。旧版本、无当前绑定、无权限或未确认本地清理会被拒绝。响应丢失时先刷新状态;不要用新版本自动重试,以免重置后来建立的新绑定。

重置保留车辆、VIN、设备 License、安装关系和历史;关闭当前绑定并撤销云端 owner 凭据,不回退 License 激活状态,也不重新开放出厂授权下载。

换板与返修

维修时优先保留原板授权区。必须换板时,为新板按 产线流程 签发独立授权;涉及原用户绑定时,先按 APP 或上述售后流程完成撤权。

在车辆编辑页的「仪表」字段选择兼容、启用且可安装的新仪表,提交当前页面版本;账号需具备对应车辆编辑和 device:install 权限。后台事务变更旧/新安装关系,失败时先刷新核对,不手工修改数据库绕过占用或版本检查。安装关系变更不会自动迁移旧板本地 owner、授权文件或用户凭据。

新板写入、重启验签后,验证车辆档案/安装关系、APP 重新绑定、真实车况和控车。旧板回收并确认旧授权不能继续控制交付车辆。仅刷固件成功不代表换板流程完成。

密钥轮换与离线撤销边界

当前 License v1 不支持已有设备授权更新或签发密钥轮换,也不允许用另一张 License 覆盖已配置授权。发现签发密钥或设备秘密可能泄漏时,由平台团队处理,不能直接重新生成平台密钥或批量刷空 NVS。

云端禁用/撤销不等于离线终端立即拒绝旧授权;APP 已缓存授权有离线窗口。需要立即撤销实物访问时,必须通过经验证的本地撤权路径并检查旧连接失效。不能把云端状态变化写成已完成离线吊销。