ruimin251204/dsh-plugin-surgery

README 摘要

dsh-plugin-surgery 给 DSH 插件一把手术刀:看得见影响面的安全卸载、一键回滚、重启确认与插件体检。 DeepSeek Harness 的插件"装容易卸难": pnpm remove 只删依赖, dsh.profile.bundles 里 的插件层条目、node modules 里的孤儿包、pnpm 元数据残留全都要手工收拾;卸错了没有撤销; 卸完还要记得重启。 dsh-plugin-surgery 把"卸载"变成一台有麻醉、有缝合的手术: - 麻醉(dry-run) :动手前先算清楚影响面——直接依赖、传递依赖、将被清除的孤儿、是否插件层; - 缝合(快照/回滚) :每次操作前自动快照,任何一步失败自动还原,卸错了随时一键回滚; - 对账(三方校验) :卸载后核对 清单(package.json)/ 锁文件(pnpm-lock.yaml)/ node modules, 不一致自动回滚; - 查房(restart-pending) :操作结果落盘,重启后 pm status 确认生效; - 体检(pm doctor) :专治"卸不干净"留下的悬空 bundle 条目、孤儿包、锁文件漂移。 安装 重启 dsh 后生效。工具名以 pm 为前缀(Plugin Manager 的手术刀)。 工具 工具 参数 作用 pm list — 列出 profile 插件现状:每个依赖是否激活为插件层、是否声明 dsh.bundle、孤儿包、待重启操作、快照数 pm uninstall package (必填)、 dryRun (必填)、 confirm 、 force 安全卸载。先 dryRun=true 预览影响面,再 dryRun=false, confirm=true 执行:快照 → pnpm remove → 同步 bundles 清单 → 三方对账,失败自动回滚 pm rollback snapshot 、 confirm 回滚依赖状态。不带参数列出快照清单(含 sha256 校验状态);带 snapshot=ID, confirm=true 还原文件并 pnpm install pm status — 待重启确认的操作、快照清单与完整性 pm doctor fix 体检:悬空 bundle、未激活的 bundle 依赖、锁文件不一致、孤儿包、待重启项; fix=true 自动对账 bundles 清单 标准用法 斜杠命令 除了对话指挥 agent,也可以直接敲命令(人机两用): 示例: 使用示例(直接对 agent 说人话) 安装后不需要任何配置—— pm 工具会自动出现在 agent 的工具集里,你只需要在对话里说: 体检: 用 pm doctor 给我的插件做个体检,有问题就修一下 卸载(推荐先预览): 把 dsh-web-ui-all 卸…

分类