《胡莱星战》挑战中央太空城

基于ADB与OpenCV的胡莱星战中央太空城挂机脚本

一、开发环境与工具链配置

在开始编写自动化脚本之前，必须先搭建好Python开发环境，并配置好Android调试桥（ADB）和图像处理库OpenCV。本方案采用Python作为开发语言，利用ADB进行设备控制，OpenCV进行图像识别，实现全自动化通关。

1. 安装Python运行环境

请确保你的系统已安装Python 3.8或更高版本。如果尚未安装，请直接访问Python官网下载对应操作系统的安装包。安装过程中，务必勾选"Add Python to PATH"选项，以便在命令行中直接调用Python。

验证安装是否成功，打开终端（CMD或Terminal），输入以下命令：

```bash python --version ```

2. 安装ADB工具包

ADB是连接电脑与Android设备的核心工具。为了方便管理，建议下载独立的Platform Tools工具包。

Windows用户下载地址： https://dl.google.com/android/repository/platform-tools-latest-windows.zip

Mac用户下载地址： https://dl.google.com/android/repository/platform-tools-latest-darwin.zip

下载后解压文件夹，将该文件夹内的路径（如 C:\platform-tools）添加到系统的环境变量Path中。添加完成后，在终端输入以下命令验证：

```bash adb version ```

3. 安装Python依赖库

我们需要安装 opencv-python 用于图像识别，numpy 用于矩阵运算，adb-shell 用于通过Python控制ADB。请在终端执行以下安装命令：

```bash pip install opencv-python numpy adb-shell ```

二、手机端连接与调试配置

环境搭建完毕后，需要将Android设备（手机或模拟器）连接到电脑，并开启USB调试模式。

1. 开启开发者选项与USB调试

在手机设置中，连续点击“版本号”7次开启开发者模式。进入“开发者选项”，找到“USB调试”并开启。如果你使用的是模拟器（如雷电模拟器、夜神模拟器），通常默认已开启或在设置侧边栏中可以直接开启。

2. 建立ADB连接

使用USB线连接手机和电脑，或者在模拟器中查看其ADB端口。在终端输入以下命令检查设备连接状态：

```bash adb devices ```

如果输出列表中显示 device 字样，说明连接成功。如果是网络模拟器，请使用连接命令，例如雷电模拟器默认端口为5555：

```bash adb connect 127.0.0.1:5555 ```

三、核心逻辑实现：图像识别与点击

本脚本的核心逻辑是：通过ADB截取手机屏幕 -> 使用OpenCV在截图中查找目标按钮（如“挑战”、“攻击”） -> 计算坐标 -> 通过ADB执行点击操作。

1. 编写ADB控制类

为了代码复用，我们首先封装一个设备控制类。创建一个名为 auto_bot.py 的文件，并写入以下基础代码：

```python import cv2 import numpy as np import subprocess import time import os class AndroidBot: def __init__(self): self.width = 720 self.height = 1280 def get_screenshot(self): """获取手机屏幕截图并转换为OpenCV图像格式""" 使用adb shell screencap -p 截图并输出到管道 pipe = subprocess.Popen('adb shell screencap -p', stdin=subprocess.PIPE, stdout=subprocess.PIPE, shell=True) image_bytes = pipe.stdout.read().replace(b'\r\n', b'\n') image = cv2.imdecode(np.frombuffer(image_bytes, np.uint8), cv2.IMREAD_COLOR) return image def click(self, x, y): """模拟点击屏幕坐标""" cmd = f'adb shell input tap {x} {y}' os.system(cmd) print(f"点击坐标: ({x}, {y})") ```

2. 实现图像匹配函数

我们需要一个函数来判断屏幕上是否存在某个特定的图片（例如“挑战”按钮的图标）。在 AndroidBot 类中添加以下方法：

```python def find_image(self, template_path, threshold=0.9): """ 在屏幕中查找模板图片 :param template_path: 按钮小图路径 :param threshold: 匹配相似度阈值，0.9表示90%相似 :return: 匹配到的中心坐标 或 None """ screen = self.get_screenshot() template = cv2.imread(template_path) if template is None: print(f"错误：无法读取模板图片 {template_path}") return None 获取模板尺寸 th, tw = template.shape[:2] 执行模板匹配 res = cv2.matchTemplate(screen, template, cv2.TM_CCOEFF_NORMED) min_val, max_val, min_loc, max_loc = cv2.minMaxLoc(res) if max_val >= threshold: 计算中心点坐标 center_x = int(max_loc[0] + tw / 2) center_y = int(max_loc[1] + th / 2) return center_x, center_y return None ```

四、胡莱星战挑战流程封装

有了基础的控制能力，现在我们需要针对“中央太空城”关卡编写具体的业务逻辑。我们需要准备几张关键UI的截图素材，放在脚本同目录下的 images 文件夹中。

1. 准备素材图片

