{"repo": "butlanys/open-autoglm-android", "files": {"README.md": {"05e461019a4b34c0b63f68c036da0272ae9da34a": {"t": 1785674184.91166, "n": 4158, "h": "00241b785fb0d750", "c": "# Open-AutoGLM-Android\n\n

\n \"Logo\"\n

\n\n

\n AI 驱动的 Android 手机自动化操控\n

\n\n

\n \"Release\"\n \"License\"\n \"Android\"\n

\n\n---\n\n基于 [Open-AutoGLM](https://github.com/zai-org/Open-AutoGLM) 的 Android 原生客户端，通过 Shizuku 实现完全本地化的 AI 手机操控，无需电脑连接。\n\n写在前头，此项目受 [Open-AutoGLM](https://github.com/zai-org/Open-AutoGLM) 项目启发，项目代码完全由Claude编写，但方案设计百分百原创，我在事先除了参考过Open-AutoGLM、scrcpy、shizuku-api的代码外，没有看过其他开发者的代码。shizuku方案是因为我日常用的多才采用，~~绝不是因为无障碍太容易被app检测到导致被ban号~~\n\n## ✨ 特性\n\n- 📱 **纯手机端运行** - 无需电脑连接 ADB，通过 Shizuku 直接获取 shell 权限\n- 🎨 **Material Design 3** - 现代化 UI，支持动态取色 (Material You)\n- 🤖 **多模型兼容** - 支持任何具有图像输入能力的 AI 模型\n- ⚡ **流式响应** - 实时显示 AI 思考过程\n- 🔒 **敏感操作确认** - 支付、删除等操作需用户确认\n- 🛠️ **人工接管** - 登录、验证码等场景支持人工介入\n\n## 📸 UI 截图\n\n| 主页 | 设置页 |\n|:---:|:---:|\n| ![主页](resources/screenshot-main.jpg) | ![设置页](resources/screenshot-set.jpg) |\n| 对话中 | 通知栏显示进度 |\n| ![对话中](resources/screenshot-chat.jpg) | ![通知栏显示进度](resources/screenshot-notice.jpg) |\n| 用户对话编辑 | ai对话编辑 |\n| ![用户对话编辑](resources/screenshot-edit-1.jpg) | ![ai对话编辑](resources/screenshot-edit-2.jpg) |\n\n感谢Tech_sky的友情支持\n\n## 📋 系统要求\n\n- Android 8.0+ (API 26+)\n- [Shizuku](https://shizuku.rikka.app/) 已安装并运行\n- (可选) [ADB Keyboard](https://github.com/senzhk/ADBKeyBoard) 用于中文输入\n\n## 📦 安装\n\n### 方式一：下载 Release\n\n前往 [Releases](https://github.com/butlanys/Open-AutoGLM-Android/releases) 下载最新版本 APK\n\n### 方式二：自行编译\n\n```bash\ngit clone https://github.com/butlanys/Open-AutoGLM-Android.git\ncd Open-AutoGLM-Android\n./gradlew assembleDebug\n```\n\n## 🔧 配置\n\n### 1. 安装 Shizuku\n\n1. 下载并安装 [Shizuku](https://shizuku.rikka.app/)\n2. 按照 Shizuku 说明启动服务（无线调试或 Root）\n3. 打开本应用，授予 Shizuku 权限\n\n### 2. 配置 AI API\n\n在应用设置页面配置 API 信息：\n\n#### 智谱 BigModel (推荐)\n\n| 配置项 | 值 |\n|--------|-----|\n| API 地址 | `https://open.bigmodel.cn/api/paas/v4` |\n| 模型名称 | `autoglm-phone` |\n| API Key | 在 [智谱开放平台](https://bigmodel.cn/) 申请 |\n\n#### ModelScope\n\n| 配置项 | 值 |\n|--------|-----|\n| API 地址 | `https://api-inference.modelscope.cn/v1` |\n| 模型名称 | `ZhipuAI/AutoGLM-Phone-9B` |\n| API Key | 在 [ModelScope](https://modelscope.cn/) 申请 |\n\n### 🔌 API 兼容性\n\n本应用支持任何**具有图像输入能力**且兼容 OpenAI API 格式的模型。\n\n如果你想使用其他模型（如 Claude、Gemini、通义千问等），可以使用 [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI) 进行 API 格式转换：\n\n```bash\n# 使用 CLIProxyAPI 将其他模型 API 转换为 OpenAI 兼容格式\n# 然后将转换后的地址填入本应用的 API 设置中\n```\n\n**兼容的模型要求：**\n- ✅ 支持图像输入（Vision 能力）\n- ✅ 支持 OpenAI Chat Completions API 格式\n- ✅ 支持流式响应 (SSE)\n\n## 🚀 使用方法\n\n1. 确保 Shizuku 运行且已授权\n2. 在设置页配置 API\n3. 在主页输入任务，例如：\n - \"打开微信搜索附近美食\"\n - \"打开淘宝搜索无线耳机\"\n - \"打开设置调整屏幕亮度\"\n - \"帮我发一条朋友圈\"\n4. 点击开始执行\n\n## 📋 支持的操作\n\n| 操作 | 说明 |\n|------|------|\n| `Launch` | 启动应用 |\n| `Tap` | 点击屏幕坐标 |\n| `Type` | 输入文本 |\n| `Swipe` | 滑动手势 |\n| `Back` | 返回键 |\n| `Home` | 回到桌面 |\n| `Long Press` | 长按 |\n| `Double Tap` | 双击 |\n| `Wait` | 等待指定时间 |\n| `Take_over` | 请求人工接管 |\n\n## 🏗️ 项目结构\n\n```\napp/src/main/java/com/autoglm/android/\n├── action/ # Action 解析与执行\n├── agent/ # Agent 核心逻辑 (PhoneAgent)\n├── config/ # 配置 (系统提示词、应用包名等)\n├── data/ # 数据持久化 (DataStore)\n├── device/ # 设备控制 (截图、点击、滑动等)\n├── model/ # AI 模型客户端\n├── service/ # 前台服务\n├── shizuku/ # Shizuku 集成 (UserService)\n└── ui/ # Jetpack Compose UI\n```\n\n## 🛡️ 安全说明\n\n- 所有敏感操作（支付、删除等）需要用户手动确认\n- 本应用不会上传任何个人数据\n- 截图仅用于 AI 分析，不会存储或传输到第三方\n- API Key 仅存储在本地设备\n\n## 📄 许可证\n\n本项目仅供学习研究使用。\n\n## 🙏 致谢\n\n- [Open-AutoGLM](https://github.com/zai-org/Open-AutoGLM) - 原始项目\n- [Shizuku](https://github.com/RikkaApps/Shizuku) - Shell 权限框架\n- [scrcpy](https://github.com/Genymobile/scrcpy) - 屏幕捕获技术参考 (Apache License 2.0)\n- [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI) - API 转换工具\n"}}}}