本文来源:https://blog.qjyg.de/posts/st-android/
一、准备工作
- Termux 应用(请卸载 termux 重装以保持环境干净)
卸载 termux 会使 termux 存储的全部内容消失,如果是曾经使用其他方式部署的。请确保备份好个人数据到手机存储中,不要在 termux 存储中。- 用途: 提供运行 SillyTavern 所需的特殊环境。
- 下载链接:
- MT 管理器
- 用途: 便于管理酒馆数据,进行查看、编辑、备份、迁移。
- 下载链接: MT管理器官网 (选择“>> 本地下载(正式版)”)
二、安装步骤
curl -sSL gugu.qjyg.de | bash
操作说明:
- 输入命令后,会出现咕咕助手菜单,输入
4,按回车键进行安装。 - 安装的一开始,屏幕上会跳出一个蓝白色确认窗口:
- 大陆网络, 依次 触屏 点击 第一项 、OK和 第三项 、OK。
- 海外网络, 触屏 点击两次 第一项 并点击 OK。
- 之后安装会自动进行,不需要再进行其他操作。安装卡住了怎么办?
如果安装卡住很长时间或进度很慢,可以关掉 Termux(后台划掉),然后重新打开,重复以上操作进行安装。
安装成功后,SillyTavern 会自动启动并弹出默认浏览器,直接进入页面。
Termux 保活(必做)
游玩期间 Termux 必须 保持开启 ,但安卓手机极易杀后台,保活是必做的,否则会掉线。
掉线具体表现为:
- 无法进入网页,一直黑屏。
- 可以进入网页,看似一切正常,或已经玩了一阵,突然无法连接 API、无法对话、点什么都没反应或者报错。

保活方法:
新手请将 Termux 挂小窗,如图,先能用再考虑美观:
稳定可用后可以尝试更改省电策略来代替挂小窗,以小米手机为例:
- 上滑屏幕,长按 Termux 窗口,点击 锁定。
- 在桌面长按 Termux 图标,点感叹号(应用信息),电量消耗 -> 无限制 。
其他手机自行找一下类似的权限设置(省电策略/后台运行之类字眼)。
遇到各种页面问题更换浏览器,把新的浏览器设为默认浏览器,或直接用新浏览器访问 http://127.0.0.1:8000 。
推荐浏览器: Via、Chrome、Edge、雨见。
三、基础设置
四、数据备份与恢复
1. 准备:让 MT 管理器能看到酒馆文件
初次使用需要先进行设置,让 MT 管理器可以访问到 Termux 里的文件。
- 首先确保 Termux 在后台运行中。
- 打开 MT 管理器,点击左上角三条横线按钮,然后点击三个点按钮,选择“添加本地存储”
- 击左上角三条横线按钮,选择列表中的“Termux”,然后点击“使用此文件夹”并确认授权。
- 完成后,在 MT 管理器的文件列表里就会出现“Termux Home”存储,点击它就能看到 Termux 根目录以及里面的 SillyTavern 酒馆根目录。
2. 了解重要文件和文件夹
| 文件/文件夹 | 说明 |
|---|---|
| SillyTavern | 这是酒馆的主文件夹,所有数据都在里面。 |
| SillyTavern/data/default-user | 最重要的文件夹。默认用户的所有聊天记录、角色卡、API 设置、预设和安装给用户的扩展都在这里。 |
| SillyTavern/public/scripts/extensions/third-party | 安装的全局扩展存放在这里。 |
| ad-st.sh | 助手文件本体。 |
| .config | 存放助手配置的文件夹。 |
| SillyTavern_Backups | 存放助手创建的本地备份压缩包的文件夹。 |
3. 云端备份与多端同步
点击跳转:酒馆用户数据云端备份与多端同步
- 删除任何文件夹之前先备份(打个压缩包,或者复制一下)
- 把新酒馆的
SillyTavern/data文件夹删掉,换成旧酒馆的data文件夹。(如果有问题就只替换SillyTavern/data/default-user试试) - 全局扩展不多可以重新下,多的话把这个也同样方式迁过来
SillyTavern/public/scripts/extensions/third-party,注意这是一个路径,要换的只有最后一层的third-party一个文件夹,别把上层的都删了。
