基于图像检测识别信息+最小堆调度器自动调度任务 （不涉及任何读取和修改游戏内存数据！）

• Alas（前端样式）
• Mower-ng（任务执行流程和场景跳转）
• DroidCastRaw
• EmulatorExtras
• MiniDevice

• 支持主流模拟器分辨率
  • 2560x1440
  • 1920x1080
  • 1600x900（开发所用分辨率，准确度最好）
  • 1280x720
• 可视化自定义键位
• 可视化选择模拟器端口（串口）

• 排行榜点赞
• 每月签到

  支持自动补签

• 购买体力

  购买体力，并执行消耗体力任务，支持自定义次数；可用任务参数「购买后消耗体力」关闭联动
  需要填写二级密码，以及保证有足够金币

• 金币招财

  支持自定义次数
  需要填写二级密码，以及保证有足够金币

• 小队突袭

  自定义收取四倍次数
  需要填写二级密码，以及保证有足够金币

• 组织祈福

  祈福并领取昨日奖励，适配超影/普通玩家

• 好友体力

  领取好友赠礼体力，并执行消耗体力任务

• 普通忍者招募
• 每日分享

  需要模拟器安装QQ/微信

• 丰饶之间

  适配超影/普通玩家
  需设置键位

• 任务集会所

  每一个小时检查任务，收取已完成的任务并接取能接的任务，收益暂未最大化

• 一乐外卖

  11点自动收取体力，并执行消耗体力任务（可用任务参数「领取后消耗体力」关闭联动）

• 每日胜场

  自动刷胜场直到今日所有宝箱领取完成，支持自定义个人键位，支持自动追回宝箱
  需要关闭“只匹配玩家”，需设置键位

• 生存挑战

  自动扫荡/重置，建议战力足够扫荡到15关的开启，否则收益不如手打

• 秘境探险

  不停刷烈炎/罡体/水牢秘境，直到用完所有探险券
  需要战力大于700-800W左右，可以自己启用测试一下

• 商城奖励

  每天15000铜币的蚊子腿，抠门魔方还要玩家自己点

• 情报站 100 活跃度

  自动完成情报站的活跃任务并领取活跃度奖励，由于这个小程序经常出现BUG，诸如：

  I.福利站加载空白
  II.情报站首页点击其他页跳转时无反应
  III.领取活跃度的时候，已领取的活跃度任务仍然显示待领取，并且点击显示重复领取
  IV.转盘抽取奖励时不停下，只能重启游戏

  因此开启此任务须自行承担小概率任务卡死的可能，需要手操解决

• 冒险副本

  自动扫荡上次扫荡的副本，如果未扫荡则会全选

• 活跃度奖励

  收取所有已到达的活跃度

• 积分赛奖励

  收取积分赛每日的奖励

• 清空邮件

  一键提取邮件
  需要在设置里设置好哪些物品（如体力/饰品/忍具）不被一键收取

• 每周胜场

  自动刷胜场直到周胜满，自动领取周胜奖励
  需要关闭“只匹配玩家”，需设置键位

• 更多玩法

  自动刷绝迹战场/大蛇丸试炼至满积分，自动领取奖励
  当本周的更多玩法任务是【团队集结战】的时候将自动跳过

• 忍法帖点赞分享

  自动给忍法帖排行榜点赞并分享
  需要模拟器安装QQ/微信

• 修行之路

  自动扫荡/重置修行之路，适配超影/普通玩家

• 团本

• 天地战场

  到点自动进入战场，可选天战/低战，自动上柱
  可设置结束后是否打叛忍，以及提前结束任务去打叛忍

• 要塞争夺战

  【本服要塞战】
  自选任意要塞刷取积分
  可设置结束后是否打叛忍，以及提前结束任务去打叛忍
  需设置键位

  【跨服要塞战】
  尚待适配

• 叛忍来袭

  在【天地战场】/【要塞争夺战】对应任务配置中启用后，将在对应任务结束时激活该任务
  有超影将自动参战，没有的将自动寻路挑战叛忍，需要战力起码能过普通模式简单叛忍
  对于组织首领/高层，提供自动开启叛忍功能

