导入角色卡
在 AI 角色扮演和互动写作生态中，Character Card（角色卡） 是承载角色人设、性格、口吻和背景设定的标准载体。Tavern Studio 兼容行业通用的 PNG 与 JSON 格式角色卡，并提供安全便利的导入流程。本篇指南将向你展示如何将外部角色卡导入 Tavern Studio，并解决导入过程中的常见冲突与加密问题。
适合谁阅读
- 准备从外部网站（如 Character Hub 等社区）下载角色卡，并想将其导入 Tavern Studio 的用户。
- 遇到重复角色卡冲突、需要批量整理角色资产的创作者。
- 导入带有密码保护（加密）的 PNG 角色卡，或遇到导入报错的排查者。
你将学会什么
- 掌握拖拽导入与底部 TabBar 统一导入的两种基础操作。
- 理解 PNG 角色卡与 JSON 角色卡的技术差异。
- 熟练应对批量导入时的重名冲突处理（覆盖或重命名）。
- 学会导入带有密码保护的加密角色卡。
- 排查“非角色卡图片”或“解析失败”等导入阻塞问题。
认识角色卡格式
在 Tavern Studio 中，您可以导入以下两类角色卡资产：
- PNG 角色卡（PNG Character Card）：这是常用的格式。它外观上是一张普通的角色立绘或头像图片，但实际上，它的 PNG 数据区块中通过特殊的隐写算法，嵌入了用 JSON 格式编写的角色性格描述、问候语、例句等元数据。
- JSON 角色卡（JSON Character Card）：不包含任何图片信息的纯文本配置文件。通常在没有立绘或网络传输纯文本设定时使用，导入后系统会为其分配一个默认的空白头像。
基础导入操作
Tavern Studio 提供了两种简单直接的导入路径：
方法 A：屏幕拖拽（推荐）
在客户端主界面处于任何管理标签页时，直接在电脑文件管理器中选中一张或多张角色卡图片，将其拖入 Tavern Studio 窗口的任意位置。客户端会拦截拖放意图，并启动统一导入预览流程。
方法 B：底部 TabBar 统一导入“+”按钮
点击屏幕下方 TabBar 正中间的 +（加号） 按钮。这会拉起全局导入管理器，您可以选择单张或批量多选文件进行导入。
冲突处理：重名与重复项
当您批量导入一大批角色卡时，难免会遇到“已经导入过同名角色”的情况。Tavern Studio 不会静默覆盖您的旧资产，而是通过 Unified Import Dialog（统一导入弹窗） 进行安全提示：
- 重命名（Rename）：系统会在新导入的角色名字后自动加上
(Copy)或序号，从而保留您原有的旧角色卡，使其并存。 - 更新覆盖（Overwrite）：使用新导入的角色设定替换当前的旧设定，历史聊天记录默认会继续保留并关联到新设定上。
- 跳过（Skip）：放弃导入当前重复的这张卡片。
导入加密角色卡（Encrypted Card）
为了保护作者的创作版权，部分角色卡在分发时使用了密码进行加密。对于这类卡片，Tavern Studio 提供了内置的密码解密流：
- 当您拖入或选择一张加密的 PNG 角色卡时，统一导入预览窗不会直接报错，而是会检测到加密标识。
- 界面会立即转换为密码索要对话框，提示您：“此角色卡已被加密，请输入解密密码”。
- 输入卡片创作者提供的密码并点击确认。
- 如果密码正确，角色卡会被当场解密，提取出人设文本，并成功添加到您的角色瀑布流列表里。
- 如果密码错误，系统会提示
Decryption failed: Wrong password or corrupted data（解密失败：密码错误或数据损坏）。
常见问题与导入排查
Q1：为什么我从社交软件保存的图片导入时，提示 "No character data found"（未找到角色数据）？
这是由于图片元数据被压缩或剥离导致的。许多社交平台（如微信、QQ、微博、Discord 等）在传输图片时为了节省带宽，默认会对图片进行二次压图，这会把隐写在 PNG 元数据区块（如 tEXt 或 iTXt）中的角色性格设定清除，使其变成一张普通的平面图。
- 解决办法：在下载角色卡时，请尽量使用专门的角色卡分享网站的 Download 按钮，或者在社交软件中要求对方以“文件发送”或勾选“原图”传输。
Q2：批量导入时遇到多个加密角色卡，能静默导入吗？
不能。如果批量导入序列中遇到了需要密码的卡片，系统会中断并弹出密码输入框。如果您直接点击取消或关闭该密码框，该张卡片会被计为“导入失败”并自动跳过，继续序列中剩余卡片的导入。
Q3：为什么有些角色卡导入后直接提示“Unsupported format for preview”？
这说明该文件可能并不是有效的 PNG/JSON 角色卡（可能是一个重命名为 .png 的其他类型文件），或者文件本身已经物理损坏。此时导入预览会禁用“导入”按钮以保护您本地数据库的稳定性。
下一步
- 开始第一次聊天：导入成功的角色卡会在你的瀑布流中展现，点击它立刻开始对话。
- 从 SillyTavern 迁移到 Tavern Studio：学习如何把你在 SillyTavern 里的全套角色卡和聊天记录导入过来。
- 世界书入门：学习如何为你的角色卡添加动态的世界观背景绑定。