ven-coder /assists

🔥Android无障碍服务(AccessibilityService)开发框架,Android自动化脚本框架,快速开发复杂自动化任务、远程协助、监听等

★ 999⑂ 238👁 9⑃ 4● 31▤ 27
JavaGPL-3.0Created 2023-07-23
Download: 3.5.53.5.5 ↓3.5.52026-08-10
+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

Discussions

Latest release

3.5.5 3.5.5 2026-08-10
- 修复:修复 web 手势 api 调用传参有误导致崩溃问题
- 优化:协程后台任务异常增加全局兜底处理,不再导致进程崩溃

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON