System-Level Android Engine

Yyds.Auto系统级别的安卓自动化平台

开源免费绿色开箱即用

Yyds.Auto 把脚本运行时、文字识别、控件树、操作录制与 APK 打包整合在同一套引擎里。手机上写 Python,桌面端投屏调试,一键推送到真机运行。有 ROOT 用 ROOT,没有就用 SHELL,同一套脚本不用改。

九大核心能力

从识别、操控到录制与打包分发,覆盖安卓自动化的完整流程。

ROOT / SHELL 双模

引擎可按 ROOT 或 SHELL 两种权限模式运行,按设备条件选择即可,适配不同的机型与部署环境。

三进程守护

yyds.keep 持续巡检自动化引擎与脚本运行时,任一环节退出即刻拉起,长时间挂机也能稳定运行。

精准触控

点击、滑动、长按一次调用完成,脚本里写 click、swipe、long_press,也支持中文别名 点击、滑动、长按。

本地文字识别

手机端直接调用 ocr() 识别屏幕文字,支持中文别名 文字识别,识别结果可直接用于判断与点击。

文本输入

input_text 一行完成输入,也支持中文别名 输入文字,无需额外对接输入法协议。

脚本加密

打包时可为脚本加密,源码不在设备上以明文留存,对外交付更安心。

打包与分发

调试阶段点「推送并启动」直接跑真机,确认无误后再一键打包成独立 APK 分发安装。

控件树匹配

ui_match 按控件属性精准定位元素,也支持中文别名 控件匹配,不依赖写死坐标,换机型同样稳定命中。

操作录制

手动操作一遍即可自动导出可直接运行的 Python 脚本,函数名规范统一,省掉从零编写的时间。

核心引擎

Android App装进手机的 Python 引擎

内置 CPython 3.13 运行时,脚本在手机本地直接执行,不依赖电脑常驻。三个进程各司其职、互相守护,函数名支持英文与中文别名,写起来更快。

内置 CPython 3.13,手机上直接运行 Python 脚本
三进程互相巡检守护,引擎或脚本异常自动恢复
支持脚本加密打包,源码不以明文留存
悬浮日志:print() 与 console.show() 实时可见
Android App 主界面

桌面端 SDK

电脑上的 Python 包,和编辑器里的 MCP

在电脑上 pip 安装 yyds-auto 即可批量编排设备;配合 MCP Server,还能让 Cursor、Codex 这类 AI 编辑器直接读屏操控真机。

yyds-auto (PyPI)

# PC 端 SDK:在电脑上操控已连接的设备

pip install yyds-auto

import yyds_auto

d = yyds_auto.connect()

d(text="一键启动").click()

  • 连接设备后即可用 Python 直接调用点击、识别等能力。
  • 多设备并行:用 yctl 指定序列号逐台编排,无需手动转发端口。

MCP Server 集成

一行安装 npx -y yyds-auto-mcp,即可在支持 MCP 的编辑器里读取屏幕、操控设备。完整配置与提示词示例见「AI 开发」。

MCP 插件使用
查看 AI 开发指南
脚本 IDE

YY畅控脚本 IDE
写完点推送并启动

在桌面端编写脚本、智能补全、投屏调试,写完点「推送并启动」,脚本立刻在真机上跑起来。改完再推,不必反复打包安装。

  • ✓ 投屏调试:真机画面实时同步,边看边改
  • ✓ 开发助手一键插入 click、ocr、ui_match 等常用调用
  • ✓ 本地热更新:改完直接推送运行,无需重新打包
查阅开发文档
main.py - Yyds.Auto Project
from yyds_auto import *

open_app("com.android.settings")
if wait_and_click_text("设置", timeout=10):
toast("已点击")
else:
toast("没找到文字")

三进程守护架构
keep · auto · py

守护进程持续巡检自动化引擎与脚本运行时,任何一环异常退出都会被自动拉起,长时间挂机也稳定可靠。

CPython 3.13
内置 Python 运行时
ROOT / SHELL
两种权限模式
3
keep · auto · py 三进程
自动拉起
进程退出后自愈恢复

控制台

设备群控管理面板

实时屏幕流、批量操作、定时任务。从一台测试机到一整批设备,用的是同一套控制台。

群控管理控制台
设备详情

设备详情面板

低延迟实时屏幕与键鼠触控,设备状态一屏掌握

在线IDE

Web IDE 调试端

在浏览器里编写 Python,批量下发到多台设备运行

配套环境

需要 ROOT?用刀盾环境

Yyds.Auto 的引擎在 ROOT 下能拿到全部能力。刷环境这一步交给刀盾环境 —— 新一代自研安卓 ROOT 环境,和我们是同一个用户群。

免重启 · 免变砖

动态注入,不用重启系统,刷机风险归零。

多设备同时刷入

电脑端批量刷入,不用再逐台操作。

自带 XP 框架

开箱即用,不需要再到论坛拼装模块。

进一步沟通

添加开发者微信,获取技术支持或咨询企业定制方案

微信二维码

wjzy_yyds

扫码添加,备注「Yyds.Auto」

Yyds.Auto Core

STABLE // v1.0.11

主要下载渠道

123 云盘下载全部安装包

桌面控制台、Android 运行时、MCP 插件与 Python SDK 都在这一份分享里。

网盘下载

桌面控制台

YY 畅控 · 桌面控制台

YY-Changkong_x64-setup.exe

57.72 MB

Windows 桌面控制中心,可管理多台 Android 设备、投屏、执行 AI 自动化任务。

双击安装程序,按提示完成安装即可。

立即下载

自动化 SDK 组件

Yyds.Auto · Android 运行时

Yyds.Auto_129_1.0.11_release.apk

46.65 MB

Android 端自动化运行时,安装后可接受 PC 端指令执行 RPA 任务。

电脑上用 yctl install <文件名>。不要 adb install。也可以把安装包发到手机后点开安装。

立即下载

MCP 服务端插件

yyds-auto-mcp-1.0.8.tgz

0.09 MB

为 Cursor / Codex / Claude Desktop 等 MCP 客户端提供 Android 设备控制工具集。接入步骤见「AI 开发」。

日常用 npx -y yyds-auto-mcp。离线包才 npm install -g ./<文件名>。配置见「AI 开发」。不要手写 adb forward。

立即下载

Python SDK · Wheel 包

yyds_auto-1.0.8-py3-none-any.whl

0.06 MB

Yyds.Auto Python 库,提供完整的设备控制 API,适合在脚本中 import 使用。

pip install <文件名>。这是电脑上的库:import yyds_auto。手机脚本不要装这个包。

立即下载

Python SDK · 源码包

yyds_auto-1.0.8.tar.gz

0.05 MB

Yyds.Auto Python 库源码归档,适合需要查看源码或在离线环境安装。

pip install <文件名>。这是电脑上的库,不要装进手机工程。

立即下载