CharaStudio 角色卡结构

CharaStudio 使用扩展版 JSON 格式存储角色数据。基本结构如下：

{
  "name": "角色名称",
  "description": "角色描述（用于 AI 理解）",
  "personality": "性格标签",
  "first_mes": "开场白",
  "avatar": "Base64 编码的头像图片或 URL",
  "chat_example": "对话示例",
  "chara_version": "1.2",
  "spec_version": "CharaStudio-v1"
}

扩展字段

CharaStudio 在标准 TavernAI 格式基础上添加了以下扩展字段：

{
  "chara_version": "1.2",
  "spec_version": "CharaStudio-v1",
  "world_setting": {
    "default_world": "默认世界观名称",
    "allowed_scenes": ["场景1", "场景2"]
  },
  "emotion_config": {
    "emotion_nodes": ["喜悦", "愤怒", "悲伤", "恐惧"],
    "default_emotion": "neutral"
  },
  "generation_params": {
    "temperature": 0.8,
    "max_tokens": 512,
    "top_p": 0.9
  }
}

字段说明

description

最重要的字段。此字段直接发送给 AI 模型，用于理解角色的完整设定。建议包含以下内容：

• 角色外貌描述
• 性格特点
• 说话风格
• 与世界观的关系
• 关系网络

personality

逗号分隔的性格标签列表，例如：

冷静, 内向, 忠诚, 观察敏锐, 略显孤高

first_mes

对话开始时角色的第一句话。这句话应满足：

• 与角色性格相符
• 激发用户的互动兴趣
• 不包含故事剧透

chat_example

对话示例（通常 2-3 对），用于帮助 AI 学习角色的说话风格：

{{user}}: 你是谁？
{{char}}: 我是...(角色的回应)
{{user}}: 说说你的过去吧。
{{char}}: ...

导出格式对比