• 跨服争霸
• 巅峰对决
• 赛季胜场

  自动刷胜场直到赛季胜场满
  需要关闭“只匹配玩家”，需要自己领取奖励

• 消耗体力

  下午5点之前每50体力执行一次，5点时执行最后一次，留体力给第二天扫荡精英副本

  I.装备合成

  需要设置合成的目标部位

  II.精英副本扫荡

  自动扫荡上次扫荡的副本，如果未扫荡则会全选

• 高级忍者招募

  每两天自动招募一次高级忍者招募
  初始状态下会每10分钟尝试一次高级招募给程序校时，属于正常现象

• 纲手的挑战
• 天天爱美食
• 药草大冒险
• 钓鱼大会
• 冬日烟花季
• 无差别预选赛

  可选自己打2次胜场后程序刷满7场/自己打6次胜场后程序刷满30场

• 配置隔离（一个配置对应一个账号，可管理不同账号日常进度）
• 多开（上限与个人电脑性能挂勾，目前见过最高4开使用）
• 自动更新（使用Github托管，请保证自己的网络可以连接到Github）
• 免覆盖更新配置

安装/更新时请确保自己的电脑网络可以连接到Github！！！ 安装路径选在非C盘位置

这是正在下载环境/拉取主分支代码，首次约700-800MB，请耐心等待
如果超过10分钟未完成，请使用加速器/科学上网后再重新安装

这是安装完环境拉取本项目Github主分支代码失败导致的
优先检查网络配置问题，看能否连接到Github，并使用 Steam++/UU加速器等进行加速
如有必要使用科学上网后（开发者不提供任何科学上网的方法）再安装一次本应用

如果依旧失败，最终解决方法如下：

访问 v17 分支代码压缩包 ，下载并解压到安装目录下即可

开发者没法帮助别人修复无法连接Github的问题
注意：需要在安装/更新前启用加速，不能在安装程序/程序本体启动之后再启用

参考I.Q2

将软件卸载后安装到除C盘以外的其他位置
如果是电脑熟练者可以尝试给自己的账户提权，获得常态管理员权限即可

将Windows的深色主题模式改成浅色模式，请等待开发者迁移前端代码并上线主题功能后一并解决该问题

分辨率设置成 1600x900(推荐)或者 1920x1080 必须是16:9比例
关闭 后台保活，以及非前台锁帧
不要设置过于极限的性能配置（最好 2 核心 2048 MB以上）

优先选择 MiniTouch，如果异常可以使用 U2

首先，可以使用设置的 串口选择，会自动列出可用的adb设备
注意：MuMu模拟器的设备使用 adb devices可能无法列出，此时需要自己填写，操作如下：

打开你安装火影忍者的那个模拟器，点进设置的 设备诊断往下翻，找到端口号，格式为 5xxx 16xxx左侧5xxx代表串口号 emulator-5xxx ，右侧16xxx代表串口号 127.0.0.1:16xxx

举例:
你模拟器给出的端口号为 5554，16384
那么你要么填写 emulator-5554，要么填写 127.0.0.1:16384，填写别的都会导致连接失败
PS：MuMu显示端口号和扫描出来的端口不一致的时候，以扫描出来的为准

其中xxx是动态分配的，请按照自己的情况填写
U2模式最好使用 127.0.0.1:16xxx的格式填写,此为模拟器通用格式
MiniTouch模式最好使用 emulator-5xxx的格式填写

目前不支持，该模拟器似乎没有提供ADB调试的方法

控制模式依旧 MiniTouch，截图模式选择 DroidCast或者 U2(推荐)，串口填写和普通版一样

按照模拟器多开中给出的顺序填写
比如MuMu的模拟器索引在模拟器列表缩略图的左上角 #0，#1，#2就是它的实例索引
雷电模拟器也在多开的模拟器列表中模拟器信息的最左侧一列可以找到

MuMu模拟器，填写最顶层的安装目录即可
如 D:\Program Files (x86)\MuMuPlayer-12.0
不要填写成类似下面的子目录！！！
不要填写成类似下面的子目录！！！

