从 SillyTavern 迁移到 Tavern Studio
如果您是 AI 角色扮演领域的资深玩家，您的电脑中可能已经积累了大量的角色卡资产、精心调优的生成预设以及细致入微的世界设定。Tavern Studio 并非 SillyTavern 的官方产品或分支，但我们深知资产积累的不易。
因此，Tavern Studio 从设计之初就兼容了 SillyTavern 生态中的常见资产格式。本篇指南将向您展示如何将已有的数据平滑迁移至 Tavern Studio，开启全新的写作与角色扮演工作流。
适合谁阅读
- 准备从 SillyTavern 切换或并行体验 Tavern Studio 的资深玩家。
- 拥有大量
.png角色卡图片、世界设定 JSON 和采样预设文件的用户。 - 在迁移过程中遇到格式解析报错或模型绑定不一致的排查者。
你将学会什么
- 了解哪些资产可以直接迁移，哪些设置需要手动重新打通。
- 掌握通过底栏“+”导入按钮批量导入 SillyTavern 资产的操作流程。
- 进行迁移后的参数校验，包括 Chat Settings 中的世界书和预设重新绑定。
- 明确规避迁移过程中的覆盖冲突与数据损坏风险。
可迁移的资产类型
Tavern Studio 提供了针对 SillyTavern 标准资产的兼容支持：
- 角色卡（Character Cards）：支持将 SillyTavern
public/characters/目录下的所有 PNG 格式角色卡直接导入。导入后，角色的立绘、名字、性格设定、问候语以及对话例句将完整保留。 - 世界书（World Book / World Info）：支持 SillyTavern 导出的
.json格式世界书设定文件。导入后，触发关键词（Keys）、条目内容（Content）和触发条件将平滑解析。 - 生成参数预设（Presets）：兼容 SillyTavern 的采样预设 JSON 文件，包括 Temperature、Top P 和 Repetition Penalty 等经典滑块配置。
资产迁移三步走
第一步：导出并整理旧资产
在您的 SillyTavern 安装目录中，找到并提取以下文件夹中的内容，将其临时复制到桌面上的一个新建文件夹中：
- 角色卡图片：存放于
SillyTavern/public/characters/目录中的.png文件。 - 世界书：在 SillyTavern 界面中导出为 JSON，或者直接从本地配置中找到相关的 World Info 文件夹。
- 参数配置：在 SillyTavern 设置面板里导出的预设
.json文件。
第二步：使用统一导入拉入 Tavern Studio
- 启动 Tavern Studio。
- 批量导入角色卡：
- 将您整理出来的所有 PNG 角色卡图片选中，直接拖拽到 Tavern Studio 的角色页瀑布流管理区。
- 系统会弹起统一导入进度对话框（Import Progress Dialog），通过底层的串行锁（SimpleLock）依次为您解析并添加这些角色。
- 如果遇到重名卡片，您可以选择“重命名”并存或“覆盖”。
- 导入世界书与预设：
- 同样地，点击屏幕底部 TabBar 中间的 +（导入） 按钮，或者将导出的世界书 JSON、预设 JSON 拖入窗口。
- 系统会自动识别文件头部，将世界书归入“世界书管理”页，将参数预设归入“预设管理”页。
第三步：重新配置 API 与重绑定
大模型的 API 密钥和中转网络设置在各个客户端之间的底层数据格式是不通用的。因此，您需要进行以下手动校验：
- 重置 API 连接：
- 点击底部 TabBar 最右侧的 Settings（设置） 按钮。
- 进入 API 页面，重新配置您的 API Key、Base URL 以及选择您所使用的模型。确保屏幕底部的连接状态球变为绿色。
- 重新绑定世界书与预设：
- 打开与某个角色的 Chat 窗口。
- 在宽屏并列或窄屏向左滑动打开的 Chat Settings 面板中，检查并确保 World Book Binding 与 Generation Preset 两个下拉菜单中，已经重新选定了您刚刚导入的对应世界书与预设包。
常见兼容性与排查问题
Q1：为什么我从 SillyTavern 复制过来的某些角色卡没有头像，显示是一片空白？
这可能由于两个原因：
- 该角色卡在 SillyTavern 里本身就是通过 JSON 外挂一个普通 JPG/PNG 头像的方式存储的，隐写数据并未真正嵌入到图片中。
- 复制过程中，文件的 EXIF 头部或 PNG 数据块损坏。
- 解决办法：在 SillyTavern 界面中打开该角色，点击“导出为 PNG（Export as PNG）”重新生成一张带有元数据的标准卡片，然后再拖入 Tavern Studio 导入。
Q2：我在 SillyTavern 里的自定义聊天背景（Theme）和 UI 字体能直接迁移吗？
不能。Tavern Studio 拥有一套全新的、基于本地优先的双端响应式用户界面。两者的 UI 渲染框架不同，自定义主题、聊天气泡皮肤以及特定字体设置均无法直接迁移。您需要在 Tavern Studio 的设置页面中重新调整字体大小、行宽并上传您的本地背景图片。
Q3：为什么绑定的世界书里，有些高级正则匹配（Regex）触发词看起来没有生效？
Tavern Studio 的世界书触发机制针对常用的关键词过滤进行了优化，支持标准正则。但如果您的 SillyTavern 世界书中使用了非常偏门、特定于旧版脚本的自定义宏语法（如特定的特殊符号变量），这部分语法可能无法在 Tavern Studio 中被直接兼容。建议您在世界书编辑器中重新校验正则表达式的兼容性。
下一步
- 备份与恢复：在确认 SillyTavern 的资产全部成功导入 Tavern Studio 后，记得为您的工作台创建第一个本地备份。
- 开始第一次聊天：了解迁移后的聊天会话中，如何使用消息重生成与聊天分支交互。
- 常见问题：查看更多关于常见错误、接口超时和硬件配置的故障排查。