⚙️

dsh-upgrade-guard

工作流更新于 2026.10.18

在终端中运行以下命令：

dsh plugin install wqx11235/dsh-upgrade-guard

将以下提示词粘贴到 DeepSeek Harness 对话框中：

在 DeepSeek Harness 终端执行 dsh plugin install wqx11235/dsh-upgrade-guard，或按官方插件安装流程从 https://github.com/wqx11235/dsh-upgrade-guard 安装后重启宿主并硬刷新页面。

插件介绍

DeepSeek Harness 发版很快，每次升级都可能收紧插件依赖的契约：服务名被移除、会话消息格式变更、ui-primitives 导出改名……同类事故反复出现，往往表现为「一升级、一片插件挂掉」或整页无法加载。

dsh-upgrade-guard 把历次事故沉淀成可复用的检查。升级前可用 Preflight 对照各插件声明的兼容范围与 npm 最新版，判断能否升到目标版本、哪些要一起动、哪些建议先停用。升级后或随时可做 Contract scan，在秒级内对照已知破坏性契约目录扫描已装插件。真正切换端口前，Boot smoke 会在测试端口拉起临时宿主，读取启动摘要并探测各客户端 bundle 是否可达，不通过就别切。

插件刻意不依赖 @deepseek-ai/* 包、不写死机器路径，并兼容 web 与官方桌面端；契约规则随新事故追加，越用越准。适合经常跟进 dsh 新版本、维护较多插件、或曾在升级后踩过批量 pending / 加载失败的人。

需要心里有数：冒烟只覆盖启动阶段，渲染期问题要靠契约扫描；扫描只覆盖目录里已收录的规则；Preflight 需要能访问 npm，git/url 安装的插件需人工核对；打包桌面运行时冒烟会标明不支持。