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 仓库。