酒馆角色卡怎么导入和制作？PNG 卡与 JSON 卡详解（2026）

结论先说：酒馆的角色卡就是一份写好的角色设定，最常见的是 PNG 图片卡（设定以 JSON 嵌在图片里），其次是纯文本 JSON 卡。导入只要在角色管理面板点 Import Character 选文件；自己写卡，重点写好 Description 和 First message 两个字段。V2、V3 两种规范酒馆都能读。

前置条件

你需要一个已经装好、能正常打开的酒馆（截至 2026-11-05 最新稳定版 1.19.0），以及至少接好一个模型 API。没装好的先看 电脑安装教程 或 安卓 Termux 教程。

网络环境

导入和编辑角色卡全在本地完成，不需要联网，也不需要加速器。只有两个环节涉及网络：从境外分享站下载卡片时可能较慢；用卡聊天时，请求发往你接入的模型，接 Gemini、Claude 需要日本、新加坡等受支持地区的出口，接 DeepSeek 直连即可。

角色卡有哪几种格式？

酒馆能识别的角色卡分为图片卡和文本卡两大类，规范版本有 V1、V2、V3。

格式	文件	规范标识	特点
PNG 卡（V2）	.png	chara_card_v2，图片内 chara 文本块	最常见，自带头像，可内嵌世界书
PNG 卡（V3）	.png	chara_card_v3，图片内 ccv3 文本块	新规范，常同时保留 V2 块兼容旧工具
JSON 卡	.json	V1/V2/V3 均可	纯文本，便于编辑，无头像
CHARX 包	.charx	V3 定义的 zip 包	卡片 JSON 加图片等资源打包

V2 规范由社区在 GitHub 的 character-card-spec-v2 仓库发布，核心字段有 name、description、personality、scenario、first_mes、mes_example，还可以通过 character_book 内嵌世界书。V3 规范（kwaroran/character-card-spec-v3）在 V2 基础上扩展，要求 PNG 里用名为 ccv3 的文本块保存经 base64 编码的 JSON；如果图片里同时有 chara 和 ccv3 两个块，应用应优先读 ccv3。

PNG 卡的设定藏在图片的元数据里，所以一旦被压缩就会丢失。微信、QQ、小红书转发的图片、截图，基本都已经不是原卡。

怎么导入角色卡？

导入只需要三步，全程在酒馆界面里完成。

1. 点击顶部导航栏的角色管理图标，打开角色列表。
2. 点 Import Character（导入角色）按钮，选择 PNG 或 JSON 文件；也可以把文件直接拖进酒馆窗口。
3. 如果弹出「This character has an embedded World/Lorebook」，说明卡里带了世界书，选择导入，让设定一起生效。

导入后，角色卡会以 PNG 形式保存在 data/default-user/characters/ 文件夹里。导入失败或导入后字段为空，最常见的原因是图片被压缩过，换原图再试。

怎么从零写一张角色卡？

新建角色只要填名字、Description 和 First message 三项就能聊，其余字段用来提升效果。在角色管理面板点 Create New Character，按下表填写。

字段	卡内字段名	作用	是否每次都发送给模型
名字	name	角色名，可在文本里用 {{char}} 指代	是
描述	description	外貌、背景、性格、世界观等核心设定	是
性格摘要	personality	一两句性格概括	是
场景	scenario	对话发生的情境	是
开场白	first_mes	角色说的第一句话，决定文风	只在开场发送一次
对话示例	mes_example	示范角色怎么说话	上下文有空间才发送

官方文档对几个字段的说明值得记住：Description 永远会被放进提示词，所有重要事实都应该写在这里；开场白只在聊天开始时发送一次，但模型会把它当作这个角色写作风格的范本；对话示例每段前要加 <START> 标记，上下文满了会被逐段挤出。

一个最小示例

下面是一张全年龄的原创角色卡 JSON（V2 结构），可以复制后改成自己的：

{
 "spec": "chara_card_v2",
 "spec_version": "2.0",
 "data": {
 "name": "林汐",
 "description": "{{char}} 是一家深夜书店的店主，25 岁，说话温和、爱用比喻，熟悉各类小说。书店只在晚上 9 点到凌晨 2 点营业。",
 "personality": "温柔、细心、有点慢热",
 "scenario": "{{user}} 下班后第一次走进这家书店避雨。",
 "first_mes": "（抬头放下手里的书）外面雨很大吧？先坐一会儿，我去给你倒杯热茶。",
 "mes_example": "<START>\n{{user}}: 有什么书推荐吗？\n{{char}}: 看你今天的心情。想被安慰，还是想被吓一跳？"
 }
}

写卡有三个实用原则：设定写具体事实而不是形容词堆砌；开场白的长度和语气就是你希望角色回复的样子；想让角色用中文回复，就用中文写卡。

角色卡从哪里找？

最稳妥的是先用酒馆自带的默认角色熟悉流程，然后自己写。社区里有不少角色卡分享站和论坛，但内容分级参差不齐，部分站点以成人内容为主。使用任何分享站之前，先看清它的内容规则和分级标识，只导入适合自己的全年龄角色。

另外要尊重作者权益：别人的卡不要改个名字二次发布，商业用途更要先取得授权。基于动漫、游戏角色写的同人卡，也只适合个人使用。

怎么导出和分享？

在角色编辑面板找到导出按钮，可以选 PNG 或 JSON。分享给朋友时发 PNG 原文件（用网盘或文件传输，不要用会压缩图片的方式），对方直接导入即可。卡里绑定了世界书的话，主世界书会一起嵌进导出的卡片。世界书的用法见 世界书与预设。

常见问题

酒馆角色卡是什么？ 保存角色设定的文件，包含名字、描述、性格、场景、开场白、对话示例。最常见的是 PNG 图片卡，导入后直接能聊。

PNG 卡和 JSON 卡有什么区别？ 内容一样、载体不同：PNG 卡自带头像、方便分享；JSON 卡是纯文本、方便编辑。

V2 卡和 V3 卡有什么区别？ V2 用 chara_card_v2 与 chara 文本块，V3 用 chara_card_v3 与 ccv3 文本块，并新增 .charx 打包格式。酒馆两种都能导入。

角色卡怎么导入酒馆？ 角色管理面板点 Import Character 选文件，或直接拖入窗口；卡内带世界书时按提示导入。

导入的 PNG 卡显示没有设定是怎么回事？ 图片被压缩过，嵌入的文本块丢了。从原始发布页下载原图。

角色卡存在电脑哪里？ data/default-user/characters/，备份时整体复制 data/default-user。

从哪里找角色卡？ 先用默认角色练手、再自己写；社区分享站分级不一，使用前看清内容规则，只导入全年龄角色。

还没接模型的话，看 酒馆接 DeepSeek、酒馆接 Gemini API 或 酒馆接 Claude API。酒馆入门总览见 新手 30 分钟上手。

参考来源

• 官方文档 · 角色设计：https://docs.sillytavern.app/usage/core-concepts/characterdesign/
• 官方文档 · FAQ（创建角色）：https://docs.sillytavern.app/usage/faq/
• 官方文档 · World Info（角色绑定世界书与导出）：https://docs.sillytavern.app/usage/core-concepts/worldinfo/
• Character Card V2 规范：https://github.com/malfoyslastname/character-card-spec-v2
• Character Card V3 规范：https://github.com/kwaroran/character-card-spec-v3/blob/main/SPEC_V3.md
• SillyTavern 官方仓库：https://github.com/SillyTavern/SillyTavern