前言¶
在 DSH 的插件化使用方式中，開發者經常需要在 Web 界面裏確認當前運行版本：當前 dsh 是不是最新 npm 版本？如果不是，更新命令是什麼？dsh-update-notifier 解決的就是這類問題：它在側邊欄底部常駐顯示已安裝的 DSH 版本，並在 npm latest 更新時給出紅點和更新面板。下面介紹它的定位、核心能力、安裝方式和注意事項。
這是什麼¶
dsh-update-notifier 是一個社區插件，維護者是 arvin-yd，許可證爲 MIT。它不是一個官方 DeepSeek 產品，也不是官方應用商店裏的應用。
它的定位是：爲 DeepSeek Harness（dsh）提供常駐版本徽標，始終顯示當前已安裝版本；當 npm registry 中 @deepseek-ai/dsh 的 latest 版本更新時，顯示紅點並打開更新面板。
核心功能¶
插件的能力集中在版本顯示、更新檢查和更新操作上：
- 在側邊欄底部提供常駐徽標，始終顯示當前已安裝的 DSH 版本。
- 輪詢 npm registry，檢查
@deepseek-ai/dsh的latestdist-tag。 - 提供
GET /dsh-update-check端點，並帶有updateHint。 - 點擊徽標打開面板，顯示當前版本、最新版本、最近檢查時間，以及可用操作。
- 提供複製更新命令、忽略、稍後提醒等操作。
- 支持對
npx-cache安裝和全局 npm 安裝進行一鍵更新。 - 支持通過按鈕或
?force=1手動立即檢查，冷卻時間爲 2 秒。 - 不採集遙測，也不進行 npm registry 之外的第三方調用。
安裝與啓用¶
先安裝到 web profile：
dsh plugin --profile web add dsh-update-notifier
安裝後需要重啓 DSH，插件纔會生效：
dsh --profile web --port <port>
運行環境要求：
- Node.js
>=22.0.0 - 依賴
@deepseek-ai/cordis ^4.0.1
如果要移除插件，執行：
dsh plugin --profile web rm dsh-update-notifier
典型用法¶
經過上面的步驟後，可以先確認 Web 端點是否可用：
curl http://127.0.0.1:<port>/dsh-update-check
這一步用於檢查主機側是否已經提供更新檢查端點。端點會返回更新檢查相關結果，並帶有 updateHint。
隨後在瀏覽器中查看側邊欄底部徽標：
1、徽標會顯示當前已安裝的 DSH 版本。
2、如果 npm latest 版本更新，徽標會顯示紅點。
3、點擊徽標打開面板，查看當前版本、最新版本、最近檢查時間，並選擇複製更新命令、忽略或稍後提醒。
4、如果使用一鍵更新，需要在面板中完成兩次明確確認。
配置覆蓋¶
插件支持覆蓋 checkIntervalMs 和 timeoutMs 兩個配置項。可以在 $DSH_HOME/profiles/web/cordis.patch.yml 中寫入類似配置：
- id: dsh-update-notifier
config:
checkIntervalMs: 21600000
timeoutMs: 5000
數據、權限與注意¶
插件會隨 DSH 進程運行相關檢查邏輯。安裝前建議先查看 GitHub 源碼和 MIT 許可證，再決定是否啓用。
它的行爲邊界如下：
- 通過 HTTPS 讀取 npm 公共 registry 的元數據，不發送憑據。
- 不寫磁盤；瀏覽器側只把被忽略的版本信息保存在
localStorage中。 - 一鍵更新只在用戶明確兩次確認後，纔在你的用戶賬戶下執行 npm 命令。
- 對
npx-cache安裝，一鍵更新會結束當前dsh進程，讓新版本可以綁定端口。 - 對全局 npm 安裝，一鍵更新會執行相應的 npm 更新命令。
- 沒有遙測、分析或 npm registry 之外的第三方調用。
適合使用它的場景包括：經常切換 DSH 版本、使用 npm latest 更新、希望在 Web 界面中快速確認當前版本和更新狀態。需要注意的是，這是一個社區插件，安裝後需要重啓 DSH 才能生效。
兼容與驗證¶
已覈實信息中，最後驗證日期爲 2026-08-15，對照 DSH 0.1.0-rc.5 和 0.1.0-rc.6 進行了驗證。
鏈接¶
- GitHub：https://github.com/arvin-yd/dsh-update-notifier
- 插件目錄：https://www.skillhub.cn/plugins/arvin-yd/dsh-update-notifier
