常见问题
提示
本部分用于用户自行排查并解决常见问题。2.0 相关问题在前，1.x 遗留问题归档在后。如果无法解决请加入官方QQ群聊1050304255（1群）或频道 酒馆启动器 进行反馈。
小提示
启动器路径最好不要包含中文或空格，遇到问题时首先删除空格和中文，再尝试解决问题。
2.0 常见问题
点了关闭按钮，启动器"不见了"但酒馆还在跑？
这是「系统托盘」功能的效果：开启托盘后，点击窗口关闭按钮会把启动器收进系统托盘，酒馆继续在后台运行。在托盘图标右键菜单中可以唤回主窗口或彻底退出。不想这样可以在「设置 → 启动器设置」关闭系统托盘。
Alt+F4 或系统关窗直接退出了？
自绘标题栏只接管标题栏上的关闭按钮；Windows 原生关闭链路（Alt+F4、任务栏右键关闭）无法拦截，会直接退出。请养成使用标题栏关闭按钮或托盘菜单退出的习惯。
内置运行时模式下个别功能/扩展异常？
内置运行时（实验性）使用 Bun 运行时替代 Node.js、进程内 Git 替代外部 Git，个别功能与扩展可能异常。遇到问题请在「设置 → 环境」切换回内置懒人包环境或系统环境。
镜像加速不生效 / 想换镜像？
2.0 默认开启自动测速选优与故障自动切换，一般无需手动干预。如需手动指定，进入「设置 → 环境 → 镜像源设置」：可一键测速、手动指定镜像站或切回官方源。注意：手动指定镜像后故障自动切换会停用（尊重你的选择），恢复自动选优即可重新启用。
版本页打不开 / 提示"未安装"？
v2.0.0-beta.2 已修复版本页读取缓慢（约 40 秒 → 1 秒）与「未安装」误报问题，请更新到最新版本。
开机自启后没有弹出窗口？
这是「静默启动」的效果：同时开启「自动启动」「自动启动时隐藏窗口」与「系统托盘」后，启动器会在后台静默启动酒馆并驻留托盘。从托盘图标右键菜单唤回主窗口即可。
酒馆装了一半点启动就闪退？
v2.0.0-beta.2 已修复该竞态：依赖未安装完成时会拒绝启动并提示，请等待安装完成后再启动。
2.0 界面和 1.x 完全不一样了？
v2.0 是界面与内核的全面重写（Python/Flet → GPUIX GPU 渲染），功能布局有调整：安装/启动/停止/更新集中在终端页，设置分为环境/酒馆设置/启动器设置三个分页。功能对照见 v2.0 新特性。
启动器有 Bug 怎么反馈？
2.0 处于 Beta 阶段，欢迎到 GitHub Issues 反馈。启动器目录下的 logs/ 文件夹内有本地错误日志（仅存本地、不上传），反馈时可附上。
找不到SillyTavernLauncher.exe
请你检查你的杀毒软件，启动器的主程序可能被杀毒软件误报认为是病毒，请将SillyTavernLauncher.exe加入杀毒软件的白名单，并将主程序还原即可。
提示
如果不放心作者自己打包的版本，你可以自行打包，打包方法参考自行打包。
启动器路径含空格/中文导致打不开
启动器路径中存在空格或中文等非法字符时可能无法启动，请将启动器路径改为不含空格和中文的英文路径。
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文件夹，系统环境找自己的安装路径） 文件并添加
勾选 专用 和 公用 网络，点击 确定 保存
酒馆启动失败相关
酒馆依赖缺失 module not found
这类型错误可能原因是懒人包解压相关问题造成，或者是系统环境下依赖安装出错
解决方法
请尝试使用启动器终端页面的更新按钮，启动器会尝试安装缺失的依赖，如果依旧出错，请你找到启动器路径下SillyTavern文件夹，删除其中的node_modules文件夹，然后再次使用启动器更新按钮尝试重新安装依赖
安装酒馆失败
这一般是因为网络问题，2.0 的镜像加速会自动测速选优与故障切换，多次失败可尝试在「镜像源设置」中手动测速或更换镜像。
配置保存失败 / 设置不生效
这是因为启动器存放的文件夹有权限问题导致配置写不到文件里去，这种问题可以通过更换启动器的存放文件夹路径或者调整文件夹权限解决。
1.x 遗留问题（仅适用于旧版，建议升级 2.0）
启动器窗口大小不正常
该问题是 1.x GUI 框架（Flet）所致，重新启动即可解决。2.0 重写后不再存在。
启动器打开弹出报错
问题截图
解决方法
更新至最新Nuitka打包版本（1.2.5及以上版本默认为Nuitka打包，但Github上的Nuitka打包从1.2.6版本开始）
提示
1.x 测试版会有一个黑色控制台窗口，请勿关闭！2.0 起不再有控制台窗口。
无法更新酒馆（1.x 旧版迁移）
如果是1.2.5以下版本的启动器，请先备份旧版本的SillyTavern文件夹，然后使用新文件夹存放新版本的文件，然后将env（懒人包的运行环境文件夹）和SillyTavern文件夹中的文件复制到新版本中。 （新版本可以不需要下载懒人包的版本，如果下载懒人包，直接备份和复制SillyTavern文件夹中的data即可）
已安装Git和Nodejs，但依旧无法使用（1.x）
请检查启动器是否打开了 使用系统环境 选项，如果打开后还是不可用，请先重启启动器再尝试，如果问题依旧，请联系开发者反馈