旧手机别吃灰:我用 WPF + ADB + OCR 做了个多设备自动化工具,已开源

一句话读懂:旧手机别吃灰:用 C# + WPF + ADB + OCR 做一个多设备自动化工具,一台电脑管理多台安卓,自动刷视频、看广告、签到,并支持实时投屏,已开源。

📱 01 起因:旧手机、金币任务和重复劳动

家里抽屉里躺着几台淘汰的安卓手机。卖不上价,扔了可惜,于是被装上了几个刷视频、看广告、签到领金币的 App。

问题很快就来了:这些任务本身不复杂,但必须人盯着。打开 App、滑几下、看到「开宝箱」点一下、广告倒计时结束点关闭、再回到任务页签个到。一台手机一轮下来要几分钟,几台手机轮流切,半小时就没了。更麻烦的是,你很难判断它到底卡在哪一步——是没识别到按钮,还是 App 弹了个新活动。

我想要的其实不复杂:

  • 一台电脑同时管理多台手机,每台独立启动、停止;
  • 自动识别当前页面,按页面状态决定点哪里、滑多长;
  • 每台设备可以设置不同的间隔、随机暂停和重复次数;
  • 出错时能看到日志,必要时还能直接看一眼手机画面;
  • 不 Root、不装 Xposed、不改 App。

于是有了这个项目:安卓自动刷视频辅助工具,C# + WPF + ADB + OCR,MIT 协议,已经开源。

项目地址:https://github.com/lixiaoliyubo/automatically-swipe-coins(GitHub) / https://gitee.com/lixiaoliyubo/automatically-swipe-coins(Gitee)

先说清楚边界:它只适合在自己的设备上做自动化学习与研究,不适合商业牟利、批量养号;OCR 识别存在误点可能,不建议完全无人值守。这些风险后面单独用一节讲。

🖥️ 02 它长什么样:一屏管住多台设备

主界面是典型的「列表 + 详情 + 操作 + 日志」布局:

主界面:设备列表、设备详情、任务参数与实时日志

左侧是 ADB 设备列表,显示设备 ID、名称、连接状态和最后检查时间;下面一行是当前设备详情,能看到当前前台应用、屏幕分辨率和最近一次 OCR 识别结果。

右侧是每台设备的任务参数:

  • 选择平台:抖音、快手、番茄、红果、支付宝等;
  • 选择页面:金币首页、看广告、开宝箱、签到等起始状态;
  • 间隔时间:分 + 秒;
  • 随机暂停:在一个区间内随机等待,避免机械地固定频率;
  • 重复次数:0 表示不限制。

底部是日志面板,可以看全局日志,也可以只看某台设备。关键异常除了写日志,还会用系统语音播报一遍——晚上不盯着屏幕,也能知道哪台设备掉线了。

工具栏里有「刷新设备」「清理所有」「所有日志」和「投屏」。投屏的使用方式是:先在列表里选中一台设备,再点「投屏」,程序会为这台设备打开 scrcpy 实时画面。

🏗️ 03 架构:WPF 只做壳,能力都在服务层

项目是标准的 MVVM + 依赖注入,没有把 ADB 调用塞进 ViewModel:

层 负责 不负责
Views / ViewModels 设备列表、参数绑定、命令转发、日志展示 不直接调 ADB、不写平台流程
DeviceService 设备发现、截图、当前应用、清理、投屏 不知道某个 App 的页面长什么样
AdWatching 每个平台的页面识别与任务分支 不关心 UI 和调度
AdWatchingFactory 按 PlatformType 创建流程实例 不持有业务状态

架构分层:MVVM、设备服务、平台流程与基础设施

平台流程用了一个很朴素的策略模式:PlatformType 枚举上挂 AppPackage 特性保存包名,AdWatchingFactory 用 switch 创建对应的 AdWatching 实例;所有流程继承 AdWatchingBase,复用点击、滑动、启动 App、返回键和 OCR 这些公共能力。

新增一个平台,理论上只需要两步:写一个继承 AdWatchingBase 的类,再在工厂里加一行映射。主界面和设备服务都不用动。

基础设施也全部通过 DI 注册为单例:日志(NLog)、内存缓存、SQLite(SqlSugar)、TTS、WebSocket。它们各自只做一件事,设备之间靠序列号隔离状态。

🔌 04 设备通信:ADB 截图比想象中更直接

设备通信基于 AdvancedSharpAdbClient。发现设备、读取型号、取屏幕尺寸、查当前前台应用,都是普通的 ADB 命令:

var adbDevices = _adbClient.GetDevices();

var device = new DeviceData { Serial = deviceId };
var receiver = new ConsoleOutputReceiver();
_adbClient.ExecuteRemoteCommand("getprop ro.product.model", device, receiver);
_adbClient.ExecuteRemoteCommand("wm size", device, receiver);
_adbClient.ExecuteRemoteCommand("dumpsys window | grep mCurrentFocus", device, receiver);

截图走的是 framebuffer,不需要在手机端装任何辅助 App:

