assistant-add-support

assistant-add-support

为语音助手宿主适配新版本 Xposed 接管支持：提取/分析 APK、比对 Hook 点变化、生成新版本配置并完成编译验证。

宿主分支

根据目标宿主查阅对应的核心类清单与指引：

• Breeno（小布助手，com.heytap.speechassist）：阅读 docs/BREENO.md
• XiaoAi（小爱同学，com.miui.voiceassist）：阅读 docs/XIAOAI.md（当前留空不支持）

---

前置环境与依赖门禁

1. REA (Reverse Engineer Anything) 门禁

优先使用 REA 分析引擎（MCP / CLI）审查 APK 内部类与方法签名。

• 上游仓库：https://github.com/morluto/rea
• 严格授权门禁：当且仅当 REA 不可用时，提示用户需先部署 REA，严禁私自自动安装或配置，由用户自主决定。

2. 提取与反编译工具

• 使用项目内的 extract-apk 技能（.agents/skills/extract-apk/scripts/）定位并导出目标 APK。
• 反编译按需进行：若需全局搜索则调用 decompile_apk.py，若只需针对性核对类结构可直接用 REA MCP 直连 APK。

---

适配流程

Phase 1: 确认目标版本

1. 通过 adb -s <serial> shell dumpsys package <package_name> | grep -E "versionCode|versionName" 获取设备上的版本信息；
2. 与用户确认目标版本号与 versionCode。

Phase 2: 提取 APK

运行 extract_apk.py 拉取当前版本 APK。根据分析需要决定是否执行全量反编译。

Phase 3: 调研现有 Hook 机理与签名比对

1. 查阅宿主分支指引（如 docs/BREENO.md），了解宿主核心类角色；
2. 以最近一个已支持版本的 app/src/main/res/raw/<package_name>_<prevVersion>_config.json 作为基准模板（配置结构即 Single Source of Truth）；
3. 在新版本中核对配置中涉及的每个类名、方法名与签名；
4. 列出变动清单（未变 / 变动的具体点位）。

Phase 4: 实现新版本配置与编译验证

1. 在 app/src/main/res/raw/ 新建 <package_name>_<versionCode>_config.json，填入新签名的配置；
2. 在 app/src/main/res/raw/<package_name>_versions.json 追加新 <versionCode>；
3. 在 app/src/main/java/a0/a0/a0/a0/a0/a0/Entrance.kt 的 configRawIdFor 中注册对应 raw 资源映射；
4. 同步运行 ./gradlew :app:compileDebugKotlin 验证编译。

Phase 5: 交付与安装门禁（严格被动）

• 严格被动原则：严禁主动向设备执行安装、推送或任何写操作！默认仅完成代码修改与编译验证，向用户汇报改动并等待代码审查（CR）。
• 仅当用户明确要求安装时：
  1. 执行打包：./gradlew :app:assembleDebug
  2. 推送并使用 pm 安装：

     adb -s <serial> push app/build/outputs/apk/debug/app-debug.apk /data/local/tmp/app-debug.apk
     adb -s <serial> shell pm install -r -d -g /data/local/tmp/app-debug.apk
     adb -s <serial> shell rm -f /data/local/tmp/app-debug.apk
     

  3. 重启宿主使 Xposed 模块生效：adb -s <serial> shell am force-stop <package_name>