数字生命卡

简介

基于女娲数字生命协议所确立的规范，任何人都可以创建一个通用的，可以被广泛应用于各类场景和生态的数字生命。数字生命卡，支持记录以下几种数据：

Base Data：数字生命最基本的，定义数字生命核心设定的数据。
Extend Data：数字生命可以平行扩展的拓展数据。

数字生命的基础属性（Base Data）

类型

是否必填

描述

meta属性

否

定义资产的基本特征，如使用协议信息、用途、创建者信息、版权信息、版本信息等。（可选，非必要属性）

soul属性

是

影响数字生命思考、决策的数字生命设定信息，简称为数字生命的“灵魂” 。

数字生命的扩展属性（Extend Data）

数字生命魅力的一部分在于其充满想象的展现和交互形式，即可使用图片、视频、3D、Live2D等各类形式代表其形象，也可以为其添加声音、或提供协议供数字生命驱动现实世界的机器人等。此部分即是用于拓展数字生命的边界。女娲实验室正在与生态开发者合作，制定数字生命应用于特定应用或特定行业领域的拓展属性。这使得数字生命资产能够在各种应用程序和各类使用场景中具有高度的通用性和适应性，确保其在不同的用例中保留其价值和实用性。目前已定义的拓展属性有：通过这样的设计，为数字生命的创建和管理，提供了一个全面且灵活的框架，允许标准化和定制。

类型

是否必填

描述

avatar

否

数字生命的形象。可以是图片、符合规范可被引擎驱动的3D模型、符合规范可被Live2D引擎驱动的文件，等各类可被展现的形象文件。

voice

否

数字生命的音色，用于指定数字生命所采用的发声音色模型，可以与DDream平台的AI 音频结合使用

other...

否

其他自定义拓展属性...

数据结构

数字生命卡支持两种文件格式：json和PNG。

两种文件格式的数据结构一致，如下：

export type CharacterBook = {
  name?: string  // 名称
  description?: string // 描述
  extensions: Record<string, any>
  entries: Array<{
    keys: Array<string>  // 关键字
    content: string  // 内容
    name?: string  // 名称
    id?: number
  }>
}

export enum NuwaExtensionVersion {
  V1 = '1.0',
}

// Nuwa 扩展公共配置基类
export interface NuwaExtensionConfigBase {
  // 为后续升级预留，当前（20240520）只有固定值为 1.0
  version: NuwaExtensionVersion
  // 指示是否禁用扩展，只有值为 true 的时候禁用，其他值忽略
  disable?: boolean
}

// 角色卡当前应用的 tts 配置 
export interface NuwaVoiceExtensionConfig extends NuwaExtensionConfigBase {
  type: string
  sex: string
  name: string
  language: string
}

// 角色卡绑定的所有 tts 列表
export interface NuwaVoicesExtensionConfig extends NuwaExtensionConfigBase {
  list: NuwaVoiceExtensionConfig[]
}

// 角色卡当前应用的 背景图 配置
export interface NuwaBackgroundExtensionConfig extends NuwaExtensionConfigBase {
  url: string
}

export enum CharacterAvatarType {
  Live2D = 'LIVE2D',
  VRM = 'VRM',
  Img = 'IMAGE',
}

// 角色卡当前应用的 形象 配置
export interface NuwaAvatarExtensionConfig extends NuwaExtensionConfigBase {
  type: CharacterAvatarType
  url: string
  name?: string
}

// 非空类型字段，默认值都是空字符串 ''，不能是 undefined 或 null
// extensions 字段，默认值是 {}，不能是 undefined 或 null，扩展时注意别删除其他平台的扩展字段
export type CharacterCardV2 = {
  spec: 'chara_card_v2' // 目前为固定值
  spec_version: '2.0' // 目前为 May 8th addition
  data: {
    // 1.0 fields
    name: string  // 名称
    description: string  // 描述
    personality: string  // 个性摘要
    scenario: string  // 情境
    first_mes: string // 首条消息
    mes_example: string // 对话示例

    // 2.0 New fields start here
    creator_notes: string  // 创作者注释
    post_history_instructions: string
    alternate_greetings: Array<string>  // 首条消息2-∞
    character_book?: CharacterBook // 世界书（暂不支持）

    // May 8th additions
    tags: Array<string>  // 标签
    creator: string  // 创作者
    character_version: string  // 数字生命版本

    // nuwa extensions
    extensions: {
      // 角色卡当前应用的 背景图 配置
      nuwa_bg?: NuwaBackgroundExtensionConfig
      
      // 角色卡当前应用的 tts 配置 
      nuwa_voice?: NuwaVoiceExtensionConfig
      // 角色卡绑定的所有 tts 列表
      nuwa_voices?: NuwaVoicesExtensionConfig 
    
      // 角色卡当前应用的 形象 配置
      nuwa_avatar?: NuwaAvatarExtensionConfig
      // 角色卡绑定的所有 形象 列表
      nuwa_avatars: {
        version: string
        list: Array<{
          url: string
          name?: string
          type: string
        }>
      }
    }
  }
}