Repository navigation
dsh-plugin-health:在临时 profile 里真装真启动,实测 250 个插件在 DSH 0.2.2-rc.1 上有 68 个跑不起来 #13383
EasonMWS
started this conversation in
Show Your Plugins!
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
TL;DR:用户侧 / 运行时。不改你的 profile、不执行修复,在隔离目录里把插件真装上真启动,记录它注册了什么、卡在等什么服务,产出可复现的报告。附带每日重建的公开兼容表和可复用的 GitHub Action。
仓库:https://github.com/EasonMWS/dsh-plugin-health(MIT)· npm
dsh-plugin-health· 当前 3.2.0(tested on DSH 0.2.2-rc.3)一、它解决的具体问题
DSH 升级后插件被静默丢掉,
stderr上只留一行。这件事在 3.1.1 里被查清了:loadProfileDirectory会把不兼容的 bundle 推进skippedBundles,reportSkippedBundles写一行 stderr,启动 preflight 还会把 patch 层里不兼容的条目禁用掉。问题不是"它还在偷偷加载",而是"它消失了,界面上没有任何地方说清楚是哪个、为什么"。
dsh-plugin-health做的就是把这个"消失"变成可见的:二、实测数据(不是估算)
最近一次全量跑,250 个插件 × DSH
0.2.2-rc.1:失败原因的分布(同一个宿主版本):
顺带产出了 21 条冲突预测——这些插件单独都能启动,但按 profile 里的组合会互相抢。
这些数据每天重建,公开在 https://easonmws.github.io/dsh-plugin-health/ 。
三、三种用法
1. 在 DSH 里看(设置 → 插件健康)
三个按钮切换视图,不再用下拉框:
面板是只读的,扫描本身不写任何东西。修复动作有独立的预览和撤销。
2. 命令行
3. 在 PR 里跑(
action.yml)给插件作者用:宿主版本变了、你的
engines.dsh写窄了、某个版本不兼容,PR 上直接能看到。产出matrix.json+matrix.md+ badge。注意这条是静态的——它解析版本声明和宿主发布历史,不装不启动。真启动是
verify那条路,跑在定时任务里。四、16 种失败原因,分类可过滤
每条失败会归到一个固定的词,页面能翻译、能筛选:
host-contract-changed值得单独说:如果所有官方条目都没报告激活状态,说明是宿主的激活判定变了,报错会指向宿主而不是插件。这个检查依赖 cordis 的FiberState.ACTIVE = 2(const enum,编译期擦除,无法 import),所以它自己也需要被检查。五、我踩过的一个坑,可能对做类似工具的人有用
doctor曾经有一条告警:这条告警是错的,而且它给的建议能把桌面应用弄到起不来。
0.1.7-rc.2到0.2.2-rc.1每一个版本都会在 profile 启动时调installProxyFromEnvironment,它把策略写进自己的环境并安装 undici 全局 dispatcher。NODE_USE_ENV_PROXY只出现在proxyEnvironmentForChild——给子进程的 overlay,宿主自己从来不该有。127.0.0.1:6074,Windows 代理对话框和npm config set proxy都这么写)会让进程直接ERR_INVALID_URL退出,开窗之前。Node 24.19.0 上实测:
3.1.1 把整条检查移除了(#7)。这里想说的是:作者侧工具如果给出会让用户改坏配置的建议,杀伤力比漏报大。
六、边界(它不做什么)
dsh-seam(源码 vs 类型定义,定位到行),两者失败模式不重叠。七、和同类工具的关系
dsh-seam(@YMoose):作者侧 / 编译期。读源码 AST + 比对.d.ts,定位到file:line。dsh-conservative-upgrade(@oldzhang82)、oh-my-dsh/dsh-plugin-upgrade-skill:升级流程与回退手册。dsh-plugin-health(本项目):用户侧 / 运行时。真装真启动。八、近期版本
verify、失败原因分类、启动试运行 Pipeline、兼容表加实测结果和升级预测。九、反馈
在 https://github.com/EasonMWS/dsh-plugin-health/issues 提 issue。跑出误报或漏报都欢迎——假告警比没有告警更糟,上面那一节就是例子。
如果你在做插件,只想问一句"我的插件在下一个 DSH 上还能不能起来",
npx dsh-plugin-health verify --plugins <你的包名> --out ./out是最省事的入口。All reactions