using Framebuffer? framebuffer = await _adbClient.GetFrameBufferAsync(
    new DeviceData { Serial = device.Id }, CancellationToken.None);

byte[]? imageBytes = framebuffer?.Data?.Length > 0
    ? framebuffer.ToBitmapAsync()
    : null;

拿到图像字节后,直接交给 OCR。这条链路的好处是通用:不管目标 App 是用原生控件、Flutter 还是 WebView 画的,只要能截到屏,就能识别。

代价也很明确:截图和识别都有开销,不适合做高频操作;framebuffer 数据偶尔会拿到空帧或异常数据,必须判空、判长度,并在 finally 里及时释放。

🔍 05 OCR + 状态机:不碰 App 私有接口

项目没有逆向任何 App 的接口,也没有 Hook。它只做一件事:看屏幕上的字,决定下一步点哪里。

OCR 用的是 PaddleOCRSharp,懒加载单例,第一次用到时才初始化:

var oCRParameter = new OCRParameter
{
    cpu_math_library_num_threads = 20,
    enable_mkldnn = true,
    cls = false,
    det = true,
    use_angle_cls = false,
    det_db_score_mode = true
};
_ocrEngine = new PaddleOCREngine(null, oCRParameter);

识别结果既参与判断,也会写回 DeviceModel.LastOcrResult,直接显示在设备详情里。这一点在排错时非常有用:流程卡住时,你至少能看到「它到底认出了什么」。

页面状态用 AppPageEnum 描述:金币首页、看广告、开宝箱、签到、看直播、逛街得金币……每个平台流程根据关键词匹配当前状态,再决定点击或滑动。

自动化闭环:截图、识别、判断、动作、等待

这里必须承认一个现实:OCR 方案怕改版。App 换一句文案、调一次布局,关键词就可能失配。所以它更适合「固定几个 App、规则相对稳定」的窄场景,而不是做成一个通用的 RPA 平台。规则越窄,识别越稳。

⚙️ 06 多设备调度:每台设备一套取消令牌

多设备最怕的是「一台卡死,全部遭殃」。项目里的做法很直接:每台设备一个 CancellationTokenSource,放在以设备序列号为键的字典里。

private readonly Dictionary<string, CancellationTokenSource> _deviceTasks;

public void StartDeviceCheck(DeviceModel device, string screenshotSaveDir)
{
    var cts = new CancellationTokenSource();
    _deviceTasks[device.Id] = cts;

    // 状态观察任务:每 2 秒读取当前前台应用
    Task.Run(async () => { /* ... */ }, cts.Token);

    // 平台流程任务:执行完整的刷视频 / 看广告 / 打卡流程
    Task.Run(async () =>
    {
        var adWatching = _adWatchingFactory.Create(device.CurPlatform);
        await adWatching.AutomateAdWatching(device, cts.Token);
    }, cts.Token);
}

点「停止」时只 Cancel 对应设备的那一套令牌,其他设备继续跑。设备断开时,刷新逻辑会把它从列表移除,同时停止它的任务。

多设备调度:独立取消令牌、夜间检测与零点清理

除了按设备调度,还有三层全局兜底:

  1. 30 秒刷新设备列表:重新枚举 ADB 设备,处理掉线与新接入;
  2. 夜间设备检测:0 点到 8 点,每 10 秒检查一次未运行设备,连续异常 30 次后尝试重新启动;
  3. 每日零点清理:停止任务、清理设备后台应用与日志,再按原状态恢复。

这里也要说清楚:这是单进程并发,不是调度集群。设备越多,OCR 的 CPU 和内存压力越大,实际使用建议从 2~3 台开始,稳定后再加。

📺 07 投屏:最后选了 scrcpy

自动化跑起来之后,还是会有「想看一眼」的时刻:广告卡住了、页面弹了活动、识别结果很奇怪。这时候远程投屏比截图刷新直观得多。

选型上没有纠结:scrcpy。开源、免 Root、延迟低、支持键鼠控制,正好符合需求。程序本身不实现解码和渲染,只负责按设备序列号拉起 scrcpy 进程:

var startInfo = new ProcessStartInfo
{
    FileName = scrcpyPath,
    Arguments = $"-s \"{deviceId}\"",
    WorkingDirectory = Path.GetDirectoryName(scrcpyPath)!,
    UseShellExecute = false,
    CreateNoWindow = true
};
Process.Start(startInfo);

scrcpy.exe 的查找顺序做了兼容:

  1. 程序目录下的 scrcpy\scrcpy.exe;
  2. 程序目录下的 scrcpy.exe;
  3. 向上最多 5 级目录里的 scrcpy\scrcpy.exe(开发时从 bin/Debug/net8.0-windows 往上就能找到仓库根目录的 scrcpy);
  4. 系统 PATH。

这样开发环境、发布目录和自行安装的 scrcpy 都能覆盖。找不到时不会静默失败,而是在日志里明确写「未找到 scrcpy.exe」。

