基于Android无障碍服务（AccessibilityService）封装的自动化开发框架
简化自动化脚本开发 · 提供各种增强能力 · 提高脚本易维护性 · 支持Web平台自动化脚本开发
📱 下载Demo · 🤖 Assists MCP · 📜 更新日志 · 📘 开发文档 · 🐛 反馈问题 · 💬 交流反馈 · 💰 赞助支持 · ⭐ Star支持
展开目录
基于无障碍与 Assists 生态，可开发各类自动化脚本与辅助工具，例如：
- 微信自动抢红包、自动接听电话
- 支付宝蚂蚁森林浇水、芭芭农场施肥与能量收集
- 各平台拓客、引流、营销自动化
- 远程控制与设备协作
上述能力可基于 原生（assists） 或 Web（assistsx-js + AssistsX） 两种方式实现，详见 开发生态。
Assists 是整条生态的基础库：基于 Android 无障碍服务封装，提供统一 API 与增强能力，让上层模块与应用专注业务而非底层细节。
- 开发更简单：无障碍能力封装为易用 API，减少样板代码
- 能力可扩展：浮窗、截图、输入法、图像识别、Web 桥接等按需选用
- 脚本易维护：步骤器与模块化设计，便于复用与迭代
- 技术栈灵活：支持原生开发，也支持 HTML + JS/Vue 的 Web 自动化（assistsx-js）
从基础库到运行平台、从 Native 到 Web，一套完整可用的自动化开发生态已围绕 Assists 形成。
无论你偏好原生开发还是 Web 技术栈，都能找到对应模块与示例，快速上手、持续扩展。
| 角色 | 项目 | 说明 |
|---|---|---|
| 🏠 基础库 | assists | 自动化基础库：无障碍服务封装、能力增强 API、浮窗管理，一切能力的根基。 |
| ⌨️ 输入法 | assists-ime | 自定义输入法：在仅能通过输入法触发搜索等场景下，为自动化提供关键能力。 |
| 📹 屏幕录制 | assists-mp | 屏幕录制与截图：整屏/节点截图，弥补无障碍无法直接截图的场景。 |
| 🖼️ 图像处理 | assists-opcv | 图像处理：集成 OpenCV，模板匹配等能力增强屏幕识别。 |
| 🌐 Web 桥接 | assists-web | Web 自动化支持：WebView 原生↔JS 通道，让 Web 端直接调用 Assists 能力。 |
| 📱 运行平台 | AssistsX | Web 自动化运行平台及节点分析工具：安装即用，支持插件本地/局域网/在线加载，开启节点分析后可在局域网用浏览器分析页面节点。 |
| 📜 JS 库 | assistsx-js | Web 自动化 JS 库：节点查找、手势、步骤器……用前端技术栈轻松编写与维护自动化。 |
| 📂 示例仓库 | assists-examples | Assists 相关示例项目：包含原生自动化与 Web 端自动化示例，即拿即跑。 |
| 📊 日志节点分析 | 日志节点上报分析系统 | 测试人员可提交运行日志与页面节点信息，开发基于上报数据分析页面结构、精准定位多设备/多界面 Bug，解决「无日志、无节点难以复现」的痛点。 |
| 🤖 AI 协作 | Assists MCP | 凡基于无障碍服务的自动化均可协作；与 AssistsX 搭配可发挥全部潜能（插件创建、逻辑编写、节点分析、Bug 排查）。 |
推荐路径：使用 assistsx-js 在 Web 端开发自动化 → 在手机安装 AssistsX 运行插件 → 接入 Assists MCP 让 AI Agent 协作开发与排障 → 参考 assists-examples 学习与扩展。
新增 MCP 支持，全面增强 AI Agent 与无障碍自动化的协作能力。
通过 MCP，AI Agent 从辅助工具提升为自动化开发流程中的核心协作者。
接入 Cursor、Claude Code、Codex、OpenCode 等支持 MCP 的 AI 编程助手后，Agent 可全程参与开发与调试：不只是「遥控手机」，而是覆盖基于无障碍服务的自动化——读节点、查文档、写逻辑、查 Bug，让 AI Agent 真正进入自动化落地全流程。
与 AssistsX 协作时，可进一步发挥 MCP 的全部潜能：覆盖插件创建、实现与排障，显著提升效率。
| 能力 | 说明 |
|---|---|
| 多端 MCP 接入 | 支持 Cursor、Claude Code、Codex、OpenCode 等 MCP 客户端 |
| 内置开发文档 | 已内置完整 Assists 原生 API 与 assistsx-js 文档；可直接与 AI 对话检索、查阅，边问边写 |
| 无障碍自动化协作 | 凡基于 Android 无障碍服务的自动化，均可读节点、写逻辑、查 Bug |
| AssistsX 全潜能 | 与 AssistsX 搭配时，支持插件创建、逻辑编写、调试与异常排查 |
| 节点读取与分析 | 原生无障碍服务节点读取与逻辑分析 |
| 异常与 Bug 排查 | 运行异常分析与问题定位 |
详细介绍及配置教程 → https://assists.cn/mcp
| 能力 | 说明 |
|---|---|
| 无障碍 API | 节点查找、点击、输入、滚动等，接口简洁易用 |
| 浮窗管理 | 浮窗的添加/删除/显示/隐藏/缩放/移动，快速实现悬浮控制 |
| 步骤器 | 可复用、易维护的自动化步骤框架与编排 |
| 屏幕与截图 | 整屏截图、指定节点区域截图（assists-mp） |
| 图像识别 | 结合 OpenCV 的模板匹配等，辅助屏幕内容识别（assists-opcv） |
| Web 自动化 | WebView 桥接，HTML + JS/Vue 开发脚本，对应 assistsx-js |
Demo 覆盖基础操作、高级自动化（收能量、发朋友圈、接听电话等）、截图与浮窗等。
强烈建议：通过 Assists MCP 在 Cursor、Claude Code 等 AI 助手中直接对话查阅开发文档。
MCP 已内置完整开发文档（含 Assists 原生 API 与 assistsx-js），检索与阅读比翻网页更高效，也更利于边问边写代码。
在线文档（飞书）：打开文档
当前推荐版本：3.5.4
repositories {
mavenCentral()
}
dependencies {
// 核心库（必选）
implementation "io.github.ven-coder:assists-base:3.5.4"
// 按需引入，版本号与上相同
// implementation "io.github.ven-coder:assists-web:3.5.4"
// implementation "io.github.ven-coder:assists-mp:3.5.4"
// implementation "io.github.ven-coder:assists-log:3.5.4"
// implementation "io.github.ven-coder:assists-ime:3.5.4"
// implementation "io.github.ven-coder:assists-opcv:3.5.4"
}| 模块 | artifactId |
|---|---|
| assists | assists-base |
| assists-web | assists-web |
| assists-mp | assists-mp |
| assists-log | assists-log |
| assists-ime | assists-ime |
| assists-opcv | assists-opcv |
迁移说明：3.5.3 起官方仓库为 Maven Central（
io.github.ven-coder）。旧版 JitPack 坐标com.github.ven-coder.assists:*仍可用于历史版本，新项目请使用上表坐标。模块说明见 开发文档。
各版本新增与变更见仓库根目录 更新日志。
请移步至在线文档
有问题欢迎反馈交流
| QQ交流群 | 微信群 | 作者微信 |
|---|---|---|
 |
 |
 |
微信群二维码过期请加作者邀请加入
开源不易，您的支持是我坚持的动力！
如果Assists框架对您的项目有帮助，可以通过以下方式支持我喔：
- 给项目点个Star，让更多开发者发现这个框架
- 分享给身边的朋友和同事
- 爱发电支持 - 您的每一份支持都是我们前进的动力
- 一杯Coffee的微信赞赏
感谢所有的支持者，得到你们的支持我将会更加完善开源库的能力！ 🚀
GNU General Public License v3.0
Copyright © 2025 ven-coder