SillyTavern-Termux

📖 项目简介

SillyTavern-Termux 是专为安卓设备打造的 SillyTavern 一站式部署与管理解决方案。

基于原生 Termux 环境，只需一条命令即可完成自动化安装、配置与管理，并配备完善的中文交互菜单，让您在手机上也能享受完整而强大的 SillyTavern 体验。

什么是 SillyTavern？

SillyTavern 是一个强大的 LLM（大型语言模型）前端界面，为高级用户提供丰富的功能：

• 支持多种 AI 模型接口（OpenAI、Claude、Gemini、AI Horde 等）
• 完善的角色卡和聊天管理系统
• 强大的扩展插件生态
• 高度可定制的界面和功能

🆕 最近更新

当前版本 v2026.10.16，支持按公有目录或用户目录管理插件，并依据插件仓库文档与参考资料完善七个插件的说明。

• 👥 多用户插件：安装与卸载先选择范围，1 固定为公有目录，其余按用户名排序；私有插件分别管理，卸载仅影响所选范围
• 🧩 插件说明：统一简介、核心亮点、使用须知与参考文档，按实际功能补充安全提示
• 🎨 插件配色：保留完善后的文案，插件菜单、详情页标题和正文配色对照 cc0e75b 恢复
• ✍️ 格式与署名：区分插件作者与配套预设作者；七个插件统一使用 © 2026 {copyright_owner}. All rights reserved. 页脚，另行保留已确认的许可说明；记忆表格交流反馈使用“官方Q群：1030109849”

v2026.10.15 更新内容：

• 🧩 新增插件：新增 龙血玄黄·数据库，开发作者 Albus，支持安装与卸载
• 🛡️ 监听与认证：使用 YAML 解析、校验和原子替换修改配置；关闭监听保留账户认证，修改后重启酒馆生效
• 🔒 维护互斥：恢复、更新、依赖修复、版本切换和卸载与启动共用系统锁，请先停止运行中的酒馆再维护
• 🔧 版本与内存：切换前检查目标版本的 Node.js 要求；内存限制独立保存，自动迁移旧设置，更新后继续生效
• 🧪 安装与输入：校验现有酒馆本体；自启动检测排除注释并检查写入结果；修复超长数字校验、输入结束循环和 Android 内网地址前缀

v2026.10.14 更新内容：

• 🔒 启动恢复：启动锁改用系统 flock 锁，相关进程结束后自动释放；升级前遗留的空锁目录会自动清理，仍在运行的服务会阻止重复启动
• 🔧 依赖完善：安装与依赖修复补齐 util-linux，提供 flock 命令；目录权限或系统锁错误会单独提示
• 📦 Discord 更新：348.10 - Stable（348010），安装包适用于 arm64-v8a 设备，最低要求 Android 7.0，脚本下载链接已同步更新

v2026.10.13 更新内容：

• 🛡️ 安装与恢复保护：保留现有非 Git 安装，拒绝无效本体与符号链接备份，目录替换失败时整组回滚
• 🧪 产物校验：下载与自更新校验成功后才替换，备份打包或校验失败不会提示成功
• 🔧 维护修复：依赖修复接入酒馆模块安装，检查目标版本的 Node.js 要求，兼容带空格的备份文件名
• 🔗 进程与网络：仅清理本次启动会话的服务，下载统一设置超时、低速检测和重试
• 🧩 插件与作者：新增 小白X、柏宝书、提示词模板，支持安装与卸载；记忆表格 补齐木悠、LSR 两位开发作者，模型插件统一命名为“自定义模型”
• ✍️ 署名格式：开发作者优先使用中文名，无中文名时保留英文，多位作者用顿号分隔；版权署名使用英文，项目与插件说明的版权年份统一为 © 2026
• 🎯 酒馆社群：酒馆频道、类脑频道、旅程频道、棱镜频道、尾巴镇频道、喵喵电波频道、LOFI频道，共 7 项，输入频道编号后回车即可选择
• 💬 加群交流：现有群统一命名为 QQ一群（807134015），新增 QQ二群（1039656113）；作者信息展示两个群号，加群交流支持选择一群或二群，文档中的加群入口同步更新
• 🖌️ 字体致谢与许可：感谢 subframe7536 提供 Maple Mono 字体，作者信息中同步展示字体来源与许可；仓库附带上游原始许可证 MapleMono-OFL.txt，字体按 SIL Open Font License 1.1 分发

