彻底了解 Silly Tavern 角色卡字段（1/5）：文件里有什么？spec、data 与元信息

系列：彻底了解 Silly Tavern 角色卡字段（共 5 篇）。字段名称与嵌套关系以社区 Character Card V2 规范说明 为准；Silly Tavern 具体界面文案、是否读取某字段，以你本机 ST 版本为准。

把角色卡想成一份「合同」：封面是 PNG 图，正文是嵌进去的 JSON。这一篇只解决一件事：JSON 最外层长什么样、哪些字段管「展示与元信息」、不进对话模型。

V1 还是 V2：先看有没有 spec

• 看起来像 V1：根对象上直接有 name、description 等六个字符串，没有 spec 字段。规范里这六个字段都必须存在，缺了就用空字符串顶上去，不能是 null。
• 看起来像 V2：根上有 spec: "chara_card_v2"、spec_version（如 "2.0"），真正的人设都在 data 对象里。这样设计，是为了让旧编辑器不要轻易「静默删掉」 V2 才有的扩展字段。

判断方式可以记一句：没有 spec 就当 V1；有 chara_card_v2 就进 data 找内容。

V2 顶层长什么样（概念）

下面是结构示意，用来对齐键名；不要当完整成品抄进生产（省略号处按你工具补全）：

{
  "spec": "chara_card_v2",
  "spec_version": "2.0",
  "data": {
    "name": "",
    "description": "",
    "personality": "",
    "scenario": "",
    "first_mes": "",
    "mes_example": "",
    "creator_notes": "",
    "system_prompt": "",
    "post_history_instructions": "",
    "alternate_greetings": [],
    "tags": [],
    "creator": "",
    "character_version": "",
    "extensions": {}
  }
}

（character_book 可省略；需要时再补，见第 4 篇。）

从下一篇开始，我们会按块拆开讲 personality 等「会进 prompt」的字段；这一篇先把 data 里偏「名片与说明」 的几项说清楚。

name

用途：标识这个角色叫什么。规范里还会配合 / <CHAR> 这类占位符，在其它字段里替换成这个名字（大小写不敏感，具体见规范）。

示例（虚构）：

林晚

description

用途：角色的描述。规范说明它通常应默认进 prompt；各前端显示的栏位名字不一样（有的叫 Description，有的界面历史原因会叫得像「Personality」），以 ST 里实际标签为准。

示例：

二十多岁的古籍修复师，说话慢、习惯先听完再开口。不擅长应付吵闹场合。

tags

用途：字符串数组，给分类、筛选用。规范明确：标签 不应 被当作 prompt 工程材料（作者不默认你会拿标签去喂模型）。

示例：

["原创", "日常", "短篇向"]

creator

用途：作者署名。

示例：

RiverStudio

character_version

用途：这张卡的版本号，方便你和下载站区分「v1.0 / v1.1」。规范里类型是字符串。

示例：

2026.04.16

creator_notes

用途：给用户看的说明，规范写明 不会 进发给模型的 prompt。适合写：推荐模型、温度、使用提示、避雷说明等。

示例：

建议新开聊天试第一句；若与你的全局 Jailbreak 冲突，请先清空卡内对应字段再试（见第 5 篇）。

---

上一章：无

下一章：（2/5）人设与说话方式：personality、mes_example

系列目录：返回文章列表 · 彻底了解 Silly Tavern 角色卡字段

---

在 Mac 上本地查看、编辑 PNG 内嵌的 JSON，可用 Sillycard。功能以 App Store 与应用内为准。