ven-coder /assists
🔥Android无障碍服务(AccessibilityService)开发框架,Android自动化脚本框架,快速开发复杂自动化任务、远程协助、监听等
★ 999⑂ 238👁 9⑃ 4● 31▤ 27
+1
Daily
999
stars
238
forks
9
watchers
4
prs
31
issues
27
releases
README
基于Android无障碍服务(AccessibilityService)封装的自动化开发框架 简化自动化脚本开发 · 提供各种增强能力 · 提高脚本易维护性 · 支持Web平台自动化脚本开发 [![][maven-central-shield]][maven-central-link] [![][license-shield]][license-link] [![][stars-shield]][stars-link] [![][forks-shield]][forks-link] [![][issues-shield]][issues-link] [📱 下载Demo][demo-download] · [🤖 Assists MCP][assists-mcp-link] · 📜 更新日志 · [📘 开发文档][docs-link] · [🐛 反馈问题][issues-link] · 💬 交流反馈 · 💰 赞助支持 · [⭐ Star支持][stars-link] --- 📖 目录 展开目录 - 📖 目录 - 🎯 适用场景 - 💡 为什么选 Assists - 🌟 基于 Assists 的开发生态 - 🤖 Assists MCP · AI Agent 协作 - 📋 核心能力 - 🎬 功能示例 - 开发文档 - 依赖集成(Maven Central) - 交流反馈 - 💝 支持开源 - ⭐ Star支持 - 💰 赞助支持 - License 🎯 适用场景 基于无障碍与 Assists 生态,可开发各类自动化脚本与辅助工具,例如: - 微信自动抢红包、自动接听电话 - 支付宝蚂蚁森林浇水、芭芭农场施肥与能量收集 - 各平台拓客、引流、营销自动化 - 远程控制与设备协作 上述能力可基于 原生(assists) 或 Web(assistsx-js + AssistsX) 两种方式实现,详见 开发生态。 💡 为什么选 Assists Assists 是整条生态的基础库:基于 Android 无障碍服务封装,提供统一 API 与增强能力,让上层模块与应用专注业务而非底层细节。 - 开发更简单:无障碍能力封装为易用 API,减少样板代码 - 能力可扩展:浮窗、截图、输入法、图像识别、Web 桥接等按需选用 - 脚本易维护:步骤器与模块化设计,便于复用与迭代 - 技术栈灵活:支持原生开发,也支持 HTML + JS/Vue 的 Web 自动化([assistsx-js][assistsx-js-link]) 🌟 基于 Assists 的开发生态 从基础库到运行平台、从 Native 到 Web,一套完整可用的自动化开发生态已围绕 Assists 形成。 无论你偏好原生开发还是 Web 技术栈,都能找到对应模块与示例,快速上手、持续扩展。 | 角色 | 项目 | 说明 | |------|------|------| | 🏠 基础库 | assists | 自动化基础库:无障碍服务封装、能力增强 API、浮窗管理,一切能力的根基。 | | ⌨️ 输入法 | assists-ime | 自定义输入法:在仅能通过输入法触发搜索等场景下,为自动化提供关键能力。 | | 📹 屏幕录制 | assists-mp | 屏幕录制与截图:整屏/节点截图,弥补无障碍无法直接截图的场景。 | | 🖼️ 图像处理 | assists-opcv | 图像处理:集成 OpenCV,模板匹配等能力增强屏幕识别。 | | 🌐 Web 桥接 | assists-web | Web 自动化支持:WebView 原生↔JS 通道,让 Web 端直接调用 Assists 能力。 | | 📱 运行平台 | [AssistsX][assistsx-link] | Web 自动化运行平台及节点分析工具:安装即用,支持插件本地/局域网/在线加载,开启节点分析后可在局域网用浏览器分析页面节点。 | | 🛰️ 远程控制 | [AssistsX][assistsx-link] | 远程控制与远程获取节点信息:下载 [AssistsX][assistsx-link],在 https://admin.assists.cn 注册并登录相同账号即可免费使用,方便远程调试与获取远程设备节点信息适配自动化逻辑。 | | 📜 JS 库 | [assistsx-js][assistsx-js-link] | Web 自动化 JS 库:节点查找、手势、步骤器……用前端技术栈轻松编写与维护自动化。 | | 📂 示例仓库 | [assists-examples][assists-examples-link] | Assists 相关示例项目:包含原生自动化与 Web 端自动化示例,即拿即跑。 | | 📊 日志节点分析 | 日志节点上报分析系统 | 测试人员可提交运行日志与页面节点信息,开发基于上报数据分析页面结构、精准定位多设备/多界面 Bug,解决「无日志、无节点难以复现」的痛点。 | | 🤖 AI 协作 | [Assists MCP][assists-mcp-link] | 凡基于无障碍服务的自动化均可协作;与 AssistsX 搭配可发挥全部潜能(插件创建、逻辑编写、节点分析、Bug 排查)。 | 推荐路径:使用 [assistsx-js][assistsx-js-link] 在 Web 端开发自动化 → 在手机安装 [AssistsX][assistsx-link] 运行插件 → 接入 [Assists MCP][assists-mcp-link] 让 AI Agent 协作开发与排障 → 参考 [assists-examples][assists-examples-link] 学习与扩展。 🤖 Assists MCP · AI Agent 协作 新增 MCP 支持,全面增强 AI Agent 与无障碍自动化的协作能力。 通过 MCP,AI Agent 从辅助工具提升为自动化开发流程中的核心协作者。 接入 Cursor、Claude Code、Codex、OpenCode 等支持 MCP 的 AI 编程助手后,Agent 可全程参与开发与调试:不只是「遥控手机」,而是覆盖基于无障碍服务的自动化——读节点、查文档、写逻辑、查 Bug,让 AI Agent 真正进入自动化落地全流程。 与 [AssistsX][assistsx-link] 协作时,可进一步发挥 MCP 的全部潜能:覆盖插件创建、实现与排障,显著提升效率。 | 能力 | 说明 | |------|------| | 多端 MCP 接入 | 支持 Cursor、Claude Code、Codex、OpenCode 等 MCP 客户端 | | 内置开发文档 | 已内置完整 Assists 原生 API 与 assistsx-js 文档;可直接与 AI 对话检索、查阅,边问边写 | | 无障碍自动化协作 | 凡基于 Android 无障碍服务的自动化,均可读节点、写逻辑、查 Bug | | AssistsX 全潜能 | 与
Top issues
#26有没有什么方法可以获取到当前处于哪个页面2 comments · 2025-11-04#21demo在coloros上无障碍权限灰2 comments · 2025-07-27#30打包好的dist.zip,通过本地加载,一直加载中1 comments · 2025-12-03#25连续截屏java.lang.NullPointerException: it.acquireLatestImage() must not be null1 comments · 2025-10-24#24opencv相关1 comments · 2025-10-20#10大佬 ,flutter插件搞起来1 comments · 2024-08-23#9有计划支持录制功能吗1 comments · 2024-08-21#37# [Bug] assists-web 3.5.7 无法正确处理 AccessibilityEventFilter 的通配配置0 comments · 2026-09-02
Discussions
#39【合作邀请】澳门“云猫 AI”团队寻 Android 无障碍自动化专家 (assists)0 comments · 2026-10-07#18关于APP被杀后无障碍服务关闭问题解决3 comments · 2025-06-06#6讨论区0 comments · 2024-04-28
Latest release
3.5.5 3.5.5 2026-08-10- 修复:修复 web 手势 api 调用传参有误导致崩溃问题 - 优化:协程后台任务异常增加全局兜底处理,不再导致进程崩溃