修复 Termux 上的 SillyTavern(酒馆):更新、卸载与 start.sh 报错
本文讲的是修好 SillyTavern 本身,而不是换掉它。直接跳到与你的症状对应的那一节即可。
1. Termux 什么都装不上、更新不了
全新安装时最常见的根本原因:用的是 Play 商店版的 Termux,它已经不再维护,自带的软件包都过时了。卸载它,改从 F-Droid(推荐)或 Termux 的 GitHub Releases 安装 Termux。然后把所有东西更新到最新:
pkg update && pkg upgrade
如果软件包下载卡住或超时,运行 termux-change-repo,换一个镜像,然后重试。
2. start.sh 以前能用,现在不行了
通常是这样:某次软件包升级把 SillyTavern 依赖的 Node 换掉了,或者一开始装的就是非 LTS 版的 Node。官方指南指定的是 nodejs-lts;很多视频教程写的却是 pkg install nodejs——光是这个差别,就能解释很多“上周还好好的”。按下面的顺序逐步排查:
pkg update && pkg upgrade
pkg install nodejs-lts
cd ~/SillyTavern && git pull --rebase --autostash
bash start.sh
如果还是不行,就重新克隆一份——同时保留你的数据:
mv ~/SillyTavern ~/SillyTavern-old
git clone https://github.com/SillyTavern/SillyTavern -b release
cp -r ~/SillyTavern-old/data ~/SillyTavern/
cd ~/SillyTavern && bash start.sh
你的聊天、角色和设置都在 data 文件夹里;旧的安装会保留在 ~/SillyTavern-old 中,直到你确认所有东西都迁移过来了。
3. 一锁屏,服务器就挂了
Android 回收后台进程非常激进,而 Termux 里的 Node 服务器正是首要目标。按效果从强到弱:
- 长时间使用前,运行
termux-wake-lock(或在 Termux 的通知中点按 Acquire wakelock)。 - 让 Termux 不受电池优化限制:设置 → 应用 → Termux → 电池 → 无限制。菜单名称因厂商而异,而且有些厂商(尤其是深度定制的 Android 系统)无论如何都会杀掉后台应用。
- 长时间聊天时,用分屏让 Termux 保持可见,而不是完全切到后台。
4. 安装时 npm 崩溃(错误代码 134)
npm install 时出现错误 134,几乎都是低内存手机内存耗尽导致的。关掉其他所有应用,重新运行安装;确认 Node 是 LTS 版(pkg install nodejs-lts)。在 32 位设备上,官方指南还要求运行 pkg install esbuild。
5. 什么都很慢
检查两件事。
- 三项
config.yaml设置。官方 Android 指南指出,在资源有限的设备上,需要检查的是角色延迟加载、磁盘缓存和聊天自动备份这三项。文档里有当前的推荐值。 - 你的角色库大小。手机存储很慢。超大的聊天文件和几百张卡的角色库,都会实实在在地拖慢加载,所以要让设备上的角色库保持精简。
6. 聊天或角色不见了
数据丢失的报告大多与写入中断有关——应用或手机在保存途中被杀掉,或者某次更新出了问题。预防胜于补救。运行一次 termux-setup-storage 以获得共享存储的访问权限,然后每次更新前都备份一下:
cp -r ~/SillyTavern/data ~/storage/shared/SillyTavern-backup
如果东西已经不见了:先停下,不要继续写入,在做最坏打算之前,先看看 data 里 SillyTavern 自己的 backups 文件夹。
7. 一锁屏或切换应用,回复就断了
这个问题不在服务器,而在浏览器。回复是通过一条实时连接流式传输到你打开的标签页里的,而手机浏览器为了省电,会在几秒内挂起后台标签页,流就断了。有三个办法:
- 在生成完成之前保持屏幕常亮。
- 使用分屏,让标签页始终不完全进入后台。
- 缩短回复长度,让回复更快完成。
Android 上的 Firefox 往往比 Chrome 让后台标签页多存活一会儿。
8. 卸载,或者干净地从头再来
没有卸载程序。SillyTavern 只是 Termux 里的一个文件夹,所以删除它就是删掉那个文件夹,或者直接删掉 Termux。先把 data 备份到共享存储,因为这两种做法都会连同你的聊天一起删掉。
完整步骤(包括保留聊天的干净重装)见:如何卸载 SillyTavern。
如果你不想在手机上跑服务器
以上内容都是为了让 SillyTavern 本身继续运行。如果你想要的正是这个,官方文档写得很好,社区也很乐于助人。
如果你真正需要的只是你的角色、你的 API 密钥和你的手机,这正是我们打造 LonelyTavern 的原因。它是一款原生 Android 和 iPhone 应用,能导入 V3 酒馆角色卡和世界书,用你自己的密钥连接任意兼容 OpenAI 的服务商,并把一切都保存在你的设备上。
免费,无需账号,没有广告,也不用半夜两点爬起来修。它不是完整的 SillyTavern:没有扩展,也没有群聊。但就最核心的玩法而言,装好就能用。
相关指南:在 iPhone 上使用 SillyTavern:三种可行的方法 · Chai:导出和备份聊天记录 · Character.AI:导出并保存聊天记录 · 全部指南。
SillyTavern 和 Termux 均为各自作者的独立项目。LonelyTavern 与这两个项目都没有关联,也未获得其认可。本文命令依据 SillyTavern 官方文档(docs.sillytavern.app)——最新说明请务必以那里为准。
