安卓一键部署酒馆

酒馆部署系列教程使用的工具是我的免费开源项目 咕咕助手，请在 github 帮我点一个免费的 star 支持一下，谢谢： https://github.com/qingjue723/st-tools

一、准备工作

开始前，手机上需要先安装两款应用。全程使用普通大陆网络即可。

1. Termux 应用

   警告

   1. 纯血鸿蒙不是安卓。
   2. 如果已有 termux，建议卸载 termux 重装以保持环境干净。
   3. 卸载 termux 会使 termux 存储的全部内容消失，请确保备份好个人数据到手机存储中，不要在 termux 存储中。
   • 下载链接:
     • Github 官方下载
   备用下载链接

   • 备用链接 1
   • 备用链接 2
   • 备用链接 3
   • 备用链接 4
   • 备用链接 5
   • 备用链接 6
   • 备用链接 7

2. MT 管理器

   • 用途: 便于管理酒馆数据，进行查看、编辑、备份、迁移。
   • 下载链接: MT 管理器官网 (选择“>> 本地下载（正式版）”)

二、安装步骤

完整复制下方命令，打开 Termux 应用，粘贴进去，然后按回车键。

curl -sSL gugu.qjyg.de | bash

操作说明:

• 输入命令后，会出现咕咕助手菜单，输入 4 ，按回车键进行安装。
• 安装的一开始，屏幕上会跳出一个蓝白色确认窗口：
  • 大陆网络， 依次 触屏 点击 第一项 、OK和 第三项 、OK。
  • 海外网络， 触屏 点击两次 第一项 并点击 OK。
• 之后安装会自动进行，不需要再进行其他操作。

安装成功后，SillyTavern 会自动启动并弹出默认浏览器，直接进入页面。

三、Termux 保活（必做）

游玩期间 Termux 必须 保持开启 ，但安卓手机极易杀后台，保活是必做的，否则会掉线。

掉线的具体表现

• 无法进入网页，一直黑屏。
• 可以进入网页，也可能已经玩了一阵，看似一切正常，但无法连接 API、无法对话、点什么都没反应或者报错。

  

保活方法

• 新手请将 Termux 挂小窗，如图，先能用再考虑美观：
  

  

• 稳定可用后可以尝试更改省电策略来代替挂小窗，以小米手机为例：

  1. 上滑屏幕，长按 Termux 窗口，点击 锁定。
  2. 在桌面长按 Termux 图标，点感叹号（应用信息），电量消耗 -> 无限制 。
     其他手机自行找一下类似的权限设置（省电策略/后台运行之类字眼）。

四、基础设置

安装好后，需要进行简单设置才能开始使用。请参考以下通用教程：

-> 新手酒馆速通攻略及入门扫盲

五、数据备份与恢复

1. 准备：让 MT 管理器能看到酒馆文件

初次使用需要先进行设置，让 MT 管理器可以访问到 Termux 里的文件。

1. 首先确保 Termux 在后台运行中。

2. 打开 MT 管理器，点击左上角三条横线按钮，然后点击三个点按钮，选择“添加本地存储”。

   

   

   

3. 点击左上角三条横线按钮，选择列表中的“Termux”，然后点击“使用此文件夹”并确认授权。

   

   

4. 完成后，在 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. 云端备份与多端同步

点击跳转：酒馆用户数据云端备份与多端同步