SillyTavern数据迁移：不同版本间升级指南

概述

SillyTavern作为一款功能强大的LLM前端工具，在版本迭代过程中数据结构的变更可能导致用户数据迁移困难。本文详细解析从1.12.0以下版本升级到1.20.0及以上版本的数据迁移完整流程，帮助用户安全、高效地完成版本升级。

版本兼容性矩阵

源版本	目标版本	迁移复杂度	主要变更点
<1.12.0	≥1.20.0	高	数据结构重构，用户数据目录变更
1.12.0-1.19.x	≥1.20.0	中	配置格式优化，新增功能支持
≥1.20.0	最新版本	低	常规功能更新，向后兼容

迁移前准备工作

1. 数据备份策略

flowchart TD
    A[开始备份] --> B[完整复制SillyTavern目录]
    B --> C[导出关键配置文件]
    C --> D[验证备份完整性]
    D --> E[存储到安全位置]
    E --> F[备份完成]

必须备份的文件和目录：

• settings.json - 全局设置文件
• secrets.json - API密钥和安全配置
• Characters/ - 所有角色卡片数据
• Chats/ - 对话历史记录
• Groups/ - 群组配置
• Themes/ - 自定义主题
• User/ - 用户相关数据

2. 环境检查清单

检查项	要求	验证方法
Node.js版本	≥16.0.0	node --version
磁盘空间	≥2GB空闲	系统工具查看
网络连接	稳定	测试下载速度
权限设置	读写权限	尝试创建测试文件

迁移操作步骤

从旧版本（<1.12.0）迁移到新版本（≥1.20.0）

步骤1：安装新版本

# 方法一：Git方式（推荐）
cd /path/to/new/directory
git clone https://gitcode.com/GitHub_Trending/si/SillyTavern
cd SillyTavern
npm install

# 方法二：ZIP包方式
# 下载最新版本ZIP包，解压到新目录

步骤2：数据迁移

重要：不要复制整个public文件夹！

需要手动复制的文件和文件夹：

源路径（旧版本） -> 目标路径（新版本）
------------------------------------
./Assets/              -> /data/default-user/Assets/
./Backgrounds/         -> /data/default-user/Backgrounds/
./Characters/          -> /data/default-user/Characters/
./Chats/               -> /data/default-user/Chats/
./Context/             -> /data/default-user/Context/
./Groups/              -> /data/default-user/Groups/
./Group chats/         -> /data/default-user/Group chats/
./Instruct/            -> /data/default-user/Instruct/
./movingUI/            -> /data/default-user/movingUI/
./KoboldAI Settings/   -> /data/default-user/KoboldAI Settings/
./NovelAI Settings/    -> /data/default-user/NovelAI Settings/
./OpenAI Settings/     -> /data/default-user/OpenAI Settings/
./TextGen Settings/    -> /data/default-user/TextGen Settings/
./QuickReplies/        -> /data/default-user/QuickReplies/
./Themes/              -> /data/default-user/Themes/
./User Avatars/        -> /data/default-user/User Avatars/
./Worlds/              -> /data/default-user/Worlds/
./User/                -> /data/default-user/User/
./settings.json        -> /data/default-user/settings.json
./secrets.json         -> /data/default-user/secrets.json

步骤3：配置文件调整

新版本配置文件可能新增字段，建议对比更新：

# config.yaml 新增配置示例
backups:
  common:
    numberOfBackups: 50
  chat:
    enabled: true
    checkIntegrity: true
    maxTotalBackups: -1

performance:
  lazyLoadCharacters: false
  memoryCacheCapacity: '100mb'
  useDiskCache: true

从1.12.0及以上版本迁移

简化迁移流程

sequenceDiagram
    participant User
    participant OldVersion
    participant NewVersion
    participant BackupSystem
    
    User->>OldVersion: 执行数据导出
    OldVersion->>BackupSystem: 创建完整备份
    User->>NewVersion: 安装新版本
    NewVersion->>BackupSystem: 自动检测备份
    BackupSystem->>NewVersion: 恢复用户数据
    NewVersion->>User: 迁移完成通知

自动化迁移命令：

# 对于Git安装的用户
cd SillyTavern
git pull
npm install
# 系统会自动处理数据迁移

常见问题解决方案

问题1：迁移后设置丢失

症状：启动新版本后原有设置不显示

解决方案：

1. 检查文件权限：确保新目录有读写权限
2. 验证文件路径：确认数据复制到正确位置（/data/default-user/）
3. 检查配置文件格式：确保JSON文件格式正确

问题2：角色卡片显示异常

症状：角色头像或信息显示不正常

解决方案：

// 重新生成缩略图
// 删除thumbnails目录后重启SillyTavern
rm -rf /data/default-user/thumbnails/

问题3：API配置失效

症状：原有的API连接无法使用

解决方案：

1. 检查secrets.json文件位置是否正确
2. 验证API密钥格式是否符合新版本要求
3. 查看新版本的API配置界面是否有变更

迁移后验证检查表

验证项目	检查方法	预期结果
角色数据	查看角色列表	所有角色正常显示
对话历史	打开历史对话	对话记录完整
API连接	测试API调用	连接正常
主题设置	切换主题	样式正确应用
用户配置	检查设置页面	个性化设置保留

最佳实践建议

1. 定期备份策略

pie title 备份频率建议
    "每日自动备份" : 30
    "重大操作前手动备份" : 25
    "版本升级前完整备份" : 25
    "月度归档备份" : 20

2. 版本管理建议

• 使用Git进行版本控制，便于回滚和更新
• 保留最近3个版本的备份，防止数据丢失
• 在升级前阅读版本发布说明，了解破坏性变更

3. 故障恢复流程

如果迁移过程中出现问题，按以下步骤恢复：

1. 立即停止新版本运行
2. 恢复备份到原始位置
3. 检查日志文件定位问题原因
4. 寻求帮助在社区论坛提问

总结

SillyTavern的数据迁移虽然涉及多个步骤，但通过系统化的备份策略和仔细的操作，可以确保升级过程平稳顺利。关键是要理解版本间的数据结构变化，遵循正确的迁移流程，并在操作前做好充分备份。

记住：没有备份的迁移存在很高的数据丢失风险。每次重大版本升级前，务必确保有可用的备份，这样才能在出现问题时快速恢复，最大限度减少数据损失。

通过本文的指导，您应该能够 confidently 完成SillyTavern不同版本间的数据迁移工作，享受新版本带来的功能和性能改进。