oneDragon

一个基于 ADB + OpenCV 模板匹配 + Tkinter GUI 的自动化脚本项目。

运行环境

• Python 3.10+
• ADB（Android Debug Bridge）
• 模拟器或 Android 设备
• OpenCV
• Tkinter（通常随标准 Python 安装提供）

安装

python -m venv .venv
# Windows
.venv\Scripts\activate
# Linux / macOS
source .venv/bin/activate

pip install -r requirements.txt

ADB 路径解析优先级

项目现在支持自动解析 ADB，优先级如下：

1. 环境变量 ADB_PATH
2. 配置文件中的 adb_path
3. 系统 PATH 中的 adb

推荐做法

Windows PowerShell

$env:ADB_PATH = "D:/leidian/LDPlayer9/adb.exe"
$env:ADB_DEVICE = "127.0.0.1:5555"
python main.py

Windows CMD

set ADB_PATH=D:/leidian/LDPlayer9/adb.exe
set ADB_DEVICE=127.0.0.1:5555
python main.py

Linux / macOS

export ADB_PATH=$(which adb)
export ADB_DEVICE=127.0.0.1:5555
python main.py

ADB_DEVICE 是可选项。若未设置，则回退到各个 JSON 配置中的 device。

启动方式

GUI 模式

python main.py

单角色日常流水线

python run_daily_pipeline.py

多角色流水线

python run_multirole_pipeline.py

项目结构

oneDragon-main/
├─ configs/                  # 各模块 JSON 配置
├─ templates/                # 模板图目录
├─ screenshots/              # 运行期截图输出
├─ fake_dungeon.py           # 核心自动化执行器
├─ run_daily_pipeline.py     # 单角色日常流水线
├─ run_multirole_pipeline.py # 多角色流水线
├─ worker_thread.py          # GUI 后台线程
├─ main_Gui.py               # Tkinter GUI
└─ main.py                   # 程序入口

配置说明

每个配置文件通常包含：

• adb_path: adb 路径（现在可被 ADB_PATH 覆盖）
• device: 设备序列号（可被 ADB_DEVICE 覆盖）
• templates_dir: 模板目录
• macros: 可复用宏步骤
• tasks: 任务列表

ROI 说明

roi 支持绝对坐标或比例坐标。比例模式下坐标范围为 0.0 ~ 1.0。

• 图像上半部：[0.0, 0.0, 1.0, 0.5]
• 图像下半部：[0.0, 0.5, 1.0, 1.0]
• 左上象限：[0.0, 0.0, 0.5, 0.5]
• 右上象限：[0.5, 0.0, 1.0, 0.5]
• 左下象限：[0.0, 0.5, 0.5, 1.0]
• 右下象限：[0.5, 0.5, 1.0, 1.0]

第二阶段已完成的改动

• 支持 ADB_PATH / ADB_DEVICE 环境变量覆盖配置
• 支持从系统 PATH 自动发现 adb
• 补充 requirements.txt
• 补充项目 README.md，降低迁移和接手成本