vsoul 中文文档 下载 App

JSON角色卡格式 —— 纯文本配置,方便精细调整

JSON角色卡是什么

JSON角色卡是把角色设定写成一段JSON格式的文本。和PNG角色卡不同,它不携带图片,只携带文字设定。用任何文本编辑器(记事本、VS Code等)都能打开和修改。

JSON角色卡适合什么场景

导入步骤

  1. 把JSON文件保存到手机
  2. 进入创意工坊,点击"导入角色卡"
  3. 选择JSON文件
  4. 等待解析完成,检查角色设定
  5. 确认后开始互动

JSON角色卡的基本结构

微灵的JSON角色卡包含四个核心字段,对应灵魂档案的四层结构:

{
  "name": "角色名字",
  "identity": "身份底稿——姓名、经历、能力、限制",
  "relationship": "关系坐标——如何认识、信任程度、共同事件",
  "world": "世界背景——时间、地点、规则",
  "expression": "表达纹理——语气、用词、节奏、叙事视角",
  "opening": "开场事件——地点、当前事件、等待回应的问题"
}

实际字段可能更多(比如模型参数、预设配置等),但以上六个是最核心的。

编辑JSON角色卡的注意事项

JSON和PNG的关系

两种格式可以互相转换。你可以把微灵中创建好的角色导出为JSON,用编辑器修改后再导入。也可以把PNG角色卡的数据提取出来转成JSON格式,方便编辑。

最终选择哪种格式取决于你的需求:想分享带图片的完整角色用PNG,想精细调整设定用JSON。