秀秀 3.234 - 安卓返回层级、案例分享兼容与客户端资源刷新

记录日期：中国时间 2026-08-25；不可覆盖快照 ID：a680076ed19916ae8e1453357ae8d7e17a7f17267cabacfa6de2742a0bf537c5

记录完整性：九项详细记录完整

## 秀秀 3.234 - 安卓返回层级、案例分享兼容与客户端资源刷新

- 建立时间：2026-08-25 CST。
- 父版本：秀秀 3.233；固定严重故障回滚基准仍为秀秀 3.2。安卓客户端技术版本由 3.221 升级为 3.222（versionCode 30222）。
- 修改目的：修复安卓系统返回键在任意页面直接退出；修复部分已安装 APP 仍显示旧案例分享弹窗、浅色目标文字和点击目标立即发送的问题；让后续服务器端前端修复能够及时进入 APP。
- 原因判断：旧 APK 未打包 `@capacitor/app`，JavaScript 返回监听没有收到安卓原生返回事件；自定义 WebViewClient 又把 `/app/` 与 `/shared/` 强制替换成 APK 内置旧资源，使服务器 3.233 更新无法进入已安装客户端。
- 修改逻辑：APK 增加 Capacitor App 原生插件；返回键按“当前弹窗→子页面→会话→消息首页”逐层返回，消息首页第一次返回仅提示、2 秒内第二次才最小化；案例分享弹窗纳入返回栈；目标点击只进入选中态，必须再点“确认发送”；目标文字对 Android/HarmonyOS WebView 使用弹窗作用域强制深色；WebView 改为线上最新静态资源优先，主页面网络失败时才使用签名 APK 内置资源兜底。
- 采用方法：保留五节点各自生产基线，只对 App 静态资源做增量补丁；使用 Capacitor 官方 AppPlugin 接收原生返回事件；沿用原 packageId、内部签名、更新校验和 Android Keystore；发布前逐包检查插件清单、签名、版本、哈希和资源标记，发布时先备份再逐节点健康检查。
- 数据/调用链路：安卓返回键→Capacitor AppPlugin→`handleMobileBackNavigation`→关闭最上层界面或回到上一级；案例库→分享给真人或 BOT→搜索→选择目标（不发送）→确认发送→既有 `/api/im/messages`；APP 启动→公网 `/app/` 最新版本资源→失败时 APK 内置 3.222 资源。
- 兼容保护：沿用原五套 packageId 和同一内部签名，可覆盖升级且保留账号、Android Keystore 会话、IndexedDB 缓存和聊天数据；未修改消息 API、数据库、账号、权限、跨服路由、BOT、OpenClaw、Q/X 军团、EasyTier、206 授权和域名。
- 改动文件：五节点 `app/mobile.js`、`app/index.html`、`shared/client.css`、功能版本 drop-in；安卓 `package.json/package-lock.json`、`MainActivity.java`、Capacitor 插件清单及五套 3.222 APK/更新清单。
- 验证结果：五类 JavaScript 通过 `node --check`；五套 APK 均通过 `apksigner`、包名/版本号/哈希校验并包含 AppPlugin；无 `.so`，属于架构无关包，可用于 64 位安卓；五个公网更新清单、APK、App/JS/CSS/API 入口均通过 HTTP 与内容标记验证；真实手机仍需最终确认系统返回手感、鸿蒙显示和系统安装确认。
- 同步与回滚：同步立志教育、影团AI、守一、守一替身、秀秀替身；静态资源回滚目录为各节点 `/var/backups/xiuxiu3/20260825-android-back-refresh-3222/`；安装包回滚目录位于 206 `/var/backups/xiuxiu3/20260825-android-3222/`。回滚仅恢复对应节点文件和更新清单，不改业务数据。