前言¶
用 DSH 跑任務時,典型的工作方式是把活兒交給智能體,自己切去處理別的事。麻煩在於你不知道什麼時候該回來:任務可能在等你審批,也可能早就跑完了。於是只能反覆切回頁面確認進度,注意力被切碎,切回來還未必有新進展。
dsh-notification-sounds 用兩個聲音解決這個問題:AI 需要你操作時播放「任務等待」,主會話及其全部子代理穩定完成後播放「任務完成」。聽到聲音再回來即可。下面介紹這個插件的定位、功能與完整的安裝啓用步驟。
這是什麼¶
dsh-notification-sounds 是一個面向 DeepSeek Harness Web UI 的聲音通知插件,由 qq33357486 維護,許可證爲 MIT。官方一句話描述是「跨平臺的等待用戶與完成聲音通知」。社區目錄頁將其歸入「客戶端」分類。
它只做提醒這一件事,觸發時機有兩個:
| 時機 | 聲音 |
|---|---|
| AI 需要用戶操作:需要審批、確認、計劃審覈或回答問題 | 「任務等待」 |
| 一個主會話及其全部子代理穩定完成 | 「任務完成」 |
有兩點容易誤解,README 中專門做了說明:
1、子代理單獨完成不會響。只有所屬主會話及其全部子代理都穩定完成,才播放「任務完成」。
2、多個主會話彼此獨立,各自觸發各自的「任務完成」。
核心功能¶
設置頁面¶
插件在 DSH Web UI 中註冊了 Settings → General → DSH Notification Sounds 設置頁。進入後可以打開通知,並試聽「任務等待」和「任務完成」兩個聲音。首次進入頁面後需要點擊或按鍵一次,以解鎖瀏覽器音頻,之後聲音提醒才能正常播放。
面向 web 平臺¶
插件通過 package.json 中的 dsh.client 配置聲明自己面向 web 平臺:
{
"dsh": {
"client": {
"platform": "web"
}
}
}
對應的安裝與更新命令均使用 web Profile。
安裝與啓用¶
先確認環境:插件 package.json 中標註的版本爲 0.1.2,engines 要求 node ^22.19.0 || >=24。
1、執行安裝命令:
dsh plugin --profile web add dsh-notification-sounds
2、重啓現有的 DSH Web 進程。注意不要啓動第二個 Web 服務,插件需要重啓現有進程才能生效。
3、重啓後進入 Settings → General → DSH Notification Sounds,打開通知並試聽兩個聲音。首次進入頁面後點擊或按鍵一次,解鎖瀏覽器音頻。
經過上面的步驟,插件即可工作。如果想確認 DSH 是否正確加載了插件,執行:
dsh --profile web --dump-config
在輸出中檢查存在 id: notification-sounds 和 name: dsh-notification-sounds 兩項,存在即說明插件已被識別。
更新¶
已安裝的插件用下面的命令更新:
dsh plugin --profile web up dsh-notification-sounds
典型用法:讓 AI 幫你安裝¶
README 提供了一段提示詞,複製給 AI 即可讓它代辦安裝與配置:
請安裝並配置 dsh-notification-sounds:
1. 檢查 dsh 是否可用,默認使用 web Profile。
2. 執行 dsh plugin --profile web add dsh-notification-sounds;如果已安裝則執行 dsh plugin --profile web up dsh-notification-sounds。
3. 用 dsh --profile web --dump-config 驗證存在 id: notification-sounds 和 name: dsh-notification-sounds。
4. 不要啓動第二個 Web 服務;提醒我重啓現有的 dsh web。
5. 告訴我進入 Settings → General → DSH Notification Sounds,打開通知、試聽「任務等待」和「任務完成」,並點擊或按鍵一次解鎖音頻。
6. 最後彙報安裝版本和驗證結果,不要修改 DSH 官方源碼。
這段提示詞把安裝、重啓、驗證、設置頁操作和注意事項都列全了,與自己手動操作是同一套流程。
適用場景與注意事項¶
適合在 DSH Web UI 裏跑長任務、經常切走做別的事的人;如果同時開多個主會話,每個會話獨立觸發完成提醒,能省去來回查看的動作。
安裝與使用前有幾點需要留意:
1、插件會以當前 dsh 進程的權限運行。安裝前建議先到倉庫查看源碼與許可證(MIT),確認可以接受再裝。
2、DSH 的理念是「一切皆插件」,但社區維護的插件目錄是獨立站點,與 DeepSeek / 幻方沒有官方從屬關係,選擇插件時自行把關。
3、不要啓動第二個 Web 服務;需重啓現有的 dsh web 進程,插件纔會生效。
4、「任務完成」的觸發條件是主會話及其全部子代理穩定完成,子代理單獨完成不會響。
結尾¶
dsh-notification-sounds 解決的是一個很具體的問題:讓 AI 安靜工作,該回來時用聲音叫你。一條命令安裝,重啓進程後到設置頁打開通知、試聽兩個聲音即可用上。
- GitHub 倉庫:https://github.com/qq33357486/dsh-notification-sounds
- 社區插件目錄頁:https://www.skillhub.cn/plugins/qq33357486/dsh-notification-sounds