SillyTavernLauncher酒馆启动器

Appearance

SillyTavernLauncher-For-Termux ​

仓库地址：https://github.com/LingyeSoul/SillyTavernLauncher-For-Termux

提示

v0.8.0 起启动器自带 WebUI 管理界面（手机浏览器打开即用，st webui 启动），同时保留完整命令行；一键安装脚本会把环境全部配置好，无需手动配置环境。旧版本（v0.7.x 及更早的 Python 版）为纯命令行版本，升级到 0.8.0 请看 0.8.0 重构说明与升级指南。

国际用户一键安装脚本：

bash
source <(curl -s https://raw.githubusercontent.com/LingyeSoul/SillyTavernLauncher-For-Termux/main/install_termux.sh)

中国大陆用户一键安装脚本：

bash
source <(curl -s https://gh-proxy.org/https://raw.githubusercontent.com/LingyeSoul/SillyTavernLauncher-For-Termux/main/install_termux_cn.sh)

推荐的Termux版本 ​

点我使用镜像下载Termux V0.118.3

警告

推荐使用作者推荐的Termux版本，否则因为termux版本过低，可能导致安装脚本提示环境不兼容

Termux 版 0.8.0 重构说明与升级指南 ​

0.8.0 是 Termux 版启动器历史上最大的一次版本迭代：整个启动器从 Python 迁移到 Node.js/TypeScript，与 SillyTavern 共用同一运行时（不再需要安装 Python），并新增了 WebUI 管理界面，旧版 Python 代码正式退役。本节基于 0.8.0 源码整理，说明 0.8.0 与 0.7.x（以 v0.7.1 为基准）的区别、0.8.0 的特色功能，以及从 0.7.x 升级的注意事项。

当前状态

0.8.0 已发布。遇到问题欢迎到 仓库 Issues 反馈，你的反馈会直接影响下一个版本。

0.7.x 与 0.8.0 的区别 ​

技术底座（重写的核心） ​

维度0.7.x（Python 版）0.8.0（Node.js 版）
技术栈Python + argparse 交互式 CLITypeScript（strict 模式），node --experimental-strip-types 直接运行，后端零构建
运行时Python venv 虚拟环境，pip 安装 4 个依赖（ruamel.yaml、flask、requests、aiohttp）与 SillyTavern 共用 Node.js（≥ 22.12），运行时 npm 依赖仅 1 个包（yaml），ZIP / HTTP / 加密全部使用 Node 内置能力
管理界面❌ 无（纯命令行）✅ Vue 3 + Vuetify 4 WebUI，手机浏览器打开即用
安装脚本需要安装python + nodejs-lts + gitnodejs-lts + git（不再安装 Python）
测试体系pytest（同步安全测试）Vitest 单元测试（协议、镜像、配置、WebUI、ZIP 等多套件）+ tsc / vue-tsc 类型检查门禁
配置存储config.jsonconfig.json（完全兼容，原子写入 + 0600 权限，旧键自动迁移）

功能变化（✅ 新增 / ⬆️ 增强 / ➡️ 继承） ​

功能0.7.x 已有0.8.0 的变化
管理界面无，全部操作走命令行菜单✅ 新增 WebUI 管理界面（详见下文）：安装/启动/停止/更新、实时日志、数据同步、配置管理、版本切换、迁移安装全部图形化操作
GitHub 镜像手动三选一（官方 / gh-proxy.org / gh.llkk.cc）⬆️ 升级为 54 站智能镜像体系（自桌面版迁移）：未选定镜像时自动测速选优、仅在镜像失效时取证切换、支持全量测速与手动点选、可输入自定义域名；gitconfig 全局重写 + npmmirror 国内镜像联动
启动器自更新CLI 内 git pull⬆️ CLI 与 WebUI 双入口（关于页可检查更新）；版本号解析同时兼容旧版 version.py 与新版 version.ts，更新后自动执行 npm install
st 默认行为autostart 布尔开关（菜单 / 直接启动酒馆）⬆️ 升级为 startup 三态：menu（交互菜单）/ st（直启酒馆）/ webui（直启 WebUI）；旧配置自动迁移，autostart 命令仍兼容
镜像切换命令st set-mirror --mirror <github|ghproxy|ghllkk>⬆️ st set-mirror <github|auto|镜像域名>，新增 auto 智能模式；旧键值 ghproxy / ghllkk 仍兼容
跨设备数据同步Token 鉴权局域网同步、ZIP 全量 + 增量、安全加固➡️ 继承（Node 等价重写，协议与安全机制不变：防路径穿越 / 防符号链接 / 防 ZIP 炸弹 / 恒时令牌比较，安全测试全量平移）
版本管理git tag 列表查看与一键切换➡️ 继承，WebUI「更多」页可直接操作
ST 配置管理端口 / 局域网监听⬆️ 继承并增强：config.yaml 注释保留式读写不变，WebUI 配置页新增 IP / Host 白名单管理与网段自动检测
迁移器扫描设备上已有 SillyTavern 安装并迁移➡️ 继承
用户协议远程拉取协议并本地缓存，版本变化重新弹出➡️ 继承
依赖修复无✅ 新增「一键修复」：重新安装 node_modules，依赖损坏时不用敲命令

命令行变化一览 ​

0.8.0 保留了 0.7.x 的全部命令（install / start / launch / update / config / autostart / set-mirror / sync / version / st-config / migrate），在此之上新增：

bash
st webui                # 启动 WebUI（默认 http://127.0.0.1:8300，自动打开浏览器；--no-open 关闭）
st startup menu         # 输入 st 时显示交互菜单（默认）
st startup st           # 输入 st 时直接启动酒馆（原一键启动）
st startup webui        # 输入 st 时直接启动 WebUI
st set-mirror auto      # 开启智能镜像（自动测速选优 + 故障自动切换）

0.8.0 特色详解 ​

📱 WebUI 管理界面（最大新增） ​

st webui 启动后自动调用系统浏览器打开 http://127.0.0.1:8300（Termux 使用 termux-open-url），不想自动打开可加 --no-open。六个页面：

  • 状态页 — 启动 / 停止 / 重启 / 安装 / 更新 SillyTavern，访问地址与环境检测，启动器新版本横幅
  • 日志页 — SillyTavern 进程与后台任务实时日志（SSE 推送，无需手动刷新）
  • 同步页 — 同步服务器启停、分享地址一键复制、令牌轮换、从远端拉取数据
  • 配置页 — ST 端口 / 局域网监听 / IP 与 Host 白名单（网段自动检测）、智能 GitHub 镜像（测速选优 / 全量测速 / 手动点选）
  • 更多 — 历史版本切换、迁移扫描、依赖一键修复、启动器重启
  • 关于 — 版本信息、检查更新、仓库与 QQ 频道入口

WebUI 安全边界

WebUI 默认只监听 127.0.0.1（仅本机可访问）。如果你在 config.json 中把 webui.host 配置为局域网监听地址，会自动启用访问令牌（webui.token），浏览器需通过 ?token= 查询参数或 Bearer 请求头认证后才能操作。

🪞 智能 GitHub 镜像加速（自桌面版迁移） ​

0.7.x 只能在 3 个镜像里手动三选一；0.8.0 带来了桌面版同款的智能镜像体系：

  • 54 站镜像注册表：内置 54 个 GitHub 加速镜像站点
  • 自动测速选优：开启智能模式后，未选定镜像时自动并发测速（分批探测，全部失效才会判定无可用镜像），选出当前最快的站点
  • 取证式故障切换：只在当前镜像实际请求失败时才自动切换，不会频繁跳变
  • 手动模式：支持全量测速（只测不切）、从推荐列表点选、输入自定义镜像域名
  • npm 联动：依赖安装自动使用 npmmirror 国内镜像
  • 镜像加速原理不变：改写 gitconfig 全局 insteadOf，SillyTavern 仓库 remote 始终保持官方地址

⚙️ 运行时统一（与酒馆同栈） ​

  • SillyTavern 本身就是 Node.js 应用，0.8.0 起启动器与酒馆共用同一运行时——Termux 里不再需要 Python
  • 安装脚本只安装 nodejs-lts (≥ 22.12) 和 git，脚本会自动校验 Node 版本
  • 运行时 npm 依赖只有 1 个包（yaml），同步服务器的 HTTP / ZIP / 加密全部用 Node 内置模块实现，npm install 失败面大幅缩小
  • TypeScript strict 模式 + 类型检查门禁 + Vitest 测试，后续版本迭代更有质量保障

从 0.7.x 升级 ​

必须重新运行安装脚本

0.7.x → 0.8.0 是跨运行时升级（Python → Node.js），不能用旧版的 st update stl 完成升级——旧更新流程拉取到新代码后，st 命令仍指向 Python，会直接不可用。请重新运行一键安装脚本：

bash
# 国际用户
source <(curl -s https://raw.githubusercontent.com/LingyeSoul/SillyTavernLauncher-For-Termux/main/install_termux.sh)

# 中国大陆用户
source <(curl -s https://gh-proxy.org/https://raw.githubusercontent.com/LingyeSoul/SillyTavernLauncher-For-Termux/main/install_termux_cn.sh)

安装脚本检测到已有安装时自动 git pull 更新代码，随后安装 Node 依赖、构建 WebUI 前端并重建 st 命令，无需先卸载。

升级说明：

  • 配置保留：config.json 完全兼容，旧的 autostart 开关自动迁移为 startup 行为（true → 直启酒馆，false → 显示菜单），镜像旧键值（ghproxy / ghllkk）继续可用
  • 数据不动：SillyTavern 本体、config.yaml、聊天数据与用户目录、同步配置全部保持原样
  • Python 环境不再使用：旧版创建的 Python venv 不会再被调用，保留无害，介意空间可手动删除
  • Node 版本：需要 Node.js ≥ 22.12（安装脚本会自动安装 nodejs-lts 并校验版本）
  • 0.8.0 之后的版本间更新，可继续使用 st update stl 或 WebUI 关于页的「检查更新」

Copyright © 2025-现在 泠夜Soul