NIKKEAutoScript 报错排查清单:10 个最常见异常与请求人工接管的解决方法
NIKKEAutoScript 报错排查清单:10 个最常见异常与请求人工接管的解决方法
NIKKEAutoScript(NKAS)是一款《胜利女神:NIKKE》自动日常脚本,支持 PC 客户端、安卓真机与 ARM 模拟器。本文整理 NKAS 运行中最常见的 10 类报错 与"请求人工接管"场景,给出每个异常的触发原因、脚本行为和具体解决步骤,帮助新手不看源码也能快速完成报错排查。
先看懂 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)。
解决步骤:
- 确认脚本进程已停止(脚本退出时会先还原屏幕方向、恢复声音);
- 人工启动并登录游戏,处理所有弹窗;
- 游戏回到主界面后,重新启动脚本实例。
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)。脚本给出的两条官方可能原因:
- 配置使用错误——阅读调度设置中该任务选项的帮助文本;
- 任务本身存在问题——将
log/error截图与日志反馈给开发者,或先更新脚本到最新版。
活动类任务(竞技场、限时作战等)还要多排查一步:确认活动是否在开放期。赛季/活动未开放时运行对应任务会反复失败并触发接管,请在调度设置中错峰启用:
报错后去哪找证据: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 步)
- 确认退出——看到"Request human takeover"日志即代表进程已结束,无需手动 kill;
- 人工登录——启动游戏、完成验证码、处理掉线弹窗;
- 确认主页——游戏停在主界面且无弹窗遮挡;
- 重启脚本——重新启动对应实例(多开场景只需重启该实例);
- 观察日志——打开任务总览与实时日志,确认调度器恢复"启动"状态、任务开始排队执行。
核心文件索引
| 文件 | 作用 |
|---|---|
| module/exception.py | 全部异常类型定义 |
| main.py | 任务执行与异常分发主逻辑 |
| module/handler/info_handle.py | 系统错误弹窗自动关闭 |
| module/notify/i18n.py | 崩溃通知多语言文案 |
| module/base/retry.py | 通用重试装饰器 |
小结
NKAS 的报错体系可以概括为"能自愈的先自愈,不能自愈的停下来叫你":系统弹窗自动关、卡住自动重启、验证码和掉线请求人工接管。日常只需记住三件事——看懂三级处理机制、翻 log/error 截图定位卡点、配置好崩溃通知,遇到"请求人工接管"时按 5 步恢复流程操作,绝大多数报错都能在 5 分钟内解决。


