Tavern Studio 下載
Tavern Studio Guide - ZH-HANT

如何從 SillyTavern 遷移到 Tavern Studio

Tavern Studio 內置了 SillyTavern 遷移工具，旨在簡化您的過渡體驗。您無需手動導出或逐個複製角色卡、世界書、預設、API 配置或聊天文件。相反，您只需將 Tavern Studio 指向您的 SillyTavern 項目文件夾，檢查導入預覽，選擇您想要遷移的內容，然後運行導入程序即可。

此遷移過程對您的 SillyTavern 文件是只讀的。Tavern Studio 從源目錄讀取資源，並將副本寫入其獨立的工作區、資料庫和資源管理系統。您的原始 SillyTavern 文件夾不會在此安全只讀導入過程中受到影響——不會刪除、移動或修改任何文件。

本指南將向您展示如何遷移角色卡、世界書 / Lorebook、OpenAI 兼容預設（OpenAI-compatible presets）、API 密鑰與配置以及標準 JSONL 格式的聊天記錄。

適用對象

  • 準備從 SillyTavern 遷移到 Tavern Studio 的現有用戶。
  • 擁有角色卡、世界書、預設和聊天日誌的用戶。
  • 尋求原生桌面客戶端，同時希望保留其現有創意資產的用戶。
  • 希望在遷移前通過預覽驗證導入結果的用戶。
  • 希望確保原始 SillyTavern 文件夾不受影響的用戶。

核心內容

內置的遷移流程支援以下 SillyTavern 資料類型：

  • 角色卡 (Character Cards)： 存儲在本地的角色卡文件。
  • 世界書 (World Info / Lorebooks)： 世界設定和背景信息資產。
  • OpenAI 兼容預設 (OpenAI-compatible presets)： 自定義系統提示詞和配置。
  • API 密鑰與配置 (API keys/configs)： API 密鑰及特定服務商的接口配置。
  • 標準 JSONL 聊天記錄 (standard JSONL chats)： 與每個角色關聯的聊天歷史日誌。

在導入 API 設置時，Tavern Studio 會儘可能映射標準的 OpenAI 兼容配置。常見的兼容服務商，如 OpenAI、Groq, Mistral、Perplexity、Cohere 和 xAI，通常可以轉換並應用程式合理的預設值。

然而，一些特定的 API 配置在遷移後仍需手動調整。您需要手動配置以下內容：

  • 自定義 API 端點 (custom endpoints) 和本地 LLM 服務（如 LM Studio, Ollama）。
  • 反向代理 (reverse proxies) 和自定義代理地址。
  • Azure OpenAI 和 Cloudflare Workers AI 集成。
  • 服務商帳戶 ID (account IDs)、缺失 base URL 或缺失的預設模型選擇。

注意：群聊（group chats）目前尚未完全支援。Tavern Studio 可能會跳過不支援的群聊資料，以避免導入後創建出損壞或無法正確管理的會話。

Tavern Studio 如何解決這個問題

Tavern Studio 將遷移視為一種集成化的應用程式級資料管理任務。它不需要您將各個資產單獨拖放到不同的導入窗口中，而是由內置導入器掃描您的 SillyTavern 項目目錄，生成詳細的預覽，允許您按用戶篩選並選擇內容範圍，然後統一導入到 Tavern Studio 工作區中。

導入完成後，Tavern Studio 會自動重新加載應用程式資料，以便新遷移的角色卡、世界書、聊天記錄和 API 設置顯示在相應的位置。如果新導入的資源（如自定義頭像、背景或世界書）未能立即顯示，重啟應用程式程式或刷新當前頁面通常可以強制進行資源重新讀取。

操作步驟

步驟 1：找到您的 SillyTavern 項目根目錄

找到您的 SillyTavern 安裝路徑。該文件夾必須包含 data 目錄（SillyTavern 存儲其配置和資產的地方）。

例如，在 Windows 系統上，路徑通常類似於：

C:\code\SillyTavern\SillyTavern

在該文件夾中，確認能看到 data 子文件夾：

C:\code\SillyTavern\SillyTavern\data

注意：如果您不小心選擇了 data 文件夾本身，Tavern Studio 會嘗試自動糾正路徑，但我們仍建議直接選擇包含 data 文件夾的項目根目錄。

步驟 2：在 Tavern Studio 中打開導入器

啟動 Tavern Studio 並前往：

Settings -> Data Management -> Import from SillyTavern

