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