wow/打包与使用说明.md

WoW_MultiTool 打包与使用说明

一、如何打包成 exe

环境要求

• Windows 系统
• 已安装 Python 3.8+（建议 3.11）
• 已安装项目依赖

步骤

1. 安装依赖（若尚未安装）
   在项目目录 wow 下打开终端，执行：

   pip install -r requirements.txt
   

2. 执行打包
   任选一种方式：

   方式 A：使用脚本（推荐）

   .\build_exe.ps1
   

   方式 B：手动命令（等价于脚本）

   pyinstaller --noconfirm build_wow_multikey.spec
   

3. 获取 exe
   打包完成后，可执行文件位于：

   项目目录\dist\WoW_MultiTool.exe
   

打包配置说明

WoW_MultiTool（集成 GUI）

• 主入口：wow_multikey_gui.py
• 输出：WoW_MultiTool.exe
• 无控制台窗口，纯 GUI 程序
• 运行所需数据：
  • dist\recorder\*.json（巡逻点/修理商/其他路线）
  • dist\game_state_config.json（状态监控截图参数）

打包后的目录结构

脚本会在打包完成后，把项目目录下的 recorder\ 整个复制到 dist\recorder\，方便直接运行：

dist\
  WoW_MultiTool.exe
  game_state_config.json
  recorder\
    waypoints.json
    vendor.json
    其他*.json

---

二、如何使用 exe

运行前准备

1. 启动游戏
   先运行并进入《魔兽世界》，确保游戏窗口标题包含「魔兽世界」。

2. 准备 recorder 文件
   巡逻/修理商等路线 JSON 统一放在 dist\recorder\（或项目目录的 recorder\）下。

启动程序

• 双击 WoW_MultiTool.exe，或在终端中执行：

  .\WoW_MultiTool.exe
  

运行中

• GUI 会显示当前状态（血量、法力、战斗、目标、背包、耐久、坐标等），并可一键启动对应模式。

停止程序

• 点击「停止」按钮，或直接关闭窗口。

配置文件说明

文件	说明
dist\\recorder\\*.json	巡逻点/修理商/其他路线文件（下拉选择）
game_state_config.json	状态监控截图参数（适配不同分辨率）

说明：巡逻模式的文件选择 只能选择 recorder 文件夹下的 json，并且在界面里用下拉框选择。

---

三、WoW 多功能控制器（集成 GUI）

WoW 多功能控制器集成了以下功能：

功能	说明
多键控制	定时向魔兽窗口发送按键（空格、1–5），防掉线、自动跳跃
状态监控	实时显示血量、法力、战斗、目标、坐标等
巡逻打怪	按 waypoints.json 巡逻，自动寻怪、战斗、拾取、跑尸、回城
自动打怪	原地寻怪、战斗、拾取（不巡逻）
巡逻点录制	在游戏内跑动时自动记录坐标点，保存到 waypoints.json

运行方式

方式 A：直接运行 Python 脚本

python wow_multikey_gui.py

方式 B：运行打包后的 exe

.\build_exe.ps1
# 然后运行 dist\WoW_MultiTool.exe

使用说明

1. 先启动魔兽世界，确保窗口标题为「魔兽世界」或「World of Warcraft」。
2. 打开 WoW 多功能控制器，点击「刷新窗口」绑定游戏窗口。
3. 多键控制：勾选按键、设置间隔，点击「启动多键」。
4. 状态监控：选择「状态监控」→ 可在下方调整多分辨率参数 → 点击「保存配置」写入 game_state_config.json。
5. 巡逻打怪：选择「巡逻打怪」→ 下方会出现配置区 → 从下拉框选择 recorder\ 下的巡逻点 JSON 和修理商 JSON → 点击「启动」。
6. 自动打怪：选择「自动打怪」→ 点击「启动」。
7. 巡逻点录制：在「巡逻点录制」Tab 输入名称 → 开始/停止 → 保存后会写入 recorder\名称.json。
8. 多键配置保存到 wow_multikey_qt.json。

---

四、常见问题

Q：打包时报错找不到某模块？
A：先执行 pip install -r requirements.txt，确保所有依赖已安装后再执行 pyinstaller --noconfirm build_wow_multikey.spec。

Q：如何把 exe 拷到别的电脑用？
A：复制整个 dist\ 文件夹即可（包含 WoW_MultiTool.exe、recorder\、game_state_config.json）。目标电脑无需安装 Python。

Q：杀毒软件报毒？
A：PyInstaller 打包的 exe 可能被部分杀毒软件误报，可添加信任或排除该 exe 所在目录。

Q：多键控制器找不到游戏窗口？
A：确保游戏窗口标题包含「魔兽世界」或「World of Warcraft」；若使用英文客户端，窗口标题为 "World of Warcraft"。