前言¶
DeepSeek Harness（DSH）强调「一切皆插件」。对于使用 dsh web 的开发者来说，本地 Harness 是否落后于 npm registry 中的新版本，常需要手动查看。duntansen/dsh-update-checker 是一个 DSH web 插件，用于在设置页中完成版本检查：读取本地 dsh --version，并与 npm registry 的 latest / next dist-tags 比较，在发现新版本时提供一键更新入口。
这是什么¶
这是一个由 duntansen 维护的 DSH web 插件，许可证为 MIT。
它把原本分散在终端里的版本检查和更新操作集中到 DSH 设置页中，包括：
- 检查本地版本与 npm registry 版本
- 一键运行更新命令
- 查看版本时间线
- 查看最近检查历史
- 设置页打开期间自动复检并触发浏览器通知
核心功能¶
版本检查¶
插件会读取本地 dsh --version，并与 npm registry 的 latest / next dist-tags 比较。
版本比较支持语义化版本，并能正确处理 rc 预发布段。
一键更新¶
发现新版本时，可以在设置页中点击更新按钮，运行：
npx -y @deepseek-ai/dsh@latest
更新过程中，页面会展示实时安装进度。完成后，页面会提示重启 dsh web。
版本时间线¶
页面会显示最近 8 个已发布版本及发布日期，并高亮当前版本。
自动复检与通知¶
在设置页保持打开时，插件每 6 小时自动复检一次。
当检测到新版本时，插件会触发浏览器通知。首次触发时，浏览器会请求通知权限。
检查历史¶
插件会将最近 10 次检查保存到：
~/.dsh/dsh-update-checker-history.json
这些记录也会在页面中展示。
安装与启用¶
从 GitHub 安装插件：
dsh plugin --profile web add github:duntansen/dsh-update-checker
安装后，重启 dsh web，打开 GUI，然后进入：
Settings → Update Check
即可使用该插件。
典型用法¶
下面介绍常见操作顺序。
1、打开 Settings → Update Check。
2、页面会显示当前版本、最新版本、next 版本和状态徽章。
3、如果检测到新版本，点击更新按钮执行更新。
4、更新完成后，按页面提示重启 dsh web。
5、需要手动重新检查时，点击 Re-check 按钮。
实现与运行细节¶
插件提供更新接口：
POST /dsh-update-check/update
该接口为同源保护，并且为单实例。
插件执行命令时跨平台运行：
- Windows 使用
cmd.exe - POSIX 使用
/bin/sh
本地版本通过 dsh --version 读取，npm registry 数据用于比较 latest / next dist-tags。
适用场景与注意¶
适合希望在 DSH 设置页中快速确认本地 Harness 版本状态的开发者。
需要注意，插件以当前 dsh 进程权限运行，并会读取本地版本、执行更新命令。安装前建议检查源码，并确认 MIT 许可证符合使用要求。
浏览器通知依赖浏览器权限；如果不想启用通知，可以拒绝权限请求。检查历史会写入：
~/.dsh/dsh-update-checker-history.json
