匯入角色卡
在 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 里的全套角色卡和聊天記錄匯入过来。
- 世界書入門：学习如何為你的角色卡添加動態的世界观背景綁定。