SillyTavernLauncher酒馆启动器

Appearance

更新日志 ​

v2.0.3（2026-10-25） ​

🐛 修复 ​

  • 同步数据安全加固：
    • 远端文件清单现在会逐条校验：绝对路径、.. 穿越、符号链接、Windows 盘符与 NTFS 备用数据流等异常条目会被拒绝，避免损坏或被篡改的清单把文件写到数据目录之外。
    • 下载单个文件时按清单校验大小与 SHA-256；校验失败或下载中断会清理临时半成品，已存在的同名文件在写入完成前保持原样。
  • 停止 / 重启不再“假成功”：无法终止的进程会保留在活动进程表并列出 PID，停止失败会如实提示；重启时若旧进程仍在运行会直接中止，避免新旧两个酒馆实例同时抢端口。
  • 配置保存失败不再静默：
    • config.yaml 解析失败时，先把原文件备份为 config.yaml.corrupt-<时间>，再回退到最小配置，避免后续保存把原配置无痕覆盖。
    • 局域网访问、主机白名单、统一白名单等开关保存失败时会明确提示并回滚界面状态，不再显示“已保存”。
    • 配置文件原子写入遇到杀毒软件或编辑器短暂占用会自动重试（最多 3 次尝试），减少偶发的保存失败。
  • Windows 自定义启动参数：带引号且包含空格的参数（如 "D:\My Data"）现在会正确传给酒馆进程，不再把引号原样带入，也能正常通过参数校验。
  • 路径包含短横线不再被误判：修复安装 / 启动 / 更新时把 - 当作非法字符的问题，D:\SillyTavern-1.12 这类路径可以正常使用。
  • 界面与稳定性：
    • 主窗口已隐藏到托盘或最小化时，不再弹出无人应答的「酒馆更新确认」框，改为自动检查更新后启动。
    • 安装、启动或更新进行中，版本页的「切换版本」按钮会禁用，避免并发改写酒馆目录。
    • 连续按 Esc 或连点关闭按钮，不再一次关掉两层对话框。
    • 内置运行环境安装过程中出现异常会正常结束并提示失败，不再一直停在「安装中」。
    • 扩展安装最终失败会清理残留目录，可以直接重试；使用系统 / 便携 Git 安装扩展时，克隆超过 120 秒会中止，不再无限挂起。
    • 托盘初始化失败时会完整释放窗口类、图标与回调资源。

⚠️ 变化（请留意） ​

  • 增量同步遇到远端清单为空时默认拒绝清空本地数据。 当服务器返回 0 个文件而本地仍有数据（常见于服务器数据目录未就绪、连错设备或地址填错），增量同步会中止并提示；同时不会再自动回退到 ZIP 全量同步来绕过该保护。如确实要清空本地数据，请手动使用 ZIP 全量同步。
  • 增量同步也会先备份。 删除 / 下载前会把现有数据备份到 backup/，备份失败即中止，本地数据保持原样；ZIP 全量同步的备份行为保持不变。

v2.0.2（2026-10-24） ​

✨ 新增 ​

  • 跳过指定版本的更新提醒：更新弹窗新增「跳过此版本提醒」。跳过后，启动时不再提示该版本，下个新版本仍会正常提醒；在关于页手动检查更新、且检测到的仍是已跳过版本时，按钮会变为「恢复更新提醒」，点一下即可恢复，无需手改 config.json。

🐛 修复 ​

  • Windows 下部分命令参数被截断：修复 .cmd / .bat 命令（如 npm 依赖安装）的参数包含 & | < > ^ ( ) 时被 cmd 当作操作符或重定向解析的问题；现在会正确加引号后传入，不再出现参数被吞成残句的情况。

v2.0.1（2026-10-16） ​

🐛 修复 ​

  • 修复无法与手机端（Termux 版）同步数据的问题。 此前"跨设备数据同步"在 Windows 与安卓 Termux 两端之间基本不可用，本次双端同时修复，涉及的典型报错场景：
    • 手机从电脑拉取数据时，全量 ZIP 同步报错 ENOENT ... payload\... 中断——只要数据里包含子目录（聊天记录、头像等必然包含）就必然失败；
    • 手机从电脑拉取数据时，增量同步报错"文件清单元数据无效"——两端清单格式不一致所致；
    • 电脑从手机拉取数据时，增量同步对中文文件名的文件（如以聊天名命名的对话文件）逐一报 HTTP 500 下载失败。
  • 增量同步不再反复下载没有变化的文件。 旧版按文件修改时间判断是否需要更新，受 ZIP 打包的时间精度影响，全量同步后的第一次增量会把绝大部分文件重下一遍；现在改为按文件内容判断，只下载真正变化过的文件，同步明显更快更省流量。

