报错自查
遇到问题先别慌,这里汇总了常见问题和解决方案。
🔧 基础排查三板斧
- 刷新页面 / 重启 fount:80% 的问题(如卡顿、显示异常)可以通过重启解决。
- 检查网络:AI 没反应?通常是梯子/网络问题。
- 使用调试面板:很多小白不知道右上角有调试按钮。点击右上角这个图标:

然后点击 “打开调试面板”。在这里你可以查看当前版本、网络状态以及自检。

💻 终端显示与启动问题
终端里全是乱码或红字?
原因:Windows 自带的 cmd 或老版 PowerShell 对彩色字符支持不好。
解决:推荐使用 Windows Terminal (微软官方终端)。

- 下载:在 GitHub Releases 页面下载
Microsoft.WindowsTerminal_..._msixbundle 安装。
- 缺少依赖:如果安装时提示缺少
Microsoft.UI.Xaml.2.8,请去 NuGet 下载对应包安装。

启动后报错退出?
- 检查端口是否被占用。
- 确保
data 目录有读写权限。
🌐 网络与 AI 调用问题
报错 400 / 403 / Network Error
原因:通常是网络连通性问题,或者 API Key 无效。
解决:
- 检查 Key:确认你的 API Key 没有欠费或过期。
- 检查梯子:
- 开启全局模式 或 TUN 模式 (虚拟网卡)。
- 更换节点 (Gemini 建议用美国、日本、新加坡节点)。
- Clash 用户注意:老版 Clash for Windows 可能有兼容性问题,推荐使用 Clash Verge Rev。


Bot 一直卡在 “Typing…”
原因:AI 请求发送出去了,但没收到回音。
解决:同上,大概率是网络超时。尝试刷新页面重试。
🐛 角色与显示问题
角色界面显示错位/报错
原因:可能是网络加载资源失败,或角色卡文件损坏。
解决:
- 强制刷新网页 (Ctrl + F5)。
- 如果是特定角色报错,尝试删除该角色重新导入。
返回主页