dsh-update-checker

DeepSeek Harness 官方运行时更新检测插件 —— 零依赖，任何 DSH 安装可用。

在 DSH 的设置页新增「检查更新」区：显示当前/最新版本，一键手动重查，定时（默认 6 小时）自动检测并发送事件通知。插件只检测，不执行更新——它运行在被更新的进程内，无法替换自己；更新请执行 npm install -g @deepseek-ai/dsh@latest。

English · 简体中文

特性

• 零依赖：纯 DSH 插件（host 路由 + client 设置页），无需安装任何外部组件
• 定时检测：启动即查 + 默认每 6 小时检查一次 npm registry（ctx.setInterval）
• 手动检测：设置页「检查更新」按钮强制重查
• 同源路由：/dsh-update/status（读缓存）、/dsh-update/check（强制重查），无 CORS 问题
• 事件通知：每次检查后 ctx.emit('dsh/update-checked', …)
• 设置页 UI：遵循 DSH 设计语言（--dsw-alias-* tokens），侧栏「检查更新」入口
• 语义版本比较：内置极简 semver 比较（支持 0.1.0-rc.N 预发布）

安装

1. 把插件包放进 profile 可解析位置：

# 以默认 web profile 为例
mkdir -p "$DSH_HOME/profiles/web/node_modules/@keLearns"
cp -r dsh-update-checker "$DSH_HOME/profiles/web/node_modules/@keLearns/"

2. 在 $DSH_HOME/cordis.patch.yml（不存在则创建）追加：

- insert:
    - id: dsh-update-checker
      name: '@keLearns/dsh-update-checker'

3. 重启 DSH（dsh web），设置页出现「检查更新」区。

配置

通过 patch 行的 config 覆盖（全部可选）：

- insert:
    - id: dsh-update-checker
      name: '@keLearns/dsh-update-checker'
      config:
        checkIntervalHours: 12   # 检查间隔（小时），默认 6
        currentVersion: 0.1.0-rc.6  # 手动指定当前版本（默认自动探测）

工作原理

• 版本探测链（自动）：config.currentVersion → @deepseek-ai/dsh → @deepseek-ai/dsh-web-app → @deepseek-ai/dsh-base（同 tag 同步发布，版本一致），从 profile 依赖闭包解析
• 检查：fetch(https://registry.npmjs.org/@deepseek-ai/dsh/latest) 与当前版本做 semver 比较
• 路由：/dsh-update/status 返回缓存（无缓存则现场查）；/dsh-update/check 强制重查并刷新缓存
• 事件：dsh/update-checked 携带 {current, latest, updateAvailable, checkedAt, error}

限制

• 不执行更新：插件运行在 DSH 进程内，无法替换自身代码。更新由外部机制完成（npm install -g @deepseek-ai/dsh@latest）。
• 依赖网络：检查需要访问 npm registry。

License

MIT © 2026 KeLearns