D:\Program Files (x86)\MuMuPlayer-12.0\nx_device\12.0
D:\Program Files (x86)\MuMuPlayer-12.0\nx_main

不要填写成类似下面的子目录！！！
不要填写成类似下面的子目录！！！

D:\Program Files (x86)\MuMuPlayer-12.0\nx_device\12.0
D:\Program Files (x86)\MuMuPlayer-12.0\nx_main

不要填写成类似下面的子目录！！！
不要填写成类似下面的子目录！！！

D:\Program Files (x86)\MuMuPlayer-12.0\nx_device\12.0
D:\Program Files (x86)\MuMuPlayer-12.0\nx_main

雷电模拟器填写类似 D:/Program Files (x86)/leidian/LDPlayer9的路径即可

如果报错信息是 AttributeError: 'ADB' object has no attribute 'screen_size

请仔细阅读II.Q1，使用 MiniTouch方案

如果报错信息和Device初始化相关

请参照II.Q2检查截图方案

每个配置对应一个账号，进度和配置之间互相独立，有几个账号就创建几个配置
新建配置可以通过点击左下角 +号创建
需要做哪个号日常就执行哪个配置即可，即以账号数分配配置而不是以模拟器分配
支持同时执行多个配置

最好选择3C，这样可以做到一把过3个每日宝箱

忍者推荐 秽土多由也 小樱 佐助
秘卷推荐 活 霸体 散
通灵推荐 忍龟 蛤蟆健 守鹤/蛞蝓

须佐鼬原皮最合适，其次可以选择任何低浮空的灌伤忍者
比如老佩恩，百战佩恩，老三代等等

体力和铜币购买次数没有做进度识别，也就是说只会按照设定次数购买
请不要自己事先买了又执行购买，只会浪费金币

说明该任务需要消耗金币，而你没有配置二级密码或者二级密码错误/长度不足6位

这是魔方的历史遗留问题，情报站时不时就会发生卡死或加载空白的问题
该任务已经重写过多次，还是没办法做到一定承受魔方的投入，见谅！

请检查站街/场景，过于庞大的站街有可能遮挡场景中任务场景的入口
部分开发者没有的场景也没法得到充分测试，请切换场景重试，如果依旧有问题请参照下面所述反馈

因为组织里做日常的时间不统一，所以宝箱会留到第二天
通过昨日奖励的方式领取，这样保证每次领取到的都是最大化的收益，避免任务的二次执行

立即执行需要在启动调度器的情况下使用
（立即执行功能现已移动至 总览面板下点击任务右侧 执行按钮）

从 v0.17.43 起，总览面板的「执行」按钮默认受任务自身的时间窗口约束： 某些任务只有在固定时间才开放进入，比如 天地战场/巅峰对决（每周三 21:00 起）、 要塞争夺战（每周六 20:00 起）、叛忍来袭（周三/周六窗口）、 赛季胜场（每月最后两天）、冬日烟花季（每日 19:00~22:00）等。

窗口外点击「执行」会弹出说明（含该任务的排期），确认后可以选择「强制执行」忽略窗口 ——但游戏里该玩法没开放时，任务会空跑到最长执行时长（并且期间其它任务无法执行）， 请谨慎使用。

全天/整周窗口的任务（如一乐外卖、修行之路、消耗体力等）几乎任何时间都能立即执行， 不受影响。

检查串口号配置和模拟器是否一致，可以参考上方II.Q2
如果一致，可以先尝试重启模拟器，可能是因为串口被占用等问题

这种问题只会在实例索引相同的情况下发生，原因是雷电模拟器没有端口被占自增的机制

假设MuMu和雷电实例索引都为0，此时MuMu和雷电串口都为emulator-5554
如果MuMu先启动，雷电后启动，此时同一个端口上有两个进程占用，就会出现串线的问题

解决的办法：同样实例索引的模拟器，雷电先启动，MuMu后启动

原理：
雷电占用emulator-5554的串口后，MuMu启动会检测端口是否被占
如果端口被占，自动+1变成emulator-5555，从而避免端口竞争

