Tavern Studio Download
Tavern Studio SEO Article - ZH

如何从 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 数据进行备份仍然是一个良好的习惯。

下一步