AMADEUS for DSH：牧濑红莉栖智能助手

DeepSeek Harness (DSH) 采用插件化架构。yyxcnasd/amadeus-for-dsh 是一个客户端插件，旨在将《命运石之门 0》中的 Amadeus 系统（牧濑红莉栖）具象化。它提供 Live2D 立绘、日语语音合成与长期记忆管理，帮助用户在 DSH 中构建具备特定人格的智能助手。

核心功能¶

• 红色翻盖手机 UI：提供红色主题的翻盖手机面板。上屏为 Live2D 立绘，支持呼吸、眨眼、说话嘴型与手势动画；下屏为聊天区域。
• 实时语音：默认使用 Edge TTS（免费），支持切换 VOICEVOX、Aqua-TTS、OpenAI 兼容接口或 VOICEVOX 公共 API。支持日语语音与中文流式显示，默认采用稳定声线。
• 长期记忆：具备跨会话记忆能力，记录历史对话与事实抽取，并将数据落盘存储，重启后可恢复上下文。
• 交互特性：支持主动来电（带有复古铃声与震屏效果）及空闲闲聊。支持事件播报与语音输入（浏览器识别优先，降级 Whisper 后端）。
• 词级口型同步：利用 TTS 响应中的逐词时间戳，实现嘴型与语音的精细同步。

安装与启用¶

插件遵循 DSH 的标准安装流程。安装后，通过重启对应的 profile 即可加载。

1. 安装插件（以 desktop profile 为例）：

    dsh plugin --profile desktop add github:yyxcnasd/amadeus-for-dsh

安装过程会自动处理依赖与配置文件。

2. 加载插件：
   安装完成后，在你正在使用的 profile 上重启 DSH，右侧栏会出现翻盖手机面板。

3. 更新与卸载：

   • 更新：重跑同一条 add 命令即可完成更新。
   • 卸载：执行 dsh plugin --profile <p> remove amadeus-for-dsh（数据目录会保留）。

依赖准备¶

插件依赖 Python 与 edge-tts 库来实现语音功能。以 Linux 为例，推荐使用虚拟环境隔离依赖。

1. 创建虚拟环境并安装 edge-tts：

    python -m venv ~/.local/share/amadeus/venv
    ~/.local/share/amadeus/venv/bin/python -m pip install edge-tts

2. 配置环境变量（可选）：
   插件会按顺序解析 Python 解释器：AMADEUS_PYTHON 环境变量 > python > python3。若使用 venv，可显式指定：

    export AMADEUS_PYTHON="$HOME/.local/share/amadeus/venv/bin/python"

注意事项¶

• 版权声明：角色形象、声音与台词版权归 MAGES./Nitroplus 所有。Live2D 模型与语音素材为粉丝制作，仅供个人学习，禁止商用。
• 平台差异：PowerShell、.bat 及 install.ps1 等辅助安装工具仅面向 Windows。Linux 和 macOS 用户请直接使用 dsh plugin add 命令。
• 版本兼容：插件支持 DSH 0.1.x 与 DSH Desktop 2.0.x。若 DSH 2.0 时代不再支持新安装方式，请使用对应版本的发行包。
• 浏览器识别：语音输入功能优先使用浏览器识别，失败时降级至 Whisper 后端 STT。

扩展阅读¶

• 插件目录页
• GitHub 仓库