Powered by

# Android (Termux) 安装

SillyTavern 可以使用 Termux 在 Android 设备上原生运行。

# 安装 Termux

  1. 从 F-Droid 或 GitHub releases 下载 Termux。
  2. 安装下载的 APK 文件。

  3. 打开 Termux 并运行您的第一个命令：

    termux-change-repo
  4. 选择 "Mirror group" 并选择离您最近的服务器。您可以触摸屏幕或使用 Unexpected Keyboard 进行滑动手势操作。

  5. 更新 Termux：

    pkg update && pkg upgrade

# 安装依赖项

安装所需的软件包：

pkg install git nodejs-lts nano

# 安装 SillyTavern

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

  • Release 分支：

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

  • Staging 分支：

    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-bit Android 需要一个无法通过 npm 安装的外部依赖项。

使用以下命令安装它：

pkg install esbuild

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

# 性能调优

由于 Android 设备的硬件限制，您可能需要调整以下 SillyTavern config.yaml 设置以获得更好的内存、存储和 CPU 使用率：

performance:
  # 避免加载所有角色数据直到需要时
  lazyLoadCharacters: true
  # 禁用磁盘缓存以减少存储使用
  useDiskCache: false
backups:
  chat:
    # 可选：禁用自动聊天备份以节省存储空间
    enabled: false

# 可选：创建别名

您可以为常用命令创建快捷方式，以便更轻松地工作。

  1. 打开编辑器修改您的 .bashrc 文件：

    nano ~/.bashrc

  2. 添加以下行来创建别名：

    # 更新 Termux 软件包
alias pkgup="pkg update && pkg upgrade"
# 启动 SillyTavern
alias st='cd ~/SillyTavern && bash start.sh'
# 更新 SillyTavern
alias stup='cd ~/SillyTavern && git pull --rebase --autostash'

  3. 保存文件并退出编辑器（在 nano 中，按 CTRL + X，然后按 Y，然后按 Enter）。

  4. 要应用更改，运行：

    source ~/.bashrc

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

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

# 延伸阅读

© Copyright 2025. All rights reserved.