# 聊天记录如何与 SillyTavern 互通：JSONL、角色卡与完整备份

作者：像素酒馆编辑组
日期：2026-11-03
规范地址：https://xstavern.com/blog/sillytavern-chat-migration/

把聊天导出成“兼容格式”，不代表换一个工具就能恢复全部体验。消息正文、角色资料、图片、摘要、状态栏与插件数据可能存放在不同位置。迁移之前先决定要搬什么，再选择文件格式，能避免导入成功以后才发现记忆和角色资源没有一起过来。

## 先分清三种导出目的

角色卡 PNG／JSON 描述人物初始设定，适合迁移人物；角色卡 ZIP 将多张卡与图片、受支持的随卡资源一起归档；原生完整备份面向像素酒馆自身的数据恢复。它们都不能自动等同于一段标准聊天记录。

独立的“SillyTavern 格式”主要用于消息交换。常见形式是 JSONL，即每行一个 JSON 对象，包含元信息和消息记录。完整的 JSON 数组、纯文本与 JSONL 不是同一种文件，不能只改扩展名就期待导入器正确理解。

如果目标是换设备继续使用像素酒馆，优先完整备份；如果目标是把一段对话带到 SillyTavern，使用独立交换格式，并另行准备角色卡。不要为跨工具分享而随手发送完整备份，因为其中可能包含远超对方所需的私人资料。

## 标准消息与私有状态存在边界

基础作者、用户标记、消息文本和时间适合交换。分支、工具调用、生成式 UI 状态、跑团属性、结构化关键记忆、插件变量与本地资源地址，则未必有目标工具认可的对应字段。保留了额外字段，也不等于对方会读取。

群聊尤其需要核对作者身份。一个导入器可能把多位角色归为单个助手，也可能对名称重复的角色处理不同。图片和音频若引用本机对象地址，到了另一台设备往往不可用。消息里看得见一个路径，不代表那个文件已经被打包。

因此“兼容”应理解为经过声明范围内的交换能力，而不是全部私有数据无损。关键资料应同时保留原生备份，在目标工具验证之后再清理旧环境，不要用一次成功导入作为删除原件的理由。

## 导出前准备一个可以对照的样本

选一段很短的测试会话，包含一条用户消息、两条角色回复、中文、引号和换行。先记录界面里的作者、顺序与正文。若需要多角色迁移，再额外加入一位不同名称的人物，观察目标端如何区分。

在[像素酒馆](https://chat.deepseektavern.com/)选择独立 SillyTavern 格式导出，保留原文件。用文本编辑器查看时，每行应是完整 JSON；消息内部换行以字符串转义表达，不能随意手工拆行。编辑器自动格式化整个文件，可能把它变成不再符合预期的结构。

检查文本编码和文件内容比检查后缀更重要。出现乱码先确认 UTF-8；出现解析错误先定位具体行，而不是删除所有标点。测试文件不要包含真实密钥、账号密码、联系方式和不希望分享的私人剧情。

## 在目标工具核对导入结果

先导入或建立匹配的角色，再按目标工具自己的聊天导入流程操作。SillyTavern 的界面和格式可能随版本变化，具体入口以[官方文档](https://docs.sillytavern.app/)为准，不要依赖一张旧截图来判断功能不存在。

导入完成后，逐项对照消息数、顺序、作者和完整正文，特别注意换行、反斜杠、引号和 HTML 标签。页面显示正常并不代表所有原始内容都保留；必要时再次导出，与小样本比较。显示层隐藏和原始消息删除是不同问题。

然后进行一轮短测试，确认新回复使用正确角色。不要立刻把旧摘要和新摘要同时塞进请求，避免重复或矛盾。跨工具后的第一次生成效果不同，可能是预设、世界书和采样参数变化，并不一定意味着聊天导入损坏。

## 从 SillyTavern 导回时保持同样谨慎

使用目标导入器支持的格式，先预览再确认。对于无法识别的字段、附件或高级状态，应保留源文件，不要静默丢弃后继续覆盖已有会话。重复导入应产生清楚结果，而不是不知不觉把同一段消息追加两次。

未知格式的文件不应作为可执行内容运行。聊天文本里出现脚本、宏或按钮，不代表导入器需要执行它。像素酒馆的插件兼容具有明确边界，原始 SillyTavern 扩展脚本不能靠聊天文件绕过权限。

若导入失败，记录文件来源工具和版本、大小、错误行、是否单聊或群聊，再制作去除私人内容的最小样本。这样更容易区分格式版本、编码、大小限制和字段支持问题，避免把完整私人聊天发给他人排查。

## 迁移前后的备份清单

迁移前分别保存原角色、世界书、预设、正则、原生完整备份和聊天交换文件。重要关键记忆另行核对，不能假设它已被转成目标工具的记忆结构。若需要整理为普通文本，应标注已发生事实、当前状态和知情范围。

迁移后在隔离会话测试，确认资料完整、资源可加载、回复身份正确，再决定是否将目标端作为日常环境。至少保留一个可打开的源端副本。更多备份实践见[本机数据安全指南](/blog/local-data-backup-safety/)，角色文件区别见[PNG 与 JSON 教程](/blog/character-card-png-json/)。格式是桥梁，验证才是迁移完成的证据。

## 常见问题

### 把普通 JSON 改成 .jsonl 就能导入吗？

不能。JSONL 要求每行符合预期记录结构，文件后缀不会转换内部数据。使用对应导出入口，保留原文件；解析错误应定位记录，而不是不断更换扩展名。

### 关键记忆和插件变量会一起迁移吗？

标准聊天格式不保证携带或解释这些私有结构。需要在原生备份中保留，并在目标工具另行核对或整理。不能把消息数一致当成全部状态一致。