你需要手动截取以下几个界面的局部图片，并保存为PNG格式：

• btn_challenge.png：关卡界面上的“挑战”按钮。
• btn_attack.png：战斗界面的“攻击”或“开始战斗”按钮。
• btn_auto.png：战斗中的“自动”按钮（如果需要开启自动战斗）。
• img_victory.png：战斗胜利界面的特征图标（如“胜利”字样或星星）。
• img_defeat.png：战斗失败界面的特征图标（如“失败”字样）。
• btn_confirm.png：结算界面的“确认”或“领取”按钮。

2. 编写主循环逻辑

在 auto_bot.py 中继续添加主逻辑方法。这个方法将是一个无限循环，不断检测当前状态并执行对应操作。

```python def run_central_space_city(self): print("启动胡莱星战中央太空城自动化脚本...") while True: try: 1. 检测是否在关卡主界面，寻找“挑战”按钮 pos = self.find_image('images/btn_challenge.png') if pos: self.click(pos[0], pos[1]) time.sleep(2) continue 2. 检测是否进入战斗准备界面，寻找“攻击”按钮 pos = self.find_image('images/btn_attack.png') if pos: self.click(pos[0], pos[1]) time.sleep(1.5) continue 3. 战斗中，开启自动战斗（如果未开启） pos = self.find_image('images/btn_auto.png') if pos: self.click(pos[0], pos[1]) time.sleep(1) continue 4. 检测战斗结果：胜利 pos = self.find_image('images/img_victory.png') if pos: print("战斗胜利！等待结算...") time.sleep(2) 胜利后通常点击任意位置或特定按钮，这里假设点击确认 confirm_pos = self.find_image('images/btn_confirm.png') if confirm_pos: self.click(confirm_pos[0], confirm_pos[1]) else: 如果找不到确认按钮，点击屏幕中央尝试跳过 self.click(int(self.width/2), int(self.height/2)) time.sleep(2) continue 5. 检测战斗结果：失败 pos = self.find_image('images/img_defeat.png') if pos: print("战斗失败，重试...") time.sleep(2) 失败后点击重试或返回 retry_pos = self.find_image('images/btn_confirm.png') 假设确认按钮也用于重试 if retry_pos: self.click(retry_pos[0], retry_pos[1]) time.sleep(2) continue 如果都没匹配到，稍作等待避免CPU占用过高 time.sleep(1) except Exception as e: print(f"发生异常: {e}") time.sleep(5) 程序入口 if __name__ == '__main__': bot = AndroidBot() bot.run_central_space_city() ```

五、运行脚本与调试技巧

代码编写完成后，即可进行实际运行测试。

1. 启动脚本

确保手机已解锁并停留在游戏主界面或中央太空城关卡入口。在终端执行：

```bash python auto_bot.py ```

2. 调整匹配阈值

如果脚本运行时无法识别按钮，可能是因为截图与实际画面有细微差异（如分辨率缩放、特效遮挡）。你可以修改 find_image 方法中的 threshold 参数。

默认为0.9（90%相似度）。如果匹配不到，可以尝试降低到0.8或0.75：

```python 例如在查找挑战按钮时降低阈值 pos = self.find_image('images/btn_challenge.png', threshold=0.8) ```

3. 多分辨率适配

上述代码基于模板匹配，因此对分辨率敏感。如果你在分辨率为1920x1080的设备上截取的素材，在720x1280的设备上运行将无法识别。

解决方案：确保脚本运行的设备分辨率与截取素材时的设备分辨率完全一致。如果必须适配多分辨率，需要在获取截图后，使用 cv2.resize 将截图统一缩放到素材所在的分辨率尺寸，再进行匹配。

例如，如果你的素材是基于720p宽度的，而手机是1080p，可以在 get_screenshot 方法返回前添加：

```python 统一缩放到720p宽度进行匹配 scale = 720 / image.shape[1] image = cv2.resize(image, (0, 0), fx=scale, fy=scale) ```

六、防封号与稳定性优化

为了确保账号安全，脚本的行为应尽可能模拟人类操作。

1. 增加随机延迟

机器人的点击间隔非常固定，容易被检测。引入 random 库，让每次点击后的等待时间在一定范围内波动：

```python import random 替换原有的 time.sleep(2) time.sleep(random.uniform(1.5, 2.5)) ```

2. 增加点击偏移

人类无法每次都精准点击像素中心点。在点击坐标上增加微小的随机偏移：

```python def click(self, x, y): 增加正负5像素的随机偏移 offset_x = random.randint(-5, 5) offset_y = random.randint(-5, 5) final_x = x + offset_x final_y = y + offset_y cmd = f'adb shell input tap {final_x} {final_y}' os.system(cmd) ```

通过以上步骤，你已拥有了一套完整的、基于图像识别的《胡莱星战》中央太空城自动化挑战脚本。请确保在游戏允许的规则范围内使用，并合理安排挂机时长。