omate 中文文档 下载 App

角色卡 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 的核心差异:

OMate 导入时的处理

  1. 读取 PNG 的所有内嵌数据块
  2. 优先使用 V3(CCV3)块的字段
  3. 若 V3 块不存在,降级使用 V2 块
  4. 最终落盘为 OMate 的原生角色数据模型,所有功能都能正常使用

双向流转

OMate 导出角色卡时,会以原卡为底稿双 chunk(V2 / V3)写回——确保你改过的角色发回酒馆社区时不丢失数据。

下一页:角色卡导出回酒馆 →