原因：连点用的是 MiniTouch（直接往模拟器的触摸设备 /dev/input/eventx 注入触点）， 这些触点的「按下/抬起」状态保存在模拟器侧。如果设备端的 minitouch 服务在触点仍按着 的瞬间退出/被杀（连点刷新、控制实例释放、模拟器自身杀服务、或宿主触摸与注入争用同一组 slot），那一下的「抬起」就丢了，这几个触点会一直停在按下状态——之后任何一次点击都会 被当成同一个手势，把残留的坐标一起上报，于是「点一下触发所有连点坐标」。 旧版本只能重启模拟器。

处理：

• 从 v0.17.46 起，程序在启动调度器前与停止调度器后都会自动检测并清理残留触点 （日志会写 已清理设备端残留触点）；
• v0.17.49 起，连点途中不再做清理（一次清理要跑秒级的 adb 命令，会把连点拖成 「点一次卡几秒」）：连接异常重建时若抬起失败，只挂起一次清理诉求，统一在 连点启动/结束、调度器启停这些时间点执行（同一模拟器 30 秒内最多清一次， 无诉求时不做任何设备操作）；
• 也可以在「助手设置 → 串口列表」里点「清理残留触点」手动恢复，不必重启模拟器；
• 若清理后仍异常，再重启模拟器并在反馈时附上日志（会包含残留触点的数量与坐标）。

第一件事：先检查一下自己的版本是否最新，具体怎么操作看下面IV.Q2

确保版本最新之后看下面的部分

1.点击程序右上角 菜单键中 日志文件，日志文件夹的结构如下

log/
├── Main.log            # 主程序日志（启动/退出/API/崩溃，含启动横幅：时间/版本/Commit）
├── launcher.log        # 引导器日志（启动/退出横幅、后端拉起过程）
├── backend.log         # 后端原始输出（uvicorn 访问日志/启动横幅/未捕获异常）
├── 配置名1/
│   ├── 2024-01-01/
│   │   ├── Xuan.log    # 该配置调度器日志（启动横幅：时间/控制模式/截图模式/串口等）
│   │   ├── Xuan.log.1
│   │   └── ...
│   ├── 2024-01-02/
│   │   ├── Xuan.log
│   │   ├── Xuan.log.1
│   │   └── ...
│   └── ...
├── 配置名2/
│   ├── 2024-01-01/
│   │   ├── Xuan.log
│   │   ├── Xuan.log.1
│   │   └── ...
│   └── ...
└── 配置名3/
    └── ...

2.1 如果你反馈的Bug是程序崩溃类问题（例如闪退）

请将Main.log、launcher.log、backend.log连同你出现Bug的配置名下当天的所有Xuan开头的日志文件取出

2.2 如果你反馈的Bug是程序配置类问题（例如连接失败等）

请将你出现Bug的配置名下当天的所有Xuan开头的日志文件取出

2.3 如果你反馈的Bug是任务执行类问题（任务没有按照预期效果执行）

I.请将你出现Bug的配置名下当天的所有Xuan开头的日志文件取出
II.开启程序 总览面板日志窗口右上角 保存图像，记录下完整的任务执行Bug过程
III.并在 log的同级目录 image下找到 扫描或 出bug的任务名文件夹下对应的截图

3.把上述得到的文件放在一个文件夹里打包成压缩包
(不要直接把文件打包成压缩包，解压起来还要再创建一个文件夹防止弄乱桌面很麻烦！！！)
4.发送到反馈群(Q1064405535)/开发者邮箱(3034160006@qq.com)中

注意，不要录屏/拍屏！

规范化的反馈有助于开发者定位问题，维护项目
不规范的反馈只会浪费开发者的生命，望周知！！！
对开发者来说，程序自己的截图+日志比个人录屏/拍屏有用得多！！！

点击程序右上角菜单中的检查更新即可更新，随时跟踪v17分支的最新情况
如果想要自动接收更新，则点击程序右上角菜单，在设置中开启 自动更新即可
如果网络始终无法连接到Github的话
（表现为点击检查更新，显示有新版本，但是始终无法完成下载更新（更新文件完会有弹窗提示），或更新显示403之类的网络错误）
请自行解决网络问题，或者参考I.Q1中的方法，从项目中下载最新代码压缩包解压到本地安装目录