goauto/android/README.md

Android Agent

一期 Android 执行端，包名为 cn.ilapage.goauto.agent。

当前已经实现：

• 首次安装生成并持久化随机 UUID installId，不读取硬件唯一标识。
• 自动注册和已认证的版本信息更新，无注册码输入页。
• Android Keystore AES-GCM 加密保存 Device Token，界面和日志不显示明文。
• 前台服务、15 秒心跳、网络恢复触发重连和最小诊断状态页。
• 清除 App 数据后按新的安装实例注册；Token 无效时明确报错，不降级为无认证注册。

服务端地址可在诊断页保存，也可在构建时通过 GOAUTO_SERVER_URL 环境变量或同名 Gradle 属性写入默认值。Release 版本只接受 HTTPS；只有 Debug 构建的独立清单允许 HTTP，便于局域网真机联调。诊断页在前台每秒刷新连接状态，但不会显示 Token 明文。

T05 真机验证记录

• 一加 PKG110 / Android 16：首次注册、15 秒心跳、前台通知和在线空闲状态已验证。
• 杀死进程后重新打开：installId 和 deviceId 保持不变，设备表仍只有一条记录，心跳恢复。
• PDD 8.17.0 版本信息已随注册提交。
• ColorOS 首次 ADB 安装需要在“安装增强防护”页执行“更多 → 开始深度扫描 → 继续安装”。
• 当前 MVP 只完成并维护一加/ColorOS 真机兼容，不包含华为 ROM。

T23 v2 真机验证进展

• 一加 PKG110 / Android 16 已验证 v2 能力上报、正式任务领取、浏览器到 PDD NewPageActivity、规格面板打开、颜色文字点击和逐颜色稳定价格。
• 图片型颜色卡片只点击文字节点，不点击整卡或“打开大图/查看大图”。
• 规格值会排除“#一次选多款#”等面板功能入口，避免把操作按钮伪装成尺码和 SKU。
• 商品 719834019024 已采到 4 个颜色、4 个 2690 分颜色价格和 4 个结构化 SKU，缺少尺码、店铺和评价时正确提交 completed_partial。
• 当前仍需一个有效的颜色 + 尺码商品完成全部尺码和多维 SKU 真机复核；不以已失效或只含单维规格的商品宣称通过。

.\gradlew.bat test
.\gradlew.bat assembleDebug

APK 输出：app/build/outputs/apk/debug/app-debug.apk。AccessibilityService、任务领取和 PDD 页面执行由后续工单实现。