docs: add Agent 0.9.28 update verification (#143 #144)

2026-08-29 21:38:53 +08:00
parent c9e1dff16f
commit 88cbef39a8
1 changed files with 8 additions and 0 deletions
@@ -293,3 +293,11 @@ adb shell am start -n cn.ilapage.goauto.agent/.MainActivity
 - 分别验证含 goods_id 的直链，以及白名单内无 goods_id 的 `p.pinduoduo.com` 短链和 `mobile.yangkeduo.com/goods2.html?ps=...`：直链不应触发 Agent 额外网络展开；无 goods_id 的白名单链接应优先由手机侧在 4 跳、每次连接/读取 5 秒、64KB 正文上限内展开，并覆盖 302/307。正文只含 `refer_goods_id` 时不得误判为商品身份。另覆盖链接后紧跟中文、多个链接冲突、白名单外跳转、超时和服务端兜底；诊断、日志和数据库不得出现链接原文、goods_id、剪贴板或响应正文。成功/部分成功应显示来源“Agent 当前页面”，相同 goods_id 不产生重复商品，任务详情与 PDD 最新档案一致。
 - 断开网络、离开详情页、制造重复分享入口或剪贴板不可用时，应得到普通人可理解的失败原因并释放设备槽；原始分享文案、剪贴板、控件树和截图不得出现在数据库或日志。
 - 验证期间不得自动搜索或选择相似商品，不得修改虾皮关联，不创建采购任务、不修改地址、不创建订单，永久禁止支付。
+
+### Android Agent 0.9.28 应用内更新检查（#143/#144）
+
+- 自动验证：`cd server && go test ./app/goauto/apprelease ./app/goauto/access ./app/goauto/migrations`；`cd android && .\gradlew.bat testDebugUnitTest assembleDebug`。服务端 APK 解析测试在 debug APK 已构建时读取真实 Manifest，当前期望 `versionCode=41`、`versionName=0.9.28`。
+- 新增迁移 `1787983700000_agent_app_release.go` 只创建 `agent_app_release` 和 `agent_app_release_setting`。未获得明确本机/正式库迁移授权时只做测试库验证。
+- APK 文件目录使用 `GOAUTO_AGENT_RELEASE_DIR`；缺省为服务端工作目录下 `var/goauto-agent-releases`，不得映射成公开静态目录。部署需让 Admin/API 进程对该目录具有创建、写入、读取和删除临时失败文件的权限。
+- 真机发布验证前确认设备空闲，再由管理员上传一个签名一致、versionCode 更高的 APK并显式设为当前。依次验证启动静默提示、设置页手动检查、下载进度/取消、断网、哈希不一致删除、未知来源引导和系统确认安装。任务执行中全部更新动作必须被阻止，心跳与前台服务继续运行。
+- 上传或设为当前属于发布动作，安装会改变设备应用版本；没有用户独立授权时不得执行。安装后系统可能关闭无障碍服务，只能由用户在系统设置重新开启。