实战：拆解 Archivist Lyra Vane

角色卡字段的底层结构

SillyTavern 的角色卡本质是一个 JSON 对象，前端展示的每个字段都对应固定的键名。理解结构后，无论是手写卡还是调试导入错误都会快很多。

一张标准 V2 卡的核心字段如下：

字段	作用	常见误区
name	角色显示名，用于 {{char}} 替换	改名不会同步更新已插入的宏
description	静态人设主体，常驻上下文	写得越长占用 token 越多，不等于越好
personality	性格摘要，部分前端会单独注入	与 description 重复会浪费预算
scenario	当前场景设定，影响开场语境	留空时模型容易自行编造背景
first_mes	首条消息，决定对话基调	与 mes_example 风格不一致会露馅
mes_example	对话范例，示范语气与格式	格式标记写错会污染输出
creator_notes	给使用者的说明，不进上下文	常被误当成隐藏设定
system_prompt	覆盖或追加系统提示	与全局预设冲突时优先级需实测
post_history_instructions	注入在对话历史之后的指令	位置靠后，对近期输出影响更强
alternate_greetings	备选开场白数组	数量多不等于质量高
character_book	内嵌世界书条目	触发关键词设置不当会失效
tags	分类标签，用于检索	不影响模型行为，只影响搜索
creator / character_version	元数据	用于版本追踪，无功能作用

占位符与符号的实际行为

SillyTavern 的宏系统是角色卡能”活”起来的关键。常见符号：

• {{char}}：替换为角色名，{{user}} 替换为你的昵称。写卡时用宏，换名字才不用重写。
• {{persona}}：注入当前用户人设描述。
• {{description}}、{{personality}}、{{scenario}}：把对应字段内容插入任意位置，用于控制注入顺序。
• {{time}}、{{date}}、{{weekday}}：动态时间，适合有日程设定的角色。
• {{random:a,b,c}}：随机抽取，用于开场白变体或随机事件。
• {{// 注释}}：注释宏，内容不进上下文，方便写卡时标注。

注意 {{original}} 与 {{char}} 的区别：前者保留原文本，后者做替换。混用会导致名字重复。

世界书与触发词

character_book 是内嵌的 lorebook，条目按关键词触发注入。关键参数：

注入位置

• Before Char：插在角色定义之前，适合全局规则。
• After Char：插在角色定义之后，最常用。
• Before/After AN：靠近作者注位置，对近期输出影响更大。
• @ Depth：按对话深度插入，数值越小越靠后，权重越高。

触发逻辑

• Key：主关键词，命中才注入。
• Secondary Keys：需与主键同时命中的附加条件。
• Selective：开启后必须满足次级键。
• Constant：常驻注入，不依赖关键词，慎用，会持续占用上下文。

关键词用逗号分隔，大小写通常不敏感，但中文分词依赖精确匹配，建议把常见简称一并列出。

实战：拆解 Archivist Lyra Vane

以市场中的 Archivist Lyra Vane 为例，看各字段如何协同：

• description 定义她作为档案管理员的职业与知识边界，明确”只回答档案相关问题”。
• scenario 设定在封闭书库中，限制场景外行为。
• mes_example 用三段对话示范她引用编号、语气克制的说话方式。
• character_book 内置若干条目，关键词为档案编号与专有名词，命中时才注入细节，避免常驻膨胀。
• alternate_greetings 提供不同切入点，方便按剧情选择。

这张卡的价值在于字段分工清晰：静态人设、动态触发、格式示范各司其职，没有把全部内容塞进 description。

常见错误清单

• 把世界书内容全写进 description，导致上下文爆满。
• mes_example 使用与 first_mes 不一致的格式标记。
• 关键词过于宽泛，如”的""我”，导致条目频繁误触发。
• 忽略 post_history_instructions 与全局预设的优先级冲突。
• 用 tags 承载设定信息，实际它只影响检索。

结语

字段、宏、触发词三者构成角色卡的完整语义层。掌握它们后，调试导入问题、优化 token 占用、复刻他人卡片都会变得可控。若想在移动端或浏览器里直接测试这些字段效果，可以用 MiniTavern 的 iOS 与 Android 应用或 Chrome 扩展加载同一张卡，也可以在 MiniTavern 角色卡市场 中对照高质量卡片的字段写法，边看边改。