前言¶
在 DSH 的使用中，agent 有時會向用戶提問、發起審批申請，或完成一輪任務。如果界面沒有聲音提醒，這些狀態變化容易被忽略。DSH 強調「一切皆插件」，社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。
下面介紹 dsh-sound-notify：一個 DSH web 插件，用於在 agent 提問、發起審批申請或完成一輪任務時播放提示音，並讓面板使用自定義主背景。
這是什麼¶
dsh-sound-notify 是一個 DSH web 插件。README 標題爲 dsh-sound-notify，package.json 中的包名爲 @dsharness/dsh-sound-notify，版本爲 0.1.0，許可證爲 MIT。GitHub 倉庫爲：
https://github.com/flayteas/dsh-sound-notify
它主要解決兩個問題：
1、在 agent 提問、發起審批申請或完成一輪任務時播放提示音。
2、自定義 DSH web 的主背景，包括背景色、背景圖片、全局遮罩、側邊欄遮罩與恢復默認。
核心功能¶
提示音¶
- 觸發條件：agent 提問、發起審批申請、完成一輪任務。
- 每個觸發條件可單獨設置音效、音量、重複次數與間隔。
- 音效選項：上揚、下行、叮咚、單聲、自定義音頻、靜音。
- 支持自定義音頻及本地音頻文件上傳。
背景¶
- 支持背景色。
- 支持背景圖片 URL 或本地文件上傳。
- 支持全局遮罩、側邊欄遮罩與恢復默認。
設置與路由¶
- 設置自動保存到
$DSH_HOME/settings.yaml並即時生效。 - 提供
/plugins/sound-notify/upload上傳與/plugins/sound-notify/files/*靜態文件路由。 - 本地文件經上傳路由保存後，設置中保存返回的 URL。
安裝與啓用¶
推薦安裝¶
推薦安裝方式需要 pnpm，並且需要先下載 dsharness-dsh-sound-notify-0.1.0.tgz。當前資料未提供下載地址或 pnpm 獲取方式。
先拿到 dsharness-dsh-sound-notify-0.1.0.tgz，再進入該文件所在目錄執行：
dsh plugin --profile web add .\dsharness-dsh-sound-notify-0.1.0.tgz
手動安裝¶
沒有 pnpm 時，可以按下面方式手動安裝：
1、把 @dsharness/dsh-sound-notify 整個目錄複製到：
$DSH_HOME/profiles/node_modules/@dsharness/dsh-sound-notify
2、在 $DSH_HOME/profiles/web/cordis.patch.yml 追加：
- insert:
- id: sound-notify
name: '@dsharness/dsh-sound-notify'
啓用¶
安裝後重啓 dsh web 並刷新頁面。
該插件的 package.json 中 peerDependencies 包含：
@deepseek-ai/schemastery >=3
dsh.bundle.patch 指向：
./cordis.patch.yml
典型用法¶
經過上面的安裝步驟並刷新頁面後，打開 DSH web 的：
設置 → 個性化
然後配置背景與提示音。
下面介紹幾個常見操作：
1、選擇內置音效：上揚、下行、叮咚、單聲或靜音。
2、選擇“自定義音頻”，上傳本地音頻文件。
3、配置背景色、背景圖片 URL，或上傳本地背景文件。
4、配置全局遮罩、側邊欄遮罩，或恢復默認。
改動會自動保存到 $DSH_HOME/settings.yaml，並即時生效。
本地文件經 /plugins/sound-notify/upload 上傳，存於：
$DSH_HOME/sound-notify/
設置中只保存返回的 URL。靜態文件可通過以下路由訪問：
/plugins/sound-notify/files/*
適用場景與注意¶
適合在 DSH web 中工作、希望在關鍵交互發生時獲得聲音提醒的開發者。若希望面板外觀更貼近個人使用習慣，也可以使用它的背景設置調整主背景。
注意：
1、插件以當前 dsh 進程權限運行。安裝前應檢查源碼與許可證。
2、推薦安裝方式需要 pnpm，且當前資料未提供 dsharness-dsh-sound-notify-0.1.0.tgz 下載地址。
3、手動安裝需要複製目錄，並修改 $DSH_HOME/profiles/web/cordis.patch.yml。
4、本地文件會保存到 $DSH_HOME/sound-notify/，設置中保存的是 URL。
5、許可證爲 MIT。
鏈接¶
GitHub：https://github.com/flayteas/dsh-sound-notify
當前已覈實資料未提供目錄頁 URL。若通過 DSH 社區目錄使用，社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。
