注意事项

系统与客户端

仅支持 Windows x64（Windows 10 及以上）。
正式服（Midnight）与怀旧服都支持。游戏内置的「辅助作战」技能推荐仅正式服有，怀旧服想要技能推荐需自己编写属性逻辑或借助 Hekili 插件。多客户端并存时，插件会装到当前按键目标所在的客户端，请用它进游戏。
内置识别 Wow.exe（正式服）、WowClassic.exe（怀旧服）与 WowB.exe（测试版），无需配置；其他 exe 名不会被识别。
首次安装或更新模块后，需要在游戏内输入 /reload 让插件加载最新内容；主窗口状态栏出现「模块已更新…按 F12」时，按 F12 即可重载。
游戏内插件的名称可在设置里自定义。改名后第一次需要完全退出并重启游戏客户端——仅 /reload 可能加载不全。

采集与异常排查

设置中的采集模式决定读取哪一份画面：

按窗口：读取游戏窗口自己的画面，其他窗口遮挡不会直接进入采样。最小化或游戏不再渲染时可能没有新帧；改变窗口大小后客户端会重新校准并恢复采集。
按屏幕：读取桌面上游戏所在区域，条带被其他窗口遮挡时会影响识别。窗口采集不可用的远程会话或虚拟显示环境可尝试此模式。
自动：优先按窗口；该路径确实不可用时才回落屏幕，短暂没有新帧不切换来源。

若状态反复在成功和失败之间切换，先记下采集模式，确认游戏没有最小化、条带未被遮挡，以及游戏分辨率与显示比例符合识别要求。若刚保存或更新模块，等待插件安装完成后再 /reload；加载尚未完成时不应重建空白模块来“修复”状态。

自动保存诊断

在系统设置开启「调试：自动保存异常诊断」，复现问题。
打开该选项提示中的目录。异常发生时会锁存状态与已有游戏原图，后台最多每秒写一份，轮转保留最近 10 份；恢复后仍会保存已排队的异常，队列满时跳过新样本。
将相关 dump-… 目录完整打包，附上版本号、采集模式、是否调整过游戏窗口及大致发生时间。排查完关闭此选项。

每份包含状态和错误原因 state.json、近期日志 recent.log，以及可用时的游戏原图 frame.bmp。没有新图时可能使用标明来源与年龄的最近游戏截图；尚未取得游戏画面时会记录缺图原因，不会补截 WA1 面板。瞬时异常会尽早记录，但不能保证队列已满或游戏没有出帧时仍捕获到对应图片。

账号与安全

单账号单会话：同一账号在新设备登录后，原设备会被立即踢下线（宏随之停止）。
忘记密码：在 Discord 社区联系我们重置即可，云端模块不受影响。
封号风险：任何自动化循环都违反暴雪用户协议，风险始终存在，请自行判断。WA1 不注入、不读内存、按人的节奏发键，但这不等于被允许。
自有模块加密后同步到云端。可编辑模块可导出为可读的 .wa1 文件；市场与兑换模块的导出、克隆权限取决于来源，兑换模块始终只读。

更新

启动时发现新版本会先自动更新再进入；运行期间也会提前下载并校验新版本，进度显示在主小条上，下次启动即为最新版，无需手动下载。
如需禁用自动更新，在程序目录放一个 noupgrade.txt 空文件即可。

关于「受保护值」

正式服（Midnight）把部分战斗相关的数值（如单位血量、光环时间）对插件设为「受保护值」，不能直接参与运算。这对普通使用没有影响；但如果你要自己写模块的自定义代码，必须遵守相应的写法，详见决策脚本与运行环境。