前言¶
用 DSH Web UI 跑智能體時，回合往往在後臺結束，或 Agent 通過 ask_user_question、審批流程等你輸入。若一直盯着界面，容易錯過；切到別的標籤頁時更明顯。瀏覽器通知可以補一部分，但需要額外權限，且和「這一回合剛跑完」的語義並不一一對應。下面介紹客戶端插件 dsh-finish-sound：在回合結束、以及 Agent 向你提問兩類事件上播放短提示音，並在設置裏統一開關、調音量與試聽。
這是什麼¶
dsh-finish-sound 是面向 DSH Web UI 的客戶端插件，維護者爲 mkpoli。它在兩類事件上播放不同的短 cue：任意會話裏某一回合結束、以及 Agent 發起提問或審批等待你操作時。插件自帶由 MOSS-SoundEffect-v2.0（Apache-2.0）生成的 WAV，可離線播放；也可在本瀏覽器內替換爲自定義音頻。社區目錄頁：https://www.skillhub.cn/plugins/mkpoli/dsh-finish-sound；源碼與說明：https://github.com/mkpoli/dsh-finish-sound。
核心功能¶
兩種事件、兩種音色¶
| 事件 | 說明 | 內置文件 |
|---|---|---|
| 回合結束 | 任意會話中回合結束都會觸發，不限於當前前臺標籤；連續排隊的多回合只在全部結束時響一次 | assets/finish.wav（兩顆明亮馬林巴音，相隔一步） |
| Agent 提問 | ask_user_question 或審批開始等待你時 |
assets/question.wav（兩顆更快、更高、更柔的馬林巴上行音） |
若同一快照既結束回合又進入提問等待，只播放提問 cue。各 clip 的 prompt 與 seed 見倉庫 lib/sounds.js 中的 CLIP_PROVENANCE。
設置入口¶
Settings → General → Event sounds 在本瀏覽器內統一控制兩種 cue 的開關、音量，並可分別試聽。Composer 側提供靜音相關能力（與簡介中的 composer mute 一致，具體 UI 以 Web 設置頁爲準）。
自定義音頻¶
每種 cue 可換成瀏覽器能解碼的音頻文件（WAV、MP3、OGG 等），大小不超過 2 MB、時長不超過 10 秒；文件保存在本瀏覽器 IndexedDB。選擇 Use built-in 可恢復插件內置 clip。
安裝與啓用¶
通過 DSH 插件管理器（Plugins → Add plugin）填寫：
github:mkpoli/dsh-finish-sound
或在命令行爲 web profile 添加並寫入 bundle：
dsh plugin --profile web add github:mkpoli/dsh-finish-sound
隨後在 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 中加入 "dsh-finish-sound"，並重啓 dsh web。包內帶有 cordis.patch.yml 注入 loader；瀏覽器端通過包的 dsh.client 聲明加載。
Release 附帶的預構建包：
dsh plugin --profile web add https://github.com/mkpoli/dsh-finish-sound/releases/latest/download/dsh-finish-sound.tgz
本地目錄可用 link:/path/to/dsh-finish-sound，用法與上述 spec 相同。
典型用法與行爲注意¶
- 安裝並重啓
dsh web後，打開 Settings → General → Event sounds，打開事件音、調節音量並試聽兩種 cue。 - 在後臺會話跑完一輪，應聽到結束音；Agent 彈出提問或審批等待時，應聽到提問音（與結束音不同）。
- 瀏覽器在未發生用戶手勢前會鎖定音頻：若 cue 觸發過早，會在你下一次點擊或按鍵時播放，除非新回合已開始。
- 需要個性化時，在設置裏爲對應事件上傳短音頻；不滿意時用 Use built-in 還原。
適用場景與安裝前注意¶
適合長時間用 DSH Web UI、多標籤或多會話並行、又不想依賴系統通知的場景。插件屬於 DSH 生態中的客戶端類擴展；目錄站點 skillhub.cn 爲社區索引，與 DeepSeek / 幻方無官方從屬關係。
安裝前建議瀏覽 GitHub 源碼與 MIT 許可證（內置 clip 爲 Apache-2.0 模型輸出）。插件隨當前 DSH Web 進程與瀏覽器環境運行，自定義音頻僅存本機 IndexedDB；敏感環境請自行評估後再啓用。
結尾¶
dsh-finish-sound 用兩種短 cue 區分「回合結束」與「Agent 在等你」，設置集中、可離線、可換音。需要安裝 spec 與行爲細節時，以 README 爲準：
