Error Handling.zh CN
安装、更新、运行过程中各类报错的排查方法。遇到其他问题可以加入 QQ 划水群 823265807 反馈。
问题索引
- 压缩包下错了
-
deploy.yaml配置报错 - 部署配置相关报错
- 杀毒软件报毒
nkas.exe -
updater.bat安装报错 - 更新失败
- 「源码更新」无法更新
- 报错 Unlink /
nkas.exe消失 - 更新报错无法解决
- 安装依赖（pip）报错
- 报错 reject by gitee
- 弹出 Git 凭据管理器
- 其他 Git 相关报错
- 报错拒绝访问 / 一直点击启动按钮
- 界面白屏、显示异常
- 勾选管理员启动后窗口一闪而过
- 购买商品时报错
- 游戏内网络相关报错
- 提示游戏分辨率不正确
- 屏幕分辨率不符合要求
- 画面颜色异常
- 启动器路径相关报错
- 找不到游戏窗口
- PC 端 / 模拟器客户端配置
- 启动器变成了竖的
- 屏幕选错了
- 旧版本常见问题：旧版界面与模拟器相关的历史问题（Q1-Q10）
请先阅读安装指南，下载正确的安装包。
config/deploy.yaml 改错或没改，请按以下任一方式修正：
- 仔细阅读安装指南-编辑安装配置，修改
config/deploy.yaml - 也可以直接在 Web UI 的「部署」页修改部署配置（修改后需重启生效），避免手动编辑 YAML 出错
请按以下任一方式修正：
- 参考安装指南-编辑安装配置，修改
config/deploy.yaml - 也可以直接在 Web UI 的「部署」页修改
属误报，放心加白名单即可。nkas.exe 是 Rust 编译的 Tauri 2 桌面端程序，未做商业代码签名，容易被误判。将 nkas.exe 或程序目录加入杀毒软件白名单；仍被拦截可暂时关闭实时监控后重试。
国内用户最常见的原因是未配置国内源。检查 config/deploy.yaml 的国内源配置（见安装指南-基本配置），再重新运行 updater.bat。
- 重新执行
updater.bat - 如果执行没有报错，请直接使用 release 中结尾为 full 的安装包
- 如果
nkas.exe（桌面启动器）已损坏或消失，也可以在更新页使用「启动器更新」修复（仅 1.x 版本可用）
现版本的更新页分为「源码更新」和「启动器更新」两个区块。此问题具体原因未定位，请尝试：
- 删除
.git文件夹 - 执行
updater.bat
- 手动执行两次
updater.bat - 如果
nkas.exe已损坏或消失，也可以在更新页使用「启动器更新」修复（仅 1.x 版本可用）
- 重新安装 NKAS
- 如果只是
nkas.exe（桌面启动器）损坏，也可以先在更新页使用「启动器更新」修复（仅 1.x 版本可用）
报 No matching distribution found for XXX 或包下载超时，请按以下方式处理：
- 重新运行
updater.bat - 仍失败则在
config/deploy.yaml中把PypiMirror换成其他镜像（也可在「部署」页修改）：
| 镜像源 | 地址 |
|---|---|
| PyPI 官方 | https://pypi.org/simple |
| 阿里源 | https://mirrors.aliyun.com/pypi/simple/ |
| 清华源 | https://pypi.tuna.tsinghua.edu.cn/simple |
| 豆瓣源 | https://pypi.douban.com/simple/ |
⚠️ 清华源可能因大量下载阻断请求（显示"尊敬的访问者"），此时请切换至阿里源。
按以下步骤逐一尝试：
- 换网
- 更换
git源，将config/deploy.yaml中Repository改为https://git.megumiss.top/megumiss/NIKKEAutoScript或者https://github.com/megumiss/NIKKEAutoScript（也可在「部署」页修改） - 关闭自动更新，将
config/deploy.yaml中AutoUpdate改为false - 如果在不受信的网络环境下遇到 SSL 证书校验相关报错，可以将
config/deploy.yaml中SSLVerify改为false
更换 git 源，将 config/deploy.yaml 中 Repository 改为 https://git.megumiss.top/megumiss/NIKKEAutoScript 或者 https://github.com/megumiss/NIKKEAutoScript（也可在「部署」页修改）。
打开脚本路径下的 \toolkit\Git\git-bash.exe，执行下图中第二个红框的命令。
必须使用管理员权限打开 NKAS。
报错拒绝访问：
一直在点击启动器的启动按钮：
最常见的原因是缺少 WebView2 Runtime（NKAS 界面依赖它渲染），请按优先级依次排查：
- 前往 微软官网 下载安装或修复 WebView2 Runtime（Windows 11 一般已预装）。
-
清除 WebView2 缓存：完全退出 NKAS（包括托盘图标），删除目录
%LOCALAPPDATA%\com.megumiss.nkas\EBWebView（即C:\Users\你的用户名\AppData\Local\com.megumiss.nkas\EBWebView），再重新启动。浏览器直连白屏的同理，用Ctrl+F5强刷或清除127.0.0.1的站点数据。典型场景：某些软件会把注册表中
.js文件的类型改成text/plain，导致界面脚本被内核拒绝执行并缓存住这个坏结果——此时日志里能看到资源请求全部返回 304，但页面始终白屏。删缓存可强制重新加载；若删缓存后仍复发，请用管理员权限的 PowerShell 执行reg add "HKLM\SOFTWARE\Classes\.js" /v "Content Type" /t REG_SZ /d "text/javascript" /f修复注册表后重启电脑（新版本已在代码内规避此问题）。 - 确认项目在纯英文路径下。
- 多次
Ctrl+R刷新界面，或重新打开nkas.exe。 - 修改
deploy.yaml中的HardwareAcceleration（切换硬件加速开关）后重启桌面端。 - 界面显示比例异常或模糊时，修改
DpiScaling后重启桌面端。 - 打开系统终端或 PowerShell 执行
netsh winsock reset，并重启电脑。 - 将
WebuiHost改为127.0.0.1，或将WebuiPort改为其他端口。 - 确认
updater.bat执行成功无报错；必要时更换 pip 源后重新执行。 - 使用了固定 IP 或 DNS 的，尝试更改后重试。
- 以上均无效时：重装 NKAS、将
EnableReload设为false（旧版本遗留机制，与白屏无直接关联，仅作最后尝试），或参考 Issue #876（未测试）。
其他显示异常示例：
系统用户是 Administrator 时应该不用勾选管理员启动，也有可能是因为解压路径在 C 盘。
（此问题暂无截图）
请检查商店购买物品填写正确。
可能是加速器的问题。
- PC 端设置中开启
游戏分辨率设置兼容模式 - 关闭游戏图标右键属性中的兼容模式
参考 PC 端使用指南 解决。
1080p 屏幕用户可以开启「旋转屏幕」选项：点击启动时屏幕会旋转为竖屏以满足竖向分辨率要求，任务结束后会自动恢复横屏，也可以使用快捷键 Ctrl+F12 手动旋转回横屏。
游戏设置未更改、关闭自动HDR选项未开启，或者各种软件设置导致了颜色变化，请参考 PC 端使用指南-游戏设置建议排查。
请填写正确的启动器路径。
启动器路径 / 游戏路径 / 窗口进程或者标题填错了，请逐一检查。
- PC 端请手动选择客户端平台为
Windows (PC端) - 如果你是模拟器，请填写 Serial
请仔细阅读 游戏客户端 这个选项的小字说明。
检查 PC 端设置中的「多屏幕模式」和「游戏窗口目标屏幕」选项。
以下条目中，涉及旧版界面的（Q1、Q2、Q6、Q7）仅适用于已移除的旧版本界面（pywebio 时代），新版本已不再适用，仅供参考；其余为游戏/模拟器相关问题，新版本同样可能遇到。
可能是运行 updater.bat 时，没有完全更新成功，可以尝试重新解压后再次运行 updater.bat。
可能是缺失了某个依赖，可以通过 CMD 手动安装 requirements.txt 中的依赖：
.\toolkit\python.exe -m pip install -r requirements.txt -i https://pypi.org/simple
这应该是无法访问 Github 时会出现的情况，可以在 config/deploy.yaml 的 GitProxy 字段中填写代理，或者更改 hosts 等。
请检查 NIKKE 的画质设置，确保选项拥有'光晕效果'和'颜色分级'两个选项，以及在游戏中收藏了想咨询的 NIKKE。
可能是模拟器的分辨率为 1280 * 720，但在运行 NIKKE 时是以竖屏运行的，这样会导致点击到错误位置，请设置为 720 * 1280 后，再次尝试。
这是因为没有初始化 Git，请运行 updater.bat。
同 Q3。
这是因为模拟器的 NIKKE 是通过 Google Play 下载的，可以卸载后在 QooApp 下载，可以解决这个问题。
这很可能是因为模拟器的 Google Play 未登录账号，可以登录账号后再尝试。
旧版本的处置方法是将 bin\deploy\ch_PP-OCRv4_det_infer.onnx 复制到报错路径，该方法已不适用：当前版本 OCR 已更换为 PP-OCRv5 模型，模型文件位于 bin\paddleocr\ 目录。如遇模型文件缺失报错，请重新运行 updater.bat 补全依赖，或检查 bin\paddleocr\ 模型目录是否完整。