插件自动更新 1708994293-hue/dsh-auto-update

dsh-auto-update

DeepSeek Harness（dsh）插件：每次打开 DSH 时自动检查你已经下载并启用的插件有没有新版本，发现后主动列出并询问是否更新——点确认才更新，更新走 DSH 官方通道，不会覆盖你的 profile 配置。

- 启动约 8 秒后后台检查，不阻塞界面；
- 有新版本时右下角出现提示卡，逐条列出 插件 当前版本 → 最新版本；
- 按钮：全部更新 / 稍后提醒；无更新时完全静默；
- 更新完成后提示「重启 DSH 后生效」，与插件市场的更新语义一致。

安装

要求：dsh 0.2.1 及以上（插件声明了 dsh.bundle manifest）。

从 npm 安装（推荐，任意平台）

dsh plugin --profile desktop add @sueleven/dsh-auto-update

npm 上无 scope 的名字 dsh-auto-update 被 registry 以「与已有包 dsh-autoupdate 名称过于相似」拒绝，因此发布名带 scope：@sueleven/dsh-auto-update。

从 GitHub 安装

dsh plugin --profile desktop add github:1708994293-hue/dsh-auto-update

从本地目录安装

Windows：脚本会复制插件并调用官方 dsh plugin 通道安装 pwsh -NoProfile -File scripts/install.ps1

任意平台：
dsh plugin --profile desktop add link:<本仓库绝对路径>

装完完全退出并重启 DSH，侧边栏「插件」页里会出现 dsh-auto-update。

从 1.0.0 升级

1.0.0 的前端模块注册名遗漏了 npm scope，可能导致 Desktop 启动失败并记录 duplicate factory registration for "dsh-auto-update"。1.0.1 修复了这个问题。新版本发布到 npm 后，完全退出 DSH，再安装：

dsh plugin --profile desktop add '@sueleven/dsh-auto-update@1.0.1' --config.minimum-release-age=0

重新打开 DSH；若此前通过恢复操作停用了插件，在插件页重新启用即可。

如何工作

| 部分 | 文件 | 作用 |
| Host 半 | lib/index.js | 启动延时检查、状态机、同源 HTTP 路由 /dsh-auto-update/status|check|apply|dismiss |
| Client 半 | lib/client.js | 注册 shell.overlay 提示卡，轮询状态、展示列表与按钮 |
| 检查/更新器 | lib/update.mjs | 读取 profile、查询 npm registry、按需调用官方 dsh plugin ... add |

检查范围：profile package.json 的 dependencies ∩ dsh.profile.bundles（即「已下载且已启用」），并排除市场里被禁用的包、非 registry 依赖（file: / link: / git: 等）以及插件自身。版本比较使用 semver，只在前向升级时列出，不会把插件降级。

更新方式：<DSH exe> --expose-internals <app.asar>/dsh/node_modules/@deepseek-ai/dsh-desktop-host/lib/cli.js plugin --profile <name> add <pkg>@<ver> --config.minimum-release-age=0，即 DSH 插件市场使用的同一个官方通道。

环境变量

| 变量 | 作用 |
| DSH_AUTO_UPDATE_DELAY_MS | 启动后延时多久开始检查（默认 8000） |
| DSH_AUTO_UPDATE_DISABLE=1 | 本次启动不检查、不显示提示 |
| DSH_AUTO_UPDATE_PROFILE | 覆盖 profile 名（默认读 DSH_PROFILE，否则 desktop） |
| DSH_AUTO_UPDATE_DATA_DIR | 覆盖日志/状态目录（默认插件包目录） |

日志

- <插件目录>/logs/auto-update.log：每次检查与更新的完整记录
- <插件目录>/logs/plugin.log：插件生命周期（启动、检查结果、用户确认、错误）
- <插件目录>/state/last-run.json：最近一次检查的结构化结果

插件目录：本地 link: 安装是 ~/.dsh/plugins/dsh-auto-update；npm 安装是 profile 的 node_modules/@sueleven/dsh-auto-update。

手动使用

只检查，不做任何修改
node <插件目录>/lib/update.mjs --check

列出可更新项（JSON）
node <插件目录>/lib/update.mjs --check --json

update.mjs 支持 --profile、--check、--json、--dry-run、--help。

卸载

dsh plugin --profile desktop remove @sueleven/dsh-auto-update

Windows 本地安装可再用 pwsh -NoProfile -File scripts/uninstall.ps1 删除插件目录。

开发

node --check lib/index.js # package.json 里 type=module
node test/client.test.mjs # 前端模块注册及插槽加载回归测试
node lib/update.mjs --check --dry-run

本地联调可把 profile 依赖换成 link:<仓库路径>，改完代码重启 DSH 即可生效。

发布到插件市场

awesome-dsh-plugin 是 DSH 插件目录，dsh-market 与「插件 → 发现」的索引都来自它。上架步骤：仓库公开、带 dsh-plugin topic、仓库创建满 1 天，然后向该仓库提 PR，新增单文件 data/plugins/<owner>__dsh-auto-update.yml：

url: https://github.com/<owner>/dsh-auto-update
name: <owner>/dsh-auto-update
category: workflow
description:
en: Checks enabled DSH plugins for new versions at startup and asks before updating them.
zh: 每次打开 DSH 自动检查已启用插件的新版本，列出并询问是否更新。

DeepSeek Harness 插件：每次启动 DSH 时检查已安装并启用的插件有没有新版本，列出检查结果，只有你确认后才更新。更新走官方 dsh plugin add 通道，重启后生效。

dsh plugin --profile desktop add @sueleven/dsh-auto-update
or: dsh plugin --profile desktop add github:1708994293-hue/dsh-auto-update

License

MIT