前言¶
在 DeepSeek Harness（DSH）裏跑智能體時，一輪任務往往要幾分鐘甚至更久。人通常會切到別的窗口，等模型跑完或需要你點批准、回答問題時再回來看。沒有 audible 反饋時，只能反覆切回 DSH 確認狀態。dsh-sound-cue 是 ITISlemon 維護的客戶端插件：在對話框底部提供音效設置入口，在一輪結束、或出現需要你操作的內容時播放不同提示音，便於「離開屏幕、聽聲回來」。
下面介紹它的定位、能力與安裝方式。安裝命令與行爲說明均來自插件倉庫 README；社區目錄頁爲 skillhub.cn 上的 dsh-sound-cue，與 DeepSeek / 幻方無官方從屬關係，DSH 生態本身是「一切皆插件」的擴展方式。
這是什麼¶
dsh-sound-cue（倉庫 ITISlemon/dsh-sound-cue）面向 DSH Web UI：在對話 composer 下方掛載一個小鈴鐺 chip，點擊後彈出浮動設置面板，用來開關總開關、選擇完成音與「需要你注意」的提醒音、調節音量並試聽。設置持久化在瀏覽器側，鍵名爲 dsh-sound-cue:settings。許可證爲 MIT。
核心功能¶
插件區分兩類音效，互不混用：
- completion（完成）：每一輪對話結束時播放一次，可選內置 preset 或自定義音頻。
- attention（注意）：當有待你處理的內容（批准、提問、計劃審閱等）時播放；默認是三音階固定提示（批准偏低、提問偏高），也可換成內置 tone 或自定義文件，便於不看屏幕也能區分「跑完了」和「在等你」。
入口與面板：
- 鈴鐺 chip 掛在 composer 底部（slot：
conversation.composer.dock/sound-cue，order 20）。 - 點擊 chip 在上方打開浮動面板（由 frame 級 overlay 渲染，對話佈局不會因此被頂開）。面板內有總開關、Keep listening on other pages（始終監聽）、attention 開關、兩套音色選擇、音量、完成音與 attention 試聽。點擊面板外或按 Escape 關閉；視口高度不足時面板可滾動，滾動條常顯。
始終監聽：開啓 Keep listening on other pages 後，音效由客戶端全局 session 狀態（running、pendingInteraction）驅動，在設置頁、插件市場或其它面板打開時仍會響；此模式下 composer 上的 chip 不再單獨觸發完成音，避免同一輪響兩次。對應無 UI 的常駐監聽掛在 shell.overlay / sound-cue:resident（order 40），設置面板爲 shell.overlay / sound-cue:popover（order 41）。
內置 tone：chime、bell、marimba、pop、ding，用 WebAudio 合成，包內不附帶音頻資源。
自定義音頻：可爲 completion 與 attention 分別選擇任意 audio/* 文件，以 data URL 存入本瀏覽器 localStorage，單文件上限 3 MB。
面板開關一覽：總開關、始終監聽、attention 提醒；兩套音色選擇；音量；兩種試聽。
安裝與啓用¶
安裝目標爲某個 DSH profile：桌面應用常用 desktop，Web CLI 常用 web。以下命令與 README 一致（標籤 v1.3.1）。
DSH 安裝前會用 git ls-remote 檢查 GitHub，因此需要本機已安裝 Git：
dsh plugin --profile desktop add github:ITISlemon/dsh-sound-cue#v1.3.1
若無 Git，可改用 release 壓縮包，跳過 Git 檢查：
dsh plugin --profile desktop add https://github.com/ITISlemon/dsh-sound-cue/archive/refs/tags/v1.3.1.tar.gz
桌面應用也可在 Settings → Plugins 裏用相同 spec 安裝。安裝完成後打開任意對話，composer 下方會出現鈴鐺 chip，即表示客戶端腳本已注入（package.json 中 dsh.client.platform 爲 web，immediately: true）。
典型用法¶
- 安裝插件並進入對話，點擊 composer 下方的鈴鐺 chip。
- 打開總開關，在面板裏爲 completion 選內置 tone 或上傳本地音頻，用預覽確認音量。
- 需要區分「跑完」和「在等你」時，打開 attention alert，爲 attention 單獨選音或保留默認三音階提示，並試聽 attention 預覽。
- 經常在設置或其它頁面停留、仍希望聽到狀態變化時，開啓 Keep listening on other pages。
- 設置會自動寫入
dsh-sound-cue:settings；換瀏覽器或清空站點數據後需重新配置自定義文件。
適用場景與注意¶
適合長時間讓 DSH 智能體在後臺跑任務、又希望用聲音感知「一輪結束」或「需要點批准 / 答問題」的開發者。attention 與 completion 分離，比單一提示音更容易建立肌肉記憶。
使用前請注意：
- 插件在當前 DSH 客戶端 / 瀏覽器環境中運行，自定義音頻只存在本機
localStorage，不跨設備同步。 - 安裝前建議瀏覽 GitHub 源碼 與 LICENSE（MIT），確認符合你的安全與合規要求；插件以當前 dsh 進程及瀏覽器權限運行，上傳的音頻僅保存在本地。
- README 中的安裝示例 pinned 爲
v1.3.1；倉庫package.json當前版本字段爲1.4.0，若需更新版本請以 release 標籤與官方文檔爲準，勿自行拼接未在文檔出現的 install spec。
開發方面：包爲純 ESM，無構建步驟；本地可將 profile 下的 node_modules/dsh-sound-cue 鏈到倉庫目錄，改 client.js 後無需重裝。冒煙測試：node dev/smoke.test.mjs（Node.js 20+）。
結尾¶
dsh-sound-cue 用兩種可配置的提示音，把「一輪跑完」和「需要你操作」從視覺上解放出來，適合配合 DSH 長時間 agent 會話使用。更多信息見 社區目錄頁 與 GitHub 倉庫。
