Android (Termux) 安装

SillyTavern 可以通过 Termux 在 Android 设备上原生运行。

安装 Termux

请勿从 Google Play Store 安装 Termux，该版本已停止维护。请改用 F-Droid（推荐）或 GitHub releases 获取最新版本。

从 F-Droid 或 GitHub releases 下载 Termux。
安装下载好的 APK 文件。
打开 Termux 并运行你的第一条命令：
```
termux-change-repo
```
选择 “Mirror group”，然后选择离你最近的服务器。你可以直接触屏操作，也可以配合 Unexpected Keyboard 使用滑动手势。
更新 Termux：
```
pkg update && pkg upgrade
```

安装依赖

安装所需的软件包：

pkg install git nodejs-lts nano

如果你使用的是 32 位 Android，请参阅下方的常见错误章节进行额外操作。

安装 SillyTavern

克隆 SillyTavern 仓库（如何选择分支）：

Release Branch：

git clone https://github.com/SillyTavern/SillyTavern -b release

Staging Branch：

git clone https://github.com/SillyTavern/SillyTavern -b staging

运行 SillyTavern

要运行 SillyTavern，请进入克隆好的目录并执行启动脚本：

cd ~/SillyTavern
bash start.sh

要更新 SillyTavern，请进入 SillyTavern 目录并执行：

cd ~/SillyTavern
git pull --rebase --autostash

请参阅下方的别名章节，了解如何创建快捷命令以简化这一流程。

常见错误

Unsupported platform: android arm LEtime-web

32 位 Android 需要一个无法通过 npm 安装的外部依赖。

使用以下命令安装它：

pkg install esbuild

然后继续执行上方的安装步骤。

性能优化

如需提升性能的通用技巧，请参阅相应的 FAQ 章节。

由于 Android 设备存在硬件限制，你可能需要调整以下 SillyTavern config.yaml 设置，以优化内存、存储和 CPU 占用：

performance:
  # Avoid loading all character data until needed
  lazyLoadCharacters: true
  # Disable disk caching to reduce storage usage
  useDiskCache: false
backups:
  chat:
    # Optional: Disable automatic chat backups to save storage
    enabled: false

可以使用 Termux 自带的 nano 文本编辑器来编辑 config.yaml 文件：nano ~/SillyTavern/config.yaml

可选：创建别名

你可以为常用命令创建快捷方式，让操作更顺手。

打开编辑器修改你的 .bashrc 文件：
```
nano ~/.bashrc
```

添加以下内容来创建别名：

# Update Termux packages
alias pkgup="pkg update && pkg upgrade"
#Start SillyTavern
alias st='cd ~/SillyTavern && bash start.sh'
# Update SillyTavern
alias stup='cd ~/SillyTavern && git pull --rebase --autostash'

保存文件并退出编辑器（在 nano 中，按 CTRL + X，然后按 Y，再按 Enter）。
要使更改生效，请运行：
```
source ~/.bashrc
```

现在你可以使用以下命令：

st 启动 SillyTavern
stup 更新 SillyTavern
pkgup 更新 Termux 软件包