SillyTavern-Launcher：一条命令装好 AI 应用全家桶｜从零跑通完整指南
SillyTavern-Launcher：一条命令装好 AI 应用全家桶｜从零跑通完整指南
【免费下载链接】SillyTavern-LauncherLauncher scripts for SillyTavern and ST-Extras.项目地址: https://gitcode.com/gh_mirrors/si/SillyTavern-Launcher
SillyTavern-Launcher 是一个把 SillyTavern 主应用和它的配套工具打包成命令行菜单的安装启动器。它替你把 git、Node.js、Miniconda、主应用，以及图像、文本、语音生成这些组件一次性装好、统一管理和更新，适合不想手动配依赖、想在 Linux 或 Mac 上一键跑通 SillyTavern 的初中级用户。
快速上手：4步跑通安装步骤
第 1 步 · 环境检查先确认 git 可用，后面全靠它拉代码。
git --version预期输出一行版本号，如git version 2.34.1。 人话：检查 git 是否装好，没有就先sudo apt install -y git。
第 2 步 · 获取项目克隆仓库并进入目录。
git clone https://gitcode.com/gh_mirrors/si/SillyTavern-Launcher && cd SillyTavern-Launcher预期：克隆完成并进入SillyTavern-Launcher目录。 人话：把启动器源码拉到本地，这是后面所有命令的执行位置。
第 3 步 · 安装依赖运行安装器，会自动补装 git、Node.js 并拉取主应用。
chmod +x install.sh && ./install.sh预期：出现安装菜单1. Install SillyTavern / 2. Install XTTS / ...，输入1回车开始克隆 SillyTavern，看到SillyTavern installed successfully。 人话：加执行权限后跑安装脚本，选 1 装主应用。
第 4 步 · 启动验证
chmod +x launcher.sh && ./launcher.sh预期：出现主菜单1. Update & Start SillyTavern / 2. Start SillyTavern / ...，底部提示Choose Your Destiny:，输入2即可启动。 人话：加执行权限后跑启动器，看到主菜单就算成功。
首次进入菜单前，脚本会自动检查路径、补装依赖、探测显卡（NVIDIA/AMD/CPU），耐心等它跑完。
项目地图：8个核心目录，各管一摊
| 目录 | 作用 | 你需要关注吗 |
|---|---|---|
| 项目根目录 | install.sh、launcher.sh两个入口，一切从这里开始 | ✅ |
SillyTavern/ | 主应用本体，含config.yaml与data/用户数据 | ✅ |
bin/settings/ | 各应用启动参数触发器（modules-*.txt） | 🔍 |
bin/logs/ | 运行日志，如stl.log、st_console_output.log | 🔍 |
SillyTavern-backups/ | 备份/还原生成的st_backup_*.7z | 🔍 |
image-generation/ | SD WebUI、ComfyUI、Fooocus 等图像应用 | ❌ |
text-completion/ | ooba、TabbyAPI、KoboldCPP 等文本应用 | ❌ |
voice-generation/ | XTTS、AllTalk、RVC 等语音应用 | ❌ |
新手最容易找错的地方：配置和触发器藏在
bin/settings/下，而不是根目录；且 SillyTavern 本体就装在启动器根目录里（与launcher.sh同级），不在系统全局目录。
配置项精讲：5个高频参数
项目有两类配置面：SillyTavern 自身的config.yaml（主应用端口、主机、语言等），以及启动器bin/settings/modules-*.txt里的key=value触发器（控制各应用启动开关）。绝大多数人只会碰下面这几个：
| 参数名 | 默认值 | 改它会发生什么 | 推荐值 |
|---|---|---|---|
config.yaml（SillyTavern 内） | 应用自带默认 | 改主应用端口、监听、界面语言等 | 按需（改主应用设置） |
listen_trigger | false | 开启后允许局域网/远程访问该应用 | true（远程访问必改） |
cuda_trigger | false | 开启后走 NVIDIA GPU 加速推理 | true（有 N 卡时） |
ffmpeg_install_path（launcher.sh） | /opt/ffmpeg | 指定 FFmpeg 安装目录 | /opt/ffmpeg（换目录时改） |
sdwebui_port_trigger | false | 为 SD WebUI 自定义端口 | 按需（改端口时） |
这些触发器文件都是纯文本
key=true/false，直接编辑或走主菜单「Toolbox → Editor」切换均可，改完下次启动生效。
踩坑速查：5个高频问题
- 启动直接报错退出⚠️ → 原因：安装路径含空格 → 修复：把项目挪到无空格目录后重跑
./launcher.sh - 同样路径报错退出⚠️ → 原因：路径含
!#等特殊字符 → 修复：换到纯字母数字路径再启动 - 提示 node not found in PATH💡 → 原因：Node.js 未进 PATH → 修复：走 Toolbox 装 Node.js，或
sudo apt install -y nodejs npm - 备份时报 7z is not installed💡 → 原因：缺少 7-Zip → 修复：走 Toolbox → App Installer 安装 7-Zip
- 提示 SillyTavern directory not found⚠️ → 原因：还没跑过 install.sh → 修复：先执行
./install.sh
适合想省掉繁琐依赖配置、用统一菜单管理 SillyTavern 与各类生成工具的用户；更多菜单与细节见仓库自带的README.md与launcher.sh主菜单。
【免费下载链接】SillyTavern-LauncherLauncher scripts for SillyTavern and ST-Extras.项目地址: https://gitcode.com/gh_mirrors/si/SillyTavern-Launcher
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考