⚠️ 变化（请留意） ​

  • ZIP 全量同步后，本地数据将与远端完全一致：远端已经删除的文件（例如对方设备上删掉的聊天）会在同步后从本地移除，不再永久残留。同步前会自动把本地原数据备份到 backup/ 目录，如有需要可随时找回。
  • 同步范围两端已统一：隐藏文件/文件夹与 .tmp 临时文件不参与同步（这类文件通常是程序运行中的中间产物）。

📌 升级提示 ​

  • 与安卓 Termux 端互传数据，需要两端启动器都更新到各自新版本：Windows 端 ≥ v2.0.1，Termux 端以 st update stl 升级到最新版。仅升级一端时，部分同步方式仍会失败。

v2.0.0 正式版（2026-10-10） ​

历经多个 beta 版本打磨，2.0.0 正式版来了！以下是相较 v2.0.0-beta.5 的更新内容。

✨ 新增 ​

  • 内置运行环境一键安装：电脑上缺少 Git / Node.js 时不再只能报错——设置页会弹出「安装内置运行环境」对话框，引导一键下载安装，自动校验下载完整性，单个组件失败可单独重试；安装完成后自动切换到「内置懒人包环境（env/）」。换新电脑也能零依赖跑起酒馆。
  • 酒馆更新前先询问（默认开启）：启动时检测到酒馆新版本，先弹窗由你选择「更新后启动」还是「跳过更新，直接启动」，不再不打招呼就更新你的酒馆。可在设置页「检测到更新时先询问」处关闭，恢复自动更新；静默启动（开机自启 + 隐藏到托盘）不受影响，保持自动更新。
  • 关于页新增「加入 QQ 频道」按钮。

🎨 改进 ​

  • 安装过程不再锁住窗口：安装内置运行环境 / Git / ZIP 安装期间可以随时关闭对话框，安装转后台继续、不会被中断，完成后弹通知提醒，进度记录保留在终端日志里。
  • 跟随系统的「减少动画」偏好：在 Windows 系统设置中关闭动画效果后，启动器会自动减弱界面动效，设置页「减少动效」开关同步生效并提示。
  • 界面细节打磨：终端字号预设扩展到 10–18px；端口、代理地址、版本日期等技术字段改用等宽字体，更易核对；输入框聚焦样式更柔和；同步页提示、按钮主次等配色语义修正。

🐛 修复 ​

  • 启动器检查更新失灵：修复测试版周期内永远收不到新版提示的问题（测试版 → 测试版的更新提示被误吞）、版本号读取源失效等问题；更新弹窗的下载入口统一指向更新说明页。
  • 设置页端口 / 代理输入框：修复已有填写内容时字段标签消失、退化成无标识裸输入框的问题。

v2.0.0-beta.5（2026-10-01） ​

✨ 新增 ​

  • 镜像源选择列表滚动条：「设置」中的镜像源选择列表接入与终端同款的自绘滚动条，列表较长时可拖拽滑块或滚动滚轮快速定位。

🔧 修复 ​

  • 修复部分 Windows 环境下网卡名称显示为乱码的问题：中文网卡名现在能正确识别与显示，中文命名的物理网卡也能被正确识别，局域网地址选择不再难以辨认。
  • 修复终端日志自动折行时，行末字符与窗口右边缘之间留白过大的问题：折行改为按像素宽度精确计算，中英文混排时行尾也能贴齐右边界。
  • 修复拖拽终端滚动条时会误选中日志文字的问题。
  • 修复拖拽终端滚动条滑块时偶发卡住、无法继续拖动的问题。

v2.0.0-beta.4（2026-09-29） ​

✨ 新增 ​

  • 终端自绘滚动条：终端日志区新增滚动条（GPUIX 渲染框架没有原生滚动条，改为自绘实现），支持拖拽滑块快速定位与滚轮滚动，长日志浏览更顺手。

