TopoMobile 是项目中的 Android 客户端工程，用于承载移动端界面、聊天交互与相关能力集成。
- 面向 Android 的主应用工程
- 与
TopoDesktop、customer_service配合完成端到端链路 - 代码以 Kotlin + Android 标准工程结构组织
- 主要源码位于
app/ - 构建与运行建议使用 Android Studio 打开
TopoMobile/目录 - 运行前请确保本机 Android SDK、Gradle 环境可用
app/：主应用源码scripts/：辅助脚本（已将原scripts/README.md合并到本文档）
- 优先在 Android Studio 中进行调试、日志查看与打包
- 变更关键交互后，建议做一次基础回归（启动、聊天主流程、核心页面跳转）
- 涉及输入法或拼音词库能力时，可结合下文
scripts流程更新数据
当前 APK 主要能力如下（按模块归类）：
TopoMobile 的核心优势之一是面向任务执行与人机协同的 GUI 体系，强调“可感知、可引导、可回放、可诊断”：
- 多层浮层系统：围绕执行中、暂停、结果、推理、边框高亮等状态提供分层可视化反馈
- 轨迹可视化链路：支持录制、叠加展示、导航提示、事件详情查看，便于复盘与问题定位
- 任务态交互组件：通过任务指示器、菜单与引导视图，降低执行过程中的理解成本
- 引导与教学 UI：内置无障碍引导、悬浮球引导、物理唤醒引导、教程弹层等上手流程
- 远控与权限提示：对关键权限、远程控制、安装确认等场景提供显式 UI 提示与流程承接
- 截图与可视化辅助：常规截图、聊天截图、长截图与全屏图片查看协同，强化“看见-分析-处理”闭环
- 语音与输入联动：语音输入、录音反馈、输入法增强与 UI 交互结合，提升复杂场景可用性
这一套 GUI 能力不仅服务日常聊天界面，也服务于智能任务执行、轨迹采集和端云协同场景。
- 聊天会话：消息发送/接收、会话列表、聊天详情、多种消息形态展示
- 好友体系：好友关系管理、资料展示、私聊协同
- 群组能力：群组创建、成员管理、群内消息与群助手相关能力
- 小助手入口：包含小助手介绍、能力入口、相关引导页面
- 任务提示体系：执行中状态、暂停态、结果态等浮层提示
- 推理与下一步提示：在任务执行过程中提供可视化反馈
- 轨迹录制：支持任务过程中的动作/事件采集与记录
- 轨迹采集：通过记录用户与屏幕的真实操作记录，高效形成轨迹
- 轨迹可视化：通过轨迹浮层、导航浮层等方式展示执行路径与交互信息
- 云端协同：支持轨迹数据与云端服务配置/同步相关能力
- 物理唤醒：提供物理唤醒相关引导与接入流程
- 无障碍能力：无障碍服务接入、权限引导与辅助数据能力
- 悬浮球/悬浮层：用于快捷触发、状态提示和交互反馈
- 通知保活（Companion 模式）：通过常驻通知与前台服务提升运行稳定性
- 远控与安装确认引导：包含远程控制权限与安装确认相关提示能力
- 截图能力：常规截图、聊天截图、长截图辅助等
- 语音能力：语音输入辅助、录音管理、语音反馈相关能力
- 输入法增强：内置输入法服务以规避部分输入框不可编辑问题
- 全屏图片查看：图片放大与沉浸式查看辅助
- 网络请求与版本更新提示
- 异常检测与缓存清理等运行期辅助能力
- UI 引导体系（教程弹层、功能引导页）
说明：不同版本构建可能会按配置开关部分功能，具体以当前分支代码与运行配置为准。
scripts 下提供从 pinyin-data 与 Rime-ice 词库生成 Kotlin 数据的脚本。
- 下载数据源：
mkdir -p external
cd external
git clone https://github.com/mozillazg/pinyin-data.git
git clone https://github.com/iDvel/rime-ice.git
cd ..- 运行解析脚本：
python apk2/scripts/parse_pinyin_data.py- 合并生成代码：
脚本会生成 apk2/scripts/generated_pinyin_data.kt，包含：
pinyinMapFromData（单字映射）commonWordsMapFromRime（常用词映射）
将其手动合并到 PinyinDictionary.kt 中，并注意去重与回归验证。
pinyin-data：单字拼音映射Rime-ice：常用词库
本 README 只保留 TopoMobile 一级目录的核心说明；更细的模块细节建议直接查看对应源码目录与注释。