与你之歌 (ST-Manager)

作者: 贝露凛倾
版本: v1.0

📖 项目简介

本项目是一个专为 Android Termux 环境设计的 SillyTavern (酒馆) 和 gcli2api (逆向 API) 一键部署与管理工具。

主要目的:

• 为 AI 模型微调的学术交流提供便捷环境。
• 简化 Termux 上复杂的环境配置和依赖安装过程。
• 提供图形化菜单，方便管理服务的启动、停止、更新和日志查看。

⚠️ 免责声明:

• 本项目仅供学习和学术交流，无其他目的。
• 免费开源，禁止商用。二改需授权。
• 禁止用于商业传播，仅限 AI 模型研究者交流。
• 禁止利用该脚本进行违反当地法律的事情。

🚀 快速开始 (使用方法)

在 Termux 中复制并运行以下命令即可一键安装：

bash <(curl -sL https://raw.githubusercontent.com/beilusaiying/ST-beilu-Rapid_deployment/main/ST-Manager/install.sh)

安装完成后，输入以下命令启动管理菜单：

st-menu

📂 项目结构

本项目采用模块化设计，便于扩展和维护：

ST-Manager/
├── core.sh                 # 核心管理脚本 (菜单逻辑、系统功能)
├── install.sh              # 一键安装脚本 (环境检测、依赖安装)
├── conf/                   # 配置文件目录
│   └── settings.conf       # 用户设置 (代理等)
└── modules/                # 功能模块目录
    ├── sillytavern/        # SillyTavern 模块
    │   ├── functions.sh    # 功能实现 (安装、启动、日志)
    │   └── menu.conf       # 菜单配置
    └── gcli2api/           # gcli2api 模块
        ├── functions.sh    # 功能实现
        └── menu.conf       # 菜单配置

✨ 功能特性

• 一键安装: 自动配置 Node.js, Python, Git 等环境。
• SillyTavern 管理: 支持安装、启动、停止、查看日志、切换分支 (Release/Staging)。
• gcli2api 管理: 集成 gcli2api 逆向服务，支持一键部署和进程管理 (PM2)。
• 系统管理: 内置环境修复、自动更新、代理设置等实用功能。
• 中文界面: 全中文菜单，操作简单直观。

🔄 更新说明

如何更新本工具？

在主菜单中选择 系统管理 -> 更新管理工具。

注意: 如果您在中国大陆使用，更新功能通常需要配置代理。 请在 系统管理 -> 系统设置 中填入您的 VPN 代理地址 (例如 http://127.0.0.1:7890)。

如何更新 SillyTavern？

在 SillyTavern 管理 菜单中选择 更新 SillyTavern。

❓ 常见问题与解决方法 (Troubleshooting)

1. 更新时提示 "No network" 或更新失败

• 原因: 无法连接 GitHub。
• 解决: 请确保您的 VPN 已开启。进入 系统管理 -> 系统设置，开启代理开关，并填入正确的代理地址 (如 http://127.0.0.1:7890，具体端口请查看您的 VPN 软件设置)。

2. 启动 SillyTavern 失败，提示 "MODULE_NOT_FOUND"

• 原因: 依赖包未正确安装。
• 解决:
  • 在菜单中选择 SillyTavern 管理 -> 常规更新，脚本会自动尝试修复依赖。
  • 或者在 Termux 中手动进入目录运行 npm install。

3. 出现 "fatal: not a git repository" 错误

• 原因: 旧版本安装脚本未完整复制文件。
• 解决: 请重新运行上方的“快速开始”安装命令覆盖安装一次即可。

4. gcli2api 启动失败

• 原因: 端口冲突或环境问题。
• 解决: 使用 查看日志 功能检查具体报错。如果是端口占用，请尝试重启手机或手动杀掉 python 进程。

🔗 链接

• Discord 粉丝群: https://discord.gg/agHeDq9bqU

🙏 致谢 (Acknowledgments)

没有以下开源项目的付出，就没有本项目的诞生：

• 随行终端 ERALINK: https://github.com/404nyaFound/eralink (本项目的基础框架参考)
• gcli2api: https://github.com/su-kaka/gcli2api (强大的逆向 API 服务)
• SillyTavern: https://github.com/SillyTavern/SillyTavern (优秀的 AI 聊天前端)

---

Enjoy your AI journey!