DeepSeek Harness 主程序版本管理插件 dsh-versions：安全升級與回滾

在 DeepSeek Harness（DSH）的使用場景中，主程序的版本升級往往缺乏回滾機制。一旦升級失敗或引入不兼容，可能導致服務中斷甚至無法訪問 Web 界面。dsh-versions 插件旨在解決這一痛點，爲 DSH 主程序提供一套完整的版本管理方案。

插件定位¶

dsh-versions 是一個 DeepSeek Harness 主程序版本管理插件，由用戶 shangdi178 維護。它運行在 dsh web 界面中，允許用戶查看當前版本、檢查更新，並直接在 Web 端完成主程序的升級、降級或重裝，同時具備自動快照和秒級回滾能力。

核心功能¶

1. 版本總覽與檢查：在「設置 → 版本管理」中查看當前 dsh 主程序版本及所屬渠道（latest/next/alpha），支持一鍵檢查 npm 更新（10 分鐘緩存）。
2. 在線操作：支持對任意已發佈版本進行在線安裝、重裝或降級。
3. 自動快照與回滾：升級前自動創建本地版本快照，支持秒級回滾至任意歷史版本，無需網絡請求。
4. 歷史記錄與重啓：記錄本地升級歷史，支持手動重啓 dsh web 服務。

安裝與啓用¶

安裝該插件需要 dsh ≥ 0.1.0。

1. 使用 dsh plugin 命令安裝插件。
2. 安裝完成後，重啓 dsh web 服務以加載插件。
3. 進入 Web 界面，在設置菜單中找到「版本管理」入口。

安裝命令：

dsh plugin --profile web add dsh-versions

典型用法¶

• Web 界面操作：進入 dsh web 的 設置 → 版本管理，查看當前版本、渠道信息，或點擊「檢查更新」。
• 非 Windows 平臺升級：由於插件依賴 Windows 工具，非 Windows 用戶若需升級，需手動執行 npm 命令：

npm install -g @deepseek-ai/dsh@<版本>

適用場景與注意¶

• 平臺限制：升級/重裝/恢復/重啓功能依賴 Windows 工具（robocopy/schtasks/PowerShell 5.1），僅在 Windows 上可用。其他平臺的對應按鈕會被禁用並提示原因。
• 權限與安全：插件僅限本機訪問，並帶有跨站防護（環回地址 + Host 白名單）。它僅負責 dsh 主程序本身，其他插件的安裝更新由 dsh plugin 命令統一管理。

總結¶

該插件通過自動快照和回滾機制，降低了 DSH 主程序升級的風險。對於需要頻繁調試不同版本的開發者而言，這是一個必要的工具。插件詳情與源碼可參考其 GitHub 倉庫。