版本更新检查knlght/DSH-update-check

dsh-update-check

让 DSH 拥有版本可见性
dsh_check_updates 模型工具 · Settings 更新检查页 · 周期自动复查
只报告，不执行升级——升级决策永远掌握在用户手里。

🌏 中文 · English

✨ 功能一览

- 🔍 版本检查：对照 npm registry dist-tags，检查 DeepSeek Harness 本体（@deepseek-ai/dsh）与 profile 已装插件（如 @anionex/dsh-vision-toolkit）的当前版本与最新版本
- 🤖 模型工具 dsh_check_updates：agent 可在任意会话主动查询版本状态（支持传入额外包名）
- 🖥️ Settings 页面：侧栏新增「更新检查」页——版本表格（包名/当前/最新/状态）、上次检查时间、「立即检查」按钮
- ⏰ 周期复查：间隔可调（30 秒 / 1 分钟 / 30 分钟 / 1 小时 / 12 小时 / 24 小时 / 关闭），默认 1 小时；启动 30 秒后自动首查
- 🛡️ 失败保护：registry 不可达时保留上次成功快照并记录错误；单包失败隔离为 unknown 条目，不影响其余包
- 🎨 原生风格：UI 全部引用 DSH 主题 token（--dsw-alias-*），明暗主题自适应

📦 安装

dsh plugin --profile web add
重启 dsh web 生效

🧠 设计要点

- 本机版本读取：profile node_modules → npm 全局根（npm prefix -g）逐级探测，无硬编码路径
- registry 查询：Node 原生 fetch（15 秒超时）
- 浏览器端点：/_dsh/update-check/snapshot（GET 快照）、/_dsh/update-check/refresh（GET 复查）、/_dsh/update-check/set-interval（POST 设间隔）
- 检查范围默认仅 DSH 本体 + profile 内已装插件；工具参数可临时扩展

🧩 生态

打上 dsh-update-check topic 的插件可接入同一生态。欢迎通过 PR 改进本插件。

📄 许可

MIT

📝 更新日志

v0.2.0

缺陷修复

- 版本比较：修正预发布版本（-rc.1）的比较逻辑——此前把整个版本串按 . 切分后逐段解析数字，0.1.5-rc.1 与 0.1.2-rc.1 会被判为相等，导致 DSH 本体长期误报「已是最新」
- GitHub tag 解析：修正带前缀的 release tag（如 dsh-v0.1.5-rc.1）的解析——此前只剥离 v 前缀，前缀残段被当作版本首段解析成 0，upstream-new 状态永不触发
- 自身跳过：修正自动发现逻辑漏掉自身 npm 包名（dsh_check_updates）的问题，此前自身会出现在检查结果里
- 界面误报：修复 Settings 页在端点返回错误时仍显示成功的问题

健壮性与安全

- 新增 npm 包名格式校验，杜绝经由工具参数 packages 的路径穿越与 URL 注入
- 并发刷新去重：定时器 / HTTP 端点 / 模型工具同时触发时复用同一在途检查，避免请求翻倍与结果错乱
- 多包检查改为并行发出，耗时不再随插件数量线性增长
- intervalMinutes 走白名单校验，非法值回落到默认 60 分钟
- 请求体超过 64 KB 时不再销毁连接，浏览器能正常收到 400 响应
- 解析 npm 全局根改为异步执行，不再阻塞宿主事件循环

测试

- 新增 17 个行为测试（host 13 + client 4），覆盖版本比较、输入校验、并发去重、HTTP 端点与插件卸载清理