ghost

English GHOST — 社区版

本地、实时的 Live2D 数字人，运行在 DeepSeek Harness（DSH）上——口型由你真正听到的 VoxCPM 1.5 语音驱动。

这是 GHOST 的社区版：本地优先、Apache-2.0 的源码快照。一次使用一个参考音色；请自备有授权的 Live2D 模型、VoxCPM 1.5 权重，以及一个参考音色片段和它的转写文本。 收到 B站直播官方邀请：参与新分区「AI 应用-机器人」试播 —— 查看实测数据。

高光 · 官方认可与实测数据 · 功能 · 快速开始 · 文档 高光 官方认可与实测数据

收到 B站直播官方邀请。 2026 年 10 月，B站直播团队邀请 GHOST 维护者以 AI 虚拟主播形式，参与新上线的 「AI 应用-机器人」 分区试播。

首次公开试播（B站创作者后台，截至 2026-10-21 的 7 日统计窗口）： *以上为创作者后台自报数据，来自一次试播及 7 日统计窗口；用于展示真实使用情况，不构成性能承诺或结果保证。未包含账号、房间或联系方式。* 版本范围

本社区版包含且仅包含三个组件：Live2D 桌宠（live2d-pet/）、TTS 联动桥（tts-bridge/）与 VoxCPM 1.5 语音插件快照（voice-plugin/）。 本项目仅包含基础框架，直播同款高阶 TTS 及部分插件暂不包含在开源版中。 💼 授权与商用说明 个人使用完全免费。 商业版本/商业功能请联系作者授权；CE 不具有的功能见下表。 如有发现一模一样的套壳售卖程序，皆为盗版，请及时止损。 说明：本开源仓库（CE）的代码按 Apache-2.0 授权；上表「商业版」指作者提供的独立商业发行版、进阶功能与商业支持服务，不等同于对 CE 源码的额外限制。需要商业版功能或商业支持时，请通过作者授权渠道获取。 三个组件如何协作

两个 DSH bundle 互相独立：关掉桌宠 = 只剩 TTS；关掉联动桥 = TTS 回到原生 daemon。桌宠单独仍可待机动画、切换模型和执行 /live2d 命令。 功能 Live2D（live2d-pet/） 渲染任意有合法授权的 Live2D Cubism 4 模型：透明常驻桌面窗口，或 GUI 内覆盖层。 口型由实际送入声卡的 PCM 的 ~20ms RMS 包络驱动，并应用实测输出延迟，使嘴型与听到的声音对齐。 情绪标签 → 原生 exp3 + VAD 混合表情；另有待机动作、呼吸、说话手势。 /live2d 命令覆盖状态、开关、模型切换、窗口管理与重载；host 仅监听回环、校验模型资产路径、对停止消费的 SSE 客户端做背压保护。 TTS（voice-plugin/ + tts-bridge/） tts 工具通过本地 VoxCPM 1.5 daemon 发声：无云端调用、无账号。 一次安装一个参考音色（音频 + 转写文本）；情绪名只是事件流标签，不切换音色。 逐句流式生成与播放；工具在播放结束前返回，并给出帧流水账（early、remainingMs、帧数），让 agent 在播放时继续工作。 支持取消、卸载、daemon 缓存；修改配置后下一次调用生效，无需重启应用。 开启联动桥时 shim 原样代理真实 daemon 并 tee 包络/情绪/延迟；关闭后恢复原生 TTS。 环境要求 Windows 10/11 + PowerShell 7（pwsh）；安装器与窗口启动器是 Windows 优先，插件代码本身可移植。 Node.js ≥ 20（含 npm/npx），并且 esbuild 可解析（安装在 live2d-pet/packages/plugin 上层的 node_modules，或设置 ESBUILD_MAIN）。 Python 3.10+ 运行 TTS 引擎；推荐 CUDA GPU（VoxCPM 1.5 在 CUDA 上运行）。语音克隆需要一个参考音色片段 + 同名转写文本。 DeepSeek Harness 桌面版或 dev 实例（DSH_HOME），因为这些是 DSH profile bundle / 插件行。 自备有授权的 Live2D Cubism 4 模型、VoxCPM 1.5 权重、参考音色（一个音频片段 + 转写文本）；仓库不附带。 独立窗口额外需要：在 live2d-pet/tools/live2d-window 里 npm install（下载 Electron，约 250MB，不入库）。 快速开始

安装器会在 profile 中创建 node_modules/@local/... junction、把两个 bundle 追加到 dsh.profile.bundles、渲染桥 patch 的占位符（ 、 、 、 、 ）、写入 TTS shim 旁路配置，并把工作区 tts.config.yml 指向 shim。运行中的桌面 profile 通过 HMR 重组合；若没有生效再重启应用。

然后用 tts 工具说一句话，角色嘴型会跟随音频。/live2d status、/live2d on|off、/live2d model 、/live2d window 可在 GUI 命令面板使用。