汽水音乐看广告领VIP自动点击器 v1.6.1 便携版（ADB+OpenCV，免环境依赖

软件测试

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

汽水音乐看广告领VIP自动点击器 v1.5.0 便携版（ADB+OpenCV，免环境依赖）

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【软件名称】：汽水音乐看广告领VIP自动点击器（便携版）

【软件版本】：v1.6.1（基于开源项目 soda-water 二次优化）

【软件大小】：71.3 MB（ZIP 附件）

【适用平台】：Windows 10 / Windows 11（免安装 Python、免配置 ADB，双击即用）

【测试设备】：小米10青春版（Android 10，分辨率 1080×1920，USB 调试已开启）

【技术栈】：Python 3.12 + OpenCV 模板匹配 + ADB

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

一、前言与致谢（必看）

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

本工具的灵感来源是 GitHub 上 Onyx-404-Not-Found 大佬的开源项目 soda-water，在此特别感谢原作者的无私开源！

原项目地址：https://github.com/Onyx-404-Not-Found/soda-water

本帖发布的版本并非完全原创，而是在原作者代码基础上，针对实际使用中踩到的坑做了多轮"训练优化"和迭代修复，主要方向是：识别精度、运行稳定性、防误点、免环境便携化。特此说明，向原作者致敬，也欢迎各位坛友一起交流优化思路。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

二、软件简介

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

汽水音乐 App 有"看广告免费领 VIP 时长"的官方活动，手动看广告费时费力。本工具通过 ADB 截屏 + OpenCV 模板匹配，自动完成整个广告观看流程：

等广告播完 → 自动点"×"关闭 → 自动点"继续观看/领取奖励" → 自动进入下一个广告

核心特性：

三阶段状态机引擎：Phase1 等广告结束"×"按钮 → Phase2 等领取奖励 → Phase3 等再看一个，循环往复

Web UI 控制台：浏览器打开 http://localhost:8765，一键开始/暂停/停止，实时查看运行日志和循环统计

多模板变体识别：同一按钮支持多种 UI 样式（如绿色/红色两种"继续观看"按钮）

ROI 区域限定匹配：只在按钮可能出现区域搜索，速度快且大幅降低误匹配

App 前台安全网：每次点击后自动检测前台 App，误跳到其他 App 时自动返回并恢复流程

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

三、在原作者基础上的优化迭代过程（本帖重点）

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

原版脚本能跑，但实际挂机时会遇到各种"智障"时刻。下面按时间线分享每一轮问题的定位和修复思路，希望能给做屏幕自动化/模板匹配的坛友一些参考。

▶ 第 1 轮：性能优化（响应太慢，错过弹窗）

问题：单轮检测 4 个模板耗时 490ms，加上 ADB 截屏 590ms，轮询周期长达 1.1~2.7 秒，而"继续观看"弹窗只显示 1-2 秒，经常错过。

优化：给每个模板限定 ROI 搜索区域（如"×"按钮只搜右上角 y<200 区域），模板匹配从 490ms 降到 216ms；轮询间隔 2.0s 压到 0.4s，点击后延迟 1.5s 压到 0.3s。

&#9654; 第 2 轮：多模板变体机制（根治误点跳转）

问题：广告播放器里会出现和"继续观看"长得像的绿色 CTA 按钮（"立即下载/立即观看"），原模板误匹配后脚本点了它，直接跳到淘宝直播 App，流程中断。

优化：放弃"通用绿色胶囊"单一模板，改为多模板变体机制——continue_watch 挂载两个变体（绿色按钮版 + 红色金币按钮版），每个模板都精确居中裁切在按钮本身，匹配阈值提到 0.80，ROI 限定 y=1000-1600 排除底部推广区。取多变体中置信度最高者。修复后 100% 不再误点。

&#9654; 第 3 轮：App 前台检测 + 自动恢复安全网（防跑飞）

新增三层防护：

