前言¶

對於使用 DeepSeek Harness（DSH）Web 端的人來說，任務完成、回合完成、任務失敗、等待批准、Agent 提問這些狀態如果錯過，需要回查界面。dsh-sounds 是一個 DSH 插件（bundle），用瀏覽器現場合成的提示音提醒這些狀態變化。相比在外部另接通知工具，它直接在 DSH 插件 bundle 中處理事件和播放聲音。

這是什麼¶

dsh-sounds 由 DNNCOVO 維護，倉庫名爲 dsh-sounds，package.json 中聲明的包名爲 harness-sounds，版本爲 0.1.0，許可證爲 MIT。

它訂閱官方服務事件，並通過獨立 SSE 端點 /harness-sounds/events 推送事件。瀏覽器端使用 EventSource 訂閱，並通過 Web Audio 振盪器合成播放提示音。

已覈實資料中說明其“獨立運行，不依賴任何其他插件”，也“不影響 DeepSeek Harness 本身”。聲音由瀏覽器現場合成，沒有音頻文件。

觸發事件與音效¶

下面是已覈實的觸發場景和對應音效。

這些提示音不是預錄音頻文件，而是瀏覽器端用 Web Audio 振盪器現場合成。

運行方式¶

已覈實資料給出如下運行鏈路：

Host (Node.js)
  jobs.onJobDone / agent/request-error / session/event
    -> SSE 廣播 /harness-sounds/events
Client (browser)
  EventSource 訂閱 -> Web Audio 合成 -> 播放

其中：

• Host 文件位於 .dsh-plugin/index.mjs，直接訂閱官方服務事件並做 SSE 推送；
• Client 文件位於 .dsh-plugin/client.js，負責 EventSource 訂閱與 Web Audio 振盪器合成。

瀏覽器自動播放策略要求先與頁面產生一次交互。資料寫明：首次 pointerdown/keydown 會解鎖 AudioContext。因此啓用後，刷新頁面並點擊頁面任意位置一次即可解鎖音頻。

安裝與啓用¶

已覈實資料未給出單條官方安裝命令，只給出安裝步驟和 package.json 配置。下面按資料中的步驟說明。

1、把本包放到 web profile 的 node_modules/，或放到任意 bundle 解析位置。

2、在 profile 的 package.json 中註冊依賴和 bundle：

{
  "dependencies": {
    "harness-sounds": "file:./node_modules/harness-sounds"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "harness-sounds"
      ]
    }
  }
}

3、重啓 dsh web。

4、刷新頁面，並點擊頁面任意位置一次，以解鎖音頻。

注意：資料中插件名稱同時出現 dsh-sounds（倉庫/README 標題）和 harness-sounds（package.json 名稱）。在上面示例的 dependencies 和 bundles 中使用的是 harness-sounds。

試聽與構建¶

資料提到可以通過 index.html / GitHub Pages 首頁試聽音效。

如果需要自行構建 client，可使用下面給出的命令：

npx esbuild .dsh-plugin/client/index.mjs --bundle --format=cjs --platform=browser --target=es2020 --outfile=.dsh-plugin/client-bundle.js
node wrap-client.mjs .dsh-plugin/client-bundle.js .dsh-plugin/client.js harness-sounds

第一條命令用 esbuild 將 client 源碼打包爲瀏覽器端的 CJS bundle；第二條命令用 wrap-client.mjs 將其包裝爲 DSH bundle 可加載的 .dsh-plugin/client.js。

適用場景與注意¶

dsh-sounds 適合希望在 DSH Web 端用輕量提示音感知任務狀態的用戶，例如：

• 任務完成後不希望頻繁切回頁面確認；
• 任務失敗或請求出錯時希望得到即時提醒；
• 等待批准或 Agent 提問時希望減少遺漏。

安裝前建議先檢查源碼與許可證。該插件會在 DSH 插件運行路徑中加載，Host 側以當前 dsh 進程權限運行，因此需要確認來源可信。已覈實資料給出的許可證爲 MIT © 2026。

結尾¶

dsh-sounds 的核心價值在於：用瀏覽器現場合成的簡短提示音，把 DSH 的任務完成、任務失敗、等待批准和 Agent 提問狀態變得更明顯，同時不引入音頻文件依賴。

• GitHub 倉庫：https://github.com/DNNCOVO/dsh-sounds
• 社區目錄頁：已覈實資料中未給出明確 URL，本文不編造鏈接。