跳到主要内容

升级

本页说明 NeoTavern 更新如何交付、升级期间你的数据会发生什么, 以及到哪里查看变更内容。

更新如何工作

NeoTavern 把核心应用、插件和主题视为独立的单元,每个单元都独立更新:

  • 核心更新替换应用本身,保持你的数据目录不受影响。
  • 插件和主题更新通过应用内各自的管理器进行,未经你确认绝不会自动激活。
  • 每次安装都是原子的:新版本在一步之内替换旧版本,并且会保留旧版本, 以便失败的更新可以回滚。
  • 软件包完整性通过校验和验证,官方目录还可能在之上添加签名。

更新永远不需要 Git、npm 或终端。如果你正常安装了应用, 就用与安装相同的方式更新它。

升级期间的数据安全

  • 更新绝不会直接修改你的用户文件:安装程序不会触碰角色、聊天记录、设定集、 人设和设置。
  • 当更新包含数据库 schema 迁移时,会在迁移运行前创建备份,而且迁移是 事务性的且幂等的。
  • 你的 SQLite 数据库以 WAL 模式运行,因此在迁移或升级期间应用保持可用, 写入保持持久。
  • 如果插件或主题更新失败,应用会保持旧版本继续工作, 而不是留下一个半安装的软件包。

查看变更内容

更新日志 列出了每一项变更及其影响。升级前请浏览最新的条目: 破坏性变更会附带迁移指南,仍处于实验性或计划中的功能会被明确标记。

更新插件和主题

打开"插件和主题"部分。每个已安装的项目都会显示其版本、状态以及是否有可用 更新。如果更新请求了新的权限,应用会再次请求你的明确同意后才应用它们 —— 更新绝不会静默扩展权限。

回滚

由于核心更新期间会保留旧版本,如果新版本出现问题,你可以重新安装它。 你的数据目录向后可读,在任何有风险的迁移之前创建的备份让你可以从界面 恢复到一个已知良好的状态。请参阅数据与备份