dsh-plugin-auto-update
给 DSH 插件做按包白名单的自动更新：在插件页打开开关、勾选允许自动升级的插件即可。
（上图是示意图，不是录屏）
它做什么
- 按计划去 npm 查已安装插件的最新版本
- 只更新你勾选的包；本地
link:/file:安装、锁定版本、报错的包一律跳过 - 默认不跨大版本、不装预发布
- 更新走 profile 里运行中的官方
pluginManager：profile 写锁、pnpm 执行、bundle 补丁校验、HMR 重载都由它负责；安装失败会把旧版本装回去 - 每次更新都记进更新记录：插件页里直接看「谁、从哪个版本、到哪个版本、什么时候、成没成」
安装
插件页 → 安装 → 填包名：
@chendaleiq/dsh-plugin-auto-update
装完重启 DSH（宿主半边需要新代际才加载）。也可以填 GitHub 地址或本地目录的绝对路径。
配置：插件页里的面板
插件 → DSH 插件自动更新 → 详情页底部：
- 启用自动更新 —— 总开关，默认关
- 升级范围 —— 允许跨大版本 / 允许预发布
- 自动更新的插件 —— 列出所有从注册表安装的插件，逐个勾选；「全部可更新的插件」= 通配
- 不能更新的包会置灰并说明原因（本地安装 / 锁定版本 / 存在错误）
改动即时生效，不需要重启。
更新记录
详情页底部的第二块就是更新记录：按时间倒序列出每次真正发生的动作。
- 一行一条：时间、包名、
旧版本 → 新版本、结果（已更新 / 更新失败 / 可升级（演练）） - 失败的记录带上回滚说明和原因（鼠标悬停可看完整原因）；更新了宿主半边会标「需重启生效」
- 刷新 重新读一次；清空记录 需要点两次确认（几秒内不点第二次就自动取消）
- 记录只记「和版本有关」的动作：
current（已经是最新）和error（查不到版本）不写进来，免得记录被刷成流水账 - 同一个包重复出现相同结果（同一个版本反复升级失败、演练反复看到同一个可升级版本）只记一次
数据存在 ~/.dsh/plugin-auto-update-history.json，最多保留 200 条（historyLimit 可改）。面板通过宿主半边提供的
GET /dsh-plugin-auto-update/history 读取，删除走同一个地址的 DELETE；没有 web server 的部署（headless）里这块会提示接口不可用，记录仍写进日志。
语言
跟随 DSH 的语言设置：默认中文，切英文后插件页和面板文案同步变英文。
日志
~/.dsh/plugin-auto-update.log，每行一个 JSON：
{"at":"…","kind":"cycle","decisions":[{"name":"dsh-plugin-desktop-notify","action":"updated","installed":"0.5.6","latest":"0.5.7"}]}
action 有 current / would-update / updated / failed / error。
边界（有意为之）
- 只碰「从注册表安装、且依赖写成范围（
^~*latest）」的包 - 随 DSH 自带的 bundle 不动；不修改你的其它配置
- 网络或插件管理器出错只记录，不中断其它包
- 宿主半边更新后需要重启应用；渲染层由 HMR 直接换掉
高级配置
面板没覆盖的字段（intervalHours 默认 6 小时、initialDelayMinutes、maxUpdatesPerRun、dryRun、registry、timeoutMs、logPath、historyPath、historyLimit）写在 profile patch 的 config 里，或覆盖 ~/.dsh/profiles/<profile>/cordis.patch.yml 的同一行。改完需要重启。
开发
node test/index.test.mjs # 宿主半边：检查、更新循环、更新记录的去重与上限
node test/client.test.mjs # 渲染层：插槽注册、远端信封、置灰原因、记录接口
协议
MIT · 仓库 https://github.com/chendaleiQ/dsh-plugin-auto-update