角色卡 V1 V2 V3 规范解析 —— Character Card 三个版本的字段差异
酒馆角色卡格式经历了三次重要迭代,每个版本新增了更多字段来增强角色定义能力。OMate 会自动识别版本,优先解析最新的 CCV3 块。
V1(Character Card 1.0)
最早的角色卡格式,字段最少:
| 字段 | 说明 |
|---|---|
| name | 角色名 |
| description | 角色描述(包含性格、场景等) |
| personality | 性格 |
| scenario | 场景 |
| first_mes | 第一条消息 |
| mes_example | 对话示例 |
| creator_notes | 作者备注 |
V2(Character Card 2.0 / Chara)
V2 在 V1 基础上增加了若干字段:
| 字段 | 说明 |
|---|---|
| system / send_as | 系统提示词 |
| post_history_instructions | 历史记录后说明 |
| tags | 标签 |
| creator | 作者 |
| character_version | 版本号 |
V3(Character Card 3.0 / CCV3)
最新版本,字段最完整。与 V1/V2 的核心差异:
- 多 chunk 结构:PNG 内嵌时会有两个数据块(V2 块 + V3 块),OMate 优先读取 V3 块
- 丰富的作者与标签字段:支持 tags 数组、category、用户评级等
- 内嵌资源:charx 格式可以包含头像、背景图等文件
- 拓展字段:深度提示词(depth_prompt)、作者备注(Author's Note)等
OMate 导入时的处理
- 读取 PNG 的所有内嵌数据块
- 优先使用 V3(CCV3)块的字段
- 若 V3 块不存在,降级使用 V2 块
- 最终落盘为 OMate 的原生角色数据模型,所有功能都能正常使用
双向流转
OMate 导出角色卡时,会以原卡为底稿双 chunk(V2 / V3)写回——确保你改过的角色发回酒馆社区时不丢失数据。