前言¶
在 DSH 的插件化使用方式中，开发者经常需要在 Web 界面里确认当前运行版本：当前 dsh 是不是最新 npm 版本？如果不是，更新命令是什么？dsh-update-notifier 解决的就是这类问题：它在侧边栏底部常驻显示已安装的 DSH 版本，并在 npm latest 更新时给出红点和更新面板。下面介绍它的定位、核心能力、安装方式和注意事项。
这是什么¶
dsh-update-notifier 是一个社区插件，维护者是 arvin-yd，许可证为 MIT。它不是一个官方 DeepSeek 产品，也不是官方应用商店里的应用。
它的定位是：为 DeepSeek Harness（dsh）提供常驻版本徽标，始终显示当前已安装版本；当 npm registry 中 @deepseek-ai/dsh 的 latest 版本更新时，显示红点并打开更新面板。
核心功能¶
插件的能力集中在版本显示、更新检查和更新操作上：
- 在侧边栏底部提供常驻徽标，始终显示当前已安装的 DSH 版本。
- 轮询 npm registry，检查
@deepseek-ai/dsh的latestdist-tag。 - 提供
GET /dsh-update-check端点，并带有updateHint。 - 点击徽标打开面板，显示当前版本、最新版本、最近检查时间，以及可用操作。
- 提供复制更新命令、忽略、稍后提醒等操作。
- 支持对
npx-cache安装和全局 npm 安装进行一键更新。 - 支持通过按钮或
?force=1手动立即检查，冷却时间为 2 秒。 - 不采集遥测，也不进行 npm registry 之外的第三方调用。
安装与启用¶
先安装到 web profile：
dsh plugin --profile web add dsh-update-notifier
安装后需要重启 DSH，插件才会生效：
dsh --profile web --port <port>
运行环境要求：
- Node.js
>=22.0.0 - 依赖
@deepseek-ai/cordis ^4.0.1
如果要移除插件，执行：
dsh plugin --profile web rm dsh-update-notifier
典型用法¶
经过上面的步骤后，可以先确认 Web 端点是否可用：
curl http://127.0.0.1:<port>/dsh-update-check
这一步用于检查主机侧是否已经提供更新检查端点。端点会返回更新检查相关结果，并带有 updateHint。
随后在浏览器中查看侧边栏底部徽标：
1、徽标会显示当前已安装的 DSH 版本。
2、如果 npm latest 版本更新，徽标会显示红点。
3、点击徽标打开面板，查看当前版本、最新版本、最近检查时间，并选择复制更新命令、忽略或稍后提醒。
4、如果使用一键更新，需要在面板中完成两次明确确认。
配置覆盖¶
插件支持覆盖 checkIntervalMs 和 timeoutMs 两个配置项。可以在 $DSH_HOME/profiles/web/cordis.patch.yml 中写入类似配置：
- id: dsh-update-notifier
config:
checkIntervalMs: 21600000
timeoutMs: 5000
数据、权限与注意¶
插件会随 DSH 进程运行相关检查逻辑。安装前建议先查看 GitHub 源码和 MIT 许可证，再决定是否启用。
它的行为边界如下：
- 通过 HTTPS 读取 npm 公共 registry 的元数据，不发送凭据。
- 不写磁盘；浏览器侧只把被忽略的版本信息保存在
localStorage中。 - 一键更新只在用户明确两次确认后，才在你的用户账户下执行 npm 命令。
- 对
npx-cache安装，一键更新会结束当前dsh进程，让新版本可以绑定端口。 - 对全局 npm 安装，一键更新会执行相应的 npm 更新命令。
- 没有遥测、分析或 npm registry 之外的第三方调用。
适合使用它的场景包括：经常切换 DSH 版本、使用 npm latest 更新、希望在 Web 界面中快速确认当前版本和更新状态。需要注意的是，这是一个社区插件，安装后需要重启 DSH 才能生效。
兼容与验证¶
已核实信息中，最后验证日期为 2026-08-15，对照 DSH 0.1.0-rc.5 和 0.1.0-rc.6 进行了验证。
链接¶
- GitHub：https://github.com/arvin-yd/dsh-update-notifier
- 插件目录：https://www.skillhub.cn/plugins/arvin-yd/dsh-update-notifier
