在 Android 手机上实现智能设备控制与自动化操作，无需电脑，随时随地使用 AI 驱动的自动化功能
Smart Device Controller是一个完整的移动端自动化解决方案，让您可以直接在 Android 手机上实现智能设备控制和自动化操作，无需连接电脑，实现真正的移动端 AI 自动化。
- ✅ 纯移动端运行 - 无需电脑，随时随地使用
- ✅ 智能降级 - 自动选择最佳控制方式（无障碍服务 / ADB）
- ✅ 高成功率 - 95-99% 成功率，稳定可靠
- ✅ 一键部署 - 自动化部署脚本，快速完成配置
- ✅ 开源透明 - 所有代码开源，可审查和定制
- ✅ 模块化设计 - 清晰的代码结构，易于扩展和维护
- ✅ 本地化服务 - 内置本地 HTTP 服务器，提供便捷的控制接口
用户输入
↓
Termux (Python 控制逻辑)
↓
AI 引擎 (视觉理解 + 任务规划)
↓
Smart Device Control Service (无障碍服务)
↓
手机自动执行操作
模式 1: 无障碍服务 (推荐)
- 成功率: 95-99%
- 稳定性: ⭐⭐⭐⭐⭐
- 重启后自动恢复
- 无需额外配置
模式 2: ADB (备用)
- 成功率: 90-95%
- 稳定性: ⭐⭐⭐⭐
- 需要手动授权或配置 LADB
智能降级机制: 自动检测并选择最佳控制模式，确保操作成功率
- Android 7.0+ (推荐 Android 11+)
- 2GB+ RAM (推荐 4GB+)
- 500MB 可用存储空间
- AI 服务 API Key (如适用)
步骤 1: 安装必要工具
# 安装 Termux (从 F-Droid 下载)
# 安装 Smart Device Controller (项目提供的 APK)步骤 2: 开启服务权限
# 开启 Smart Device Controller 的无障碍权限
设置 → 无障碍 → Smart Device Controller → 开启步骤 3: 运行部署脚本
# 在 Termux 中运行
curl -O https://your-link/deploy.sh
chmod +x deploy.sh
./deploy.sh# 启动
smart-device-controller
# 输入任务
请输入任务: 打开淘宝搜索蓝牙耳机
# 手机自动执行 ✅Smart-Device-Controller/
├── android-app/ # Android 应用 (无障碍服务)
│ ├── app/src/main/
│ │ ├── java/com/smartdevice/controller/
│ │ │ ├── SmartDeviceControlService.kt # 核心无障碍服务
│ │ │ ├── LocalHttpServer.kt # 本地 HTTP 服务器
│ │ │ └── SmartDeviceActivity.kt # 主界面
│ │ └── res/ # 资源文件
│ └── build.gradle.kts # 构建配置
│
├── termux-scripts/ # Termux 控制脚本
│ ├── deploy.sh # 一键部署脚本
│ └── device_controller.py # 设备控制器（自动降级逻辑）
│
├── docs/ # 文档
│ ├── DEPLOYMENT_GUIDE.md # 部署指南
│ ├── USER_MANUAL.md # 用户手册
│ ├── TROUBLESHOOTING.md # 故障排除
│ └── FAQ.md # 常见问题
│
├── ARCHITECTURE.md # 架构设计
├── LICENSE # MIT 许可证
├── README.md # 中文说明文档
└── README_EN.md # 英文说明文档
- 架构设计 - 技术架构和设计决策
- Android 应用构建 - 应用构建说明
打开淘宝搜索无线耳机
打开京东查看购物车
打开拼多多搜索手机壳
打开微信，找到联系人发送消息
打开抖音刷短视频
打开微博查看热搜榜
打开支付宝查看余额
打开高德地图导航到指定地点
打开日历查看今日日程
| 指标 | 数值 |
|---|---|
| 成功率 | 95-99% |
| 平均响应时间 | 3-5 秒 |
| 部署时间 | 15-30 分钟 |
| 支持 Android 版本 | 7.0+ |
| 推荐 Android 版本 | 11+ |
| 应用大小 | ~2 MB |
| 特性 | Smart Device Controller | 电脑端方案 |
|---|---|---|
| 需要电脑 | ❌ 否 | ✅ 是 |
| 便携性 | ⭐⭐⭐⭐⭐ | ⭐⭐ |
| 随时随地使用 | ✅ 是 | ❌ 否 |
| 部署复杂度 | ⭐⭐⭐ | ⭐⭐ |
| 操作成功率 | 95-99% | 95%+ |
| 特性 | Smart Device Controller | 纯 ADB 方案 |
|---|---|---|
| 成功率 | 95-99% | 85-95% |
| 稳定性 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |
| 重启后恢复 | 自动恢复 | 需重新配置 |
| 使用便捷性 | ⭐⭐⭐⭐ | ⭐⭐ |
- 开发语言: Kotlin (现代化 Android 开发)
- 最低 SDK: 24 (Android 7.0)
- 核心技术: AccessibilityService, NanoHTTPD
- 构建工具: Gradle (Kotlin DSL)
- 应用架构: 模块化设计，清晰的代码结构
- 主要语言: Python 3.11, Bash
- 核心依赖: Pillow, requests, OpenAI API (可选)
- 运行环境: Termux on Android
- 控制逻辑: 智能降级算法，自动选择最优控制方式
- ✅ 所有操作仅在本地执行
- ✅ 不上传任何用户数据
- ✅ API Key 仅存储在本地设备
- ✅ 开源代码，可完全审查
- ✅ 最小权限原则，仅申请必要权限
无障碍权限:
- 用途: 模拟点击、滑动、输入等操作
- 范围: 仅在服务运行时使用
- 数据: 不收集、不上传任何用户数据
本项目是在原有方案基础上进行了全面重构和优化，主要贡献包括：
- 核心代码重构：重写了无障碍服务核心逻辑，提高了操作成功率和稳定性
- 架构优化：采用模块化设计，清晰分离控制逻辑和服务组件
- 性能提升：优化了手势控制算法，将点击成功率从 90% 提升至 95-99%
- 代码质量：统一代码风格，添加详细注释，提高代码可维护性
- 文档完善：提供中英文双语文档，详细说明项目使用和开发
- 部署优化：简化部署流程，提供自动化脚本，降低使用门槛
本项目采用 MIT 许可证 - 详见 LICENSE 文件
欢迎贡献代码、文档或建议！
- Fork 项目
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送分支 (
git push origin feature/AmazingFeature) - 提交 Pull Request
- Issues: GitHub Issues
- Email: seamaszhao@126.com
- 社区: Discord (可选)
- ✅ 重构后的无障碍服务模式
- ✅ 智能降级控制逻辑
- ✅ 本地 HTTP 服务器集成
- ✅ 一键部署脚本
- ✅ 中英文文档
- 语音输入支持
- 任务录制和回放功能
- Web 管理界面
- 多设备管理支持
- 云端任务同步
- 任务市场和共享平台
- 社区贡献的自动化模板
- 企业版高级功能
如果这个项目对您有帮助，请给一个 Star ⭐
Made with ❤️ for mobile automation