前言¶

用 DSH 跑會話時，人的注意力經常不在窗口上：會話可能早就結束，也可能正卡在權限確認或選項彈窗上等你處理，回頭才發現已經空等了很久。這類事件最適合用聲音提醒——響一聲就知道該回來看了。

下面介紹的 dsh-sound-lab 解決的就是這個問題。它是 DSH Web GUI 的聲音工坊：爲四種對話觸發事件挑選音效、生成 AI 角色語音、上傳管理自己的音效庫，全部在設置對話框裏點選完成，不需要寫代碼；同時內置一個明日方舟安潔莉娜角色的懸浮桌寵。

這是什麼¶

dsh-sound-lab 由 miiaowuwu 維護，是一個 DSH 插件（當前版本 1.3.2，MIT 許可證）。DSH 的理念是「一切皆插件」，這個插件在 Web GUI 側做了三件事：

1、事件音效：會話結束、選項彈窗、權限請求、停止四種觸發條件，各自獨立啓用並指定音效；
2、音效庫：上傳、管理本地音頻，非內置音效可重命名，誤隱藏的內置音效可恢復；
3、AI Voice：接入阿里雲百鍊，用克隆音色把臺詞生成語音，一鍵加入音效庫。

桌面側則是一個懸浮窗：默認是安潔莉娜的精靈圖動畫桌寵，也可以切換成圓形小球。

核心功能¶

觸發事件音效¶

設置對話框提供 4 個觸發條件：會話結束 / 選項彈窗 / 權限請求 / 停止。每個觸發條件都有獨立的啓用開關和音效下拉，下拉里可選內置鈴聲（Web Audio 琶音）、無聲，或音效庫裏的指定音效。

其中選項彈窗和權限請求屬於「注意事件」：彈窗一出現就響鈴，並且優先於完成類音效——保證需要你操作的事件不會被錯過。

音量用 0–100% 的滑塊調節，試音下拉配合 ▶ 按鈕可即時預覽，另有重置按鈕。

懸浮桌寵與外觀¶

默認形態是安潔莉娜動畫桌寵（60fps 精靈圖、半速播放）：

• 待機時站立，點擊會打招呼，可拖拽移動；
• 拖到屏幕邊緣會停靠：左右停靠隱藏 40% 並旋轉 30°，頂部停靠倒掛並隱藏 80%，底部停靠不隱藏；
• 空閒 90 秒入睡；
• 會話結束時慶祝，選項彈窗與權限請求時困惑，停止與報錯時倒下。

外觀有 3 種：Whale Girl（默認）/ Pure White / Pure Black，語音名稱可自定義。不想用角色動畫的話，可切換成圓形小球：小球拖到屏幕邊緣會摺疊成半球（只顯示一個 ">" 圖標），點擊打開設置對話框。

事件切換動畫帶 150ms 半淡入過渡，避免動作之間生硬跳變。

音效庫管理¶

音效來自插件 sounds/ 目錄下的本地音頻，支持 mp3/wav/ogg/m4a/flac/opus/aac/wma/webm 格式，由 sounds.json 控制文件管理。在設置對話框裏可以：

1、選擇文件或直接拖拽上傳；
2、刪除音效，非內置音效可重命名；
3、恢復被隱藏的內置音效。

插件內置 3 個音效："hirari do～" / "Huh?" / "AWAWA!"，不可刪除或重命名——執行刪除時只是軟隱藏，隨時可恢復；隱藏狀態的音效可直接預覽、即時播放。

音頻由宿主側 /dsh-sounds-control 靜態服務提供，支持 Range/206 分塊、ETag 與流式傳輸。

AI Voice 語音生成¶

AI Voice 對話框需自備阿里雲百鍊 API Key 與克隆音色 ID。填入後輸入臺詞即可生成語音，支持自定義文件名、預覽和刪除；滿意可一鍵加入音效庫並自動註冊，之後就能在觸發條件下拉里選用。token 費用自理。

配置持久化¶

設置會雙寫持久化：一份存 localStorage，一份存宿主側 config 文件，重啓後不丟。