在交互上,一开始考虑过设备列表右键菜单,最后改成了工具栏按钮 + 当前选中行:

  • 右键菜单是隐藏入口,新用户不一定发现;
  • 工具栏按钮始终可见,配合选中行,操作路径更短;
  • 也不会出现「右键点到了另一行」的误操作。

投屏:左侧 scrcpy 实时画面,右侧主程序继续管理设备

投屏窗口是独立进程,关掉它不影响自动化任务;同一台设备重复点击会打开多个窗口,这是当前版本的已知行为。

🕳️ 08 踩过的坑

1. OCR 引擎的内存异常。 PaddleOCRSharp 在极端情况下会抛 AccessViolationException,普通 catch (Exception) 接不住。处理方式是在识别处单独捕获,记录日志后强制 GC,并让引擎保持懒加载、全局只初始化一次。

2. framebuffer 拿到空数据。 设备锁屏、画面剧烈变化或 ADB 抖动时,可能拿到空帧。代码里对 Data 和 Length 都做了判断,finally 中释放引用并建议 GC,避免大对象堆积。

3. 后台线程更新 UI。 设备列表和日志都绑定在 UI 线程上,后台任务直接改集合会抛异常。所有集合更新统一走 Application.Current.Dispatcher.Invoke,WebSocket 设备列表还做了增量更新,避免整表重刷。

4. 平台改版导致关键词漂移。 这是 OCR 方案的固有成本。App 更新后,原本能识别的「开宝箱」变成了「去开启」,流程就会卡住。除了及时改关键词,没有更优雅的通用解法。

5. scrcpy 的 adb 版本。 scrcpy 自带 adb,和系统里的 adb 版本不一致时可能提示版本不匹配。通常 scrcpy 会重启 adb 服务,稍等重试即可;反复失败时,统一使用同一份 adb.exe 最稳。

6. 设备多了以后资源吃紧。 每台设备都在跑截图 + OCR,CPU 和内存会线性上涨。控制并发数量,比盲目加设备更实际。

⚠️ 09 边界与风险:能自动,但不能无人值守

这个项目能帮你省掉重复点击,但它不是「挂机赚钱机器」。使用前请认真评估:

  • 误操作风险:OCR 会认错字,坐标点击也可能点偏。误点可能触发关注、分享、下单、开通会员甚至支付。请关闭免密支付、解绑大额支付方式,不要在有支付能力的账号上长期无人值守。
  • 设备与调试风险:开启 USB 调试后,电脑对手机拥有较高控制权限。不要连接陌生电脑或使用来源不明的数据线;投屏会把手机画面实时显示在电脑上,注意周围环境与隐私。
  • 数据风险:日志、截图和 SQLite 数据库都保存在程序运行目录,可能包含页面文字、账号昵称等信息。分享日志或提 Issue 前先清理。
  • 合规风险:请遵守所在地法律法规和目标平台规则,不要用于商业牟利、批量养号、数据爬取等用途。

建议使用专用测试设备和测试账号,不要在主力机上直接跑。程序提供了「停止」按钮和日志,但「能停下来」仍然需要人来判断。

🚀 10 怎么跑起来

环境要求:

  • Windows 10 / 11(x64);
  • .NET 8 SDK;
  • 安卓设备开启「开发者选项 → USB 调试」;
  • adb 在 PATH 中,或直接使用仓库里 scrcpy/adb.exe 所在目录;
  • 投屏功能需要 scrcpy.exe,仓库已自带 scrcpy/ 目录。

克隆、构建、运行:

git clone https://gitee.com/lixiaoliyubo/automatically-swipe-coins.git
cd automatically-swipe-coins

dotnet restore
dotnet build TimerCheckApp/TimerCheckApp.csproj -c Release
dotnet run --project TimerCheckApp/TimerCheckApp.csproj

运行前先确认设备连接:

adb devices

状态应为 device,而不是 unauthorized 或 offline。首次连接时,记得在手机上确认 USB 调试授权。

程序运行时会在目录下自动创建:

Logs\          按天写入的日志
Screenshots\   截图目录
Database\      SQLite 数据库

这些目录不纳入版本控制,也不会把任何账号密码写进仓库。

🌱 11 最后:开源之后

这个项目最初只是为了解决自己的重复劳动,写到最后,反而变成了一个挺完整的工程练习:ADB 设备管理、framebuffer 截图、OCR 识别、页面状态机、多设备取消令牌、scrcpy 进程调用、WPF 数据绑定和日志告警,几乎每一块都能单独拿出来讲。

它不完美:OCR 怕改版、设备多了吃资源、投屏会开多个窗口,这些都是真实存在的限制。但对我来说,它已经把一个「每天都要手动做、又一直很烦」的流程,变成了一个可以启动、观察、随时停止的桌面工具。

项目已按 MIT 协议开源:

如果它刚好对你有用,点个 Star 就是最大的鼓励;遇到问题或者想补充新的平台流程,欢迎提 Issue 或 PR。

再次提醒:请仅在自有设备上用于学习与研究,遵守平台规则,注意账号与支付安全。


posted @ 2026-11-19 12:00  源动力技术栈  阅读(27)  评论(0)    收藏  举报