前言¶
在 DeepSeek Harness（DSH）裏做長期陪伴類智能體，常見做法是分散配置：角色提示詞在一處，TTS 在另一處，長期事實要麼靠模型上下文硬撐，要麼自己寫腳本落盤。QQ 或語音通話若再單獨接網關，會話、記憶和朗讀很難對齊同一條鏈路。
大肥魚（dsh-dafeiyu-dot）把角色、聲音、記憶宮殿與 QQ 收進一個配置中心，在 DSH 側欄以客戶端插件形式運行。項目由 wz20 維護，源碼 MIT 許可，當前處於公測；接口兼容性以 DSH 0.2.1-rc.3 爲驗證基線，Windows 用戶請使用插件 0.11.1 或更新版本（修正界面圖標等靜態資源路徑校驗）。社區目錄頁：skillhub.cn/plugins/wz20/dsh-dafeiyu-dot；倉庫：github.com/wz20/dsh-dafeiyu-dot（GitHub 星標 4，分類：客戶端）。DSH 生態強調「一切皆插件」；SkillHub 等目錄爲社區站點，與 DeepSeek / 幻方無官方從屬關係。
這是什麼¶
一句話定位：DeepSeek Harness 陪伴插件——可視化配置角色與「鯨魚娘模式」，支持情緒語音、本地記憶宮殿、QQ 私聊/羣 @、半雙工語音通話，以及 DSH 窗口內的記賬與陪伴掛件。
插件負責編排與配置；對話模型、語音推理、QQ 網關由使用者自行準備並接入兼容服務。
核心功能¶
下面按 README 中「能做什麼」表格歸納，均爲插件已聲明能力。
角色與模式¶
在同一會話中編輯名字、稱呼與角色提示詞，可在標準模式與鯨魚娘模式之間切換。退出鯨魚娘模式後，陪伴記憶與自動朗讀停用；掛件可繼續獨立顯示。DSH 文字會話自動朗讀、通話語音與 QQ 語音分別管理。
情緒語音¶
本地鏈路可走 VoiceStudio（引擎 ID audiocpp）經 audio.cpp 與 Breeze TTS 2；雲端可走 BreezeBlue 官方 API。兩條路線均支持同一音色的情緒表達（臺詞清洗 + 語氣判斷，情緒指令隨合成請求下發）。另提供 OpenAI 兼容 TTS，可選音色、音量與語速；非 1 倍語速時可經 FFmpeg 保音高調速。
記憶宮殿¶
長期事實帶來源保存；回覆前自動召回（當前最多 6 條、總注入不超過 3,600 字符），壓縮前補存。支持關係圖瀏覽、精讀、更正、遺忘與備份。需要把工作區記憶落到指定目錄時，可配置 memoryPalaceRoot。私聊、不同羣與不同羣成員的記憶隔離存儲。
QQ 陪伴¶
通過 NapCatQQ 等兼容 OneBot v11 正向 WebSocket 的網關接入；插件主動連接網關。配對主號私聊；羣中需逐羣啓用，且僅在真實 @ 時回覆。支持語音條、主題表情與消息摘要看板。
語音通話¶
手動開始的半雙工通話，複用當前會話、模型與記憶；可靜音、打斷、掛斷，也可展開文字輸入。識別沿用 DSH 當前語音識別配置（README 以 SenseVoice ONNX 爲參考示例）。
記賬掛件¶
在 DSH 窗口顯示賬務與陪伴掛件，支持觸點聲音；顯示與音效可獨立開關。掛件數據與部分媒體目錄沿用 DSH 數據目錄下的 .dshw-*.json、whale-roles/ 等路徑（詳見 README「本地數據與隱私」）。
技術棧概覽¶
插件通過服務接口對接外部組件，使用者配置自己的兼容實例：
| 能力 | 參考組件 |
|---|---|
| 宿主 | DeepSeek Harness、Cordis、Node.js ES Modules |
| 本地 TTS | VoiceStudio → audio.cpp → Breeze TTS 2 |
| 雲端 TTS | BreezeBlue API（默認 https://api.breeze.blue/v1，模型 breeze-tts-2） |
| NapCatQQ，OneBot v11 正向 WebSocket | |
| 記憶 | Markdown 事實、JSON 狀態與索引、本地檢索 |
詳細部署鏈路與架構圖見倉庫 README「技術棧與參考部署」「架構與流程」。
安裝與啓用¶
安裝前請自行閱讀倉庫源碼與 MIT 許可證；插件以當前 DSH 進程權限運行，API 密鑰與網關令牌經 DSH 憑據服務管理。
準備環境¶
至少需要：DSH 桌面版及已配置的對話模型；任選 BreezeBlue 官方 API、或 VoiceStudio + audio.cpp + Breeze TTS 2、或 OpenAI 兼容 TTS；使用通話時需 DSH 語音識別器；使用 QQ 時需 NapCatQQ 或兼容網關；需要變速時需 FFmpeg。
從倉庫地址安裝¶
在 DSH 插件安裝入口粘貼倉庫地址，確認安裝並啓用：
https://github.com/wz20/dsh-dafeiyu-dot
或使用命令行：
dsh plugin --profile desktop add "https://github.com/wz20/dsh-dafeiyu-dot" --ignore-scripts
安裝後從側欄「大肥魚」進入配置中心，再按下一節配置語音、記憶與可選 QQ。
本地開發可在 dsh-dafeiyu-dot 項目目錄執行（資料原文，非 git clone 指引之外的額外步驟）：
dsh plugin --profile desktop add "link:$PWD" --ignore-scripts
重啓 DSH 後從側欄打開配置中心。
典型配置步驟¶
經過上面的安裝，可按 README「配置自己的大肥魚」順序操作：
- 角色：填寫名字、稱呼和提示詞，選擇陪伴會話，開啓鯨魚娘模式。
- 語音：選擇本地或在 API 中選擇「BreezeBlue 官方 API」／「OpenAI 兼容 API」。填寫密鑰，讀取並選擇音色，檢查連接後手動試聽。
- 記憶：開啓陪伴記憶；需持久化到工作區時設置
memoryPalaceRoot。 - QQ（可選）：運行網關，啓用 OneBot v11 正向 WebSocket，保存地址與令牌，選擇會話並完成主號配對；羣回覆逐羣啓用。
- 通話與掛件（可選）：從會話頂欄或配置中心進入語音通話；按需開啓掛件與觸點音效。
BreezeBlue 路線示例：在「大肥魚 → 語音」選 API → BreezeBlue 官方 API，填寫 API Key，「保存並讀取音色」後選擇音色或 voice_id，再檢查連接與試聽。細則見倉庫 docs/setup.md。
本地數據與適用注意¶
默認運行目錄爲 $DSH_HOME/dsh-dafeiyu-dot/；未設置 DSH_HOME 時爲 ~/.dsh/dsh-dafeiyu-dot/。長期記憶默認在運行目錄 memory-palace/，備份須包含隱藏目錄 .state/。
適合誰：希望在 DSH 內一站式搭陪伴角色、要帶情緒朗讀與可審計長期記憶、並可選接 QQ 或半雙工通話的桌面用戶。注意：遠程對話模型與 TTS 會收到相應會話與臺詞；QQ 可用性依賴網關與賬號狀態；項目公測，接口以自述基線爲準；配對主號私聊複用所選會話及該會話已啓用的 DSH 工具權限，請使用可信賬號。故障恢復見 docs/recovery.md。
結尾¶
大肥魚把角色、情緒語音、記憶宮殿、QQ 與通話收進 DSH 客戶端插件的統一配置中心，適合在 Harness 裏做可延續記憶的陪伴場景。進一步瞭解能力與隱私說明見 GitHub README；安裝與目錄索引分別見 https://github.com/wz20/dsh-dafeiyu-dot 與 https://www.skillhub.cn/plugins/wz20/dsh-dafeiyu-dot。
