一张PNG图片里藏着一个AI角色SillyTavern角色卡片系统从入门到精通【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavernSillyTavern 自称LLM Frontend for Power Users面向高级用户的 LLM 前端它的角色卡片Character Card系统是几乎所有玩法的基础你把一个角色喂给任意大模型它就能以这个角色的身份和你对话。本文从新手最常见的困惑入手层层拆解角色卡片的存储原理、导入导出机制、进阶定制玩法与常见排雷路径带你完整掌握 SillyTavern 角色卡片的使用与制作。一、新手困惑为什么角色不是一个文件夹而是一张图片用过其他 AI 聊天前端的朋友第一次接触 SillyTavern 时多半会愣住社区里分享的角色怎么是一张 PNG 图片拖进网页后角色的姓名、性格、开场白居然全都出现了——难道大模型能从像素里读出人物设定答案是否定的。SillyTavern 角色卡片的秘密在于PNG 文件不仅能存图像还能在文件内部附加一段文本信息。角色数据就藏在这段看不见的文字里图片本身只是它的外壳和门面。这种设计带来的直接好处是——一张角色卡 一个文件 一个可分享、可版本管理、可拖拽导入的完整角色。你不用解压压缩包、不用复制 JSON、不用纠结配套文件丢失一张图走天下。这个设计并非 SillyTavern 首创但它是把PNG 元数据存角色这条路线做得最彻底、生态最庞大的实现之一。二、破局PNG 元数据到底怎么藏角色数据要理解角色卡片先要懂一点 PNG 的底层格式。PNG 文件由一系列数据块chunk组成有负责图像的IHDR、IDAT也有可选的文本块tEXt。tEXt块的设计初衷是存储作者署名、版权声明之类的信息SillyTavern 把它玩出了新花样把完整的角色 JSONBase64 编码后塞进tEXt块。读取时的流程是这样的用png-chunks-extract把 PNG 拆成数据块列表过滤出所有tEXt块用png-chunk-text解码出键值对找到键名为charaV2 规范或ccv3V3 规范的块优先读取ccv3把 Base64 文本解码成 UTF-8 字符串得到完整角色 JSON。写入时则反过来把角色 JSON 转成 Base64插入到IEND结束块之前并自动生成一份 V3 兼容副本。这套逻辑的核心实现只有不到一百行集中在 src/character-card-parser.js。看一段最关键的read()函数const textChunks chunks.filter((chunk) chunk.name tEXt) .map((chunk) PNGtext.decode(chunk.data)); // V3 优先 const ccv3Index textChunks.findIndex((chunk) chunk.keyword.toLowerCase() ccv3); if (ccv3Index -1) { return Buffer.from(textChunks[ccv3Index].text, base64).toString(utf8); } // 回退到 V2 const charaIndex textChunks.findIndex((chunk) chunk.keyword.toLowerCase() chara); if (charaIndex -1) { return Buffer.from(textChunks[charaIndex].text, base64).toString(utf8); }逐行解读先把所有文本块解析出来然后按V3 优先、V2 兜底的顺序查找角色数据最后把 Base64 还原成可读字符串。这套双版本机制保证了向后兼容——老的 V2 卡片能读新的 V3 卡片也能读新旧生态不割裂。【技术要点】角色卡片的三种规范版本V1chara_v1最早期格式字段简陋如今基本只用于兼容旧文件V2chara目前社区主流字段结构完善包含姓名、描述、性格、场景、开场白、示例对话等V3ccv3新一代规范支持结构化字段、标签、创作者信息等解析时拥有最高优先级。三、从单张卡片到角色库系统是怎么组织的角色卡片能解析只是第一步SillyTavern 还围绕它搭了一套完整的存取、校验与缓存体系大致分三层数据存储层data/目录下的用户数据默认dataRoot: ./data每张导入的卡片落盘为独立的 PNG 文件另有基于node-persist的磁盘缓存目录配合 100MB 上限的内存缓存performance.memoryCacheCapacity避免频繁读盘业务逻辑层src/validator/TavernCardValidator.js 负责按 V1/V2/V3 规范逐字段校验卡片结构src/endpoints/characters.js 提供角色列表、上传、编辑、删除等 RESTful 接口还支持lazyLoadCharacters配置角色很多时可只加载浅层数据、按需展开用户界面层public/下的前端脚本负责渲染角色面板、拖拽导入、批量操作等交互。这套分层让一张卡片和一个角色库被统一管理单张卡片负责便携与分享角色库负责组织与调用。值得一提的是校验器对字段缺失会给出具体的报错字段名如first_mes排错时非常有用。四、动手实操5 分钟创建第一个角色理解了原理下面进入实战。SillyTavern 角色卡片制作教程的第一课是创建一个最简单的咖啡馆服务员。【入门示例】基础角色创建步骤准备一张角色立绘 PNG社区推荐 608x920 左右比例接近竖版立绘打开 SillyTavern 界面进入角色管理面板点击新建角色上传立绘填写基础字段姓名、角色描述用两三句话说清身份与外貌、性格、开场白再补上 1-2 组示例对话mes_example这能显著提升模型模仿语气的能力点击保存。此刻系统调用了character-card-parser.js的write()函数把刚才填写的 JSON 编码进 PNG 的tEXt块——你的第一张角色卡片诞生了。保存后这个 PNG 就是完整的角色载体。你可以把它发给任何人对方在 SillyTavern 里拖拽导入即可使用无需任何额外配置。整个过程从零到一不超过五分钟。五、进阶玩法给角色加表情和场景入门之后多数用户会想要更沉浸的体验。SillyTavern 内置了表情Expressions与背景Backgrounds两套扩展让角色不只是文字对话而是有了视觉反馈。表情系统在角色的同名文件夹里放入按情绪命名的一组图片如joy.png、sadness.png、anger.png前端会根据对话内容自动匹配情绪。项目自带的示例角色 Seraphina 就配备了 27 张情绪立绘放在 default/content/Seraphina/情绪判定支持三种后端本地规则none、Extras 分类服务classify、或直接用 LLM 做情绪分类llm。用 LLM 判定时系统会把角色情绪标签列表与最新消息拼成提示词让大模型判断当前应展示哪种情绪效果最自然但会增加一次 API 调用。背景系统对话场景可以随时切换。项目自带 20 多张背景图从现代卧室到中世纪市场、废土都市都有SillyTavern角色卡片的场景背景中世纪城镇酒馆场景和表情组合起来配合立绘与背景就把纯文本聊天升级成了有声有色的视觉化剧本。【进阶示例】书店老板角色的分层配置性格分层表面性格礼貌、专业与内在性格爱书如命、毒舌分别写进描述的不同段落并用当顾客谈论冷门书时这类条件句触发内在性格情绪联动为角色配置 8-10 张关键情绪立绘避免每张都做导致维护成本失控记忆增强启用世界信息World Info插件把常客档案做成关键词触发的词条角色就能记住老顾客的偏好。这里的原则是够用就好表情不必集齐全部 27 种覆盖高频情绪即可背景不必为每个场景都配图先服务核心叙事。六、三种角色存储方案的横向对比为什么 SillyTavern 坚持用 PNG 而非传统存储下表可以直观看出取舍特性SillyTavern PNG 卡片纯 JSON 文件数据库存储便携性极高单文件即完整角色中等需配套文件管理低依赖服务端可视化立绘即身份所见即所得无图像载体需额外关联头像分享传播拖拽即可零门槛需打包传输基本无法直接分享版本管理天然适合 Git 跟踪适合但缺图形载体弱维护成本低中高需要坦诚的一点PNG 方案并非没有代价。角色 JSON 以 Base64 形式重复存储V2/V3 双份会让文件体积略增且单张卡片的元数据容量存在实际上限超大世界观设定仍需借助世界信息文件等外部手段。这是便携性优先的设计取舍社区普遍认为利大于弊。七、排雷3 个高频问题与解决路径【问题一】导入 PNG 后提示无法识别为角色卡片症状图片拖入后没有出现角色控制台报No PNG metadata病因图片是纯照片或截图本身不含tEXt数据块或元数据损坏、被其他软件重压缩时丢块解决先确认文件确实来自 SillyTavern/支持角色卡的社区再用 src/validator/TavernCardValidator.js 的思路手动校验 JSON 字段是否齐全最后尝试找原文件重新导出。【问题二】角色对话OOC脱离角色设定症状角色说话不像自己语气与性格描述不一致病因多半不是卡片坏了而是描述写得太抽象她很温柔模型无从发挥解决把抽象形容词换成具体行为示例补充 3-5 组高质量的示例对话检查上下文预设Context Template是否把角色描述字段正确送入提示词。【问题三】角色很多后界面卡顿症状角色列表加载缓慢、内存占用攀升病因每次加载都解析全部卡片元数据解决在 default/config.yaml 中开启performance.lazyLoadCharacters: true走浅层加载并确认useDiskCache保持开启定期清理不再使用的角色。八、总结与延伸学习回顾全文SillyTavern 角色卡片的核心是用 PNG 的tEXt块承载 Base64 编码的角色 JSON这一个巧妙机制围绕它系统生长出 V2/V3 双规范解析、结构校验、缓存加速、表情与场景扩展等一整套生态。对新手它意味着极低的分享门槛对进阶用户它提供了深度定制的完整舞台。想继续深入可以按自己的水平选路线入门先跑通上文的基础创建流程熟悉角色面板与世界信息的基础用法进阶研究 default/content/presets/ 下的上下文与指令预设理解提示词工程如何影响角色表现尝试给角色配置表情与多套背景专家精读 src/character-card-parser.js 与 src/endpoints/characters.js理解双版本写入策略与缓存设计参考 src/byaf.js 与 src/charx.js 了解 BYAF、CharX 等衍生格式的兼容实现动手写一个自定义扩展接入extensions.js的钩子。本地部署时克隆仓库执行npm install与node server.jsNode.js ≥ 20即可启动仓库地址为 https://gitcode.com/GitHub_Trending/si/SillyTavern 。从一张图片开始你也能亲手造出一个有血有肉的 AI 角色。【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
