SoulLink Emotion SDK

访问官方网站 · 下载或播放仓库内演示视频 · 在 Bilibili 查看原视频

Soullink Emotion SDK 是一套面向 Live2D 数字角色、桌宠和 AI 角色的实时表演引擎。它不把角色表现简化成“收到一句话，切换一个表情”，而是维护一条连续的情绪与动作状态：情绪有强度，动作有时序，语音有口型，模型有自己的参数能力。

你可以只使用无网络的 TypeScript engine，也可以按需组合 Planner、Embedding、TTS、PIXI 渲染器、Vue 校准工具和 HTTP API。

演示视频完整展示了从消息理解到 Live2D 表演的链路：

视频文件来自本项目演示素材，模型和 Cubism Core 的授权请以各自发布方条款为准。

桌宠需要的不是一次性动画，而是持续、可打断、能适配不同模型的表现状态。Soullink Emotion 将表现拆成可组合的层：

• 情绪层决定角色当前的整体状态和自然回落。
• Idle 层提供呼吸、眨眼、注视、微动和低频姿态变化。
• Reaction 层承接消息带来的即时表情与动作。
• Speech Performance 层为说话生成头部、身体、视线和表情重音，但不抢占 LipSync 的嘴部控制权。
• ModelProfile 层把语义通道映射成具体模型的 Cubism 参数，并按模型能力自动降级。

npm install @soullink-emotion/sdk

npm install @soullink-emotion/engine

import {
  SoullinkRuntime,
  loadModelProfile,
  motionStylePresets
} from "@soullink-emotion/engine";

const { profile } = await loadModelProfile("/models/hiyori/soullink.profile.json");
const runtime = new SoullinkRuntime({
  profile,
  motionStyle: {
    ...motionStylePresets.natural,
    seed: 20260717
  }
});

runtime.sendMessage("今天辛苦了", 0);
const snapshot = runtime.update(timeSeconds, deltaSeconds);
renderer.setParameters(snapshot.live2dParams);

import {
  SpeechPerformancePlanner,
  SoullinkRuntime,
  deriveSpeechPerformanceCapabilities
} from "@soullink-emotion/engine";

const planner = new SpeechPerformancePlanner();
const performance = planner.plan({
  emotion: "happy",
  durationMs: 4200,
  intensity: 0.75,
  confidence: 0.9,
  capabilities: deriveSpeechPerformanceCapabilities(profile),
  lifecycleToken: requestId,
  seed: 20260717
});

runtime.startSpeechPerformance(performance, audioClockSeconds, "replace");

仓库包含一个可以直接运行的浏览器测试台，支持模型加载、情绪预设、VAD 控制、FACS 覆盖、动作风格、语音动作规划和参数调试。

npm install
npm run dev

打开 http://127.0.0.1:4173。不配置 AI 服务也可以使用本地规则、情绪预设、VAD、FACS 和 Idle 动作；Embedding、Planner 和 TTS 模式需要额外配置服务。

发布前完整校验：

npm run release:check

环境要求：Node.js 20.19+ 或 Node.js 22.12+，npm 10+。

感谢每一位关注、试用和反馈的开发者：

• 完整包接入指南
• 第三方集成教程：对话、语音与 JEV 动作
• 测试与发布说明
• 发布流程

• Provider 凭据只能放在可信的服务端环境，不能写入 src、VITE_*、Profile 或发布包。
• Live2D 模型、贴图和 Cubism Core 不属于本 SDK 的 Apache-2.0 授权范围，分享模型前请单独确认授权条款。
• 仓库中的演示视频仅用于说明 SDK 的表现效果；其中出现的角色模型、音乐和素材仍以原作者授权为准。

Soullink Emotion SDK 以 Apache License 2.0 发布，详见 LICENSE。