安裝與啓用¶

兩種安裝方式對 Desktop 用戶和 web 用戶都可用，二選一。

方式 A：Setup 安裝器¶

1、如果 dsh 還沒啓動過，先啓動一次以初始化 profile，然後退出；
2、從 GitHub Releases 下載 dsh-sound-lab-Setup-1.3.2-x64.exe，雙擊安裝；
3、安裝器會自動重啓 dsh。

安裝器會把插件部署到 $DSH_HOME/plugins/dsh-sound-lab，並通過官方 dsh plugin 命令註冊到所有已初始化 profile（web、desktop 等共享同一副本）。更新時重新下載最新的 Setup 安裝包運行即可，舊版本自動覆蓋，無需先卸載。卸載時雙擊 dsh-sound-lab-UnSetup-1.3.2-x64.exe，完成後自動重啓 dsh。

方式 B：CLI 命令¶

需要 Node.js 環境。按自己運行 dsh 的方式二選一執行。

Desktop 用戶：

npx @deepseek-ai/dsh plugin --profile desktop add dsh-sound-lab --config.minimumReleaseAge=0

web 用戶（通過 npx dsh web 運行）：

npx @deepseek-ai/dsh plugin --profile web add dsh-sound-lab --config.minimumReleaseAge=0

兩條命令都附帶 --config.minimumReleaseAge=0。安裝完成後重啓 dsh：

npx @deepseek-ai/dsh web

經過上面的步驟，重啓後看到懸浮桌寵（或小球）就說明插件已生效，點擊即可打開設置對話框。

開發場景下還有兩個便利腳本：npm run setup 自動檢測所有本地 profile 並註冊插件；npm run setup:deploy 部署到 $DSH_HOME/plugins 並讓每個 profile 指向該副本。

典型用法¶

給「會話結束」配一個提醒音：

1、點擊懸浮的桌寵或小球，打開設置對話框；
2、在觸發條件裏勾選「會話結束」的啓用開關；
3、音效下拉選「內置鈴聲」，或選音效庫裏已有的音效；
4、用試音下拉 + ▶ 預覽確認效果，再用音量滑塊調整大小。

上傳自己的音效：

1、在音效庫區域選擇文件或拖拽上傳（支持 mp3/wav/ogg/m4a/flac/opus/aac/wma/webm）；
2、非內置音效可重命名；
3、回到觸發條件下拉，選用剛上傳的音效。

生成角色語音併入庫：

1、準備好阿里雲百鍊 API Key 與克隆音色 ID；
2、打開 AI Voice 對話框，填入 Key 與音色 ID，輸入臺詞；
3、設定文件名，生成後預覽；
4、一鍵加入音效庫並自動註冊，即可在觸發條件下拉中選用。

適用場景與注意事項¶

適合的用戶：

• 經常把 DSH 會話掛在後臺，希望事件發生時有聲音提醒的人；
• 想維護自己的音效庫，或用克隆音色生成角色語音的人；
• 喜歡桌寵、想要一點桌面氛圍的用戶——不喜歡可以切小球或換外觀。

使用前注意：

1、插件以當前 dsh 進程的權限運行，安裝前建議先閱讀源碼，確認許可證（MIT）符合你的使用要求；
2、這是明日方舟安潔莉娜的同人項目，僅限個人學習娛樂，不可商用；
3、AI 語音生成需自備阿里雲百鍊 API Key 與克隆音色 ID，token 費用自理；
4、內置 3 個音效不可刪除或重命名，刪除只是軟隱藏，可隨時恢復。

結尾¶

dsh-sound-lab 把事件提醒做成了可視化點選：四種觸發條件各配各的音效，音效庫自己上傳管理，還能用克隆音色現做語音；配上桌寵，掛在後臺的會話也有了明確的存在感。如果你在用 DSH Web GUI，可以試一試。

• 社區目錄頁：https://www.skillhub.cn/plugins/miiaowuwu/dsh-sound-lab （社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係）
• GitHub：https://github.com/miiaowuwu/dsh-sound-lab