从 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 后，記得為您的工作台创建第一個本地備份。
- 開始第一次聊天：了解遷移后的聊天会話中，如何使用消息重生成與聊天分支交互。
- 常见问题：查看更多關于常见错误、介面超时和硬件配置的故障排查。