功能介绍

提示

本教程基于 v2.0（GPUIX 重写版）编写，旨在帮助新手知晓并理解启动器的各项功能。1.x 旧版功能差异见 v2.0 新特性。

界面总览

2.0 采用左侧导航 + 右侧内容的布局，共 6 个页面：

• 终端：主页面，酒馆的安装 / 启动 / 停止 / 更新操作和实时日志都在这里
• 版本：SillyTavern 历史版本查看与一键切换
• 同步：局域网数据同步（服务器 / 客户端）
• 扩展：SillyTavern 扩展的安装与卸载
• 设置：环境、酒馆设置、启动器设置三个分页
• 关于：版本信息、相关链接与更新检查

标题栏为自绘沉浸式设计，支持拖动移动、最小化与关闭。点击关闭按钮时：开启系统托盘则收进托盘，未开启托盘会弹出退出确认，防止误关正在运行的酒馆。

酒馆管理（终端页）

终端页底部提供五个操作按钮：安装 / 启动 / 停止 / 更新 / 清空，操作进行中相关按钮会自动互斥禁用，防止误操作。

• 安装：一键克隆安装 SillyTavern 并安装依赖，npm 依赖走国内镜像
• 启动：一键启动酒馆；开启「自动检查酒馆更新」后，启动前会先检查并完成更新
• 更新：采用 git pull --rebase --autostash 更新酒馆，package-lock 冲突自动恢复（最多重试 2 次）
• 终端日志：ANSI 彩色渲染（256 色/真彩），按窗口宽度自动折行，大日志量下滚动流畅

GitHub 镜像加速

官方 GitHub 访问慢时，可使用加速镜像加速酒馆的安装、更新和扩展下载。

• 官方源 / 加速镜像二选一：设置 → 环境 中一键切换
• 自动测速选优：默认开启，启动器会自动测速选择最快的镜像，测速结果定期自动刷新
• 故障自动切换：当前镜像不可用时自动切换到可用镜像；手动指定镜像后则固定使用你选的镜像
• 镜像源设置：可一键测速、手动指定镜像站，或切回官方源

提示

镜像加速通过改写 Git 配置（insteadOf）生效，酒馆仓库的 remote 始终保持官方地址，不影响手动 git 操作。

运行环境模式（设置 → 环境）

三种运行环境模式，按「懒人包 env 目录 → 系统工具链 → 内置运行时」自动探测，也可手动切换：

• 内置懒人包环境（portable，默认）：工具链来自启动器目录旁的 env/（便携 Git + Node.js），随懒人包分发，开箱即用、不污染系统
• 系统环境（system）：直接使用系统已安装的 Git 与 Node.js 18+；此模式下可配合「修改 Git 配置文件」做镜像改写
• 内置运行时（embedded，实验性）：以启动器内嵌的 Bun 运行时启动酒馆、安装依赖，Git 由进程内实现完成——无需安装任何外部环境，单文件也能跑

内置运行时（实验性）

SillyTavern 官方主运行时为 Node.js，内置模式使用 Bun，个别功能与扩展可能异常。切换到该模式前会弹出兼容性风险确认，设置页也会常驻提示。遇到问题请切回懒人包或系统环境。

警告

懒人包不要切换到系统环境，已有环境的机器才需要系统环境模式。环境体检功能可以帮你确认当前环境是否就绪。

启动命令行

在设置 → 环境中点击「启动命令行」，打开已加载环境变量的命令行窗口（懒人包环境会自动带上便携 Git / Node.js 的 PATH），可自行执行需要 Git 或 NodeJS 环境的命令。

酒馆设置相关（设置 → 酒馆设置）

警告

请先关闭酒馆再进行设置，保存后需重启酒馆才能生效

局域网访问

开启后，局域网内其他设备可以访问当前设备上的酒馆。

提示

第一次开启后会自动生成 whitelist.txt 并放行当前网段，关闭后不会删除。白名单支持「智能子网」：网段变化时自动更新放行条目，也可以在白名单对话框中「信任当前网段」或手工编辑放行网段。

私网过滤白名单

开启后酒馆只信任指定私网网段的请求（默认放行回环地址），监听地址异常时启动器会自动修复，防止配置被意外改成对外暴露。

监听端口

监听端口：默认为8000，如果8000端口被占用，请修改成其它端口（如8888）。

