前言¶
DSH 的理念是「一切皆插件」。社區目錄是獨立站點,與 DeepSeek / 幻方無官方從屬關係。
如果使用 DSH web profile,需要確認 AI 是否已經完成回覆時,可以用一個提示音作爲反饋。dsh-notify-sound 在回合結束時播放內置提示音,並支持在 DSH 設置頁中更換音效、調整音量與開關。下面介紹它的功能、安裝與使用方式。
這是什麼¶
dsh-notify-sound 是一個 DSH web 插件,由 xxxxxxxyu 維護。
它監聽 turn/end(回合結束)事件,並通過 WebSocket 即時推送通知;前端收到通知後播放所選音效。插件代碼採用 MIT License。
核心功能¶
回覆完成提示¶
- AI 回覆完畢後自動播放提示音
- 監聽
turn/end(回合結束),並通過 WebSocket 即時推送,零輪詢 - 默認音效爲
staplebops-01.aac - 音效文件內置在插件中,無需聯網
設置項¶
- 內置 44 個音效,可在設置頁下拉選擇
- 設置頁支持開/關、音效選擇、音量調節和試聽
- 設置即時保存,重啓後保留
- 設置存儲在 DSH 設置服務,且全局生效
安裝與啓用¶
先確認運行要求:
- DSH web profile(
dsh web) - Node.js >= 20
從 GitHub 安裝¶
下面命令中的 <you> 按原文保留爲佔位符:
dsh plugin --profile web add git+https://github.com/<you>/dsh-notify-sound.git
安裝後確認包已加入配置項:
dsh.profile.bundles
然後重啓 dsh 服務生效。
本地開發安裝¶
先在 web profile 目錄中安裝本地包:
cd C:/Users/<you>/.dsh/profiles/web
pnpm add file:/path/to/dsh-notify-sound
如需開發構建,執行:
npm install
npm run build
構建產出:
lib/index.js
lib/client.js
典型用法¶
打開 DSH 設置頁,左側導航出現“提示音”。
可操作項如下:
| 設置項 | 說明 |
|---|---|
| 回覆完成提示音 | 開關 |
| 提示音 | 下拉選擇內置音效,共 44 個 |
| 試聽 | 播放當前選中的音效 |
| 音量 | 0 ~ 100% 滑塊 |
配置與接口¶
偏好存儲在 DSH 設置服務中,namespace 爲:
dsh-notify-sound
插件提供以下偏好 API:
/notify-sound/api/sounds.list
/notify-sound/api/prefs.get
/notify-sound/api/prefs.update
所有路由經過與 /api 網關相同的瀏覽器信任圍欄(loopback / 同源校驗)。
依賴與許可證¶
依賴方面,package.json 中聲明的 peerDependencies 包括:
@deepseek-ai/cordis ^4.0.1
react
react-dom
其中 react 與 react-dom 爲可選。
package.json 中聲明的配置項爲:
dsh.bundle.patch
值爲:
./cordis.patch.yml
許可證方面,插件代碼採用 MIT License。內置音效來自 Stephanvs/opencode-sfx,音效爲 MIT 許可,版權歸其作者。
適用場景與注意¶
適合使用 DSH web profile,並希望以聲音確認 AI 回覆完成的開發者或使用者。
插件以當前 dsh 進程權限運行,安裝前應檢查源碼與許可證。
設置全局生效;音效內置且無需聯網,適合不想依賴外部音頻資源的場景。
結尾¶
dsh-notify-sound 提供了“回覆完成提示音”的完整鏈路:安裝、設置頁配置、設置保存和重啓保留。如果只需要一個輕量的完成提示,可以先按上面的步驟安裝並試聽。
插件目錄頁:https://www.skillhub.cn/plugins/xxxxxxxyu/dsh-notify-sound
GitHub:https://github.com/xxxxxxxyu/dsh-notify-sound