常见问题

提示

本部分用于用户自行排查并解决常见问题，如果无法解决请加入官方QQ群聊1050304255（1群）进行反馈。

小提示

启动器路径最好不要包含中文或空格，遇到问题时首先删除空格和中文，再尝试解决问题。

警告

懒人包不要去点系统环境检测，系统环境下不要去点内置环境检测。如果谁再问，直接拉黑！

启动器打不开

1.3.X的启动器打不开是因为路劲中有空格或中文等非法字符，请将启动器路径改为不含空格和中文的英文路径即可。

找不到SillyTavernLauncher.exe

请你检查你的杀毒软件，启动器的主程序可能被杀毒软件误报认为是病毒，请将SillyTavernLauncher.exe加入杀毒软件的白名单，并将主程序还原即可。

提示

如果不放心作者自己打包的版本，你可以自行打包，打包方法可以参考仓库主页readme中的打包教程。

启动器窗口大小不正常

该问题是GUI框架所致，目前无解，重新启动即可解决

启动器打开弹出报错

问题截图

解决方法

更新至最新Nuitka打包版本（1.2.5及以上版本默认为Nuitka打包，但Github上的Nuitka打包从1.2.6版本开始）

提示

测试版可能会与正式版有一些区别，一般最新测试版基本上就是正式版了，测试版会有一个黑色控制台窗口，请勿关闭！

SillyTavern进程已退出

问题截图

解决方法

打开任务管理器，找到node.exe进程，点击结束进程即可

提示

如果是因为运行了其它工作在8000端口的程序导致端口冲突，请在启动器设置中修改端口后再启动SillyTavern即可解决问题

启用局域网访问后无法访问

请检查SillyTavern文件夹下是否有whitelist.txt文件，如果没有请尝试通过开关启动器对应开关尝试创建，如果依然无法创建，请手动创建一个whitelist.txt文件并写入以下内容：

127.0.0.1
192.168.*.*

随后重新启动酒馆，再次尝试连接即可。

提示

如果仍然无法解决问题，请进行防火墙放行
步骤 1 进入控制面板
选择 系统和安全 → Windows Defender 防火墙
步骤 2：允许应用通过防火墙
点击左侧 允许应用或功能通过 Windows Defender 防火墙
点击 更改设置（需管理员权限）
点击 允许其他应用 → 浏览，选择 nodejs路径下的node.exe（懒人包找启动器路径下的env文件夹，系统环境找自己的安装路径） 文件并添加
勾选 专用 和 公用 网络，点击 确定 保存

无法更新酒馆

更新酒馆功能需要1.0.4（至少）才开始能正常使用

如果是1.2.5以下版本的启动器，请先备份旧版本的SillyTavern文件夹，然后使用新文件夹存放新版本的文件，然后将env（懒人包的运行环境文件夹）和SillyTavern文件夹中的文件复制到新版本中。 （新版本可以不需要下载懒人包的版本，如果下载懒人包，直接备份和复制SillyTavern文件夹中的data即可）

Git更新失败

启动器会自动尝试git重试等操作，如果依然失败请截图后在群中反馈 QQ群聊1050304255（1群）

已安装Git和Nodejs，但依旧无法使用

请检查启动器是否打开了 使用系统环境 选项，如果打开后还是不可用，请先重启启动器再尝试，如果问题依旧，请联系开发者反馈

酒馆启动失败相关

酒馆依赖缺失 module not found

这类型错误可能原因是懒人包解压相关问题造成，或者是系统环境下依赖安装出错

解决方法

请尝试使用启动器终端页面的更新按钮，启动器会尝试npm安装缺失的依赖，如果依旧出错，请你找到启动器路径下SillyTavern文件夹，删除其中的node_modules文件夹，然后再次使用启动器更新按钮尝试重新安装依赖