提示

如果酒馆无法访问，请确保防火墙已放行。

自动设置请求代理

启用后，启动器会自动检测系统代理（环境变量优先、注册表兜底）并写入酒馆的请求代理配置，无需手动填写。

启动优化参数

启用后，启动酒馆时会自动添加 --max-old-space-size=4096 参数以增加内存限制，适合大型模型或内存不足的情况。（内置运行时模式下 Bun 不支持该参数时会自动忽略并提示）

自定义启动参数

不清楚怎么写请留空！启动器会做安全校验后拼入启动命令。

主机白名单 / 统一白名单

可管理酒馆的主机名白名单；「统一白名单」开启后 IP 白名单与主机白名单双向同步，改一处即可。

版本管理（版本页）

• 列出 SillyTavern 的历史版本（读取本地仓库 git tags），点击即可查看版本信息
• 「切换到此版本」对话框确认后一键切换，切换前会自动保护你的本地改动
• 切页缓存：切换页面不会重新读取，需要最新列表时手动刷新

扩展管理（扩展页）

• 一键安装 SillyTavern 扩展：支持 Git 安装（自动套用镜像加速，失败自动走镜像兜底重试）和 ZIP 安装
• 支持卸载、重命名、全局目录与用户目录间移动/复制
• 全局扩展与用户级扩展分区管理

启动器设置（设置 → 启动器设置）

自动检查启动器更新

启用后，启动器启动时会自动检查更新，并在有更新时弹出提示（不会自动安装）。

自动检查酒馆更新

启用后，点击启动按钮会先检查酒馆更新，完成更新后再启动。

系统托盘

启用后，点击窗口关闭按钮会把启动器收进系统托盘，酒馆继续在后台运行。托盘图标右键菜单支持：打开主窗口、启动酒馆、关闭酒馆、重启酒馆、退出启动器（按酒馆运行状态自动置灰）。

自动启动

启用后，打开启动器会自动启动酒馆。

自动启动时隐藏窗口（静默启动）

同时开启「自动启动」「自动启动时隐藏窗口」与「系统托盘」后，打开启动器不再弹出主窗口——酒馆在后台静默启动，启动器驻留托盘，需要时从托盘唤回。

外观

• 暗色 / 亮色主题切换
• 5 套主题色预设：沧蓝 / 余烬 / 青碧 / 鎏金 / 紫棠
• 「减少动效」开关，低配机器可关闭界面动画

终端

终端字体与字号设置（多档字号预设 + 预置字体 + 自定义字体名），保存后立即生效，右侧带实时预览。

数据同步（同步页）

安全警告

数据同步功能涉及您的聊天记录、设置和API密钥等敏感信息，请仅在信任的局域网内使用！

服务器模式

将当前设备作为同步服务器，允许局域网内其他设备同步数据。

• 启动同步服务：开启后启动同步服务器
• 监听地址：默认自动获取本机局域网 IP，只绑定局域网网卡、绝不监听 0.0.0.0；监听地址异常时自动恢复
• Token 鉴权：开启鉴权后，客户端必须携带令牌才能同步，令牌经 Authorization 头传输、不会出现在请求 URL 中
• 服务端口：默认端口9999，可根据需要修改
• 首次启动提醒：首次启动时显示 30 秒安全倒计时，提醒您注意数据安全

提示

服务器地址格式为：http://您的IP:9999，例如 http://192.168.1.100:9999

客户端模式

从其他设备的同步服务器下载数据。

• 服务器地址：输入要连接的服务器地址（服务器开启鉴权时需附带 Token）
• 扫描服务器：自动扫描局域网内可用的同步服务器
• 同步方法：
  • 自动 (优先ZIP)：自动选择最佳同步方式
  • ZIP全量同步：下载完整的数据压缩包
  • 增量同步：仅同步变更的文件（按修改时间比对，保留文件时间戳）
• 备份现有数据：同步前自动备份当前数据到backup文件夹内
• 服务器预检查：开始同步前自动检查服务器可用性

同步状态

实时显示当前同步状态、进度和数据信息，包括数据目录、文件数量和总大小。

关于（关于页）

显示启动器版本与相关链接，可手动检查启动器更新。也可以在启用「自动检查启动器更新」后，启动时自动获得更新提示。