[Task][T05] 实现 Android 自动注册、心跳与前台保活 #7

Closed
opened 2026-08-14 14:24:39 +08:00 by ila · 1 comment
Owner

基本信息

要解决的问题

Android Agent 首次启动自动生成安装身份、提交信息完成注册,并在后续启动使用设备 Token 心跳和领取任务。

范围

  • 首次安装生成随机 UUID installId 并持久化,不采集硬件唯一标识。
  • 无本地 Token 时自动提交设备信息注册,无注册码输入页。
  • 安全保存 deviceId 和 deviceToken。
  • 已有 Token 时携带认证调用注册接口更新版本信息。
  • 前台服务、心跳、网络恢复和最小诊断状态页。
  • App 数据被清除后生成新 installId,按新设备注册。

验收标准

  • 首次启动无需人工步骤即可注册并出现在管理端。
  • 进程重启和网络切换后恢复心跳。
  • 已注册设备不会因普通重启生成新 installId。
  • Token 无效时显示明确错误,不通过无认证重复注册覆盖旧设备。
  • 华为和一加真机验证通过。

参考文档

  • docs/08-agent-api-contract.md
## 基本信息 - 上级 Epic: #1 - 所属 MVP: #2 - 任务编号: T05 - 前置依赖: #3、#5、#6 - 原始需求确认: 2026-08-14 ## 要解决的问题 Android Agent 首次启动自动生成安装身份、提交信息完成注册,并在后续启动使用设备 Token 心跳和领取任务。 ## 范围 - 首次安装生成随机 UUID `installId` 并持久化,不采集硬件唯一标识。 - 无本地 Token 时自动提交设备信息注册,无注册码输入页。 - 安全保存 `deviceId` 和 `deviceToken`。 - 已有 Token 时携带认证调用注册接口更新版本信息。 - 前台服务、心跳、网络恢复和最小诊断状态页。 - App 数据被清除后生成新 installId,按新设备注册。 ## 验收标准 - 首次启动无需人工步骤即可注册并出现在管理端。 - 进程重启和网络切换后恢复心跳。 - 已注册设备不会因普通重启生成新 installId。 - Token 无效时显示明确错误,不通过无认证重复注册覆盖旧设备。 - 华为和一加真机验证通过。 ## 参考文档 - `docs/08-agent-api-contract.md`
ila changed title from [Task][T05] 实现 Android 注册、前台保活和连接状态页 to [Task][T05] 实现 Android 注册、心跳与前台保活 2026-08-14 15:09:26 +08:00
ila changed title from [Task][T05] 实现 Android 注册、心跳与前台保活 to [Task][T05] 实现 Android 自动注册、心跳与前台保活 2026-08-14 15:52:56 +08:00
Author
Owner

用户已于 2026-08-15 明确验收通过,现关闭工单。

用户已于 2026-08-15 明确验收通过,现关闭工单。
ila closed this issue 2026-08-15 08:58:28 +08:00
Sign in to join this conversation.
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: OPC/goauto#7