frostming/dsh-auto-update

dsh-auto-update

一个运行在宿主端的 DeepSeek Harness 启动自动更新插件。

DeepSeek Harness 官方 CLI 没有 self-update，社区里已有的插件（如 dsh-update-checker）只能检查更新、然后让用户点按钮手动安装。这个插件补上“无人值守”这一环：每次启动时对比本机 dsh --version 与 npm registry 的 dist-tag，发现新版本时按配置只提醒（默认，安全）或自动安装（需显式开启）。

特性

- 启动时检查一次：启动后延迟几秒自动检查一次，之后不再重复检查
- 正确的 semver 比较：正确处理 0.1.0-rc.5 → 0.1.0-rc.6 这类预发布版本
- 两种模式：
- notify（默认）：只在控制台打印醒目的“发现新版本”横幅，不安装
- install：自动执行安装命令（默认 npm install -g @deepseek-ai/dsh@）
- 状态持久化：检查结果写入 ~/.dsh/dsh-auto-update-state.json，保留最近 10 次历史
- profile 无关：不依赖 webServer，web / headless / tui / 任意自定义 profile 都能用
- 优雅卸载：启动检查的 setTimeout 通过 ctx.effect 注册，HMR 替换或插件卸载时自动清理
- 零运行时依赖：只用 Node 内置模块 + 全局 fetch

安装

dsh plugin --profile web add github:frostming/dsh-auto-update
或从本地 checkout 安装
dsh plugin --profile web add /path/to/dsh-auto-update

重启 dsh web 生效。默认只提醒不安装，控制台会打印：

════════════════════════════════════════════════════════
dsh-auto-update: update available
installed: 0.1.0-rc.5
available: 0.1.0-rc.6 (latest)
action:    notify only — run npm install -g @deepseek-ai/dsh@0.1.0-rc.6
════════════════════════════════════════════════════════

开启自动安装

编辑 profile 的 cordis.patch.yml（$DSH_HOME/profiles//cordis.patch.yml），覆盖 mode：

- insert:
- id: dsh-auto-update
name: 'dsh-auto-update'
config:
mode: install
可选：自定义安装命令，{version} / {package} 会被替换
installCommand: 'npm install -g {package}@{version}'

⚠️ DeepSeek Harness 目前处于 developer preview，官方明确声明会有破坏性兼容变更。自动安装等于接受这种风险，请谨慎开启。

配置项

| 键 | 默认值 | 说明 |
|---|---|---|
| channels | ["latest", "next"] | 按优先级咨询的 dist-tag |
| startupDelayMs | 5000 | 启动后检查的延迟，毫秒 |
| mode | "notify" | "notify" 或 "install" |
| installCommand | npm install -g {package}@{version} | 安装命令模板 |
| stateFile | ~/.dsh/dsh-auto-update-state.json | 状态文件路径 |
| verbose | true | 是否打印检查日志 |

目录结构

dsh-auto-update/
├── package.json        # dsh bundle 声明（dsh.bundle.patch）
├── cordis.patch.yml    # 插入插件行到 profile 层级栈
├── lib/
│   ├── index.js        # 宿主端：启动时一次性检查 + 决策 + 安装执行
│   ├── semver.js       # 无依赖的 semver 比较
│   ├── version.js      # 本地版本解析 + npm registry 查询
│   └── state.js        # 状态持久化
└── test/               # node --test 单元测试

测试

npm test

License

MIT