#
1.12.0 迁移指南
SillyTavern 1.12.0（代号 "Neo Server" 更新）包含几个可能影响您使用 SillyTavern 方式的关键更改。
本指南将帮助您为更新做好准备并提供进一步的指导。
#
数据存储更新
1.12.0 改变了 SillyTavern 处理用户数据的方式。
之前，所有持久数据都与前端部分一起存储在 /public 目录中，这造成了混乱和潜在的故障点，同时也使容器化和系统级应用程序安装变得相当具有挑战性。
#
有什么变化？
所有来自 /public 的持久信息，如设置和聊天记录（完整列表见下文）都被移动到一个可配置路径的单独目录中，使其可移植且独立于 Web 服务器本身。当出于兼容性目的需要时，例如托管扩展、全尺寸角色卡片、用户图片上传等，已设置智能重定向以自动从数据目录托管用户文件。
#
设置数据根目录
您可以通过 config.yaml 或使用 --dataRoot 控制台参数启动服务器，提供数据根目录的绝对路径或相对路径（相对于 ST 仓库目录）。
YAML 示例
# -- 数据配置 --
# 用户数据存储的根目录
dataRoot: C:\Users\Harry\Documents\ST-Data控制台示例
node server.js --dataRoot="/Users/harry/ST-Data"
# 或
npm run start -- --dataRoot="/Users/harry/ST-Data"默认的数据根路径是 ./data，即 SillyTavern 仓库中的 data 目录。
注意
数据根路径应该是完整的绝对路径或完整的相对路径。您_不能_使用路径快捷方式，如 ~ 或 %APP_DATA%，因为这些是由 shell 解析的，而不是操作系统。
#
迁移
#
重要！ 开始之前
- 仅当您想要从默认位置移动 dataRoot 时。否则，请跳过此部分。 在首次运行更新后的服务器之前设置数据根目录。运行
npm install使config.yaml填充新值，或传递控制台参数。 - 所有数据将迁移到
default-user账户中。更多信息请参见下面的用户 部分。
#
非容器（裸机）安装
您不需要做任何事情！当您启动 ST 服务器并检测到旧的存储格式（通过检查 /public/characters 目录是否存在）时，自动迁移将为您处理一切。
移动任何文件时，将在 /backups/_migration/YYYY-MM-DD（解析为当前日期）目录中创建自动备份，但在运行迁移之前进行完整的手动备份始终是一个好习惯。
#
容器化（Docker）安装
在 Docker 卷中迁移数据稍微复杂一些，但也很直接。虽然仓库提供的 docker-compose.yml 已更新以反映这些更改，但您可能需要调整自定义工作流程/部署。
第 1 步。 创建一个新卷，并将其挂载到容器内的 "/home/node/app/data" 路径。不要删除 config 卷。
volumes:
- "./config:/home/node/app/config"
- "./data:/home/node/app/data"第 2 步。 将除 config.yaml 文件外的所有内容从 config 卷移动到 data 卷的 default-user 子目录中。
第 3 步。 重建容器并启动它。
注意
/public 目录和 config 卷之间的软链接不再需要，也不会内置到 Docker 容器中！
#
需要迁移什么？
以下文件和目录需要进行数据迁移。假设使用默认配置，下表提供了迁移前后的路径。
#
用户
1.12.0 添加了（完全可选的）在同一服务器上创建多用户设置的功能，允许多个用户甚至同时使用他们自己完全隔离的 SillyTavern 实例。用户账户还可以通过密码保护，提供额外的隐私层。
更多信息请参阅用户文档。