前言¶
DeepSeek Harness（DSH）強調「一切皆插件」。對於使用 dsh web 的開發者來說，本地 Harness 是否落後於 npm registry 中的新版本，常需要手動查看。duntansen/dsh-update-checker 是一個 DSH web 插件，用於在設置頁中完成版本檢查：讀取本地 dsh --version，並與 npm registry 的 latest / next dist-tags 比較，在發現新版本時提供一鍵更新入口。
這是什麼¶
這是一個由 duntansen 維護的 DSH web 插件，許可證爲 MIT。
它把原本分散在終端裏的版本檢查和更新操作集中到 DSH 設置頁中，包括：
- 檢查本地版本與 npm registry 版本
- 一鍵運行更新命令
- 查看版本時間線
- 查看最近檢查歷史
- 設置頁打開期間自動複檢並觸發瀏覽器通知
核心功能¶
版本檢查¶
插件會讀取本地 dsh --version，並與 npm registry 的 latest / next dist-tags 比較。
版本比較支持語義化版本，並能正確處理 rc 預發佈段。
一鍵更新¶
發現新版本時，可以在設置頁中點擊更新按鈕，運行：
npx -y @deepseek-ai/dsh@latest
更新過程中，頁面會展示即時安裝進度。完成後，頁面會提示重啓 dsh web。
版本時間線¶
頁面會顯示最近 8 個已發佈版本及發佈日期，並高亮當前版本。
自動複檢與通知¶
在設置頁保持打開時，插件每 6 小時自動複檢一次。
當檢測到新版本時，插件會觸發瀏覽器通知。首次觸發時，瀏覽器會請求通知權限。
檢查歷史¶
插件會將最近 10 次檢查保存到：
~/.dsh/dsh-update-checker-history.json
這些記錄也會在頁面中展示。
安裝與啓用¶
從 GitHub 安裝插件：
dsh plugin --profile web add github:duntansen/dsh-update-checker
安裝後，重啓 dsh web，打開 GUI，然後進入：
Settings → Update Check
即可使用該插件。
典型用法¶
下面介紹常見操作順序。
1、打開 Settings → Update Check。
2、頁面會顯示當前版本、最新版本、next 版本和狀態徽章。
3、如果檢測到新版本，點擊更新按鈕執行更新。
4、更新完成後，按頁面提示重啓 dsh web。
5、需要手動重新檢查時，點擊 Re-check 按鈕。
實現與運行細節¶
插件提供更新接口：
POST /dsh-update-check/update
該接口爲同源保護，並且爲單實例。
插件執行命令時跨平臺運行：
- Windows 使用
cmd.exe - POSIX 使用
/bin/sh
本地版本通過 dsh --version 讀取，npm registry 數據用於比較 latest / next dist-tags。
適用場景與注意¶
適合希望在 DSH 設置頁中快速確認本地 Harness 版本狀態的開發者。
需要注意，插件以當前 dsh 進程權限運行，並會讀取本地版本、執行更新命令。安裝前建議檢查源碼，並確認 MIT 許可證符合使用要求。
瀏覽器通知依賴瀏覽器權限；如果不想啓用通知，可以拒絕權限請求。檢查歷史會寫入：
~/.dsh/dsh-update-checker-history.json