get_foreground_app()：解析 dumpsys window 输出拿到前台包名（注意小米 Android 10 没有 mCurrentFocus 字段，要用 topApp 字段，这是个坑）

is_in_soda_music()：白名单判断（汽水音乐本体 + 字节 ExcitingVideoActivity 广告组件都算安全）

recover_to_soda_music()：误入外部 App 时先连按 3 次 BACK，无效则强停错误 App 并重新拉起汽水音乐

每次模拟点击后 0.3 秒自动校验，一旦跑飞立即自动恢复，恢复失败则自动暂停脚本防止误操作。

&#9654; 第 4 轮：阶段盲区修复（明明有"×"却不动）

问题：Phase2/Phase3 的等待循环里只检查自己的目标模板，不检查 ad_finished。当新广告的"领取成功 ×"在这些阶段出现时，脚本要傻等 30 秒超时才处理。

优化：两个阶段的循环体开头都补上 ad_finished 检测，命中立即点击并让主循环重启。单周期从 ~30 秒缩短到 ~9 秒。

&#9654; 第 5 轮：用历史截图做"离线训练"（精度提升）

把运行期间积累的 586 张命中截图当训练集回放验证，发现了隐藏的竞态漏洞：claim_reward 模板在"继续观看"弹窗上误匹配高达 0.881（真实按钮在 y=787，误匹配点在 y=640），一直靠检测顺序侥幸避开。

优化：ROI 从 (100,600,1000,1500) 收紧到 (100,720,1000,1150)，误匹配降到 0.355（安全区），真实命中 13/13 全保留。这种"攒截图→离线回放→调 ROI"的闭环很适合模板匹配类项目的持续调优。

&#9654; 第 6 轮：疑难 bug 修复

空包名误判：dumpsys 偶发返回空字符串，被当成"误入其他 App"触发 BACK×3 把广告退掉 → 改为无法判断时不折腾（宁可不动作也不误动作）

截图堆积：异常路径跳过了清理逻辑，498 张 200MB → 提前返回前也执行自动轮换清理

&#9654; 第 7 轮：便携版打包（本帖附件）

内嵌 Python 3.12.10 embeddable + opencv-python-headless + numpy + ADB，目标机器零依赖

坑1：embeddable 的 ._pth 隔离模式会忽略 PYTHONPATH → 在 python312._pth 里写相对路径 ..\app 解决

坑2：OpenCV 的 imread/imwrite 不支持中文路径（目录名含"汽水音乐"就挂）→ 全部改用 np.frombuffer + cv2.imdecode 读、cv2.imencode + 文件写入

坑3：ADB 自动发现逻辑加了"程序目录"检测，便携版 adb.exe 放 app 目录下自动生效

双击 run.bat 自动启动并打开控制台，Win10/Win11 亲测通过

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

四、使用说明

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

准备工作（手机端，仅需一次）：

安卓手机开启"开发者选项"和"USB 调试"

用 USB 数据线连接电脑，手机上弹出授权提示时点允许

运行步骤：

解压附件 ZIP 到任意目录（建议英文路径，虽然已支持中文，但求稳）

双击 run.bat，会自动启动服务并打开浏览器控制台（http://localhost:8765）

手机打开汽水音乐，进入"看广告免费听"页面

控制台显示"设备已连接"后，点"开始"即可，之后全自动循环

注意事项：

模板图片是按 1080×1920 分辨率截取的，其他分辨率手机需要重新截模板（templates 目录下替换即可，帖子里附了教程思路）

部分杀软可能对内嵌的 adb.exe / Python 报可疑（无签名），放行即可

建议手机插着电并用"充电时屏幕常亮"设置，避免锁屏中断

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

五、亲测截图

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

▲ Web UI 控制台：设备检测、模板加载状态、实时日志、循环统计

                    

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

六、附件成品

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

26.9.12 13:07  已更新 v1.6.1

https://wwato.lanzoue.com/b0139yucbc

希望大家不做白嫖党，赠人玫瑰手余余香

免费评分走一走

