前言¶
使用 DeepSeek Harness(DSH)Web GUI 時,模型回覆完成後的狀態提示不一定足夠明顯。尤其當頁面失去焦點或切到其他標籤頁時,很難第一時間知道本輪迴復已經結束。
dsh-web-notification 是一個面向 DSH Web 端的小型插件,用來在模型完成回覆時顯示系統級 Web 通知。
這是什麼¶
dsh-web-notification 的核心定位是:在 DeepSeek Harness Web GUI 中,模型完成回覆時顯示系統級 Web 通知。
它面向 Web profile 使用,許可證爲 MIT。GitHub 倉庫爲:
https://github.com/2h0n/dsh-web-notification
核心功能¶
下面是已覈實的運行時行爲:
- 每次模型完成回覆時觸發系統級 Web 通知,標題爲
🐳 Model Replied,正文爲本輪用戶消息。 - 無用戶消息時,通知正文回退到會話標題。
- 啓動時及首次用戶交互時自動請求通知權限;Safari 中請求權限需要用戶手勢。
- 按輪次去重,避免同一回覆重複通知。
- 不注入可見 UI 元素。
- 多會話的回覆會各自觸發通知。
- 通知使用唯一 tag:
dsh-reply-done-<sessionId>-<turn>,並設置renotify: true。 - 構建側通過
build.mjs將src/client/index.js打包爲瀏覽器 bundle,並以__ModuleLoader__握手格式加載。
安裝與啓用¶
先安裝指定版本壓縮包到 web profile:
npx @deepseek-ai/dsh plugin --profile web add https://github.com/2h0n/dsh-web-notification/archive/refs/tags/v0.1.0.tar.gz
安裝完成後重啓 Web:
npx @deepseek-ai/dsh web
建議按下面的步驟驗證:
1、瀏覽器控制檯沒有 dsh-web-notification 相關錯誤。
2、在同一會話發送兩條消息,確認每條回覆都會觸發一次通知。
3、再次執行 npx @deepseek-ai/dsh web 後,插件仍然存在。
安裝時注意:
npx @deepseek-ai/dsh plugin --profile web add安裝該包時,會因包聲明dsh.bundle自動追加到dsh.profile.bundles。- 如果改用
pnpm add安裝,需要手動添加 bundle 條目。 - 如果安裝報
ERR_PNPM_TARBALL_INTEGRITY,可先運行pnpm install --update-checksums,再重試。
本地開發與移除¶
本地開發需要 Node.js 22.19+ 或 24+。
執行構建:
node build.mjs
lib/ 是構建輸出目錄,不應手動編輯。
安裝當前目錄:
npx @deepseek-ai/dsh plugin --profile web add "$PWD"
然後重啓 Web:
npx @deepseek-ai/dsh web
如需移除插件:
npx @deepseek-ai/dsh plugin --profile web remove dsh-web-notification
適用場景與注意¶
這個插件適合需要在 DSH Web 中離開當前頁面後,仍能收到“模型已回覆”提醒的使用者。
插件依賴瀏覽器通知能力,首次使用需要授予通知權限;Safari 中必須在用戶手勢中請求權限。由於插件會隨 DSH Web 客戶端加載,建議安裝前檢查源碼、依賴聲明與許可證;本文介紹的插件許可證爲 MIT。
GitHub 倉庫:
https://github.com/2h0n/dsh-web-notification