🔧 修复 ​

  • 修复「自动代理」写入已失效的代理地址、导致酒馆 API 请求全部 ECONNREFUSED 无法获取回复的问题：此前代理软件退出后，Windows 注册表残留的系统代理会被误当作「代理在运行」，直接写入酒馆配置。现在写入前会先做可达性探测，探测失败则不启用并回退直连；关闭「自动代理」开关时会同步撤回已写入的代理配置；已受影响的用户下次启动酒馆时会自动检测并恢复直连，无需手动修改 config.yaml。

v2.0.0-beta.3（2026-09-23） ​

✨ 新增 ​

  • 系统托盘：开启后，点击窗口关闭按钮会把启动器收进系统托盘，酒馆继续在后台运行；托盘图标右键菜单可随时唤回主窗口或彻底退出。可在「设置」页开启/关闭。
  • 静默启动（自动启动时隐藏窗口）：同时开启「启用自动启动」「自动启动时隐藏窗口」与「系统托盘」后，打开启动器不再弹出主窗口——酒馆自动在后台启动，启动器驻留托盘，需要时一键唤回。

🔧 修复 ​

  • 多项稳定性加固：托盘错误处理收口、资源释放闭环等内部质量修复。

v2.0.0-beta.2（2026-09-22） ​

✨ 新增 ​

  • 全新自绘标题栏：窗口改为无边框沉浸式外观，标题栏支持拖动移动、最小化与关闭；侧边栏原有的关闭入口已并入标题栏。

🔧 修复 ​

  • 打开「版本」页不再长时间无响应（读取耗时约 40 秒 → 1 秒），且不再误报 SillyTavern「未安装」。
  • 修复在内置运行时安装/更新进行中点击「启动」，可能导致酒馆异常闪退的问题。

v2.0.0-beta.1（2026-09-21） ​

v2.0 系列首个测试版：界面与内核全面重写，旧版 Python 界面正式退役。

✨ 新增 ​

  • 全新 GPU 渲染界面：整体迁移到 GPUIX 原生渲染框架，全新设计语言，支持暗色/亮色主题与多套主题色预设切换。
  • 内置运行时（开箱即用，实验性）：无需再单独安装 Git 与 Node.js——启动器内置运行时与进程内 Git 实现，全新环境也能一键起酒馆；原有的便携版 / 系统环境模式继续保留。
  • GitHub 镜像加速：内置多个加速镜像源，支持自动测速选优、故障自动切换，也可在设置中手动指定。
  • 单文件版：提供单个 exe 直接运行，无需安装。
  • 终端页重做：ANSI 彩色输出渲染、按窗口宽度自动折行、终端字号可调，大日志量下滚动更流畅。
  • 设置中心：环境、酒馆设置、启动器设置分页管理。
  • 局域网同步增强：新增 Token 鉴权、监听地址异常自动恢复、仅允许私网连接，首次开启同步时出现安全提示。
  • 安全与稳定性：TLS 证书校验异常自动回退、统一错误日志（logs/ 目录）、异常崩溃兜底记录、访问白名单重构。

v2.0 与 1.x 的详细区别见 v2.0 新特性与升级指南。

升级说明（v2.0） ​

  • 直接用新版启动器覆盖旧版即可，配置文件（config.json）向下兼容。
  • 从 1.x 升级的用户：首次启动会重新走一遍欢迎引导。

1.x 历史版本（Python 版，已停止维护） ​

v1.3.10 (2026-05-30) ​

🔧 改进优化 ​

  1. Git 更新完成后自动刷新版本页，版本列表与本地状态保持一致
  2. 安全与健壮性大面积强化
    • 命令注入校验（commit/tag/URL 正则校验）
    • ZIP 解压 Zip Slip 路径穿越防护
    • gitconfig 多编码容错、终端渲染容错

v1.3.9 (2026-05-05) ​

🔧 改进优化 ​

  1. 修复窗口固定高度导致的缩放（DPI）显示问题
  2. 改进酒馆安装处理逻辑

v1.3.8 (2026-04-24) ​

✨ 新增功能 ​

  1. 远程用户协议获取
    • 启动器从官网拉取《使用协议》并本地缓存，协议版本变化后自动重新弹出
  2. 未成年人保护
    • 首次启动酒馆前、首次安装酒馆前均需确认年满 18 周岁