完整更新内容可在菜单 6. 脚本管理 → 2. 查看更新日志 查看。

✨ 核心特性

🚀 极致自动化部署

一键安装，全自动配置

• ✅ 零配置安装：一条命令完成环境检测、依赖安装、字体配置、主程序部署
• ✅ 智能依赖管理：自动检测并安装 Node.js、Git、curl 等核心依赖，失败自动重试
• ✅ 开箱即用：安装完成后自动配置启动项，重启 Termux 即可进入管理菜单
• ✅ 容错机制：依赖安装失败自动清理缓存并重试（最多 3 次），下载失败及时中止并提示

🛠️ 全功能管理菜单

7 大功能模块，覆盖全生命周期管理

💖 卓越用户体验

专为中文用户打造的友好界面

• 🎨 全中文界面：菜单、提示、帮助文档全面中文化，无语言障碍
• 🖌️ 终端美化：自动配置 Maple Mono 等宽字体（subframe7536 开发，SIL Open Font License 1.1），提升终端可读性
• 📱 移动优化：界面布局针对手机屏幕优化，操作流畅便捷
• 🔗 智能跳转：支持一键跳转 QQ一群、QQ二群、邮件客户端、Discord 频道

🌐 丰富资源生态

连接社区，获取资源

• 📦 应用一键安装：内置 Discord 348.10 - Stable 下载器（arm64-v8a，Android 7.0+），下载后自动调用系统安装器（termux-open，兼容新版 Android）
• 🎯 社群直达：7 个 Discord 社群（酒馆频道、类脑频道、旅程频道、棱镜频道、尾巴镇频道、喵喵电波频道、LOFI频道）一键访问
• 🧩 插件市场：集成酒馆助手、记忆表格、自定义模型、小白X、柏宝书、提示词模板、龙血玄黄·数据库，支持安装与卸载
• 📚 完善帮助：详细的局域网配置指南、常见问题解答

🔒 数据安全保障

完善的备份与恢复机制

• 💾 多层级备份：支持用户数据独立备份和完整本体备份
• 📤 便捷导出：备份文件自动保存至手机「SillyTavern」专用文件夹
• 📥 智能恢复：自动检测存储权限，从备份目录智能识别文件，一键恢复
• 🧪 完整性校验：恢复前自动校验压缩包，先解压到临时目录、成功后才替换，损坏备份不会破坏现有数据
• ⚠️ 安全提示：恢复操作前强制确认，避免误操作导致数据丢失
• 🔐 权限管理：导出/导入前自动检测并申请存储权限，确保操作顺利进行

🚀 快速上手

只需三步，即可在安卓设备上运行 SillyTavern！

步骤 1：安装 Termux

⚠️ 重要提示：推荐使用官方 GitHub 或 F-Droid 发行版。Google Play 目前有面向 Android 11+ 的实验分支，与常用发行版存在功能差异，完整兼容性需要单独验证。

📥 官方下载渠道

💡 下载遇到问题？ 加入 QQ一群（807134015） 或 QQ二群（1039656113），群文件中提供 Termux 安装包备用下载。

步骤 2：一键安装脚本

打开 Termux，粘贴并执行以下命令：

curl -O https://raw.githubusercontent.com/print-yuhuan/SillyTavern-Termux/refs/heads/main/Install.sh && bash Install.sh

安装过程自动完成以下操作：

1. ✅ 环境检测与存储权限配置
2. ✅ 更新包管理器
3. ✅ 安装核心依赖（Git、Node.js、curl 等）
4. ✅ 下载并配置终端字体
5. ✅ 克隆 SillyTavern 官方仓库
6. ✅ 下载管理菜单脚本
7. ✅ 配置菜单自启动
8. ✅ 安装 SillyTavern 依赖包

