dsh-update-notifier

dsh web 启动时自动检测 @deepseek-ai/dsh 是否有可更新版本。

功能

• 启动后 1 秒首检 + 每 6 小时轮询 + 手动“立即检查”
• 对比本地 package.json#version 与 registry.npmmirror.com（回落 registry.npmjs.org）的 dist-tags.latest / next，semver 兼容 x.y.z-rc.n
• 有更新时：
  • shell.overlay 顶部居中卡片（可关闭，localStorage 按版本记忆 dismiss，下次新版本自动复现）
  • 卡片关闭后，conversation.input.dock 输入框上方显示轻量胶囊，点击可重新展开
  • 卡片内提供 npm i -g @deepseek-ai/dsh@{latest|next} 一键复制 + Release notes 链接
• 检查过程不会“卡在正在检查更新”：
  • 宿主 getStatus 若落在自检窗口内，会等待（≤2s）正在进行的检查，直接返回已完成的结果
  • 客户端在未拿到 checkedAt 前按退避重试 checkNow（RPC 通道是拉取式的，宿主不会推送新快照）
  • 30 秒仍无结果 → 显示可重试的错误卡片；加载卡片本身也带「立即检查 / 关闭」按钮

界面

卡片跟随 DSH 主题（浅色 / 深色），全部颜色取自 --dsw-alias-* 设计变量，无硬编码色值。

• 状态色：有更新 = business 蓝，已最新 = success 绿，检查失败 = warn 橙
• 版本来源以 npm dist-tags + GitHub tag 胶囊呈现，命中当前版本的一枚高亮并标注「当前」
• 右上角为图标操作：立即检查（检查中转圈）、常驻、关闭
• 依赖的 hover / focus / 动画规则由插件自带的一个 <style> 提供，随插件卸载一并移除
• 支持 prefers-reduced-motion，图标按钮均带 title + aria-label

结构

dsh-update-notifier/
├── package.json
├── cordis.patch.yml
├── lib/
│   ├── index.js   # host: /dsh-update-rpc getStatus/checkNow
│   └── client.js  # client: overlay banner + dock pill
└── test/          # 回归测试（不随 npm 包发布）

测试

npm test

• test/loading-recovery.mjs：把真实的 lib/client.js 装进 vm（自带最小 React hooks 运行时 + 假时钟）， 复现「页面在宿主自检窗口内加载」的场景，断言横幅能从加载态恢复到结果态、宿主无响应时 30 秒后变成可重试错误、宿主已完成时不多发请求。 加 --expect-stuck 可对旧版本 bundle 断言“卡在加载态”，用于证明用例真能复现问题。
• test/host-getstatus.mjs：用 stub fetch（1.5s 延迟）启动真实的 lib/index.js，在自检进行中调用 getStatus，断言返回的是完整快照而不是 {checkedAt:null, checking:true}。
• test/rpc-bridge.mjs：直接驱动真实的 /api/dsh-update-rpc/* 精确 Fetch 路由，断言路由清单（三条、仅 POST、 requestBody: buffered）、client-request 信封契约（回显 rpcId、method 必须等于 endpoint）、 错误码走 gateway 分类，以及宿主缺少该 seam 时保持惰性而不是抛错。 传一个迁移前的 index.js 路径即可看到协议差异。详见 AUDIT-dsh-0.1.7-alpha.1.md。

安装

dsh plugin --profile web add https://github.com/xia-sc/dsh-update-notifier
# 重启 dsh web 生效

验证：

dsh --profile web --dump-config  # 应含 update-notifier
# 浏览器半（DSH 0.1.7+ 只有 combo 形式；rev 是 bundle 文件 mtimeMs/ctimeMs/size 的哈希前 12 位）：
#   GET http://127.0.0.1:3080/plugins/??dsh-update-notifier/client.js&rev=<rev>   200
# 裸 /plugins/dsh-update-notifier/client.js 在 0.1.7 上必然 404
# RPC（0.5.0 起挂在 /api 之下）：POST /api/dsh-update-rpc/getStatus
#   {"type":"client-request","rpcId":"1","method":"dsh-update-rpc/getStatus","payload":{"args":{}}}
#   method 是 /api 之下那段路径（不是裸 getStatus）；无 token 会 401，不存在的路径是 404