FEAIA 开发文档 FEAIA Developer Documentation FEAIA開発者ドキュメント

MySkin.skinpack/
├── manifest.json        # 必须：元数据和声明
├── preview.png          # 必须：封面图 (512×512)
├── preview_anim.gif     # 可选：动态预览 (300×300)
├── assets/
│   ├── model/           # VRM: model.vrm  /  Live2D: model.model3.json + textures/
│   ├── emotions/        # 情感动作覆盖（可选）
│   │   ├── happy.json
│   │   ├── sad.json
│   │   └── ...
│   ├── audio/           # 语音包（可选）
│   │   └── greet_zh.wav
│   └── shaders/         # 自定义 URP Shader（可选）
└── README.md            # 可选：说明文档

{
  "skinpack_version": "2.1",
  "id": "com.yourname.myskin",
  "name": "My Skin Name",
  "version": "1.0.0",
  "author": "Your Name",
  "author_url": "https://example.com",
  "license": "CC-BY-NC-4.0",
  "type": "vrm",               // "vrm" | "live2d" | "pixel"
  "model_path": "assets/model/model.vrm",
  "thumbnail": "preview.png",
  "preview_anim": "preview_anim.gif",
  "feaia_min_version": "0.9.0",
  "tags": ["fantasy", "female", "3d"],
  "emotion_pack": true,        // 是否包含自定义情感动作
  "audio_pack": false,         // 是否包含语音包
  "description": {
    "zh": "中文简介",
    "en": "English description",
    "ja": "日本語説明"
  }
}

// assets/emotions/happy.json
{
  "emotion": "happy",
  "blendshapes": {
    "Joy": 0.8,
    "A": 0.3,
    "Blink_L": 0.1,
    "Blink_R": 0.1
  },
  "animation_clip": "Anim_Happy_Loop",
  "transition_duration_ms": 300,
  "loop": true,
  "idle_variation": true,     // 是否在循环中加入随机小动作
  "particle_preset": "hearts" // 可选：粒子特效 hearts|stars|sparkle|null
}

assets/model/
├── model.model3.json       # 主配置文件
├── textures/
│   ├── texture_00.png
│   └── texture_01.png
├── model.moc3             # 模型数据
├── motions/
│   ├── happy.motion3.json
│   └── idle.motion3.json
└── physics.physics3.json  # 物理设置

# 安装 SkinPack CLI
pip install feaia-skinpack-cli

# 验证目录结构
feaia-skinpack validate ./MySkin/

# 打包为 .skinpack
feaia-skinpack pack ./MySkin/ --output ./dist/MySkin.skinpack

# 预览（需要 FEAIA 客户端运行中）
feaia-skinpack preview ./dist/MySkin.skinpack

# 上传到社区（需要登录）
feaia-skinpack publish ./dist/MySkin.skinpack --token YOUR_TOKEN

// FSM 转换权重配置 (config.json)
"fsm": {
  "transition_ms": 300,        // 状态过渡时间
  "priority": {
    "react": 10,               // 最高：音乐/事件触发
    "surprise": 9,
    "angry": 8,
    "happy": 5,
    "sad": 5,
    "think": 7,                // AI 生成中
    "neutral": 0               // 最低：默认回归
  },
  "auto_return_idle_ms": 15000, // 15s 无交互回归待机
  "affection_influence": 0.3   // 好感度对情绪偏移的影响权重
}

{
  "version": "0.9",
  "window": {
    "opacity": 1.0,            // 0.0–1.0
    "scale": 1.0,              // 0.5–2.0
    "always_on_top": true,
    "click_through": false,    // 是否穿透点击
    "position": { "x": 1600, "y": 800 }
  },
  "skin": {
    "active": "com.vpro.sakura",
    "auto_detect_type": true   // 自动识别 VRM/Live2D
  },
  "ai": {
    "provider": "ollama",
    "base_url": "http://127.0.0.1:11434",
    "model": "qwen2.5:7b",
    "context_length": 4096,
    "temperature": 0.8,
    "system_prompt_path": "persona/default.txt",
    "memory_enabled": true,
    "memory_max_entries": 500
  },
  "emotion": {
    "enabled": true,
    "auto_infer": true,        // AI 自动推断情感
    "intensity_scale": 1.0
  },
  "music": {
    "enabled": true,
    "bpm_sync": true,
    "lyric_emotion": true      // 歌词情感联动
  },
  "affection": {
    "enabled": true,
    "initial_value": 50,       // 0–100
    "decay_per_hour": 0.5
  },
  "ipc": {
    "enabled": true,
    "pipe_name": "feaia_ipc_v1"
  },
  "performance": {
    "target_fps": 60,          // 30 / 60 / 120
    "idle_fps": 15,            // 后台降帧
    "gpu_instancing": true
  }
}