dsh-update-checker

维护一套 DSH 工作站时，npm 包和从 GitHub 拉取的插件分散在 profile、lockfile 和 node_modules 中，想确认哪些有新版本往往要手动翻 registry、比 commit、读 pnpm 输出，而 pnpm 把成功提示和真正的错误写在同一条流里，很难判断到底卡在哪一层。dsh-update-checker 把这件事收进设置页的一张表里：打开设置 → 更新检测，即可看到所有可更新、已最新、预发布和失败的项，点击统计卡即可联动筛选两张详表。

它的检测对两类源分别适配。npm 包对比 latest、next 与已发布最高版本；GitHub 包优先用 git ls-remote 取远程 HEAD 和全部标签（不受 API 限流），失败时自动回退 GitHub API，因此 github.com:443 被阻断时依然能给出结果。一次 ls-remote 同时拿到标签，能读出已安装版本和目标版本，避免钉在发布标签上的包因分支移动而永远显示可更新。失败时插件会剥掉 pnpm 的噪声行，把真因归类为 git 通道不通、供应链策略拦截构建脚本、发布冷静期或网络问题，并给出可直接粘贴的配置行。

适合日常维护 DSH 环境、同时依赖 npm 和 GitHub 插件的开发者，尤其是网络受限、或 profile 中供应链策略需要人工审批构建脚本的场景。一键更新采用后台任务机制，检查与更新均不阻塞请求，离开页面后台照常跑完；需要执行第三方构建脚本时会先把目标文件、精确写入行和副作用摊开给用户确认，不会悄悄绕过授权。