目前稳定版本：

v1.6.1

v1.5.0

v1.3.5

闲聊

大家的各种反馈我都看到了，但是更新需要时间，需要多次进行调试，

现在通过自主学习的私人定制化，会大幅提高命中率，如果反馈良好，将不再更新版本。此贴将终结。除非有好点子等之类的。

最后  感谢大家捧场，来参与到这个“训练”当中来，感谢！

版本更新：

v1.6.1 更新内容

------------------------------------

全新自主学习模型升级

解决各个手机因为分辨率问题导致的失误率高的问题，

新增：领金币模式，可在看广告领金币模式下刷金币

v1.5.0 更新内容

------------------------------------

-全新版本支持小米/真我/华为等真机实测

-添加对直播广告模板进行自动退出

-修复多个BUG

-鸿蒙 USB 调试说明

-右侧 USB 面板

v1.4.8 更新内容

------------------------------------

修复核心 bug（论坛用户"yf992151915"反馈,澎湃OS3 / 小米13 实测）

v1.4 更新内容

------------------------------------

- 新增：USB 调试状态检测。Web 控制台"设备"卡片新增独立状态行：

- 优化："截取模板"按钮改名为"截图模板"；点开后弹窗里的英文模板名

  "模板"卡片也同步中文

v1.3.5 更新内容

------------------------------------

- 国际化：Web 控制台所有按钮 / 标签 / 提示全部改为中文

控制台与日志输出全面中文化

- 优化：暂停按钮在运行/暂停两种状态下自动切换"暂停"/"继续"文案

v1.3 更新内容

------------------------------------

- 优化：launcher 不再显示数字菜单，打开即直接启动 Web 控制台

  （如需旧菜单，源码版可运行 python launcher.py --menu）

- 修复：run.bat 改为 GBK 编码，解决中文 Windows 控制台

  出现 "xx 不是内部或外部命令" 乱码报错的问题

- 修复：run.bat 增加文件缺失自检，缺文件时给出明确中文原因

------------------------------------

v1.2.5 更新内容

------------------------------------

- 修复：缺失文件报错修复

v1.2

- 修复：补齐遗漏的 index.html（旧包打开报 "index.html not found"）

- 新增：多分辨率自适应 — 模板和检测区域按手机实际屏幕宽度自动

  等比缩放（720p / 1080p / 1440p 等分辨率均可直接使用，无需重做模板）

- 新增：版本号显示（控制台标题与 /api/status 中）

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

七、免责声明

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

本工具仅供 ADB 自动化与 OpenCV 模板匹配技术的学习交流，请勿用于任何商业用途

本工具不修改、不破解任何软件，仅模拟人工点击官方界面按钮；请遵守相关 App 用户协议

请于下载学习后 24 小时内删除，喜欢的音乐请支持正版

使用本工具产生的一切后果由使用者自行承担，与原作者 soda-water 及本帖发帖人无关

再次感谢 GitHub 原作者 Onyx-404-Not-Found 的开源奉献，没有他的项目就没有本帖的优化实践。也欢迎坛友回帖交流模板匹配、防误点、状态机设计等方面的心得，共同进步！

野渡的猫

效果好不好很看业务理解，纯技术视角容易跑偏。

南山铺子

准确率到九成之后每提升一个点都要付出成倍代价。

流浪铺子

演示效果和稳定上线之间差着十万八千里。

半夏不眠

评估标准不统一的话，各家都说自己效果好，没法比。

茶白隔壁老王

开源方案胜在可控，闭源胜在省事，取舍看团队能力。你们的延迟和成本大概什么水平？

长夏旧巷

这种场景其实更依赖工程化，模型只是其中一环。有对比过同类的其他方案吗？

闲云看海

冷启动阶段最难，没有历史数据就没法做效果对比。

清和记事

从我们实际用下来看，最大的收益是省了重复劳动而不是替代人。

一叶林间

最容易被忽略的是评估环节，没有好的评测集根本没法优化。