AnothetLoice/dsh-hotplug-engine2

dsh-hotplug-engine

DSH 热插拔执行引擎:为插件市场、智能体和宿主插件提供可靠的安装、启用、禁用、回滚和审计服务(仅为执行层,非市场本身)。

AI 分析

核心用途是作为底层服务,为 DSH 提供安全、可回滚的插件生命周期管理。适合需要开发插件管理界面、或让 Agent 具备自主安装/启停插件能力的开发者。

套件
dsh-hotplug-engine
版本
0.1.5
授權
MIT
最近更新
2026年8月16日

安裝

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:AnothetLoice/dsh-hotplug-engine

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 
 add dsh-hotplug-engine
# 或 dsh plugin add dsh-hotplug-engine

bundle 包:装/卸后重启 profile;新客户端面板刷新页面加载。

上手

  • 宿主注入:inject: ['hotplugEngine'],调 ctx.hotplugEngineinstall / 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

License

MIT