前言¶
DeepSeek Harness (DSH) 的核心 CLI 工具 @deepseek-ai/dsh 需要定期更新以獲得新功能和安全修復。手動檢查版本並升級會中斷工作流。dsh-update-notifier 插件解決了這一痛點，在 DSH Web 界面啓動時自動檢測 @deepseek-ai/dsh 的可用更新，並在發現新版本時提供明確的升級指引。
插件定位¶
這是一個聯網工具插件，由開發者 xia-sc 維護，採用 MIT 許可證。它通過交叉驗證 npm registry 與 GitHub Tags 來確認版本狀態，旨在讓 DSH 用戶的工具鏈維護更加自動化。
核心功能¶
- 自動檢測與輪詢：啓動後 1 秒進行首次檢查，之後每 6 小時輪詢一次。同時支持手動“立即檢查”。
- 版本對比：將本地
package.json#version與 npm registry（dist-tags.latest/next）進行對比，使用semver兼容規則。 - 界面反饋：
- 有更新時顯示可關閉的橫幅，關閉後會在輸入框上方顯示輕量膠囊，點擊可重新展開。
- 卡片內提供npm i -g @deepseek-ai/dsh@{latest|next}一鍵複製安裝命令。 - 錯誤處理：檢查失敗時提供重試選項。若 30 秒無結果顯示，會出現可重試的錯誤卡片。
- 主題適配：支持深色/淺色主題，顏色取自 DSH 的設計變量。
安裝與啓用¶
使用官方 CLI 命令添加插件：
dsh plugin --profile web add https://github.com/xia-sc/dsh-update-notifier
添加後需重啓 DSH Web 生效。
典型用法¶
插件啓動後，若檢測到 @deepseek-ai/dsh 有新版本，會在界面頂部顯示更新橫幅。用戶點擊橫幅中的命令即可複製安裝命令，隨後重啓 DSH Web 即可完成升級。若網絡檢查失敗，界面會提供重試入口。
技術細節與注意¶
- RPC 路由：掛載在
/api之下。 - 依賴：依賴
@deepseek-ai/cordis ^4.0.1。 - 樣式清理：插件卸載時會自動移除樣式。
- 宿主集成：插件會等待宿主自檢窗口內的檢查結果（等待時間 ≤ 2 秒），避免阻塞。
- 超時機制：如果 30 秒內未收到檢查結果，界面會顯示可重試的錯誤狀態。
總結¶
該插件通過 API 檢測 DSH 更新，解決了版本維護的痛點。對於需要頻繁更新 DSH 的開發者，這是一個實用的輔助工具。
