基于 AutoGLM 的 Android 原生智能助理应用
无需电脑连接，直接在手机上运行的自动化操作框架
--- ## 📱 关于本项目 > **本分支说明**：当前是 `install` 分支（主分支），用于直接下载和使用应用。如需查看源码，请切换到 [`src` 分支](../src)。 AutoGLM Android 是基于 [Open-AutoGLM](https://github.com/zai-org/Open-AutoGLM) 官方项目的 Android 原生实现。与官方 Python 版本需要通过 PC 端 ADB 连接控制不同，本项目作为 Android 原生应用直接运行在手机上，通过 Android 无障碍服务实现屏幕感知和自动化操作，为用户提供真正的"手机端 AI 助理"体验。 ### ✨ 核心特性 - **无需电脑** - 直接在手机上运行，不用连电脑 - **语音控制** - 用自然语言描述任务，AI自动执行 - **智能操作** - 自动识别界面元素，完成点击、滑动、输入等操作 - **悬浮窗辅助** - 实时显示操作状态，随时暂停/继续 - **自动检测** - 一键检测所有权限和功能是否正常 - **动态应用识别** - 自动获取手机所有已安装应用，无需手动配置应用列表 --- ## 📲 下载安装 ### 系统要求 | 要求 | 说明 | |------|------| | 系统版本 | Android 8.0 及以上 | | 存储空间 | 约 50MB | | 其他 | 需要开启无障碍服务、悬浮窗权限 | ### 安装步骤 **方式一：直接安装 APK** 1. 下载最新版本的 APK 安装包 2. 在手机上打开 APK 文件进行安装 3. 如提示"未知来源"，请在设置中允许安装来自此来源的应用 --- ## ⚙️ 使用指南 ### 第一步：授予必要权限 首次打开应用后，需要授予以下权限才能正常使用： | 权限 | 用途 | 如何开启 | |------|------|----------| | 无障碍服务 | 让 AI 能够看到和操作屏幕 | 设置 → 无障碍 → AutoGLM → 开启 | | 截图权限 | 让 AI 能够看到当前屏幕内容 | 点击应用内"截图权限"按钮授权 | | 悬浮窗权限 | 显示操作状态悬浮球 | 设置 → 应用管理 → AutoGLM → 悬浮窗 | | 录音权限 | 语音输入功能（可选） | 运行时弹窗授权 | **💡 小技巧**：点击首页的「自动检测」按钮，可以一键检查所有权限状态，点击「去授权」可以快速跳转到对应设置页面。 ### 第二步：配置 API 密钥 应用需要连接智谱 AI 的 GLM 模型才能工作，需要先获取 API 密钥： 1. **注册智谱 AI 开放平台** - 访问 [智谱AI开放平台](https://open.bigmodel.cn/) - 注册并登录账号 2. **获取 API Key** - 进入「API密钥」页面 - 点击「新建API密钥」 - 复制生成的 API Key 3. **在应用中配置** - 打开应用，进入「设置」页面 - 填写以下信息： - **API 地址**：`https://open.bigmodel.cn/api/paas/v4`（已自动填充） - **模型名称**：`autoglm-phone` - **API Key**：粘贴刚才获取的密钥 - 点击「测试连接」验证配置是否正确 ### 第三步：开始使用 1. 在首页输入框中输入您想要执行的任务，例如： - `打开微信发送消息给张三` - `在抖音搜索美食视频` - `打开美团点一杯奶茶` - `帮我清理一下手机相册` 2. 点击「执行任务」按钮 3. 应用会自动分析当前屏幕，逐步完成任务 4. 查看操作日志，了解 AI 的执行过程 --- ## 🛠️ 常见问题 ### Q: 无障碍服务在哪里开启？ **A:** 不同品牌的手机操作略有差异： | 品牌 | 开启路径 | |------|----------| | 小米/红米 | 设置 → 更多设置 → 无障碍 → AutoGLM | | 华为/荣耀 | 设置 → 辅助功能 → 无障碍 → AutoGLM | | OPPO/一加 | 设置 → 其他设置 → 无障碍 → AutoGLM | | vivo | 设置 → 辅助功能 → 无障碍 → AutoGLM | | 三星 | 设置 → 辅助功能 → 无障碍 → AutoGLM | **通用方法**：在手机设置中搜索"无障碍"，找到 AutoGLM 并开启 ### Q: 为什么截图权限无法授予？ **A:** 截图权限每次重启应用后需要重新授权： 1. 点击应用内"自动检测" 2. 查看截图权限状态 3. 如显示"未授权"，点击"去授权"按钮 4. 在弹窗中选择"立即开始" 5. 勾选"AutoGLM"后点击"开始" ### Q: 应用执行任务时卡住了怎么办？ **A:** 点击悬浮球弹出悬浮框，点击「停止」按钮即可中止 ### Q: 支持哪些应用？ **A:** 支持**手机所有已安装应用**！ 应用会自动扫描并识别您手机上已安装的所有应用，包括： - 社交应用：微信、QQ、微博、钉钉等 - 短视频：抖音、快手、B站等 - 购物：淘宝、京东、拼多多、美团等 - 生活服务：饿了么、大众点评、携程等 - 系统应用：设置、时钟、计算器等 - 其他您安装的任何应用 **无需手动添加**，启动应用时会自动获取并缓存所有应用信息。 --- ## 🎯 使用技巧 ### 1. 任务描述要清晰 **❌ 不好的描述**： - "买东西" - "找人" **✅ 好的描述**： - "打开美团点一杯奶茶" - "打开微信发消息给张三，问他今晚吃什么" ### 2. 逐步执行复杂任务 对于复杂任务，可以用自然语言详细描述： - 如：用京东帮我买台小米17pro还有华为mate70pro，加到购物车一块买，用京东自营 ### 3. 充分利用悬浮窗 - 悬浮球显示当前执行状态 - 紫色代表无任务，或任务已完成，此时不会控制您的手机 - 橙色代表正在执行任务，会让AI分析操作您的手机,完成任务或遇到异常情况或您手动停止，AI会终止任务，悬浮球恢复紫色 ### 4. 使用自动检测功能 定期点击「自动检测」按钮，确保所有权限和功能都正常工作 --- ## 📊 权限详细说明 | 权限 | 是否必须 | 说明 | |------|----------|------| | 无障碍服务 | ✅ 必须 | 核心功能，让 AI 能够看到屏幕并执行操作 | | 截图权限 | ✅ 必须 | 让 AI 能够获取当前屏幕内容进行分析 | | 悬浮窗权限 | ✅ 必须 | 显示操作状态和悬浮球 | | 录音权限 | ⚪ 可选 | 语音输入功能，暂时未开放 | --- ## 🔒 隐私与安全 - **数据去向**：应用仅在本地运行，截图数据仅用于 AI 分析，不会上传至任何服务器 - **API 通信**：仅与智谱 AI 官方 API 通信，不经过第三方服务器 - **无恶意行为**：应用不收集任何个人信息，不进行任何未授权操作 - **开源透明**：源代码完全开源，欢迎审查 --- ## 📝 更新日志 ### v1.1.0 (最新版本) - ✨ **新增**：动态应用识别功能 - 自动获取手机所有已安装应用 - ✨ **新增**：支持任意已安装应用，不再局限于预定义应用列表 - ✨ **优化**：应用启动时自动构建应用名称与包名的映射缓存 - ✅ 支持无障碍服务控制 - ✅ 支持截图分析 - ✅ 支持基本操作（点击、滑动、输入、返回等） - ✅ 支持悬浮窗状态显示 - ✅ 支持权限自动检测 - 🔄 持续优化中 ### v1.0.0 - ✅ 基础功能发布 - ✅ 支持预定义应用列表（约150个应用） --- ## 🌟 技术架构 - **语言**: Kotlin - **架构**: MVVM + Repository Pattern - **异步**: Kotlin Coroutines - **UI**: Material Design 3 - **无障碍**: AccessibilityService + AccessibilityNodeInfo --- ## 📚 相关链接 - [Open-AutoGLM 官方项目](https://github.com/zai-org/Open-AutoGLM) - Python 版本 - [智谱AI开放平台](https://open.bigmodel.cn/) - 获取 API Key - [源码分支](../src) - 查看完整源代码 --- ## 📄 许可证 本项目基于 [Apache-2.0](LICENSE) 许可证开源。 --- ## ⚠️ 免责声明 本项目仅供学习和研究使用。使用本软件所产生的一切后果由使用者自行承担。严禁用于任何违法活动。 ---⭐ 如果这个项目对您有帮助，请点个 Star 支持一下！