前言¶
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 提供了一种低侵入式的版本管理方式。对于需要在多环境部署或频繁关注版本迭代的开发者，通过侧边栏直接获取升级命令和状态，能显著减少手动查阅文档的时间。
