NIKKEAutoScript 报错排查清单:10 个最常见异常与请求人工接管的解决方法

原创2026-10-28 19:19:001,254 阅读

NIKKEAutoScript 报错排查清单:10 个最常见异常与请求人工接管的解决方法

NIKKEAutoScript(NKAS)是一款《胜利女神:NIKKE》自动日常脚本,支持 PC 客户端、安卓真机与 ARM 模拟器。本文整理 NKAS 运行中最常见的 10 类报错 与"请求人工接管"场景,给出每个异常的触发原因、脚本行为和具体解决步骤,帮助新手不看源码也能快速完成报错排查。

NIKKEAutoScript 任务总览界面,调度器与实时日志可帮助监控任务状态、排查报错

先看懂 NKAS 的异常处理三级机制

排查任何报错前,先了解脚本出错的"处理链路",全部异常定义集中在 module/exception.py:

级别 触发条件 脚本行为
① 自动恢复 游戏系统错误弹窗(GameSystemError) 自动关闭弹窗并重试,最多 3 次,见 main.py
② 自动重启 卡住 / 点击过多 / 截图失败(GameStuckError 等) 保存错误日志,10 秒后自动重启游戏,见 main.py
③ 请求人工接管 验证码、掉线、任务连续失败 3 次等 立即停止并退出,发送崩溃通知,等待人工处理

其中"任务连续失败 3 次"会触发 TaskFailedThreeTimes,脚本会输出两条可能原因并请求人工接管(见 main.py)。收到 ③ 类提示时,不要反复重启,按第六节的恢复流程操作即可。

10 个最常见异常速查表

# 异常 典型现象 一句话解决思路
1 RequestHumanTakeover 日志输出"请求人工接管" 人工登录游戏,确认主页后重启脚本
2 CaptchaRequired 登录时弹出验证码 手动完成验证码验证
3 AccountError 提示"Game offline, please relogin" 重新登录游戏账号
4 GameServerUnderMaintenance 维护页面识别成功 等维护结束后重启脚本
5 GamePageUnknownError 提示"Game page unknown" 检查网络/服务器状态,查看 log/error 截图
6 GameSystemError 游戏内系统错误弹窗 脚本自动关闭并重试 3 次
7 GameStuckError 画面长时间不变化 自动重启游戏;手动游玩时先停 NKAS
8 GameNotRunningError 游戏未启动 自动执行 Restart 任务拉起游戏
9 ScreenResolutionNotEnough 分辨率低于 720×1280 将游戏窗口/模拟器调至 720×1280 以上
10 任务失败 3 次 TaskFailedThreeTimes 通知 核对调度配置与活动时间,更新脚本

逐个击破:10 个异常的排查步骤

1. RequestHumanTakeover:请求人工接管(最高优先级)

这是 NKAS 的"兜底异常",含义是:脚本已经无法继续,必须你来接手。定义见 module/exception.py,常见抛出点包括模拟器连接失败、配置错误等(如 module/device/adb/connection.py)。

解决步骤:

  1. 确认脚本进程已停止(脚本退出时会先还原屏幕方向、恢复声音);
  2. 人工启动并登录游戏,处理所有弹窗;
  3. 游戏回到主界面后,重新启动脚本实例。

2. CaptchaRequired:登录出现验证码

登录环节识别到验证码时抛出(定义见 module/exception.py),脚本会发送"需要处理验证码,请人工接管"通知后退出。

解决步骤: 切到游戏窗口手动完成验证码验证 → 保持游戏登录态 → 重启脚本。避免频繁更换登录方式以降低验证码触发概率。

3. AccountError:登录失败 / 游戏掉线

日志提示 Game offline, please relogin or input account(见 main.py)。

解决步骤: 检查网络与账号登录态 → 手动重新登录 → 重启脚本。若持续出现,检查多开账号配置是否串号。

4. GameServerUnderMaintenance:服务器维护中

识别到维护页面后,脚本会停止游戏并退出(见 main.py)。

解决步骤: 查看官方维护公告 → 等待维护结束 → 重启脚本即可,无需修改任何配置。

5. GamePageUnknownError:游戏页面未知

通常由断网或服务器异常导致,脚本无法确认当前界面(见 main.py)。

解决步骤: 先检查本机网络与服务器状态 → 到 ./log/error/<时间戳>/ 查看最后一张截图,确认脚本"卡"在哪个页面 → 恢复网络后重启脚本。

6. GameSystemError:游戏内系统错误弹窗

游戏本体弹出的报错框。脚本会自动点击关闭并重试(恢复逻辑见 module/handler/info_handle.py),3 次未恢复则升级为 GameStuckError 走自动重启流程。

