SillyTavern版本升级全攻略：四阶段安全迁移指南

1. 准备阶段：构建升级安全网

升级软件如同登山前的准备工作，需要检查装备、规划路线并确保安全措施到位。在开始SillyTavern的升级前，建立完善的安全机制至关重要。

1.1 核心数据备份策略

采用"3-2-1备份法则"确保数据安全：

1. 创建三个备份副本
2. 存储在两种不同媒介
3. 至少一个异地备份

关键数据备份路径：

• 角色数据：data/characters/ - 包含所有自定义角色信息
• 对话历史：data/chats/ - 存储所有聊天记录
• 配置文件：config.yaml - 系统设置和偏好配置
• 插件数据：plugins/ - 已安装插件及相关配置

执行备份命令：

# 创建备份目录
mkdir -p ~/sillytavern_backup/$(date +%Y%m%d)

# 复制核心数据
cp -r data/characters ~/sillytavern_backup/$(date +%Y%m%d)/
cp -r data/chats ~/sillytavern_backup/$(date +%Y%m%d)/
cp config.yaml ~/sillytavern_backup/$(date +%Y%m%d)/
cp -r plugins ~/sillytavern_backup/$(date +%Y%m%d)/

1.2 版本兼容性检查

在升级前执行兼容性预检：

• 确认当前Node.js版本：node -v（推荐v16.0.0+）
• 检查npm版本：npm -v（推荐v7.0.0+）
• 查看当前SillyTavern版本：grep version package.json


2. 执行阶段：选择最佳升级路径

选择升级路径如同选择交通方式：高铁快捷但需要特定轨道，自驾灵活但需亲自操控，步行最安全但耗时较长。根据自身技术背景选择最适合的升级方式。

2.1 升级路径决策树

是否熟悉Git操作？
├── 是 → 方案A：Git一键升级
│   ├── 执行 git pull
│   ├── 运行 npm install
│   └── 重启服务 npm start
├── 否 → 是否遇到兼容性问题？
    ├── 是 → 方案C：全新环境部署
    │   ├── 克隆仓库 git clone https://gitcode.com/GitHub_Trending/si/SillyTavern
    │   ├── 复制备份数据
    │   └── 安装依赖 npm install
    └── 否 → 方案B：手动包升级
        ├── 下载最新压缩包
        ├── 解压至临时目录
        ├── 覆盖核心文件
        └── 运行 npm install

2.2 方案A：Git一键升级（推荐）

适用于熟悉Git操作的用户，操作简单且更新及时：

1. 进入项目目录：cd /path/to/SillyTavern
2. 拉取最新代码：git pull origin main
3. 更新依赖包：npm install
4. 重启服务：npm start

2.3 方案B：手动包升级

适用于不熟悉Git但无兼容性问题的用户：

1. 下载最新版本压缩包
2. 解压至临时目录：unzip SillyTavern-latest.zip -d ~/temp
3. 复制核心文件：cp -r ~/temp/SillyTavern/* /path/to/SillyTavern/
4. 更新依赖：npm install
5. 重启服务：npm start

2.4 方案C：全新环境部署

适用于遇到严重兼容性问题的情况：

1. 克隆仓库：git clone https://gitcode.com/GitHub_Trending/si/SillyTavern
2. 进入目录：cd SillyTavern
3. 安装依赖：npm install
4. 恢复备份数据：cp -r ~/sillytavern_backup/[日期]/* ./
5. 启动服务：npm start


3. 验证阶段：确保系统稳定运行

升级完成后需要进行全面测试，如同建筑完工后的质量检查，确保每个部分都能正常工作。

3.1 功能验证清单

1. 基础功能检查

   • 确认角色列表完整显示
   • 验证对话历史正常加载
   • 测试消息发送和接收功能

2. 高级功能测试

   • 检查插件是否正常运行
   • 验证设置页面功能完整性
   • 测试媒体内容加载能力

3. 性能评估

   • 观察页面响应速度
   • 检查内存使用情况
   • 测试并发连接稳定性

3.2 故障排除流程图

升级后遇到问题？
├── 数据丢失 → 从备份恢复 data/ 目录
├── 界面异常 → 清除浏览器缓存 (Ctrl+Shift+R)
├── 插件失效 → 检查插件更新或暂时禁用
├── 无法启动 → 查看日志 npm run debug
└── 其他错误 → 提交issue至官方仓库

4. 优化阶段：提升系统性能与体验

升级完成并非终点，而是优化的开始。如同园艺工作，需要定期修剪和施肥才能让植物茁壮成长。

4.1 系统优化建议

1. 性能调优

   • 清理冗余对话历史：npm run clean-history
   • 优化配置文件：调整config.yaml中的缓存设置
   • 启用压缩：在server.js中配置gzip压缩

2. 安全加固

   • 更新依赖包：npm update
   • 审查插件权限：移除不必要的插件
   • 启用访问控制：设置密码保护

4.2 版本选择决策指南

版本类型	特点	适合用户
稳定版 (Stable)	经过充分测试，bug较少	普通用户、生产环境
测试版 (Beta)	包含最新功能，可能有bug	技术爱好者、开发者
开发版 (Dev)	实时开发中，功能不稳定	贡献者、高级用户

选择建议：

• 追求稳定：选择最新稳定版
• 需要新功能：选择测试版并定期更新
• 参与开发：使用开发版并提交反馈


附录：版本兼容性检查清单

• [ ] Node.js 版本 ≥ v16.0.0
• [ ] npm 版本 ≥ v7.0.0
• [ ] 磁盘空间 ≥ 500MB
• [ ] 网络连接稳定
• [ ] 备份已完成并验证
• [ ] 了解当前版本号
• [ ] 知道回滚方案