⏱️ 预计耗时：首次安装约 5-15 分钟（视网络状况而定）

步骤 3：启动使用

安装完成后，重启 Termux 即可自动进入管理菜单。

🎉 恭喜！现在您可以：

• 选择 1. 启动酒馆 开始使用 SillyTavern
• 选择 3. 酒馆配置 → 1. 局域网配置项 设置局域网访问
• 选择 4. 酒馆插件 安装社区热门插件

📋 功能详解

📊 主菜单功能总览

🔧 局域网配置详解

通过 3. 酒馆配置 → 1. 局域网配置项 可以：

• 开启/关闭网络监听：允许局域网内其他设备访问 SillyTavern
• 获取内网地址：自动检测并显示设备的局域网 IP 地址
• 查看连接帮助：详细的局域网连接指南和常见问题解答

监听配置通过校验后才写入，重启酒馆后生效。关闭监听会保留已有账户与密码认证设置。

支持的连接方式：

1. 两台设备连接同一 WiFi 路由器
2. 其他设备连接本机开启的热点
3. 本机连接其他设备开启的热点

🔐 安全提醒：开启网络监听后，SillyTavern 默认用户没有密码，同一网络内的任何设备都可直接访问。请启动酒馆后在「用户设置 → 管理用户」中为账户设置密码。

🔗 关联启动配置详解

通过 3. 酒馆配置 → 3. 关联启动配置 可以：

• 开启/关闭关联启动：控制启动酒馆时是否同时启动 Gemini-CLI-Termux 反代服务
• 查看反代日志：实时查看反代服务的运行日志
• 智能日志管理：超过 5MB 自动清理，防止占用过多空间

支持的启动模式：

使用前提：

• 模式 2 需要先安装 Gemini-CLI-Termux
• 确保已安装 Python 环境（pkg install python）
• 反代服务将后台运行，日志保存在 $HOME/setup.log

注意事项：

• 退出酒馆（停止 SillyTavern）时会自动关闭本次会话的反代服务，避免后台进程残留
• 同一时间只允许一个脚本启动会话；启动锁由系统管理，相关进程结束后自动释放。划掉 Termux 后若全部服务已停止，可直接再次启动；若服务仍在后台运行，会提示先停止现有服务
• 升级前遗留的空 $HOME/.st_run.lock 目录会在确认没有现有服务后自动清理。新的 $HOME/.st_run.flock 是持久锁文件，文件存在不代表服务正在运行，无需手动删除
• 划掉后台不一定代表全部服务已停止，脚本会保留仍在运行会话的互斥保护，避免重复启动
• 可通过「查看反代日志」功能检查反代服务运行状态
• 日志文件超过 5MB 时，下次启动会自动清理

🧩 可用插件列表

安装后刷新酒馆页面，再按插件说明启用和配置。详情页提供功能、依赖与相关文档；记忆表格的 LSR 配套方案、数据库的脚本版说明均已标明适用范围。

安全提示：酒馆助手、小白X 的代码渲染及提示词模板能够执行脚本，只应加载可信内容。向外部模型、绘图或语音服务发送数据前，请确认服务配置与发送范围。

文案格式、作者署名、版权与许可来源见 插件说明规范与资料来源。

👥 公有与私有插件

通过 4. 酒馆插件 → 1. 安装插件 或 2. 卸载插件，先选择安装或卸载范围：

用户列表只读取 data 下直接存在的用户目录，忽略 _ 或 . 开头的目录、普通文件和符号链接。默认用户 default-user 也会列出；没有用户目录时仍可选择公有范围。私有安装会按需创建所选用户的 extensions 目录，不会创建用户账户或用户目录。

• 安装：选择范围后进入插件列表，再选择插件并确认安装。
• 卸载：选择范围后，仅显示该范围内已安装的插件，输入插件编号并确认卸载。同一插件在公有目录或其他用户目录中的副本不受影响。
• 返回：输入 0 逐级返回，可重新选择范围。

