dsh-update-check
让 DSH 拥有版本可见性
dsh_check_updates 模型工具 · Settings 更新检查页 · 周期自动复查
只报告,不执行升级——升级决策永远掌握在用户手里。
✨ 功能一览
- 🔍 版本检查:对照 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 <本仓库 / npm 包名>
# 重启 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 端点与插件卸载清理