SuperAPI AI 工具集

plugin-upgrade

部署与运维

查看项目

更新于 10-16 02:36

技能介绍

用途:处理 DSH 插件的三类任务——只读更新检查(Mode A)、已安装插件升级(Mode B)、插件源码随 DSH 宿主升级的迁移(Mode C)。用户意图不明确时先确认模式,避免把“帮我看看有没有更新”变成安装或改代码。不处理“只升级 DSH 核心而不管插件”,也不得修改 DSH 核心来掩盖插件不兼容。

主要能力:区分源码身份与安装身份(registry 包、Git checkout、workspace/junction、复制安装),记录 Git SHA、包名、插件版本、DSH 依赖队列与当前 DSH/Node 版本;按 package.json/lockfile、dsh-plugin.json、cordis.patch.yml 等文件边界保留所有权;核对目标版本来源、兼容范围、发布说明与破坏性变更;记录回滚基线。

使用方式:Mode A 只读调查并报告版本、兼容范围、破坏性变更、风险与验证计划,不改文件、不装依赖、不跑生命周期脚本。Mode B 按已解析的包身份选择唯一更新机制,有 lockfile 时只用其包管理器,先出变更计划并取得明确确认,再在专用分支/工作树做最小改动,验证目标 profile 组合确实解析到目标包。Mode C 先在仓库自身依赖状态跑基线(build/typecheck/tests,需先展示命令并确认),把既有失败记为豁免清单;按 references/README.md 的 from→to 元数据连接版本走廊,扫描七类触点,只保留命中的卡片,产出迁移计划并确认后实施,最后单独做插件自身 SemVer 升级。

限制:任何写入、安装、版本获取/切换或包脚本运行前都需展示计划并确认;不自动 stash/reset/clean/强制更新;不暴露凭据;无法高置信判断时标记“待复核”;本地观察与一手来源冲突时两者都记录并复现。全局 DSH 宿主升级(npm install -g @deepseek-ai/dsh@<exact-version>)不能在宿主会话内执行,须在外部终端先完全停止所有 dsh 进程再运行。