📝 其他改动 ​

  • 懒人包不再附带 SillyTavern，需要通过启动器一键安装

v1.3.7 (2026-04-14) ​

🔧 改进优化 ​

  1. 酒馆仓库切回官方源管理
    • 版本列表不再从远程 JSON 获取，改为读取本地 SillyTavern 仓库 git tags
    • 镜像加速方式改为改写 Git 配置（insteadOf），酒馆仓库 remote 始终保持官方地址
  2. 扩展管理修复与依赖更新

v1.3.6 (2026-03-23) ​

✨ 新增功能 ​

  1. 扩展管理
    • 新增扩展页面，支持 Git / ZIP 两种方式安装扩展
    • 支持卸载、重命名、全局目录与用户目录间移动/复制
    • Git 方式安装扩展自动套用镜像加速

📝 其他改动 ​

  • CI 构建流程更新

v1.3.5 (2026-02-22) ​

✨ 新增功能 ​

支持在启动器内直接管理 IP 白名单和主机白名单
版本切换更稳定（自动 fetch 最新 release 分支）
更新功能支持自动处理更多Git异常情况

🔧 问题修复 ​

修复白名单配置无法重置的问题

v1.3.4 (2026-02-07) ​

🔧 改进优化 ​

  1. Flet 框架升级
    • 升级至 Flet 0.80.5
  2. 添加酒馆白名单更新
    • 添加酒馆白名单更新，完美适配不同网络环境

🐛 修复问题 ​

修复打开局域网时，终端不显示IP的问题

v1.3.3 (2026-01-26) ​

🔧 改进优化 ​

  1. Flet 框架升级
    • 升级至 Flet 0.80.4
  2. 添加更新日志跳转按钮
    • 添加更新日志跳转按钮，方便用户查看更新日志

🐛 修复问题 ​

  • 修复系统环境下版本切换失败的问题

v1.3.2 (2026-01-16) ​

🔧 改进优化 ​

  1. Flet 框架升级
    • 升级至 Flet 0.80.2
  2. 优化使用体验

v1.3.1 (2026-01-12) ​

✨ 新增功能 ​

  1. 版本切换功能

    • 新增 SillyTavern 版本管理界面，支持切换不同版本
    • 支持查看所有可用的版本标签
    • 支持一键切换到指定版本

  2. 启动优化参数选项

    • 新增"使用优化参数"开关
    • 开启后自动添加 --max-old-space-size=4096 参数以增加内存限制

  3. 首次启动答题

    • 新增首次启动时的知识答题
    • 帮助用户了解数据同步的安全注意事项
    • 首次启动同步服务器时显示安全倒计时警告

  4. 打开命令行窗口功能

    • 支持打开已加载环境变量的命令行窗口
    • 方便用户进行调试和手动操作

  5. 同步服务器预检查

    • 开始同步前自动检查服务器可用性
    • 服务器不可用时及时提示用户，避免长时间等待

🔧 改进优化 ​

  1. Flet 框架升级

    • 升级至 Flet 0.80.1
    • 全面兼容新版 Flet API
    • 优化了终端系统的稳定性

  2. 终端系统改进

    • 修复终端显示问题
    • 改进日志刷新机制
    • 优化内存使用，尝试修复内存泄漏问题

  3. 网络模块优化

    • 修复获取虚拟机适配器 IP 的问题
    • 优先使用物理网卡 IP 地址
    • 增强局域网 IP 检测准确性

  4. 同步 UI 日志重构

    • 优化日志刷新性能
    • 自动滚动到最新日志

  5. 错误处理增强

    • 添加错误对话框，更友好的错误提示
    • 增强退出时的资源清理
    • 修复页面销毁后的异常处理

  6. 系统环境检测

    • 首次启动时检测 Node.js 和 Git 环境
    • 缺少必要环境时给出明确的安装提示

🐛 修复问题 ​

  • 修复更新检查功能
  • 修复终端日志刷新的显示问题
  • 修复程序退出时的资源未释放问题
  • 修复同步服务器启动时的状态显示
  • 修复网络 IP 获取可能返回虚拟网卡地址的问题

📝 其他改动 ​

  • 改进虚拟环境打包流程
  • 优化 GitHub Actions 工作流
  • 更新 .gitignore 配置

Copyright © 2025-现在 泠夜Soul