點擊 Choose Folder 並選擇您的 SillyTavern 項目根目錄。

步驟 3：查看導入預覽

等待導入器完成對該目錄的掃描。界面將顯示一個預覽，列出以下項的數量：

  • 角色卡
  • 世界書
  • 預設
  • API 配置
  • 聊天記錄

如果預覽為空，或者數量明顯不正確，請取消導入並重新確保選擇了正確的 SillyTavern 項目根目錄。

步驟 4：選擇用戶和內容範圍

勾選您要導入的特定 SillyTavern 用戶資料及內容組。如果您擁有極大的資料集，可以考慮先遷移最核心角色卡組合，以便更輕鬆地進行導入後驗證。

步驟 5：執行導入

點擊 Import 並等待過程完成。完成後，Tavern Studio 將自動重新加載其資料庫和工作區。

步驟 6：驗證導入的資產

導入完成後，請檢查 Tavern Studio 中的以下版塊：

  • Characters： 檢查角色列表以確保角色卡已正確加載。
  • Chats： 打開導入的角色，驗證其 JSONL 聊天歷史是否已恢復。
  • World Books： 導航至世界書管理區域，檢查導入的世界信息文件。
  • API Settings： 檢查 API 配置頁面上的密鑰和端點映射。
  • Resource Assets： 確認頭像、背景和相關文件已加載。

步驟 7：檢查模型和 API 設定

對於導入的 API 配置，請仔細檢查：

  • API 密鑰是否已正確保存。
  • Base URL 是否匹配您的服務商端點。
  • 是否已選擇可用且受支援的預設模型。
  • 是否需要手動補全自定義代理、帳戶 ID 或本地服務主機名。

在開始長對話會話前，建議使用導入的角色和預設發送一條測試消息，以確保連接一切正常。

與 SillyTavern 的關係

Tavern Studio 是一個獨立的替代品，並非 SillyTavern 官方項目。它是一個完全獨立的、本地優先的應用程式程式，支援主流的社區 AI 角色卡及格式。此導入工具僅作為一項便利功能提供，旨在幫助您重新利用現有的創意資產和配置，而絕不會修改或幹擾您的 SillyTavern 原始安裝。

常見問題

我應該在導入器中選擇哪個文件夾？

您必須選擇 SillyTavern 的項目根目錄——即包含 data 文件夾的那個目錄（例如 C:\code\SillyTavern\SillyTavern）。不要選擇單個角色文件夾，也不要直接選擇 data 文件夾。

導入會損壞我原本的 SillyTavern 文件嗎？

不會。導入器完全是只讀的。它讀取您的 SillyTavern 目錄並將資產的副本寫入 Tavern Studio 的獨立資料庫和工作區。您的原始文件不會受到任何修改。

支援導入哪些類型的資料？

Tavern Studio 目前支援導入角色卡、世界書 / Lorebook、OpenAI 兼容預設、API 密鑰與配置以及標準的 JSONL 格式聊天記錄。

我的舊聊天記錄（傻酒館裡的資料）可以遷移嗎？

是的，與角色關聯的標準 JSONL 聊天歷史可以被導入。每個符合格式的聊天文件都將被導入為獨立的會話分支，並完整保留消息順序。損壞、失效或不支援的聊天文件可能會被跳過。

支援群聊遷移嗎？

目前尚未完全支援群聊資料遷移。導入程序可能會跳過不支援的群聊內容，以避免生成損壞的對話歷史。

為什麼有些本地端點或自定義代理在導入後需要手動配置？

自定義端點、反向代理、本地 LLM 配置（如 Ollama 或 LM Studio）、Azure OpenAI 和 Cloudflare Workers AI 等，通常需要特定的主機名、帳戶 ID 或自定義路由路徑。這些設置無法完全自動映射，您需要手動在 API 設置頁面中填寫這些細節。

導入的角色或資產沒有顯示怎麼辦？

首先檢查導入報告是否包含錯誤。如果確認文件已成功導入但未顯示，請嘗試刷新頁面或重啟 Tavern Studio 以強制重新加載資源資料庫。

在遷移前，我是否仍需要備份我的 SillyTavern 文件夾？

儘管導入器是只讀的、不會修改您的 SillyTavern 目錄，但在進行任何資料遷移操作前，對您的原始 SillyTavern 資料進行備份仍然是一個良好的習慣。

下一步

下載 Tavern Studio
Windows