v0.5.4 preview

dsh-dragon-control 0.5.4 preview

Windows x64 only. 本次只改宿主兼容声明，不动任何动作、权限或审计逻辑。

修了什么

DSH Desktop 0.2.1 起在装载期校验插件的 engines.dsh。0.5.3 把它精确钉在 0.2.0-rc.2，于是升级到 0.2.1-rc.2 之后宿主直接跳过整个 bundle：

dsh: skipping profile bundle "dsh-dragon-control": Error: Plugin dsh-dragon-control@0.5.3
is incompatible with dsh 0.2.1-rc.2: requirements {"engines.dsh":"0.2.0-rc.2"}.

跳过是静默的（只有启动 stderr 一行，界面没有任何提示），表现是插件行和两个工具一起消失。0.5.4 把范围放宽为：

"engines": { "node": ">=24", "dsh": ">=0.2.0-rc.2 <0.2.2-0" },
"peerDependencies": { "@deepseek-ai/dsh-tools": ">=0.2.0-rc.2 <0.2.2-0" }

为什么放宽是安全的

• 插件对宿主 API 的依赖只有一处：index.mjs:59 动态导入 @deepseek-ai/dsh-tools 的 validateJsonSchemaValue。在 0.2.1-rc.2 的安装包里该导出仍然存在（已核对打包的 dsh-tools/lib/index.js）。
• 在 0.2.1-rc.2 宿主上实测：插件行正常装载，dragon_browser / dragon_desktop 注册成功，启动无插件错误。
• @deepseek-ai/cordis 的 peer（~4.0.4）未变。

验证

• 本地：npm run check（54 个模块语法检查）、npm test（80/80 通过）、npm run pack:local（73 个文件，tgz sha256 e7ad87547829a4004445ee47f7821935851bcb0ea98f2f2a35ba7db86522895b）。
• CI：以本 tag 触发的 GitHub Actions 结果为准，本地检查不替代 CI。
• 尚未覆盖：真实窗口的 Windows UI 自动化回归（混合 DPI、多显示器、管理员窗口矩阵、物理 Esc）仍按 PUBLISHING.md 的稳定版前清单，由人工验收记录。

安装

dsh plugin --profile desktop add C:\path\to\dsh-dragon-control-0.5.4.tgz

或从 Release 资产下载 tgz 后安装。