dsh-plugin-updates

DSH 插件自动更新 · 0.2.3

兼容维护：同时支持 DSH 0.2.1-rc.2 / rc.3，保留旧版用法与设置。验证范围与复现见 [DSH 兼容说明](docs/DSH_COMPATIBILITY.md)。

原生 DSH 插件，连接已安装插件的原 GitHub 仓库，默认开启自动更新，每 24 小时检查一次。检查和安装直接使用程序与官方 DSH CLI，不发起模型调用。

[最新 Release](https://github.com/InariNGT-Ofiicial/dsh-plugin-updates/releases/latest) · [安装包 v0.2.3](https://github.com/InariNGT-Ofiicial/dsh-plugin-updates/releases/download/v0.2.3/dsh-plugin-updates-0.2.3.tgz) · [问题反馈](https://github.com/InariNGT-Ofiicial/dsh-plugin-updates/issues)

首次启动延迟 15 秒；重启读取上次检查时间，未到期不会重复检查。默认覆盖同一 DSH 主目录下所有 profile 的直接安装插件，包含未启用的安装条目。更新保留它们原有的启用状态。更新安装完成后，在对应 profile 重新加载或重启时生效；插件不会自动重启 DSH。

安装或升级

需要 Node.js 24+、DSH 0.2.1-rc.2 或 rc.3。可直接安装 Release URL，无需构建：

dsh plugin --profile desktop add https://github.com/InariNGT-Ofiicial/dsh-plugin-updates/releases/download/v0.2.3/dsh-plugin-updates-0.2.3.tgz

桌面版命令未加入 PATH 时：

& 'D:\DSH\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop add https://github.com/InariNGT-Ofiicial/dsh-plugin-updates/releases/download/v0.2.3/dsh-plugin-updates-0.2.3.tgz

也可从 Release 下载 .tgz 后通过本地路径安装。命令安装后重新加载或重启 DSH。旧版的检查时间设置会保留，已有人工设置仍优先于默认值。

本插件的 package.json.repository 指向本仓库，通过 Release URL 或下载包安装后，也会检查自己的后续正式 Release。默认排除预发布；升级安装本插件后需要重新加载才能运行新版代码。

插件市场适配

v0.2.3 已提供中英文标题、说明、作者和蓝白更新图标，兼容 DSH 插件管理展示。支持 format 1 自定义索引的市场可添加：

https://raw.githubusercontent.com/InariNGT-Ofiicial/dsh-plugin-updates/main/market/index.json

搜索“插件自动更新”，核对作者与原仓库后安装。索引固定到已发布 Git 提交，后续 Release 自动刷新。不同版本的 Discover 属于可选功能；没有该页面时仍可直接安装 Release 包。第三方精选市场是否默认收录由其维护者决定，详见 [市场安装说明](docs/MARKET.md)。

在 DSH 对话中人工控制

可以直接说“把检查间隔改成 48 小时”“关闭自动更新，只保留检查”“开启自动更新”“现在检查并更新插件”。

| 接口 | 参数示例 | 行为 |

| --- | --- | --- |

| plugin_updates_check | {} | 立即检查版本，不安装；15 分钟 HTTP 缓存可复用 |

| plugin_updates_status | {} | 查看最近报告、检查时间和自动更新开关，不发网络请求 |

| plugin_updates_schedule | {"action":"set","intervalHours":24} | 每 24 小时检查，立即调整计时并持久化 |

| plugin_updates_schedule | {"action":"set","intervalHours":0} | 暂停所有定时检查和定时更新，仍可手动调用 |

| plugin_updates_schedule | {"action":"get"} / {"action":"reset"} | 读取间隔 / 清除人工覆盖并恢复插件配置值 |

| plugin_updates_auto_update | {"action":"get"} | 查看自动更新开关及最近更新历史 |

| plugin_updates_auto_update | {"action":"set","enabled":false} | 关闭自动安装，保留版本检查 |

| plugin_updates_auto_update | {"action":"set","enabled":true} | 开启自动安装 |

| plugin_updates_auto_update | {"action":"reset"} | 恢复插件配置的开关，默认开启 |

| plugin_updates_auto_update | {"action":"run"} | 按当前开关立即检查并更新 |

| plugin_updates_auto_update | {"action":"run","packageName":"example-plugin","profile":"desktop"} | 只更新指定已安装插件；名称为示例占位符 |

检查间隔支持 0～168 小时，非零间隔最短按 1 分钟计时。开关更改在当前安装结束后阻止后续更新，不强行终止正在执行的包管理操作。人工设置优先于原生配置；调用对应 reset 后重新使用原生配置。

自动更新怎样选择安装源

先从本地安装信息确定原仓库：用户配置 → GitHub 安装来源 → .git origin → package.json.repository。检查最近 30 条 Release，默认排除草稿与预发布；无可核对 Release 时检查最近 30 条标签，再降级查看分支版本。候选版本必须与仓库中的包名、版本匹配，使用 MIT node-semver 7.8.5 比较。

自动安装范围：

• npm 正式包安装的插件：从该 profile 配置的包源读取同名、精确版本包，重新核对其 GitHub 仓库、包名、版本和 DSH 要求，再通过官方 DSH CLI 安装。不会把另一个仓库的同名包当成原插件。
• GitHub 或 tarball 安装的插件：优先取对应 Release 的插件 .tgz，没有时尝试标签归档；核对安装包内容、包名、版本、可运行入口和 bundle patch。Release 提供 SHA-256 digest 时同时校验。只接受 GitHub 官方下载域名，跨域下载不传递 GitHub token。
• 本地 link/workspace 源码、仅开发分支的新版本、缺少可安装包的多包仓库、别名安装、缺少 GitHub 来源等情况：在报告中说明原因，保留原安装。多包仓库需要插件专用 .tgz，或原本通过 npm 正式包安装。

每次安装固定到检查过的版本，关闭安装生命周期脚本，不自动批准构建脚本或 DSH 版本豁免。不适配当前 DSH / Node.js、需要构建但没有运行入口、包名不符或包摘要校验失败的条目会被标记。

安装前保存旧包 tarball 和 profile 的 manifest、lockfile、workspace 设置、patch。安装成功后回读包名、版本、入口及启用状态；失败且文件已改变时尝试通过官方 CLI 安装旧版本。回退也失败则标记 needs_attention，暂停对该插件的自动重试，供人工处理。备份及日志保留本地，不自动删除。

这里的“已更新”表示安装文件已核对，不代表插件业务功能已在运行中重新验收。不同插件、依赖和宿主版本可能仍需重新加载后检查。无法确认的结果不会显示为成功。不会自动合并本地源码或比较同版本的提交变化，不递归管理普通依赖，也不更新 DSH 内置核心包。

原生配置

在当前 profile 的 cordis.patch.yml 中设置已有条目：

- id: plugin-updates
  config:
    autoUpdate: true
    intervalHours: 24
    checkOnStart: true
    startupDelaySeconds: 15
    allProfiles: true
    includePrereleases: false
    timeoutMs: 12000
    maxRequests: 40
    githubTokenEnv: DSH_GITHUB_TOKEN
    proxyUrl: ""