# SillyTavern-Termux

**Repository Path**: swordjs/SillyTavern-Termux

## Basic Information

- **Project Name**: SillyTavern-Termux
- **Description**: No description available
- **Primary Language**: Shell
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-07-24
- **Last Updated**: 2025-07-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SillyTavern-Termux

[![License](https://img.shields.io/badge/License-Custom-blue.svg)](https://gitee.com/print-yuhuan/SillyTavern-Termux/blob/main/LICENSE)
[![Version](https://img.shields.io/badge/Version-2025.07.20-brightgreen.svg)](https://gitee.com/print-yuhuan/SillyTavern-Termux/blob/main/menu.sh)
[![Platform](https://img.shields.io/badge/Platform-Termux%20(Android)-orange.svg)](#)
[![QQ Group](https://img.shields.io/badge/QQ%E4%BA%A4%E6%B5%81%E7%BE%A4-807134015-blue)](https://qm.qq.com/q/Z1kk7tCrcG)

一款专为中国用户优化的安卓 SillyTavern 一键部署与管理脚本，旨在提供极致便捷的本地化体验。

---

## ✨ 项目亮点

-   🚀 **一键自动化部署**: 从环境检查到应用启动，全程自动化，告别繁琐的手动配置。
-   🇨🇳 **深度本土优化**:
    -   **镜像加速**: 自动切换 `Termux` 软件源至中国大陆镜像，极大提升依赖下载速度。
    -   **网络优化**: 内置 `GitHub` 镜像代理，解决国内网络环境下仓库克隆失败的问题。
-   🛠️ **智能化管理与维护**:
    -   **依赖自检修复**: 智能检测并补全 `Node.js`、`Git` 等核心依赖，一键修复环境问题。
    -   **全能管理菜单**: 集成了启动、更新、配置、备份、插件管理、一键卸载等高频操作。
    -   **脚本自更新**: 支持在线检查并更新脚本，轻松获取最新功能与优化。
-   💄 **卓越用户体验**:
    -   **中文交互界面**: 所有提示与菜单均为中文，清晰易懂，符合国人使用习惯。
    -   **终端美化**: 自动配置更适宜代码阅读的 `MapleMono` 字体，提升视觉舒适度。
    -   **便捷插件生态**: 支持一键安装/卸载“酒馆助手”、“记忆表格”等热门第三方插件。

---

## 🚀 快速开始

### **第 1 步：安装 Termux**

为确保脚本稳定运行，请务必使用官方推荐版本。 **强烈建议卸载 Google Play 商店版**。

-   **推荐版本**: `v0.119.0` 或更高版本
-   **官方下载渠道 (二选一)**:
    -   [**GitHub**](https://github.com/termux/termux-app/releases)
    -   [**F-Droid**](https://f-droid.org/en/packages/com.termux)

> 💡 **备用方案**: 如果您无法从上述渠道下载，可**加入QQ交流群 `807134015`**，群文件已提供可完美运行该脚本的官方Termux的安装包。

### **第 2 步：执行一键部署命令**

打开 `Termux`，根据您所在的网络环境，**选择对应的命令**，长按屏幕粘贴并执行：

> 🇨🇳 **国内用户 (Gitee 镜像，推荐):**
> ```bash
> curl -O https://gitee.com/print-yuhuan/SillyTavern-Termux/raw/main/Install.sh && bash Install.sh
> ```

> 🌍 **海外或具备代理环境的用户 (GitHub):**
> ```bash
> curl -O https://raw.githubusercontent.com/print-yuhuan/SillyTavern-Termux/refs/heads/main/Install.sh && bash Install.sh
> ```

### **第 3 步：跟随引导完成**

脚本将自动完成所有配置。安装结束后，**重启 Termux** 即可进入主菜单。

---

## 📌 重要说明

-   🌐 **网络环境**
    -   **大陆用户**: 运行酒馆一键部署脚本时，**请勿开启**任何网络代理软件（如 VPN 等），以免干扰国内镜像源的连接。
    -   **海外用户**: 请确保您的代理设置正确，以便能正常访问 `GitHub` 等海外服务。

-   📢 **支持渠道变更**
    -   为提供更高效、集中的技术支持，自 `2025年07月01日` 起，**Bilibili 评论区将不再提供任何答疑服务**。

-   🆘 **寻求帮助**
    -   部署过程中如遇任何报错或疑问，**强烈建议加入 QQ 交流群 `807134015`**，群内有热心群友和作者提供及时帮助与支持。

-   💾 **存储权限**
    -   脚本首次运行时会请求存储权限，请务必点击“允许”，这是确保数据备份等功能正常运作的前提。

---

## ⚙️ 菜单功能概览

| 选项   | 功能说明                                         |
| :----- | :----------------------------------------------- |
| `1. 启动酒馆` | 🚀 运行 `SillyTavern` 主程序                       |
| `2. 更新酒馆` | 🔄 从 `GitHub` 拉取 `SillyTavern` 的最新更新       |
| `3. 酒馆配置` | 🔧 快速开启/关闭公网访问、恢复初始配置等         |
| `4. 酒馆插件` | 🧩 一键安装或卸载社区热门插件                      |
| `5. 系统维护` | 🛠️ 检查依赖、修复环境、备份/导出数据或整个应用      |
| `6. 脚本管理` | 📦 更新本脚本、查看日志、或一键彻底卸载        |
| `7. 关于脚本` | ℹ️ 查看作者信息、获取交流群号及反馈渠道          |

---

## ❓ 常见问题 (FAQ)

**Q: 为什么强烈推荐 F-Droid 或 GitHub 上的 Termux 版本？**
**A:** Google Play 商店的版本因政策原因已停止更新，缺少必要的组件和功能，会导致脚本无法正常运行。

**Q: 脚本执行报错或下载失败怎么办？**
**A:** 首先，请根据您所在的地区检查网络代理设置。其次，确保网络连接稳定。若问题持续，**请加入QQ群 `807134015` 寻求帮助**。

**Q: 如何备份我的角色卡和聊天记录？**
**A:** 在主菜单中选择 `5. 系统维护` -> `3. 导出酒馆数据`。脚本会将您的数据打包，并保存到手机的“下载”文件夹中。

---

## 💬 联系与支持

-   **项目作者**: 欤歡
-   **反馈邮箱**: `print.yuhuan@gmail.com`
-   **QQ 交流群**: `807134015` ([点击链接可尝试自动加群](https://qm.qq.com/q/Z1kk7tCrcG))
-   **项目主页**:
    -   [**Gitee (国内推荐)**](https://gitee.com/print-yuhuan/SillyTavern-Termux)
    -   [**GitHub (海外用户)**](https://github.com/print-yuhuan/SillyTavern-Termux)

> 如果您觉得这个项目对您有帮助，欢迎 Star 支持！

---

## 📄 许可协议

本项目采用“署名-非商业性使用”自定义协议。您可以自由使用、分发和修改本脚本，但**严禁用于任何商业目的**。如需商业授权，请通过邮件联系作者。