解决步骤: 偶发可忽略;反复出现说明游戏本体异常,手动重启一次游戏客户端,必要时验证游戏完整性。

7. GameStuckError:游戏卡住

界面长时间无变化或点击次数过多时触发,脚本保存错误日志并提示 10 秒后重启游戏(见 main.py)。

解决步骤: ⚠️ 日志会提示"If you are playing by hand, please stop NKAS"——如果你正在手动玩游戏,请先停止 NKAS,避免脚本重启游戏打断你的手操。

8. GameNotRunningError:游戏未运行

任务启动时游戏不在运行状态,脚本会自动调用 Restart 任务拉起游戏(见 main.py)。

解决步骤: 一般为瞬时现象可等待自愈;若反复出现,检查 PC 客户端窗口是否最小化/遮挡,或模拟器是否已运行。

9. ScreenResolutionNotEnough:屏幕分辨率不足

模板匹配基于 720×1280 截图,分辨率过低会直接报错退出(定义见 module/exception.py)。

解决步骤: 将游戏窗口或模拟器分辨率调至 720×1280 及以上(PC 端建议独占/固定窗口模式)→ 重启脚本。

10. 任务连续失败 3 次:TaskFailedThreeTimes

调度器统计每个任务的失败次数,同一任务失败 3 次即请求人工接管(见 main.py)。脚本给出的两条官方可能原因:

  1. 配置使用错误——阅读调度设置中该任务选项的帮助文本;
  2. 任务本身存在问题——将 log/error 截图与日志反馈给开发者,或先更新脚本到最新版。

NIKKEAutoScript 冠军竞技场活动日历,活动类任务报错排查前需先确认活动是否开放

活动类任务(竞技场、限时作战等)还要多排查一步:确认活动是否在开放期。赛季/活动未开放时运行对应任务会反复失败并触发接管,请在调度设置中错峰启用:

NIKKEAutoScript 特殊竞技场活动日历横幅,排查活动类任务报错前先核对开放时间

报错后去哪找证据:log/error 日志

任何致命异常都会自动调用 save_error_log(实现见 main.py),在 ./log/error/<毫秒时间戳>/ 目录下生成:

  • 最近 60 张截图(按时间命名)——最后一张就是脚本"倒下"时的界面;
  • log.txt——从最后一个任务开始截取的完整日志。

排查套路:打开最新的时间戳文件夹 → 看最后一张截图判断卡在哪个页面 → 对照上文速查表找到对应异常。

让手机第一时间收到报错:开启崩溃通知

NKAS 内置多通道通知推送(SMTP 邮箱、OneBot 等,实现位于 module/notify/),常用崩溃文案定义在 module/notify/i18n.py:

  • RequestHumanTakeover → "请求人工接管"
  • CaptchaRequired → "需要处理验证码,请人工接管"
  • GamePageUnknownError → "游戏页面未知"
  • TaskFailedThreeTimes → "任务 `{task}` 失败3次或以上。"

配置建议: 开启"任务崩溃时通知"(Notification_WhenDailyTaskCrashed),并配置至少一种推送渠道;Windows 桌面可叠加 Win 通知(Notification_WinOnePush)。相关默认值见 module/config/config_generated.py。这样即使脚本退出,你的手机也会立刻收到"请求人工接管"提醒。

请求人工接管后:标准恢复流程(5 步)

  1. 确认退出——看到"Request human takeover"日志即代表进程已结束,无需手动 kill;
  2. 人工登录——启动游戏、完成验证码、处理掉线弹窗;
  3. 确认主页——游戏停在主界面且无弹窗遮挡;
  4. 重启脚本——重新启动对应实例(多开场景只需重启该实例);
  5. 观察日志——打开任务总览与实时日志,确认调度器恢复"启动"状态、任务开始排队执行。

核心文件索引

文件 作用
module/exception.py 全部异常类型定义
main.py 任务执行与异常分发主逻辑
module/handler/info_handle.py 系统错误弹窗自动关闭
module/notify/i18n.py 崩溃通知多语言文案
module/base/retry.py 通用重试装饰器

小结

NKAS 的报错体系可以概括为"能自愈的先自愈,不能自愈的停下来叫你":系统弹窗自动关、卡住自动重启、验证码和掉线请求人工接管。日常只需记住三件事——看懂三级处理机制、翻 log/error 截图定位卡点、配置好崩溃通知,遇到"请求人工接管"时按 5 步恢复流程操作,绝大多数报错都能在 5 分钟内解决。

登录后查看全文
NIKKEAutoScript