常见问题

2025/9/28

如果查看了本文档仍旧无法解决你的问题，可以在Issue查阅是否有相似问题，如果无相似问题可以通过Issue提问。

查阅文档没有结果，也可以通过用户社区进行提问

1.怎么下载？

❓Github 下载太慢/下载失败

可以使用下面的公益加速服务：

https://moeyy.cn/gh-proxy/

https://github.abskoop.workers.dev/

https://gitmirror.com/files.html

或者更换其他下载方式。

❓找不到下载文件的位置？不知道下载哪个文件/版本？

BetterGI 在 Github 页面提供了多个版本，主要是安装版和便携版，不同版本除了打包与安装方式之外，无任何区别。

在本页面额外提供了另外的安装版本，具体区别见下方说明。

下载位置在更新日志下方：

安装版（新在线版） 的文件名是 BetterGI.OnlineInst.exe，自动选择优路线下载并安装。（当前只在本页面提供）
安装版（新离线版） 的文件名是 BetterGI.Install.版本号.exe，安装速度比下面的安装版更快，且会自动更新到新版本。
安装版 的文件名是 BetterGI_Setup_v版本号.exe，安装后会自动在开始菜单创建快捷方式。如果你不知道解压缩是什么操作，请使用这个版本。（已不再提供）
便携版 的文件名是 BetterGI_v版本号.7z （老版本是zip压缩包），解压并运行 BetterGI.exe 即可。

有更高版本号的情况下优先下载更高版本号的 BetterGI！

2.怎么启动？

❓启动软件提示`You must install .NET Desktop Runtime to run this application`？

提示如图：

BetterGI 需要安装 .NET 8 运行时才能运行，请根据提示安装，否则无法启动软件。

没有提示，也进不去？手动安装下载：.NET 8 运行时

❓无论是自动拾取，还是自动剧情都没反应，也没有日志打印。

在启动页内尝试更换截图方式。

3.无法使用

❓云原神无法使用？

请注意当前只支持PC端云原神，不支持网页版云原神。使用时请注意：

只能使用 WindowsGraphicsCapture 的截图方式
云原神有三个窗口，可能自动识别到的窗口不正确，请使用“启动”页中的“手动选择窗口”功能来选择正确的云原神窗口

❓以前好好的，突然所有功能不能用了？

如果你使用的截图方式是 BitBlt ，大概率是 Win11 更新导致窗口化游戏优化自动开启。

BetterGI 启动后会自动修改窗口化游戏优化为关闭状态，但是在原神启动状态下的修改是不会实时生效的，也就是说：你只需要重启原神后重试即可！

更多相关内容可以见此Issue：Win11下 BitBlt截图方式不可用的解决方法

❓使用自动拾取的时候能看到拾取的日志，但是没有按F键拾取？

请确认是以管理员权限启动软件。
模拟操作部分可能被部分安全软件拦截，请关闭安全软件或加入白名单！已知 360安全卫士、提高了拦截强度的 WindowsDefender 会拦截部分类型的模拟点击。

❓自动拾取可以使用，为什么自动剧情没反应？

游戏内的自动剧情功能打开时，BetterGI 的自动剧情才会启用。也就是游戏左上角的“自动”按钮处于“播放中”状态。

❓为何软件会闪退？

一般为内存不足导致的，可能是js脚本造成的内存溢出。
最简单的解决方法是添加内存，当然也可以通过添加虚拟内存解决。

❓B服登录卡住，无法使用自动伐木/好感？

在非官服场景下，像B服这种登录窗口属于内嵌窗口，会因为windows系统缩放倍率发生微小变化，如果是登录页面点不到登录按钮的情况，请把你的系统缩放倍率改为100%。

❓为什么我运行软件后没有反应，一条龙或脚本无法运行？

请确保你的原神没有被其他悬浮窗软件遮挡，例如显示显卡温度、cpu温度、cpu占用等悬浮窗，这些窗口会遮挡游戏内容影响识别，能不开尽量不要开启。

4.报错相关

❓报错提示 "Some simulated input commands were not sent successfully..." 或 "模拟键鼠消息发送失败！..."

早期版本提示 "Some simulated input commands were not sent successfully..."

最新版本提示 "模拟键鼠消息发送失败！..."

模拟操作部分可能被部分安全软件拦截，请关闭安全软件或加入白名单！已知 360安全卫士、提高了拦截强度的 WindowsDefender 会拦截部分类型的模拟点击。

❓任务结束后提示"没有检测到Starward协议注册"

Starward是一款米哈游旗下游戏的第三方启动器，该启动器内有游戏时间记录功能，当使用Starward的自定义启动程序启动BGI时，计时功能会失效。

BGI提供了一个选项，开启后即可正常计时，该选项位于“同时启动原神”下。

如果你没有安装 Starward 并开启了这个选项，就会出现这个提示。

这个提示不会对脚本运行造成影响。

如果你安装了 Starward ，可以在此处开启 URL 协议注册后使用本功能在 Starward 中记录游戏时间。

❓首次启动时，任意功能没反应/七圣召唤卡卡在“选择初始手牌”/自动钓鱼没有“进入自动钓鱼”日志

在启动页内尝试更换截图方式。可以先测试自动拾取，完全没日志打印的话，换截图方式重试。不断的打印物品日志但是不按F拾取的话，请关闭安全软件。

❓使用其他软件解锁120帧后软件失效？

在启动页内尝试更换截图方式。

❓Windows 11 下，无法使用 `BitBlt` 截图方式？

参考：#92 设置后重试。但是修改这个设置后，可能会造成游戏性能下降。

❓提示“PaddleOcr预热失败”应该如何解决？

造成这个问题原因有很多种，以下罗列相关的解决方式，请自行判断，如果依旧无法解决，可以提Issue并附上报错截图。

关于这个问题的更多讨论：#132

情况一：把 BetterGI 解压到了桌面或者中文路径下可能会出现这个问题（大部分系统不会出现这个问题），请移动到非桌面的全英文路径下重试。
情况二：把系统编码修改成了 UTF-8，请修改回默认系统编码后重试。取消勾选下图中的选项即可。

情况三：
- case1:提示 onnxruntime.dll: FAIL, handle=0 的情况下，请安装VC++运行库，官方下载地址：vc_redist.x64.exe
- case2:提示 Unable to load DLL 'onnxruntime'or one of its dependencies: 动态链接库(DLL)初始化例程失败。(0x8007045A) 的情况下，也请安装VC++运行库，官方下载地址：vc_redist.x64.exe

情况四：如下图提示 onnxruntime.dll: OK, handle=0,但是 mkldnn.dll: FAlL, handle=0 的情况下，说明 ONNX 可能用不了，只能补充其他方式进行使用。请不要和情况三混淆！。进入 wwk.lanzouq.com/ioU1f1tvgnwd 后，下载并解压，然后把里面的4个dll放到软件根目录，并覆盖。参考：#283