dsh-hotplug-engine
English
给 DSH 做插件管理的服务插件。市场、agent、其他插件都能调用：安装、卸载、启停、回滚、审计，一条链路。
做什么
DSH 用 cordis.patch.yml 和 loader 管理插件。这个插件把这套操作包成服务：改 patch、调 pnpm、装后健康确认、失败自动回滚、全程审计。只动文件和命令，不碰内核。
不做什么
- 不是市场：没有目录、搜索、榜单、推荐。
spec（装什么、从哪装）由调用方给，引擎不猜。
- 不改官方机制：HMR、loader、patch 语义都是官方的，只消费，不重写。
- 不另存状态：以官方组合树为唯一真源，引擎只投影和差分。
- 不带安装界面：UI 只有最小管理面板（查看、启停、回滚、审计），没有 spec 输入。
接入方式
| 场景 | 入口 |
|---|
| 市场 / 插件管理界面 | 注入 hotplugEngine 服务，或调 REST |
| agent 会话 | hotplug_* 工具 |
| 宿主插件 | 注入 hotplugEngine |
安装
pnpm --dir <profile-dir> add dsh-hotplug-engine
# 或 dsh plugin add dsh-hotplug-engine
bundle 包：装/卸后重启 profile；新客户端面板刷新页面加载。
启停
- 引擎改 profile 的
cordis.patch.yml，loader 反射后即时生效（mode:'hot'）；未反射则提示重启。
- patch 行（用户写的或引擎写的）都能启停，流式/块式 YAML 都能改。
- DSH 默认禁用的行（在 bundle 层，没有引擎可改的 patch 行）改不了：UI 显示 🔒「默认禁用」，点击只浮提示，API 返回
HOTPLUG.PATCH.DEFAULT_DISABLED。
DSH 版本
- 目标
0.1.1-rc.2（current），带版本支持矩阵（supportReport()）。
dshPath 显式配置才走官方 dsh plugin CLI，否则 pnpm 直装。0.1.0-rc.6 为 legacy，不再作为验收目标。
上手
- 宿主注入：
inject: ['hotplugEngine']，调 ctx.hotplugEngine 的 install / rollback / enable 等方法，Promise resolve 即操作完成。
- REST：前缀
/api/dsh-hotplug，同源。写：install / uninstall / enable / disable / rollback；读：snapshot / status / audit / operations / events（SSE）。
- 工具：
hotplug_status / hotplug_install / hotplug_uninstall / hotplug_toggle / hotplug_rollback / hotplug_audit，写工具走审批。
完整契约见 docs/01-contract.md。
Changelog
0.2.0
- 补 DSH
0.1.1-rc.2 支持。
DshProfileAdapter：显式 dshPath 才走官方 dsh plugin，否则 pnpm 回退。- patch 写层结构化，流式/块式行都能启停；webServer 就绪后自动挂 REST。
- 新增 DSH 默认禁用门禁：UI 🔒 徽标 + 内联提示，API 返回
HOTPLUG.PATCH.DEFAULT_DISABLED。
- 客户端面板卡片化（紧凑 + 折叠），深浅色自适应。
License
MIT
