《TheMindFlayer (无尽冬日) 自动化助手》用户使用手册
欢迎使用 TheMindFlayer 自动化助手！本手册将帮助您快速了解如何配置脚本、各项功能的作用，以及使用过程中的注意事项。请耐心阅读，确保获得最稳定、最高效的挂机体验。
一、 使用前必看的注意事项 ⚠️
为了保证脚本能够正常识别游戏画面和文字，请务必遵守以下基本要求：
1. 分辨率要求：
• ADB模式下模拟器分辨率只能设置为 1080*1920（竖屏）。
2. 运行环境要求：
• 脚本存放路径不能包含中文或特殊字符！ 请将脚本解压放置在纯英文路径下（例如：D:\Games\TheMindFlayer\），否则会导致截图存放、图像识别（OpenCV）路径读取失败。
• 请以管理员权限运行脚本软件，确保能正常点击和截图。
3. 模拟器设置：
• 推荐使用 MuMu模拟器12 或 雷电模拟器（LDPlayer）。
• 其他模拟器可能也支持，但未做充分测试。
• MuMu 用户建议使用模拟器安装目录内的 adb.exe，并关闭会降低性能的低资源占用模式；雷电用户建议同样优先使用安装目录内的 adb.exe。
• 多开同步执行时，如果截图、OCR 或点击明显变慢，优先减少同步设备数、改为顺序执行，并降低 OCR 并发数。
4. 窗口模式：
• 暂未完全适配所有功能，建议优先使用 ADB 模式。
5. 必须依赖库：
• 报错："初始化失败"相关错误时，大概率是缺少运行库，请自行安装：https://aka.ms/vs/17/release/vc_redist.x64.exe
6. OCR并发数优化：
• 脚本会根据您的CPU核心数自动设置合理的OCR并发数（默认为CPU核心数的一半，范围2-8）。
• 如需手动调整，可在CMD命令行执行：set TMF_OCR_MAX_PARALLEL=数字（范围1-16）
• 示例：set TMF_OCR_MAX_PARALLEL=4 设置为4个并发
• 建议：4核CPU使用2-4并发，8核CPU使用4-6并发，16核及以上可尝试8-12并发
二、 核心设置说明 (配置篇) ⚙️
在启动任务前，请先点击左侧导航栏的 [设置]，进行基础环境的配置。配置保存后将会自动记录，下次打开无需重复设置。
1. 连接模式选择
• 窗口模式：通过 Windows 电脑底层 API 截取并点击游戏窗口。优点是不受网络环境影响；缺点是游戏窗口不能被完全遮挡，且必须保持在前台可见（哪怕是屏幕边缘），且功能不完善。
• ADB 模式（强烈推荐）：通过安卓调试桥接协议直接与模拟器内核交互。优点是完全支持后台运行、支持窗口最小化或遮挡，甚至可以直接锁屏挂机；速度更快、更稳定。
2. 窗口 / 设备管理
【窗口模式下】 - 窗口管理：下拉框会列出目前电脑上所有已打开的窗口。 - 选择对应游戏窗口后点击 [+ 添加]，可添加多个窗口进行多开挂机。
【ADB 模式下】
• ADB 路径：请点击"浏览"手动选择模拟器安装目录下的 adb.exe（一般位于安装目录下/MuMuPlayer/nx_main/adb.exe）。
• 添加设备（自动识别）：点击 [刷新设备] 按钮，系统会自动搜索当前启动的模拟器。选择正确的窗口名称（如 MuMu安卓设备-1）的设备并点击 [添加]，如自动识别不到设备请看下条手动添加设备。
• 添加设备（手动添加端口）：在 [端口] 栏中输入设备ADB端口，点击 [连接并添加]。
• ADB端口号查看：打开MuMu [设置中心] ，下滑至ADB端口行，相应设备行的5位端口号。
• 设备性能建议：设备添加后，设备卡片会根据模拟器名称和序列号显示对应的性能建议，例如 MuMu / 雷电的 ADB 路径、分辨率、多开执行方式等。
• 截图定位工具：每个设备卡片提供 [截图定位工具]，可用于取坐标、框选 ROI、保存模板，适合排查点击偏移和模板识别问题。
• 多角色切换：添加 ADB 实例后，展开卡片可开启"多角色切换"功能。你可以在 4 个输入框中填写该账号下的 4 个角色名称。脚本在执行完当前角色任务后，会自动切换到下一个角色继续执行（注意：角色名必须填写准确，用于文字识别切换）。
3. 通用设置
• 执行间隔（分钟）：一轮所有任务执行完毕后，等待多少分钟再开始下一轮。快速循环可设置较短时间（如 10 分钟）。
• 自动重连：开启后，游戏掉线时脚本会自动尝试恢复连接。
• 等待时间（分钟）：遇到掉线需要自动重连时，延迟多少分钟后再进行重试。
• OCR GPU加速：如果您的电脑有独立显卡（NVIDIA/AMD），建议开启以提升OCR识别速度；集成显卡建议关闭。
• 快捷键与托盘：Ctrl+Shift+F8 全局启动/停止任务，Ctrl+Shift+F9 全局显示/隐藏窗口；如果系统热键注册失败，窗口内仍可使用 F8 / F9。系统托盘菜单也可执行启动/停止、显示/隐藏和退出。
• ADB 输入速度：点击、滑动、文本输入会默认优先使用快速 ADB 通道，失败时自动回退到兼容 adb.exe 子进程；如遇到个别模拟器兼容问题，可在启动前设置环境变量 TMF_ADB_INPUT_MODE=adb 强制兼容模式。
4. ADB 多开执行模式 🆕
当添加了多个 ADB 设备时，可以选择：
• 顺序执行：按从上到下的顺序，逐个设备依次执行任务。上一个设备的所有任务执行完毕后，再开始下一个设备。适合对性能要求不高或需要严格顺序的场景。
• 同步执行（并行）：所有设备同时开始执行各自的任务，速度最快。适合多开挂机、快速完成所有账号日常。
注意：同步执行会消耗更多 CPU 和内存资源，请根据电脑配置量力选择。
5. 每设备独立任务配置 🆕
当添加了多个设备后，任务面板顶部会出现设备切换标签页（如"全局"、"设备1"、"设备2"等）。
• 全局配置：在"全局"标签下勾选的任务和配置，会作为所有设备的默认模板。
• 设备独立配置：点击对应设备的标签页，可以为该设备单独设定要执行的任务、各任务的详细参数（如兵种等级、巨兽等级、采集资源等）。设备配置独立于其他设备，互不影响。
• 配置自动保存：切换标签页时，当前设备的配置会自动保存；切回时自动恢复。
使用场景示例：设备1 的大号执行所有任务 + 打巨兽10级；设备2 的小号只做日常 + 打野兽5级。
三、 任务功能详解 (功能篇) 🚀
在 [任务面板] 中，你可以自由勾选你需要自动化执行的任务。 脚本的执行逻辑是：选中任务后，点击 [启动脚本]，系统会按照特定分区的优先级顺序，从上到下依次执行一轮。
📌 基础侧边栏任务
这一区域的任务主要处理游戏内简单的每日红点和日常收取：
• 队列1 / 队列2：尝试自动升级建筑（建筑队列空闲时，此功能只会升级默认建筑）。
• 盾兵 / 矛兵 / 射手：自动在兵营中训练部队，保持造兵不停（点击卡片上 ⚙️ 按钮可配置兵种等级等级1-10，并可选是否启用晋升，勾选晋升时晋升的兵种等级为选择的兵种等级，每个兵种单独配置）。
• 联盟捐献：自动在联盟科技内进行捐献，最大化获取联盟币（此功能只会在联盟捐献红点出现时触发）。
• 联盟互助：自动在联盟中进行互助操作，帮助盟友完成互助请求。
• 科技研究：自动在研究院研究科技（点击 ⚙️ 按钮可设定优先研究方向为：发展 / 经济 / 战斗）。
• 仓库补给 / 晨曦回礼 / 生命之树：自动领取对应的散碎福利（如需领取伐木小屋，请将伐木小屋放置到生命之树附近）。
• 英雄招募：自动进行每日的免费英雄招募。
• 宠物寻宝：自动派遣宠物完成寻宝日常，领取寻宝、联盟奖励。
💎 资源类任务
这个区域的任务属于需要消耗较多时间外派部队或打野的较长流程任务。提示：你可以直接拖动资源任务卡片调整执行顺序，也可以通过任务卡片右侧的 ↑↓ 箭头微调顺序；顺序会随当前设备 Profile 自动保存。
• 联盟宝箱：自动领取联盟成员充值或打野发送的联盟宝箱。
• 情报处理：自动处理灯塔的每日情报（点击 ⚙️ 按钮可配置是否使用体力罐头以及是否使用编队出征以及编队优先顺序）。
• 冰原巨兽：自动在野外搜索并对冰原巨兽发起集结（点击 ⚙️ 按钮深入配置：设定集结时间 5/15/30/60 分钟、巨兽等级 0-10、发车限制次数 0为无限次、是否以及按何种顺序 例如1234 调用预设编队出征、体力不足自动补罐、自定义执行时段以防无人参与集结；未勾选使用编队时将按游戏默认选择进行出征，勾选时程序会检查编队内有无英雄若无英雄会跳过此编队；发车次数每日零点重置）。
• 自动野兽：自动消耗体力在野外搜索并击杀普通野兽（点击 ⚙️ 按钮配置：目标级别 1-30级、打怪限制次数 0为不限次、是否以及按何种顺序调用预设编队出征、体力不足自动补罐）。
• 自动采集：当部队空闲时，自动搜索对应等级的资源点并派遣采集（点击 ⚙️ 按钮配置：最大同时派出队列数 选0为不限队列，即出所有空闲部队、单独指定专注采集生肉/木材/煤矿/铁矿或平分依次采集、以及资源点目标等级 1-8级、是否优先联盟安全区资源、是否单独英雄带队采集、是否使用采集加速）。
• 探险奖励：在探险（挂机收益）中自动收取奖励，默认每执行3轮才会进入收取一次，避免频繁打断。
• 领主指令：自动完成"领主指令"的每日任务清单，帮助领取任务奖励。
• 联盟互助：自动完成联盟互助。
• 礼包兑换：自动领取礼包兑换码，兑换码可在the-mind-flayer\config\exchange_codes.txt进行配置。
⚔️ 定时活动任务
这个区域的任务需要设定触发时间，到达指定时刻时自动触发一次执行：
• 自动跟车：定时触发。
• 定时触发模式（点击 ⚙️ 设置触发时间，如 12:00）：到达设定时间后自动执行跟车任务。
• 开启后，脚本会监控联盟战争频道。当有指定盟友发起巨兽集结或其他活动集结时，会在毫秒级响应并自动派兵上车，保证吃满联盟红利。
• 三种上车模式 车头图片匹配、车头名称文字匹配、随缘上车
[跟车配置（点击 ⚙️ 按钮）]：
> 车头图片匹配
- 手动将游戏置于联盟战争页面，并保证页面中有想要的车头正在集结；点击在游戏中识别并选择车队按钮，程序会自动获取车头名称图片，选择后保存；
> 车头名称文字匹配
- 在文本名称模糊匹配输入框输入想要加入的车头名称，多个名称中间用中文逗号分隔如"天马,King"，支持模糊匹配；
> 随缘上车
- 勾选随缘上车按钮
1. 支持细粒度开启或关闭 1 到 8 单独每一支队伍的自动出征许可。
2. 支持细微指定每一支持许可的编队出征状态为"必须有英雄"带队，或是"可以无英雄随便上"（优化体力最大配置）。
3. 驻留时长为本功能持续运行多长时间，单位为秒。
4. 支持设定定时触发时间（格式
HH:MM），到达时间后会立即执行。
• 竞技场：在设定的时间自动进入竞技场挑战（点击 ⚙️ 设置触发时间，如 21:00）。到达设定时间后，脚本将自动：进入竞技场 → 搜索低战力对手（绿色战力标识）→ 自动挑战 → 重复至挑战次数用完或刷新次数用完。
1. 支持选择钻石刷新
2. 支持配置最大钻石刷新次数
3. 支持配置战力差距值
🛡️ 常驻守备任务
• 自动开罩：开启后，脚本会定期监视画面中的屏幕边缘红框（敌人侦查/攻击警告）。当识别到即将遭受攻击时，自动消耗背包内的护盾道具立刻开启防护罩或召回部队。
该任务为单独线程，会持续检测是否受击
开罩测试较少有问题请及时反馈；召回目前已经比较稳定
1. 支持配置扫描间隔
🧩 特殊任务
• 坐标出征：对指定坐标进行持续出征。
• 宠物洗练：自动进行宠物洗练，所选属性之和大于零时保留洗练否则重新洗练。使用时保证游戏页面在洗练界面。
• 梦境寻忆：自动完成梦境寻忆闯关模式的章节（点击 ⚙️ 按钮可配置闯关参数）。
使用步骤：
1. 将游戏页面置于"点击开始"页面；如果是已经适配完成的章节，脚本会自动点击开始
2. 闯关模式可按需调整点击间隔；需要抢时间时可勾选连续点击
3. 点击启动脚本，脚本自动开始
4. 通过后点击停止脚本，再次将页面置于"点击开始"页面，进行下一关
⚠️ 注意事项：
- 物品位置取自网上攻略，可能存在个别缺少或位置偏移，请及时手动点击以防浪费鱼干
- 连续点击会跳过同一轮目标之间的点击间隔；如出现漏点，可关闭连续点击或适当调大点击间隔
• 起号流程：自动进行起号操作，还未完善。
十、 防风控设置 🛡️
为了降低游戏风控系统检测自动化行为的风险，TheMindFlayer 提供了防风控功能。该功能允许您配置在执行指定轮次任务后自动关闭并重新启动游戏，从而模拟正常玩家的游戏行为模式。
1. 功能说明
防风控功能会在执行完指定轮次的任务后：
1. 自动关闭游戏进程
2. 等待一段时间（确保进程完全终止）
3. 重新启动游戏
4. 等待配置的间隔时间后继续执行任务
这种周期性的重启可以有效降低被游戏风控系统检测为自动化脚本的风险。
2. 配置参数说明
在设置页面的"防风控设置"区域，您可以配置以下参数：
• 启用防风控功能：开关按钮，控制是否启用此功能
• 重启阈值（轮次）：执行多少轮次任务后触发游戏重启（默认值：10 轮次）
• 重启间隔（秒）：游戏重启后等待多长时间再继续执行任务（默认值：300 秒，即 5 分钟）
• 游戏启动 Activity：游戏的启动 Activity 名称（默认值：.MainActivity）
3. 推荐配置值
• 重启阈值：建议设置在 10-20 轮次之间。过于频繁的重启会影响任务执行效率。
• 重启间隔：建议设置在 300-600 秒（5-10 分钟）之间。过短的间隔可能无法达到防风控效果，过长的间隔会降低任务执行效率。
4. 使用示例
假设您配置了以下参数：
• 重启阈值：10 轮次
• 重启间隔：300 秒（5 分钟）
那么脚本会在执行完 10 轮任务后：
1. 自动关闭游戏（执行 adb shell am force-stop com.gof.china）
2. 等待 3 秒确保进程完全终止
3. 重新启动游戏（执行 adb shell am start -n com.gof.china/com.unity3d.player.DDUnityLaunchActivity）
4. 等待 5 分钟后继续执行任务
5. 注意事项
⚠️ 重要提示：
- 仅支持 ADB 模式：此功能仅在 ADB 模式（模拟器）下可用，不支持窗口模式。
- 游戏包名固定：当前版本仅支持《无尽冬日》游戏（包名：com.gof.china）。
- 重启后需要重新登录：游戏重启后可能需要重新登录。您可以在任务脚本中添加自动登录逻辑。
- 影响任务执行效率：过于频繁的重启会降低任务执行效率，请根据实际情况合理配置。
6. 查找游戏启动 Activity
如果默认的 Activity 名称（.MainActivity）无法正常启动游戏，您可以通过以下命令查找正确的 Activity 名称：
adb shell dumpsys activity activities在输出结果中查找游戏的包名（com.gof.china），找到对应的 Activity 名称并填入配置中。
7. 高级用法：重启后状态恢复
如果您需要在游戏重启后自动恢复到任务执行状态（例如自动登录、导航到任务界面），可以在任务脚本中使用回调函数：
def recover_state(automator):
"""重启后恢复游戏状态"""
automator.click_text("登录")
automator.wait_for_text("主界面")
# 添加更多恢复操作...
# 在任务循环中调用
automator.increment_task_round(post_restart_callback=recover_state)回调函数说明：
• 参数：回调函数接收一个参数 automator，即当前的 GameAutomator 实例
• 返回值：无需返回值
• 异常处理：如果回调函数执行失败，脚本会记录错误日志并抛出 CallbackError 异常
• 最佳实践：
• 在回调函数中添加适当的等待时间，确保游戏界面加载完成
• 使用 wait_for_text() 等方法确认界面状态
• 添加异常处理逻辑，避免因单次失败导致整个任务中断
四、 常见问题及使用建议 💡
1. 为什么启动按钮点不了？
• 检查是否至少勾选了一个任务。
• 检查是否在【设置】中添加并启用了至少一个 ADB 设备。
2. 多开模拟器时端口找不到？
• 刷新设备或重启脚本。
3. 点击偏移、乱点、发呆？
• 100% 是因为您的模拟器分辨率不是 1080*1920！请进模拟器设置 -> 显示设置里强制修改为 1080*1920 竖屏分辨率，并重启模拟器。
4. 日志里一直报 OCR 或截图错误？
• 请检查文件路径是否有中文（例如 D:\我的工具\脚本 是错误的，应该改为 D:\tools\script）。
5. 多开同步执行时卡顿？
• 同步执行会并行处理多个模拟器的 OCR 识别和截图，比较消耗 CPU。如果电脑配置较低（低于8G内存/4核CPU），建议：
• 使用"顺序执行"模式
• 减少同时运行的模拟器数量
• 降低OCR并发数（设置环境变量 TMF_OCR_MAX_PARALLEL=2）
• MuMu / 雷电优先使用各自安装目录下的 adb.exe
• 如果点击或滑动兼容性异常，可设置 TMF_ADB_INPUT_MODE=adb 改用兼容输入模式
6. 设备独立配置没有生效？
• 请确认是否在对应设备的标签页下进行了配置。在"全局"标签页下修改的配置只会作为新设备的初始模板，不会自动覆盖已存在的设备配置。
7. 如何优化OCR性能？
• 开启GPU加速（如果有独立显卡）
• 根据CPU核心数调整并发数：4核用2-4并发，8核用4-6并发
• 使用顺序执行模式而非同步执行（降低CPU压力）
8. 停止任务为什么现在更快？
• 截图重试、点击间隔和通用等待都会响应停止事件。点击 停止任务、托盘停止或快捷键停止后，程序会尽量在当前 ADB/OCR 调用结束后的最短时间内退出。
9. 快捷键没有反应怎么办？
• 全局热键依赖系统允许程序注册键盘监听，若被安全软件或权限限制拦截，请切回窗口内使用 F8 / F9，或通过系统托盘菜单启动/停止。
祝您挂机愉快，资源爆仓！有任何其他疑问或建议可反馈给作者。