插件一键更新 leoyoul/dsh-onekey-update

dsh-onekey-update 一键更新

DeepSeek Harness（dsh）插件：每次启动后检查已下载且已启用的插件有没有新版本，在界面右下角列出来，点一次「全部更新」就逐个升级到最新版，完成后提示重启。

界面是原生风格通知条：左侧 3px 状态竖条 + 徽标，配色全部取自 DSH 主题 token（--dsw-alias-、--dsw-radius-、--dsw-shadow-*），随主题明暗与品牌色变化，不写死颜色。四态（有更新 / 全最新 / 更新中 / 失败）共用一套结构，更新中用分段进度条，失败行标 ✗ 并给出 pnpm 关键错误。

更新执行是跨平台的：不依赖 DeepSeek Harness.exe，macOS / Windows / Linux 都用同一套官方 CLI 通道。

交互

- 启动约 8 秒后后台检查，不阻塞界面。
- 检查完一定给结论：有新版本时列出 插件 当前版本 → 最新版本，按钮 全部更新 / 稍后提醒；全部最新时也弹卡片，标题 全部插件都是最新版，说明检查了多少个、跳过了多少个，按钮 重新检查 / 知道了。
- 在待更新插件下点「查看更新日志」可直接展开并滚动阅读；按需读取 GitHub Releases 最近 100 个发行版中匹配本次升级区间的说明，未找到或访问失败会单独提示。当前不读取 CHANGELOG 文件，发行版未覆盖所有版本时结果可能不完整。
- 展开日志后可点「翻译为中文」，译文与原文可切换。点击时日志文本会发送给 Bing，代码、链接和版本号会先保护；无需另开其他插件。网络失败时保留原文并在标题旁提示重试。
- 点「全部更新」：显示 3/7 dsh-context 0.75.1 → 0.77.0 的实时进度，逐条执行。
- 结束：标题给出 成功 N、失败 M，每行标 ✓ / ✗，失败行给出 pnpm 输出的关键一行；提示重启 DSH 生效。
- 部分失败不影响其余插件继续升级。

检查范围

profile package.json 的 dependencies ∩ 已启用（dsh.profile.bundles 或 cordis.patch.yml），并排除：

- 插件自身；
- 非 registry 依赖（file: / link: / git: / 本地路径）；
- 已在插件页停用的包（.dsh-market/state.json）；
- node_modules 里找不到、无法确定当前版本的包。

版本比较使用完整 semver（含预发布段），只列前向升级，不会降级。查询 dist-tags.latest，先问 https://registry.npmjs.org，失败再问 https://registry.npmmirror.com。

更新通道

逐条执行官方通道：

dsh plugin --profile <profile> add <name>@<version> --config.minimum-release-age=0

dsh 可执行文件按下列顺序解析，不依赖 PATH、不判断 .exe 后缀：

1. <resources>/runtime/cli/bin/dsh（应用自带的 CLI，macOS 已实测）；
2. <resources>/app.asar/dsh/node_modules/@deepseek-ai/dsh-desktop-host/lib/cli.js，用 Electron 以 ELECTRON_RUN_AS_NODE=1 --expose-internals 方式调用；
3. <resources>/app/dsh/...（解包运行时的同位置）。

都不存在时报「找不到 DSH CLI」，卡片进入失败态，不会静默跳过。

--config.minimum-release-age=0 用于绕过 pnpm 的最小发布时长限制，否则刚发布的版本会被供应链策略拒绝。

安装

从 GitHub（推荐，任何平台）：

dsh plugin --profile desktop add git+https://github.com/leoyoul/dsh-onekey-update.git

本机开发时用链接安装：

dsh plugin --profile desktop add link:/Users/leoy/Documents/dsh-onekey-update

装完完全退出并重开 DSH，插件页会出现「一键更新」，右下角按检查结果出现卡片。

在 DSH「发现」页里安装

插件已发布到 npm，主流市场自动收录（约 24 小时同步一次）：直接在 插件 → 发现 里搜 dsh-onekey-update 安装即可。

环境变量

| 变量 | 作用 |
| DSH_ONEKEY_UPDATE_DELAY_MS | 启动后延时多久检查（默认 8000） |
| DSH_ONEKEY_UPDATE_DISABLE=1 | 本次启动不检查、不显示卡片 |
| DSH_PROFILE | 覆盖 profile 名（默认 desktop） |
| DSH_HOME | 覆盖 ~/.dsh |

状态与日志

- ~/.dsh/onekey-update/state.json：最近一次检查与更新的结构化结果；
- ~/.dsh/onekey-update/onekey-update.log：检查、逐条更新、错误记录。

宿主路由（同源）：GET /onekey-update/status、POST /onekey-update/check|apply|dismiss。

开发

npm run check # node --check 三个源文件
npm test # 版本比较、profile 扫描、registry 回退、汇总逻辑

检查逻辑 lib/check.mjs 是纯函数 + 只读 IO，可脱离 Electron 直接在 node 里跑：

node -e "import('./lib/check.mjs').then(async m => console.log(await m.checkAll(m.profileDirFor('desktop'))))"

已知边界

- 更新的是宿主正在运行的 node_modules，新版本要重启 DSH 才生效。
- 卡片不列 registry 的所有历史版本，只升到 dist-tags.latest。
- 安装在 link: 目录时没有构建步骤，改完源码重启 DSH 即生效。