💾 备份与恢复

支持两种备份模式：

备份文件存储位置：/storage/emulated/0/SillyTavern/（手机「SillyTavern」文件夹）

安全恢复机制：

• 🧪 恢复前自动校验压缩包完整性，损坏备份直接中止
• 📦 先解压到临时目录并验证目录结构；替换失败时整组回滚，回滚失败会保留副本并显示位置
• 💡 本体备份不含依赖，恢复后首次启动会自动安装（需联网）
• 📌 恢复过程会临时占用与备份相当的额外存储空间
• 🔒 恢复前请停止所有酒馆服务；运行会话或其他维护持有系统锁时，目录替换会被拒绝

智能权限管理：

• 📂 导出前自动检测存储权限，未授权时自动申请
• 📁 备份目录不存在时自动创建
• 🔍 导入前验证备份目录和文件，提供清晰提示

🔄 版本切换

通过 5. 系统维护 → 7. 酒馆版本切换，可在 SillyTavern 各发布版本间自由切换：

核心功能：

• 🏷️ 查看版本标签：列出所有可用的 Git 标签版本，显示发布日期和当前版本
• 🔀 切换酒馆版本：切换到任意已发布的标签版本，自动重新安装对应依赖
• 📖 版本切换帮助：详细的使用指南、注意事项和常见问题解答

使用场景：

安全保障：

• ⚠️ 切换前自动检测未提交的更改
• 🔒 二次确认机制防止误操作
• 💾 建议切换前先备份数据
• 🔄 支持通过「更新酒馆」回到最新 release 分支

智能依赖管理：

• 🔧 版本切换后自动清理旧依赖
• 🧪 切换代码前检查目标版本的 Node.js 要求，不兼容时保留当前代码与依赖
• ♻️ 三次重试机制确保依赖安装成功
• 📦 失败时提供修复建议和指引

📌 注意事项

系统要求

• ✅ 操作系统：Android 7.0 及以上版本
• ✅ Termux 版本：v0.118.3 或更高（请使用官方渠道下载）
• ✅ 存储空间：至少 500MB 可用空间（推荐 1GB 以上）
• ✅ 网络连接：稳定的网络环境（首次安装需下载约 200MB 数据）
• ✅ Node.js 版本：当前 SillyTavern release 要求 20.x 或更高，具体以目标版本 package.json 中的 engines.node 为准（脚本安装依赖时会检查兼容性）

权限要求

首次运行脚本时，需要授予以下权限：

• 📂 存储权限：用于备份/恢复数据、访问「SillyTavern」备份文件夹
• 🌐 网络权限：用于下载依赖、更新程序和访问 AI 服务

⚠️ 请务必在弹窗提示时点击「允许」，否则部分功能将无法正常使用。

权限说明：

• 安装脚本和菜单脚本会在需要时自动申请存储权限
• 存储权限用于在 /storage/emulated/0/SillyTavern/ 目录中读写备份文件
• 如果权限申请失败，相关备份/恢复功能将无法使用

使用建议

• 📶 网络环境：建议在 WiFi 环境下进行首次安装和大版本更新
• 🔄 定期备份：建议每周备份一次用户数据，避免意外丢失
• 📱 设备性能：推荐使用内存 4GB 及以上的设备，以获得更流畅的体验
• 🔋 后台运行：启动酒馆时脚本会自动启用唤醒锁（termux-wake-lock）并在退出时解除；使用期间仍建议尽量保持 Termux 前台运行，防止系统杀后台

❓ 常见问题

🧰 安装与环境

💾 备份与数据

🌐 配置与使用

🔄 更新与版本

🔗 关联启动

⚙️ 脚本与自定义

🔗 相关链接

SillyTavern 官方资源

• 📦 官方仓库：SillyTavern/SillyTavern
• 📖 官方文档：docs.sillytavern.app
• 💬 Discord 服务器：discord.gg/sillytavern
• 🗣️ Reddit 社区：r/SillyTavernAI

本项目资源

