AMADEUS for DSH

《命运石之门 0》Amadeus —— 牧濑红莉栖（Makise Kurisu）智能助手，DeepSeek Harness 插件。

红发翻盖手机里的她：Live2D 立绘 + 日语语音 + 长期记忆 + 主动来电 + AI 聊天。

🎬 效果预览与演示

• 演示视频（B 站）：https://www.bilibili.com/video/BV1CCb16rE3Q/

🚀 安装（与生态其它插件一致，dsh plugin add）

仓库根即 npm 包（amadeus-for-dsh，声明了 dsh.bundle.patch），因此安装方式和其他 GitHub 插件完全相同：

# 安装到 desktop profile（DSH Desktop 自带 CLI 的默认 profile）
dsh plugin --profile desktop add github:yyxcnasd/amadeus-for-dsh

# 或安装到 web profile
dsh plugin --profile web add github:yyxcnasd/amadeus-for-dsh

dsh plugin add 会：

1. 用 pnpm 把包装进该 profile 的依赖（profiles\<profile>\package.json）；
2. 因为包内声明了 dsh.bundle.patch，自动把它加入该 profile 的 dsh.profile.bundles；
3. 重启 DSH 后，Amadeus 对该 profile 的所有会话自动加载（右侧栏出现翻盖手机面板）。

零命令替代：在你正在使用的 profile 上重启即可看到效果。更新：重跑同一条 add 命令即可（或 dsh plugin --profile <p> update github:…）。

老用户（v2.x 时代 install.ps1）迁移

v2.0 的 install.ps1 会把插件复制到 profiles\node_modules\amadeus-for-dsh 并在 profiles\web\cordis.patch.yml 手写加载行。新安装方式会自动清理这些旧痕迹 （幂等，原文件备份 .bak-*），避免重复加载冲突。

辅助脚本（可选）

• 在线一行命令（自动选 profile、初始化数据目录、可选 TTS 通道）：

  powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/yyxcnasd/amadeus-for-dsh/main/install-online.ps1 | iex"
  

• 本地发行包（zip）→ 解压 → 双击 Amadeus-OneClick.bat 或运行 .\install.ps1 [-Profile desktop|web] [-Channel edge|quest]

pnpm 依赖：dsh plugin 需要 pnpm 在 PATH（DSH Desktop 自带；普通安装 npm i -g pnpm 或 corepack enable）。

Edge TTS 通道需要 Python 3.9+（脚本自动 pip install edge-tts，失败可改用 VOICEVOX 公共 API 通道，无需 Python）。

⚙️ 安装位置

%DSH_HOME% 默认 C:\Users\<你>\.dsh，可用环境变量覆盖。 卸载：dsh plugin --profile <p> remove amadeus-for-dsh（保留数据目录）。

✨ 功能

• 红色翻盖手机 UI：上屏 Live2D 红莉栖（呼吸/眨眼/说话嘴型/手势），下屏聊天；暗红主题。
• 实时语音：默认 Edge TTS（免费开箱即用），可切 VOICEVOX / Aqua-TTS / OpenAI 兼容 / VOICEVOX 公共 API；默认「声线稳定」不自动切音色；按情感着色（12+ 情绪）。
• 词级口型同步：TTS 响应携带逐词时间戳，嘴型按词包络 + 音频能量双驱动。
• AI 聊天：红莉栖人格（毒舌傲娇），日语语音 + 中文流式显示；可选独立 OpenAI 兼容 API。
• 长期记忆：历史 + 事实抽取落盘，跨会话、跨重启。
• 主动来电 / 空闲闲聊：复古铃声 + 震屏，间隔可调；长时间无互动自动开口。
• 事件播报 / 语音输入：目标完成、后台任务结束（失败也会播报）等日语播报；浏览器识别优先，降级 Whisper 后端 STT。

🛠 开发

node tools/build_static.mjs   # plugin/src/* → 仓库根 host.mjs + client.mjs
node tools/build_client.mjs   # esbuild 打包 client.js（仅改 client 源码时需要）
powershell -ExecutionPolicy Bypass -File tools/make_dist.ps1   # 生成发行 zip
dsh plugin --profile desktop add link:.   # 本地开发安装（不改远程）

• 动态源（会话内热更新）：plugin/src/host.js、plugin/src/client.js、plugin/web/*。
• 路径解析：安装后 host.mjs 用 import.meta.url 定位包目录（即资源根）；运行数据在 %DSH_HOME%\amadeus；开发可用 AMADEUS_ROOT 覆盖资源根。
• 架构与迭代记录见 docs/；TTS / Live2D 调研见 research/。

📁 目录

package.json / host.mjs / client.js   # 仓库根即 npm 包（dsh plugin add 安装）
cordis.patch.yml                       # bundle 补丁层（dsh 自动纳入 profile.bundles）
install.ps1 / install-online.ps1       # 辅助安装器（内部即 dsh plugin add）
Amadeus-OneClick.bat                   # 发行包内的一键入口
plugin/src + plugin/web/               # 插件源码 + 翻盖手机面板
tools/                                 # TTS/STT python、构建脚本
assets/                                # Live2D 模型、图标、铃声
config/ persona/                       # 默认配置模板、人格提示词
docs/ research/                        # 设计文档、调研笔记

兼容性

• DSH（@deepseek-ai/dsh）0.1.1-rc.2 / DSH Desktop 2.0.x：已按新版 API 适配 （fs.writeText 签名、agent/error 事件移除等），web 与 desktop profile 均可安装。
• 旧版 DSH（2.0 时代）不再支持新安装方式时，请使用对应版本的发行包。

版权

角色形象/声音/台词归 MAGES./Nitroplus；Live2D 模型与语音素材为粉丝制作，仅供个人学习，禁止商用。