dsh-plugin-compat-check

dsh-plugin-compat-check

检查已安装的DSH插件与目标版本的兼容性，提供源码位置、依据和覆盖限制。声明放行、激活或无发现不等于业务正常。欢迎 Star ⭐。

简体中文 | English | 한국어

版本与入口

0.1.7 提供rc.3适配、升级预检、参数语义与边界加固。Node ^22.19.0 || >=24，宿主声明 >=0.2.0-rc.2；已认证精确目录仅 0.2.0-rc.2、0.2.1-rc.2、0.2.1-rc.3，最低版本声明不认证未来宿主。

npm插件提供兼容性页、详情/角标、compat_check与skill。仓库另有CLI、安装检查、静态批量、作者CI和健康执行器，共享内核。npm包无CLI bin，不支持npx dsh-plugin-compat-check。Plan维护契约与待办，docs/current-state.json记录限定验证。

界面示例

历史截图展示呈现方式，不代表当前源码或业务已验收：

安装与使用

dsh plugin --profile <profile> add dsh-plugin-compat-check

DSH 0.2.1-rc.3：左下角账号菜单 → 设置 → 内置插件 → 兼容性。选择实际profile，不默认desktop；agent可调用compat_check。面板支持筛选、折叠、完整报告预览/复制和基线新增风险；依赖图仅表示潜在关系，人工记录不改判定，健康页只导入历史JSON。使用指南说明操作与限制。

仓库CLI

仓库工具从源码运行：

git clone --branch main https://github.com/lcy0121/dsh-plugin-compat-check.git
cd dsh-plugin-compat-check
npm ci --ignore-scripts
node bin/compat-check.mjs --nm ~/.dsh/profiles/<profile> --no-baseline
node bin/compat-check.mjs --help

选项	作用
--nm <dir>	目标profile或node_modules；必需
--dsh-version <v>	目标DSH版本；预检中为当前版本
--probe <json> / --probe-boot	读取观测 / 经授权启动临时宿主
--json / --quiet	完整JSON / 总结行
--no-baseline / --dry-run	禁读写基线 / 比较但不写
--baseline-file <path>	自定义基线位置
--issue-report	可分享Markdown；预览后自行分享
--rules <json> / --catalog <json>	覆盖规则 / 参考目录
--help / --version	完整帮助 / 工具版本

静态检查不执行目标或联网，普通检查写自身基线；no-baseline禁读写，不完整扫描不推进。probe-boot/安装检查会执行目标，须相应授权；临时profile不是OS沙箱。

升级预检与作者工具

面板输入目标版本，或调用compat_check({"upgradeTo":"0.2.1-rc.3"})；agent当前版本取宿主，结果为upgradePreview。CLI须提供两个精确版本：

node bin/compat-check.mjs --nm ~/.dsh/profiles/<profile> --dsh-version 0.2.1-rc.2 --upgrade-to 0.2.1-rc.3 --json

三个精确版本可任意比较，未知版本退出3。只静态比较同组私有字节，不升级/执行宿主或借用probe、豁免、普通基线。0/1/2表示无/非致命/致命新增或变重风险，3表示无法预检；0仍可有旧风险。见契约。

作者CI提供矩阵、门禁及JSON/SARIF/JUnit/HTML；指南提供静态批量。健康执行器默认review，run须授权。另见skill与完整tgz构建。

结果与验证

普通退出码：0未发现冲突、1部分可用或未知、2不兼容、3工具/输入错误。保留certainty/impactBasis/coverage/vacuous，未观测不是缺失；坏基线保留原件。客户端业务另验收，分享前预览，导出不自动发帖。

npm test
npm run check
node plugin/scripts/prepublish-check.mjs
node tools/meta-check.mjs --json

默认测试不启动真实DSH/模型，打包回归需要registry；check核对格式、文档/生成副本、语法与目录。发布前检查不发布；元数据核验需gh/npm和网络，取数失败不算通过。macOS/Linux仅有记录范围内证据，Windows未真实验收。

规则 · 维护与目录治理 · 当前证据。

License

MIT · 第三方依赖与许可证。