v2.0 新特性与升级指南
v2.0（GPUIX 重写版）是启动器历史上最大的一次版本迭代：界面与内核全面重写，旧版 Python（Flet）代码正式退役。本文档基于 2.0 源码整理，说明 2.0 与 1.x（以 v1.3.10 为基准）的区别、2.0 的特色功能，以及从 1.x 升级的注意事项。
当前状态
2.0 已正式发布（v2.0.0），历经多个 Beta 版本打磨。遇到问题欢迎到 仓库 Issues 反馈，你的反馈会直接影响下一个版本。
1.x 与 2.0 的区别
技术底座（重写的核心）
| 维度 | 1.x（Python 版） | 2.0（GPUIX 重写版） |
|---|---|---|
| 技术栈 | Python + Flet | TypeScript（strict）+ React 19 + GPUIX（GPU 渲染） |
| 运行时宿主 | Python 解释器，Nuitka 打包 | Bun 运行时，bun build --compile 打包 |
| 界面渲染 | Flet 控件树渲染 | GPU 直接渲染原生界面，渲染更流畅、启动更快 |
| 测试体系 | ❌ 无自动化测试 | ✅ Vitest 单元测试 + 起真实 GPU 窗口的 E2E 测试 |
| 稳定性保障 | 错误弹窗 | 统一错误日志（logs/，仅本地不上传）+ 崩溃兜底落盘（crashGuard） |
功能变化（✅ 新增 / ⬆️ 增强 / ➡️ 继承）
| 功能 | 1.x 已有 | 2.0 的变化 |
|---|---|---|
| 运行环境模式 | 懒人包（env）/ 系统环境 两种 | ✅ 新增第三种「内置运行时」（实验性）：内嵌 Bun 运行时启动酒馆、进程内 Git 实现、内置依赖安装——无需安装 Git 和 Node.js，单文件也能跑 |
| GitHub 镜像 | 手动三选一（官方 / gh-proxy.org / gh.llkk.cc） | ⬆️ 升级为 56 站镜像注册表：自动测速选优（ping/TCP 双探针）、故障自动切换、官方源/加速镜像一键二选一、也可手动指定 |
| 数据同步安全 | 服务器仅限局域网，无任何鉴权 | ✅ 新增 Token 鉴权（常数时间比较，令牌经 Authorization 头传输）；服务端只绑局域网网卡，绝不监听 0.0.0.0 |
| 数据同步稳定性 | 固定监听地址 | ⬆️ 监听地址异常自动恢复（自愈写回配置）；局域网自动发现改为并发探测，更快 |
| 终端体验 | ANSI 16 色彩色渲染，字号固定 | ⬆️ 终端引擎重做：完整 VT 状态机（256 色/真彩/粗体/下划线）、按窗口宽度自动折行（中文占 2 列）、字体与字号可调、大日志量滚动更流畅 |
| 界面主题 | 暗色/亮色切换，主题色固定蓝色 | ⬆️ 新增 5 套主题色预设（沧蓝/余烬/青碧/鎏金/紫棠）+「减少动效」选项 |
| 酒馆配置管理 | 监听/端口/代理/IP 白名单/主机白名单/统一白名单 | ⬆️ 新增私网过滤白名单（启动自愈）；「智能子网」白名单自动更新真正接线生效（1.x 中为未启用的死代码） |
| 启动期更新检查 | checkupdate 开关实际不生效，只能手动检查 | ✅ 启动时自动检查启动器更新并弹出提示 |
| 更新酒馆 | git pull --rebase --autostash + package-lock 冲突恢复 | ⬆️ 保留原机制，重试提升至 ≤2 次，新增镜像取证兜底；内置运行时模式全链路等效支持 |
| 安装/启动防呆 | 无 | ✅ 启动成功探针（秒退判失败）、依赖未装完拒绝启动、安装/启动/更新操作互斥 |
| 安装包形态 | Nuitka 打包 zip 目录 | ✅ 新增单文件 exe（SillyTavernLauncher-<版本>-win-x64.exe，无需安装）；懒人包 zip 继续提供 |
| 欢迎引导 | 欢迎问答 + EULA + 两个独立的 18 周岁确认框 | ⬆️ 精简为一条流程：问答 → EULA → 更新检查 → 可选自启；年龄确认合并为一个对话框；已同意协议的用户后台自动核对协议版本变化 |
| 系统托盘 | 有（5 项菜单 + 关闭到托盘） | ➡️ 继承（2.0 早期 Beta 缺失，beta.3 恢复），改为 Win32 原生实现，菜单按酒馆运行态实时置灰 |
| 自动启动 | 有（开启即强制托盘并静默启动） | ⬆️ 拆分为独立开关：「自动启动时隐藏窗口」可单独控制，组合更灵活 |
| 扩展管理 | v1.3.6 起：Git/ZIP 安装、卸载、目录移动/复制、重命名 | ➡️ 继承，卸载加固（只读文件处理），网络失败自动走镜像兜底重试 |
| 版本管理 | 本地 git tag 列表 + 一键切换 | ➡️ 继承，新增列表缓存（切页不丢），内置运行时下走进程内 Git 等价实现 |
| 侧边栏退出按钮 | 有 | ➡️ 移除，退出统一由标题栏关闭按钮承担（按托盘状态分流：隐藏到托盘 / 退出确认 / 直接退出） |
与 1.x 无差异的部分
镜像加速原理（gitconfig insteadOf 改写 + 酒馆 remote 保持官方）、更新酒的 rebase 策略、config.yaml 注释保留式读写、懒人包/系统环境双模式、18 周岁确认、EULA 30 秒倒计时等机制在 1.x 已存在，2.0 是继承与打磨，不是新增。
2.0 特色详解
🍺 内置运行时（实验性，最大新增）
无需再单独安装 Git 与 Node.js：
- 酒馆启动：由启动器内嵌的 Bun 运行时直接拉起 SillyTavern
- Git 操作：isomorphic-git 进程内实现（fetch 走内置 HTTP 客户端，带 TLS 证书回退）
- 依赖安装：内置
bun install+ 国内镜像源，全程零外部依赖 - 三种模式按「env/ 目录 → 系统工具链 → 内置运行时」顺序自动探测，也可在设置页手动切换；切换到内置运行时前会弹出兼容性风险确认
内置运行时兼容性声明
SillyTavern 官方主运行时为 Node.js，内置模式使用 Bun 运行时，个别功能与扩展可能异常；Git 操作为进程内 JS 实现，极端仓库操作可能失败；依赖安装生成 bun.lock，与 npm 存在行为差异。遇到问题请在设置页切换回懒人包环境或系统环境。
🚀 GitHub 镜像增强
- 内置 56 个加速镜像站（按速度分档管理）
- 自动测速选优：ping 探测为主、TCP 握手兜底，自动选择最快镜像，测速结果 12 小时保鲜、启动时自愈
- 故障自动切换：当前镜像确认不可达时自动切到最快候选（手动指定镜像则不切换，尊重你的选择）
- 「镜像源设置」对话框：一键测速、手动指定、自动选优开关、一键切回官方源
🖥️ 系统托盘与静默启动
- 系统托盘：开启后点击窗口关闭按钮，启动器收进托盘、酒馆继续后台运行；托盘右键菜单（打开主窗口/启动酒馆/关闭酒馆/重启酒馆/退出启动器）按运行状态实时置灰
- 静默启动：同时开启「自动启动」「自动启动时隐藏窗口」与「系统托盘」后，打开启动器不弹主窗口——酒馆自动在后台启动，启动器驻留托盘，需要时一键唤回
🧪 工程质量
- Vitest 单元测试 + 起真实 GPU 窗口的 E2E 测试（截图取证）
- 单文件打包链内置门禁：类型检查 → 单元测试 → 编译 → 产物验证 → 冒烟启动，全过才出包
- 崩溃兜底：未捕获异常/Promise 拒绝自动落盘到 logs/，方便排查；错误日志仅存本地，不上传
从 1.x 升级
- 直接用新版启动器覆盖旧版即可，配置文件（config.json）向下兼容（旧的环境开关等键会自动迁移）
- 从 1.x 升级：首次启动会重新走一遍欢迎引导（问答 → 协议 → 更新检查）
- 懒人包用户：SillyTavern 文件夹和 env 文件夹无需变动，新版启动器自动识别
- 单文件版用户：下载新 exe 替换旧文件即可
1.x 还能用吗？
1.x 历史版本仍可在 GitHub Releases 的历史 tag 中下载，但已停止维护，建议升级到 2.0。1.x 时期的问题排查方法见常见问题。