改之前先看这九件事
数字和路径以代码为准。不要把下面的句子当成另一份实现。
ROOT 或 SHELL
引擎以 ROOT 或 SHELL 跑。App 进程 uid 大于 10000，不能直接写 /data/local/tmp。
三个进程
yyds.keep 巡检 yyds.auto 和 yyds.py。间隔在 keeper.cpp：AUTO_CHECK_PERIOD_MS 是 400，PY_CHECK_PERIOD_MS 是 200，单位毫秒。
触控
实现在 uiautomator/input。脚本里写 click、swipe、long_press。中文别名 点击、滑动、长按。
文字识别
手机上调用 ocr()。中文别名 文字识别。改到电脑识别时看 yyds-desktop/docs/umi-ocr.md。
输入文字
脚本里用 input_text。中文别名 输入文字。函数表在 API.md，不要另写一套输入法协议。
脚本加密
只改 ScriptEncryptor.kt 和 script_crypto.c。不要按层数在别的文件重写。
打包 APK
这是分发。第一次运行在脚本 IDE 点「推送并启动」，不是先打包。
控件树
脚本里用 ui_match。中文别名 控件匹配。导出实现在 uiautomator，不要在页面上猜字段。
操作录制
导出的是手机 main.py：from yyds_auto import *，函数名是 click、swipe、long_press。生成逻辑在 TouchRecorder.exportPython。中文别名也可以调用。
核心引擎
Android App三个进程，英文函数名
内置 CPython 3.13。进程是 yyds.keep、yyds.auto、yyds.py。手机脚本函数名用英文，中文别名也可以调用。打包 APK 是分发，第一次运行先点「推送并启动」。
android-app-home.png
电脑脚本
电脑上的 Python 包，和编辑器里的 MCP
电脑上用 pip 装 yyds-auto。手机脚本不要装这个包。编辑器里控设备看「AI 开发」，日常操控用 yctl。
yyds-auto (PyPI)
# 只在电脑上跑，不要写进手机 main.py
pip install yyds-auto
import yyds_auto
d = yyds_auto.connect()
d(text="一键启动").click()
- 上面是电脑库。手机工程不要 pip install，也不要写 d.click()。
- 多台设备用 yctl -s 序列号，不要手写 adb forward。
MCP Server 集成
安装命令是 npx -y yyds-auto-mcp。环境变量 YYDS_DEVICE_HOST=127.0.0.1、YYDS_DEVICE_PORT=61140。日常操控用 yctl -s 序列号。步骤在「AI 开发」。
mcp-in-action.png
YY畅控脚本 IDE
写完点推送并启动
在桌面端写脚本、补全、投屏调试，然后在脚本 IDE 点「推送并启动」。手机上的 main.py 第一行是 from yyds_auto import *，函数名用 click、ocr。中文别名也可以调用。
- ✓ 投屏视频端口 1264，控制端口 1265。常量在 stream/constants.rs
- ✓ 开发助手插入 click、ocr、ui_match。中文别名也可以调用
- ✓ 本地热更默认复制 adb reverse tcp:8765 tcp:8765
from yyds_auto import *
open_app("com.android.settings")
if wait_and_click_text("设置", timeout=10):
toast("已点击")
else:
toast("没找到文字")
三个进程
yyds.keep / auto / py
守护进程在 yyds-android/app/src/main/jni/keeper.cpp。巡检间隔是 AUTO_CHECK_PERIOD_MS（400）和 PY_CHECK_PERIOD_MS（200），单位毫秒。自动化引擎端口 49009，Python 引擎端口 61140。
控制台
设备群控管理面板
实时屏幕流、批量操作、定时任务。能带多少台以机器和带宽为准，不要写死设备数量。
console-dashboard.png missing
设备详情面板
提供超低延迟的 WebRTC 实时屏幕与键鼠触控支持
Web IDE 调试端
随时随地通过浏览器编写 Python 并下发到百台终端
进一步沟通
添加开发者微信，获取技术支持或咨询企业定制方案
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 <文件名>。这是电脑上的库，不要装进手机工程。