Character Card V2：格式上多了什么，GitHub 上怎么找样例

我不是规范作者，只是做工具时要读格式。下面是我给第一次接触 V2的人准备的「够用版」说明：够你少踩坑、知道去哪查原文。

V2 大致在解决什么

可以把 V1 想成「能用的第一版」，V2 则在社区演进里补了更清晰的结构（例如字段分层、扩展方式），让不同前端、不同工具之间少打架。你不需要背每一个键名，但要建立一个预期：同一张卡，在不同版本前端里，表现可能略有差异，以你用的软件文档为准。

和「一张 PNG + JSON」的关系没变

常见形态仍然是：PNG 里嵌 JSON。V2 动的是 JSON 里怎么组织信息，不是把「角色卡」变成另一种完全不同的东西。若你已读过 Character Card 是什么，可以把 V2 理解成：说明书换了一版排版，章节更清楚。

上 GitHub 怎么搜

按动词来：

1. 打开 GitHub，搜索框输入 character card v2 或 tavern card spec。
2. 优先看 README 写清楚字段、有 license 的仓库。
3. 看到示例 JSON 时，对照作者说明：哪些是必填、哪些是扩展。
4. 若要引用或改写示例，先看许可证（MIT、CC 等），别默认「网上都能抄」。

不同仓库可能用不同名字描述同一概念，别慌，对照字段表比死记一篇教程靠谱。

实操时容易忽略的两点

• 编码与换行：手工改 JSON 时，一个引号没转义就能让整张卡读不出来。改完用工具校验一下。
• 兼容性：导出前确认你的前端（例如 Silly Tavern）支持你用的字段集合。最稳的是：先小改、再导入、再聊几句验收。

相关阅读

• 彻底了解 Silly Tavern 角色卡字段（系列目录）
• 从模板到一张能用的卡
• 怎么写「更好用」的角色卡

---

在 Mac 上本地管理、预览、编辑 Silly Tavern 系 PNG 角色卡，可以用 Sillycard。我不是来替你做合规判断的，但把卡当文件管清楚，改稿会轻松很多。产品细节以 App Store 与应用内为准。