前言¶
DeepSeek Harness（DSH）的 Web profile 環境下，版本更新通常需要手動查閱發佈記錄。dsh-update-status 插件通過讀取 npm 的發佈信息，在 DSH 的側邊欄中提供版本狀態展示、升級命令生成以及受控重啓能力。
這是一個由 idoall 維護的 MIT 協議插件，專注於提供只讀的狀態查詢與操作指引，不改變 DSH 核心行爲。
插件簡介¶
idoall/dsh-update-status 是一個只讀的 DeepSeek Harness Web 版本狀態與發佈渠道指引插件。它通過在側邊欄嵌入版本徽章，讓用戶在零配置的情況下掌握當前運行狀態。
核心功能¶
版本狀態與視覺反饋¶
插件在展開的側邊欄中顯示運行版本。狀態通過顏色和動畫區分：
* 綠色圓點：運行版本已是 npm 最新發布。
* 灰色脈衝：正在檢查版本狀態。
* 呼吸的琥珀色光環：存在更新（包括 stable、release candidate 或 alpha）。
* 紅色徽章：版本檢查失敗。
主題與交互¶
- 主題跟隨：支持淺色、深色或系統模式，自動適配 DSH 的界面設置。界面採用中性色芯片，確保在深色模式下清晰可見。
- 移動端適配：使用瀏覽器頂層模態框，確保滾動面板在 DSH 抽屜之上。
- 無干擾更新：有更新時不會重繪整個側邊欄，僅改變徽章狀態，避免打斷用戶操作。
發佈版本邏輯¶
- 單一發佈線：只讀取 npm 最新發布的版本，不做額外配置。
- 誠實對比：使用 SemVer 排序，確保
0.2.1-alpha.1優先於0.2.0-rc.2，預發佈版本排序正確。 - 兼容性標籤：插件驗證過的版本標記爲 verified，未驗證的新版本僅作爲提示，不會改變側邊欄外觀。
升級與緩存¶
- 複製式指引：生成精確到具體版本的安裝命令，不會運行該命令。
- 緩存策略：使用宿主檢查代替輪詢，支持配置緩存時長，僅在點擊“檢查更新”時繞過緩存。
安裝與啓用¶
該插件依賴 DeepSeek Harness 的 Web profile。安裝命令如下：
dsh plugin --profile web add dsh-update-status@latest
安裝完成後，刷新 Web GUI 即可生效。
典型用法¶
- 打開 DSH 側邊欄抽屜。官方圖標保持不變，名稱行顯示
DeepSeek加上當前版本徽章。 - 點擊徽章。更新面板打開，不會觸發父級“新建會話”的操作。
- 查看運行版本。如果已是最新發布，面板會提示“已是最新”。
- 查看更新信息。當存在新版本時，面板顯示版本名稱、發佈日期以及插件是否已驗證該版本。
- 複製生成的命令。該命令固定在確切版本，在主機終端執行。
- 重啓。面板的 Restart 控件僅在完成“受控重啓”設置後出現。
注意事項¶
- 只讀操作：該插件不修改 DSH 核心、安裝或升級 DSH、回滾包、下載發佈版或替換文件。
- 受控重啓限制：Restart 控件僅在顯式安裝了受控用戶級服務後可用。插件會請求安全重啓，但前提是存在相應的服務監管。
- 安裝要求：需要 Node.js 20 或更高版本，且需運行在已驗證的 DSH 發佈版本上。
結語¶
dsh-update-status 提供了一種低侵入式的版本管理方式。對於需要在多環境部署或頻繁關注版本迭代的開發者，通過側邊欄直接獲取升級命令和狀態，能顯著減少手動查閱文檔的時間。
