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 倉庫