前言¶
DeepSeek Harness (DSH) 的核心 CLI 工具 @deepseek-ai/dsh 需要定期更新以获得新功能和安全修复。手动检查版本并升级会中断工作流。dsh-update-notifier 插件解决了这一痛点，在 DSH Web 界面启动时自动检测 @deepseek-ai/dsh 的可用更新，并在发现新版本时提供明确的升级指引。
插件定位¶
这是一个联网工具插件，由开发者 xia-sc 维护，采用 MIT 许可证。它通过交叉验证 npm registry 与 GitHub Tags 来确认版本状态，旨在让 DSH 用户的工具链维护更加自动化。
核心功能¶
- 自动检测与轮询：启动后 1 秒进行首次检查，之后每 6 小时轮询一次。同时支持手动“立即检查”。
- 版本对比：将本地
package.json#version与 npm registry（dist-tags.latest/next）进行对比，使用semver兼容规则。 - 界面反馈：
- 有更新时显示可关闭的横幅，关闭后会在输入框上方显示轻量胶囊，点击可重新展开。
- 卡片内提供npm i -g @deepseek-ai/dsh@{latest|next}一键复制安装命令。 - 错误处理：检查失败时提供重试选项。若 30 秒无结果显示，会出现可重试的错误卡片。
- 主题适配：支持深色/浅色主题，颜色取自 DSH 的设计变量。
安装与启用¶
使用官方 CLI 命令添加插件：
dsh plugin --profile web add https://github.com/xia-sc/dsh-update-notifier
添加后需重启 DSH Web 生效。
典型用法¶
插件启动后，若检测到 @deepseek-ai/dsh 有新版本，会在界面顶部显示更新横幅。用户点击横幅中的命令即可复制安装命令，随后重启 DSH Web 即可完成升级。若网络检查失败，界面会提供重试入口。
技术细节与注意¶
- RPC 路由：挂载在
/api之下。 - 依赖：依赖
@deepseek-ai/cordis ^4.0.1。 - 样式清理：插件卸载时会自动移除样式。
- 宿主集成：插件会等待宿主自检窗口内的检查结果（等待时间 ≤ 2 秒），避免阻塞。
- 超时机制：如果 30 秒内未收到检查结果，界面会显示可重试的错误状态。
总结¶
该插件通过 API 检测 DSH 更新，解决了版本维护的痛点。对于需要频繁更新 DSH 的开发者，这是一个实用的辅助工具。
