wechat_jump_game：3 步跑通微信跳一跳的 Python 辅助教程

【免费下载链接】wechat_jump_game微信《跳一跳》Python 辅助项目地址: https://gitcode.com/gh_mirrors/we/wechat_jump_game

wechat_jump_game 是一个用来自动化微信小游戏「跳一跳」的 Python 辅助项目：它通过 ADB 截取手机屏幕，用图像识别找到小人与下一块的距离，换算出需要的按压时长，再模拟长按完成跳跃。适合想练习图像识别和 ADB 自动化的开发者，或者单纯想折腾这个 2017 年经典项目的同学。

它到底在干什么

先搞懂整体链路，后面改配置时才知道该往哪儿下手。整个跳跃循环只有 5 步：

1. 截图：调用adb shell screencap获取手机当前画面，存盘或直接读入内存；
2. 找起点：逐像素扫描，按固定的 RGB 色值区间定位小人的位置；
3. 找终点：在分数下方区域扫描，靠底色与方块的色差找出下一块顶面；
4. 换算按压时长：计算两点距离，乘以press_coefficient等系数得到长按毫秒数；
5. 触发跳跃：发送adb shell input swipe x y x y time(ms)，小人完成一跳。

wechat_jump_auto.py 就是这条链路的完整实现；另有精简版 wechat_jump_auto_slim.py（只取 x 轴距离，适配任意屏幕）和 AI 校准版 wechat_jump_auto_ai.py。

从零跑起来的三个动作

准备一台安卓手机并打开 USB 调试（iOS 需要 WebDriverAgent，是另一套流程，见 jump_bot/README.rst）。

动作一：拿到代码

git clone https://gitcode.com/gh_mirrors/we/wechat_jump_game cd wechat_jump_game

跑通标志：目录里能看到common/、config/和若干wechat_jump_auto*.py脚本。

动作二：装依赖

pip install -r requirements.txt

注意：requirements.txt里锁了较老的版本（如 numpy 1.13.3），新 Python 环境容易装失败；跑安卓精简版只装Pillow就够，其余可按需补。

跑通标志：python -c "import PIL"无任何报错。

动作三：连上手机首次运行

adb devices python wechat_jump_auto_slim.py

运行前确认手机已进入「跳一跳」并开始游戏，小人站在棋块上。

跑通标志：控制台先打印Capture Method: 2，随后出现Times: 1和Distance: xx.xx% | Press: xxxms，手机里能看到小人真的跳起来了。

按你的环境改哪里

配置文件是程序自动加载的 JSON，加载顺序写在 common/config.py：先看脚本同目录的.json，再看config/{分辨率}/config.json，都没有就用config/default.json。仓库里已备好按分辨率和华为、小米、三星、iPhone 等品牌的示例（config/下各目录），挑一个复制过来改：

只有在小人经常跳空或跳短时才需要动这些值。

容易翻车的几个点 ⚠️

• 启动就退出，提示“请安装 ADB 及驱动并配置环境变量”：系统里找不到 adb。把 adb 加入 PATH；Windows 用户可参考仓库自带的Tools/目录。
• 输出“未找到设备”：USB 调试没开，或部分机型“USB 调试（安全模式）”没开，见 changelog.md 中的记录。
• 小人不动或总是跳近：press_coefficient不匹配你的机型，先换config/里同分辨率的配置文件，再微调。
• 输出piece_fuzzy: 0,0：截图不在游戏画面里（停在主页）。重新开始一局游戏再运行。

另外 README.md 明确提到微信检测较严，防 ban 手段可能已失效，建议把它当学习项目用。

想继续深入的可以看：颜色识别与距离换算在 wechat_jump_auto.py，ADB 封装在 common/auto_adb.py。

【免费下载链接】wechat_jump_game微信《跳一跳》Python 辅助项目地址: https://gitcode.com/gh_mirrors/we/wechat_jump_game