• 🏠 项目主页：github.com/print-yuhuan/SillyTavern-Termux
• 📋 问题反馈：提交 Issue
• 📝 更新日志：查看 Releases

💬 社区与支持

获取帮助的多种方式

QQ一群 点击加入 QQ一群 QQ二群 点击加入 QQ二群 实时在线交流 快速获取帮助 分享使用经验

邮件反馈 发送邮件 详细问题描述 功能建议提交 商业授权咨询

GitHub Issues 提交反馈 Bug 报告 功能请求 公开讨论

反馈时请提供

为了更快地解决问题，请在反馈时提供以下信息：

• 📱 设备信息：手机型号、Android 版本
• 📦 软件版本：Termux 版本、脚本版本
• 📋 问题描述：详细的错误信息或截图
• 🔄 复现步骤：如何触发该问题

🤝 贡献指南

欢迎为本项目贡献代码或建议！

如何贡献

1. Fork 本仓库到您的 GitHub 账户
2. 克隆仓库到本地：git clone https://github.com/your-username/SillyTavern-Termux.git
3. 创建分支：git checkout -b feature/your-feature-name
4. 提交更改：git commit -m "Add: your feature description"
5. 推送到 GitHub：git push origin feature/your-feature-name
6. 提交 Pull Request，描述您的更改

贡献类型

• 🐛 Bug 修复：修复已知问题
• ✨ 新功能：添加实用的新功能
• 📝 文档改进：完善 README、添加使用指南
• 🌍 国际化：翻译成其他语言
• 🎨 界面优化：改进菜单布局和交互体验

代码规范

• 使用清晰的变量和函数命名
• 添加必要的注释说明
• 保持与现有代码风格一致
• 测试您的更改确保功能正常

回归测试

测试在 Linux/WSL 的私有临时目录运行，不操作真实酒馆数据。需要 Python、Bash、Git、Node.js、npm 和 unzip；YAML 回归还需一个已有的 yaml 包，可使用酒馆已安装的依赖：

ST_REVIEW_YAML_DIR="$HOME/SillyTavern/node_modules/yaml" python3 -m unittest discover -s tests -v

YAML 包未提供时，相应测试会明确跳过；发布前请确保这些测试也全部通过。

📄 开源协议

本项目许可

本项目采用 自定义非商业许可协议（基于 CC BY-NC 4.0），主要条款：

• ✅ 允许：个人使用、学习、修改、分发
• ❌ 禁止：商业用途、出售、集成到付费产品
• 📝 要求：署名原作者、包含许可协议文本

SillyTavern 许可

本项目部署的 SillyTavern 采用 AGPL-3.0 许可协议。

Maple Mono 字体许可

仓库内的 MapleMono.ttf 为 Maple Mono NF CN 字体，来源于 subframe7536/maple-font，由 subframe7536 开发。

该字体采用 SIL Open Font License 1.1，字体的原始版权与许可声明完整保存在 MapleMono-OFL.txt，字体资源按该许可证分发。

商业授权

本项目禁止用于商业用途，请通过以下方式联系作者：

• 📧 邮件：print.yuhuan@gmail.com
• 💬 QQ一群：807134015
• 💬 QQ二群：1039656113

详细许可条款请查看 LICENSE 文件。

⭐ 致谢

特别感谢

• 💖 SillyTavern 项目及其开发团队
• 💖 Termux 项目，为安卓提供了强大的 Linux 环境
• 💖 Maple Mono 项目及开发者 subframe7536，为本项目提供终端等宽字体资源
• 💖 所有社区插件开发者（KAKAA、青空莉想做舞台少女的狗、木悠、LSR、LenAnderson、biex、柏柏、zonde306、Albus 等）
• 💖 为本项目提供反馈和建议的所有用户

支持本项目

如果本项目对您有帮助，欢迎通过以下方式支持：

• ⭐ 在 GitHub 点亮 Star
• 🔀 Fork 本项目并提交改进
• 📢 分享给更多需要的朋友
• 💬 加入 QQ一群（807134015） 或 QQ二群（1039656113） 参与社区建设

您的支持是项目持续维护的最大动力！