# 角色卡 PNG 和 JSON 有什么区别？导入、世界书与资源检查指南

作者：像素酒馆编辑组
日期：2026-11-03
规范地址：https://xstavern.com/blog/character-card-png-json/

角色卡不是一张好看的头像，而是一组用于建立人物与场景的结构化资料。它可能以 JSON 文件保存，也可能嵌在 PNG 图片的元数据里。因此“能打开图片”和“能导入角色设定”是两件事；图片软件显示正常，并不能证明其中还保留着卡片数据。

## PNG 是封面，也可以是资料容器

PNG 文件由多个数据块组成。常见酒馆角色卡会在文本类元数据块中携带编码后的角色定义，前端读取这些内容后创建人物。封面承担视觉识别，元数据承担行为设定。具体字段与版本需要由导入器识别，而不是看文件扩展名猜测。

如果通过社交软件发送图片、截图重存，或者用图片压缩服务重新编码，元数据可能被移除。这样得到的文件仍是有效 PNG，却可能只剩封面。传输时尽量用“发送原文件”或 ZIP，导入后核对名称、描述、开场白和世界书，不要只看图片是否出现。

另一个常见误区是把 JPG 改名为 PNG。扩展名不改变内部编码，也不会凭空加入人物资料。只有封面的情况下，需要另有角色 JSON 或重新建立设定；不要把缺数据文件当成完整角色卡反复导入。

## JSON 更便于检查，但通常不包含完整图片

JSON 是可读文本，适合审查和版本比较。你能检查人物名称、性格描述、场景、首条消息、示例对话与扩展字段。不同卡片规范和工具对字段的解释可能不同，存在同名字段不代表导入行为完全一致。

JSON 内可能只有图片地址，也可能没有封面。迁移时仅保存 JSON，不能假设远程地址将永久可用。角色卡 ZIP 备份应同时保存图片与结构化资料，世界书、正则、预设等随卡资源也应在导入前明确展示，让用户知道带进来的不仅是人物文字。

手动编辑 JSON 前先复制原文件。字符串里的双引号与换行必须遵守 JSON 语法；少一个逗号就可能导致整个文件无法解析。若只是修改人物介绍，优先使用应用内编辑器，再导出检查，通常比直接修改原始数据安全。

## 导入前看清四类内容

第一类是人物与玩法。确认角色是谁、用户扮演什么身份、是否允许自由推进、有哪些固定流程。第二类是世界设定，检查城市、阵营、力量体系是否清楚，是否把所有背景都塞进每次请求必发的长描述。

第三类是格式与资源。卡片可能依赖世界书关键词、预设输出结构、正则替换或受控 HTML 展示。若原作者说明需要某个扩展，应查看目标工具的兼容文档。像素酒馆不是完整的 SillyTavern 扩展运行时，原始 JavaScript 不能因为附在卡里就被视为可执行插件。

第四类是授权和内容边界。公开可见不等于可以任意二次分发；导入到本机也不等于获得重新上架的许可。成人内容应遵守年龄与平台规则，不能依赖一段干净简介判断整张卡的分级，封面和正文同样需要检查。

## 用一个小样本验证导入

在[像素酒馆](https://chat.deepseektavern.com/)导入后，先打开角色详情。比较文件与界面里的名称、开场白、人物设定及世界书数量。如果有随卡资源确认步骤，逐项阅读后再选择，不要为了省事盲目启用所有内容。

然后新建一段测试聊天，发送能触发一个核心设定的短消息。例如卡片写明人物从不饮酒，就询问是否愿意在酒馆点酒。这里测试的是设定有没有进入请求，以及模型是否遵循，而不是追求文学质量。世界规则再用一条明确关键词测试，避免同时引入太多变量。

若出现标签原样露出、按钮无反应、状态栏不更新，分别检查文本、显示和插件适配。导入成功只说明基础数据被接受，不代表卡片原平台的全部交互都被复刻。可以先使用基础文字玩法，再决定是否需要改写扩展部分。

## 批量导入与去重应保守处理

一次导入很多文件，最容易混淆的是“同名”和“相同”。两个角色都叫“林”，不代表其人物定义一致；同一个角色换了封面，也不一定应该覆盖原文件。更稳妥的策略是完全相同的卡跳过，同名不同内容保留独立副本。

像素酒馆支持选择一个受支持的角色卡备份 ZIP，或一次最多十个 PNG／JSON 文件进行批量导入。处理前检查预览，处理中观察成功、跳过与失败项。失败文件应保留原件单独排查，不要把部分成功误认为整个目录都已恢复。

导入不会自动替换旧聊天中的人物状态，也不应覆盖历史对话。卡片定义与会话进度是两类资料：前者描述角色的初始设定，后者记录这个周目已经发生的事情。关键道具和个人选择更适合保存在会话记忆，而不是直接改写所有周目共用的角色档案。

## 备份与跨工具交换的边界

如果目标是保留个人全部资料，使用原生完整备份；如果只是分享自己有权分享的角色，使用角色 PNG／JSON 或角色卡 ZIP；如果是迁移对话，使用独立的 SillyTavern 聊天格式。这三种文件用途不同，不能互相替代。

建议建立一个包含日期、来源、授权说明和原文件的归档目录。测试修改后的卡时保留原版，这样出现世界书缺失或格式问题，可以比较到底是源卡依赖、导入解释还是后续编辑造成的。更多概念可查阅[SillyTavern 角色文档](https://docs.sillytavern.app/usage/characters)，迁移步骤见[聊天记录交换指南](/blog/sillytavern-chat-migration/)。

## 常见问题

### 为什么 PNG 图片能看，导入却提示没有角色资料？

可能只剩图片，人物元数据被压缩或转存过程移除了。优先找作者提供的原文件或配套 JSON，不要用修改后缀来修复。也应确认源卡规范属于导入器支持范围。

### 换封面会不会改变人物？

这取决于编辑工具怎样保存元数据。单纯视觉编辑不应被当成完整角色更新流程。更换后重新打开详情核对设定，并保留旧文件，再决定是否长期使用新版本。