dsh-plugin-compat-check 0.1.5 → 0.1.7

package/README.md

@@ -1,63 +1,52 @@
 # dsh-plugin-compat-check
 
-如果你觉得这个项目有用或有趣，欢迎点个 [Star ⭐](https://github.com/lcy0121/dsh-plugin-compat-check) 支持一下！
-
-检查**已安装的 DSH 插件**与目标 DSH 版本的兼容性，提供源码位置、依据及覆盖限制。声明放行、激活成功不等于业务功能正常。
+检查**已安装DSH插件**与目标版本的兼容性，提供源码位置、依据和覆盖限制；声明放行、激活或无发现不等于业务正常。欢迎 [Star ⭐](https://github.com/lcy0121/dsh-plugin-compat-check)。
 
 [简体中文](https://github.com/lcy0121/dsh-plugin-compat-check/blob/main/README.md) | [English](https://github.com/lcy0121/dsh-plugin-compat-check/blob/main/README.en.md) | [한국어](https://github.com/lcy0121/dsh-plugin-compat-check/blob/main/README.ko.md)
 
-**0.1.5** · Node `^22.19.0 || >=24`。提供兼容性标签、插件详情发现/角标、`compat_check` 对话工具和 skill provider。发布与验收记录见 [Plan](https://github.com/lcy0121/dsh-plugin-compat-check/blob/main/docs/Plan.md)。
+**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**，最低版本声明不认证未来宿主。
 
-![插件详情：部分可用、源码位置、影响与依据](https://raw.githubusercontent.com/lcy0121/dsh-plugin-compat-check/main/plugin/assets/compat-detail-partial.png)
+![历史详情页示例，不代表当前制品或业务验收](https://raw.githubusercontent.com/lcy0121/dsh-plugin-compat-check/main/plugin/assets/compat-detail-partial.png)
 
 ## 安装与使用
 
-```bash
+```sh
 dsh plugin --profile <profile> add dsh-plugin-compat-check
 ```
 
-DSH 0.2.1-rc.2：**更多 → 设置 → 内置插件 → 兼容性**。请选择实际 profile，不默认使用 desktop；agent 可调用 `compat_check`。
-
-0.1.5 提供搜索/组合筛选、折叠发现、完整报告预览/显式复制、基线新增风险及“下一步核实”。安装/loader 事件和5秒巡检触发后台刷新，保留筛选与旧报告，失败显示原因。报告显示目标、参考目录版本/摘要和验收范围；重复插件身份无法判定且不推进基线。绑定探针超过5分钟的未来时钟偏差会被拒绝，保留静态发现及原因。分享前须预览敏感信息，筛选不会删减完整报告。
+安装registry可用版本。DSH rc.3入口：**左下角账号菜单→设置→内置插件→兼容性**；选择实际profile，不默认desktop。agent调用`compat_check`，skill指导读取同一报告。
 
-依赖关系区分host/client、必需/可选/子作用域；提供声明仅为候选，路径/环不证明实际故障。人工复核记录单独保存，身份变化后待重审，不隐藏发现或覆盖判定、基线及豁免。健康面板**只导入历史 JSON**，不运行检查，历史通过不证明当前制品正常。步骤见 [使用指南](https://github.com/lcy0121/dsh-plugin-compat-check/blob/main/docs/guide.md)。
+面板支持筛选、折叠、完整报告预览/显式复制及基线新增风险。依赖图仅表示潜在关系，人工记录不改判定，健康页只导入历史JSON；分享前预览，筛选不裁剪完整导出，不自动发帖。[使用指南](https://github.com/lcy0121/dsh-plugin-compat-check/blob/main/docs/guide.md)说明操作和预算。
 
 ## 升级前兼容性预检
 
-在面板输入目标 DSH 版本后运行，或调用 `compat_check({"upgradeTo":"0.2.1-rc.2"})`，需要时指定实际 `profile`；当前版本取自运行中的宿主。结果放在独立 `upgradePreview`，不覆盖普通 `report`。
-
-当前/目标两端仅支持精确 **0.2.0-rc.2、0.2.1-rc.2**。未知版本或范围返回 `status=unsupported-version`、退出3，不回退到邻近目录。对同一组插件私有字节副本静态提取，再按两端目录/声明独立判定，保留制品哈希、目录来源/摘要、当前/目标报告、差异和覆盖限制。worker有预算、卸载取消与清理，失败明确报错；不是 OS 原子快照。
+输入目标版本或调用`compat_check({"upgradeTo":"0.2.1-rc.3"})`；当前版本取宿主，返回upgradePreview、普通report为null。三个登记精确版本可任意比较，未知版本/范围退出3，不借邻近目录认证。
 
-预检不执行插件或安装/升级宿主，不读运行时、探针、profile豁免、普通缓存/基线，不写产品状态。结果码 **0/1/2** 仅表示无新增/变重风险、非致命新增/变重、含致命新增/变重；**3** 为不可用。目标已有问题仍见 `targetReport`；**0不代表目标可用或升级后业务通过**，客户端功能需另验收。[契约及复现](https://github.com/lcy0121/dsh-plugin-compat-check/blob/main/docs/Plan.md#27-升级前静态预检契约)。
+只静态比较同组私有字节，不安装/升级宿主或使用运行时、probe、豁免、普通缓存/基线。**0/1/2表示无/非致命/致命新增或变重风险，3表示无法预检**；0仍可有旧问题。[完整契约](https://github.com/lcy0121/dsh-plugin-compat-check/blob/main/docs/Plan.md#27-升级前静态预检契约)。
 
 ## 从源码构建安装
 
-仓库根是 private 开发工作区，不是可激活的插件包。在根安装依赖，再打完整 tgz：
+根是private工作区，检出main或所需版本后构建完整tgz：
 
-```bash
+```sh
 npm ci --ignore-scripts
 cd plugin
 npm pack --pack-destination <已存在的绝对输出目录>
 dsh plugin --profile <临时profile> add file:<生成的tgz绝对路径>
 ```
 
-prepack 同步权威 skill/报告契约，暂存共享 kernel、LICENSE 和第三方说明，postpack 清理 kernel。根 GitHub spec、裸 `plugin/` 复制和源码 file 安装不能代替完整 tgz。
+prepack同步skill/契约并暂存内核、LICENSE和第三方说明，postpack清理内核。根GitHub spec、裸plugin复制或源码file安装不代替完整tgz。
 
-npm 包**没有 CLI bin、安装检查 shell 或 probe 入口**，不支持 `npx dsh-plugin-compat-check`。CLI、安装检查、静态批量、作者CI、健康执行器及真实插件/浏览器/模型回归仅在[仓库](https://github.com/lcy0121/dsh-plugin-compat-check#readme)使用，不随 npm 分发。
-
-安装检查会联网、启动宿主并执行目标；临时 profile 不是 OS 沙箱。健康执行器默认审阅，须显式 `--run` 及当次授权才执行目标命令，也不是 OS 沙箱。风险/覆盖门禁、JSON/SARIF/JUnit和版本矩阵见[作者CI](https://github.com/lcy0121/dsh-plugin-compat-check/blob/main/docs/author-ci.md)。
+npm包**没有CLI bin**，不支持`npx dsh-plugin-compat-check`。CLI、安装检查、静态批量、[作者CI](https://github.com/lcy0121/dsh-plugin-compat-check/blob/main/docs/author-ci.md)和健康执行器从仓库运行；安装/probe-boot/健康run会执行目标，须相应授权，临时profile不是OS沙箱。
 
 ## 判定与边界
 
-- 当前 profile 只采样服务描述符，不执行 getter，结合可靠映射且启用的 loader FAILED/PENDING。其它 profile 仅用静态证据，不借用当前宿主服务；未知、未采样或省略键不等于缺失。
-- Babel AST/包内值流在有时间/内存限额的 worker 中分析，不执行目标源码，动态覆盖仍有限。必需 inject 激活障碍与方法失效分别判断。
-- 保留 `certainty`、`impactBasis`、`coverage`、`vacuous`。API 发现通常有 `file:line`，声明/loader事实可能无位置；无发现不证明业务正常。
-- 声明规则与精确版本豁免依据目标 DSH 判定；非法字段不可豁免。普通检查的未知/未来版本回退及自定义目录保持未认证提示，内置目录摘要不符则无法判定。升级预检严格限定上述两个版本。[目录治理](https://github.com/lcy0121/dsh-plugin-compat-check/blob/main/docs/maintaining.md#api目录候选审查)须经来源核验、差分、规则复核及真实验收。
-- 宿主体检不装包、不调用外部命令或联网，默认写自身隔离基线；不完整扫描不推进。普通检查需禁基线读写时使用仓库 CLI 的 `--no-baseline`；升级预检始终隔离基线。
-- 报告保留完整发现、覆盖、观测与基线；面板拒绝损坏/不支持版本的负载。旧 probe 提示未绑定，旧基线中性重建。
+保留certainty、impactBasis、coverage和vacuous。未观测不等于缺失，描述符采样不执行getter；其它profile不借当前宿主服务。动态分析覆盖有限，源码位置须真实，客户端业务另验收。
+
+普通体检写自身隔离基线，不完整扫描不推进；坏/旧基线保留原件，no-baseline禁读写。人工处置不授予豁免。rc.2/rc.3参数参考、弃用及生命周期提醒不证明实测失败/泄漏，不新增致命语义规则。
 
-已有 macOS/Linux 限定验证，Windows 待真实验收；固定样本不是生态准确率或完整业务/模型质量认证。[计数与证据](https://github.com/lcy0121/dsh-plugin-compat-check/blob/main/docs/current-state.json) · [完整契约](https://github.com/lcy0121/dsh-plugin-compat-check/blob/main/docs/Plan.md#2-现行判定与集成契约) · [源码及问题反馈](https://github.com/lcy0121/dsh-plugin-compat-check)。
+[Plan](https://github.com/lcy0121/dsh-plugin-compat-check/blob/main/docs/Plan.md)维护契约和待办，[维护指南](https://github.com/lcy0121/dsh-plugin-compat-check/blob/main/docs/maintaining.md)说明目录认证。macOS/Linux仅有[限定证据及实际发布记录](https://github.com/lcy0121/dsh-plugin-compat-check/blob/main/docs/current-state.json)，Windows未真实验收，历史结果不认证新制品。
 
 ## License
 
-[MIT](https://github.com/lcy0121/dsh-plugin-compat-check/blob/main/LICENSE) · 第三方依赖及许可证见 [THIRD_PARTY_NOTICES.md](https://github.com/lcy0121/dsh-plugin-compat-check/blob/main/THIRD_PARTY_NOTICES.md)，两份文件也随 npm 包提供。
+[MIT](https://github.com/lcy0121/dsh-plugin-compat-check/blob/main/LICENSE) · [THIRD_PARTY_NOTICES.md](https://github.com/lcy0121/dsh-plugin-compat-check/blob/main/THIRD_PARTY_NOTICES.md)，两者随npm包提供。

package/THIRD_PARTY_NOTICES.md

@@ -12,6 +12,7 @@ This inventory covers the production and development npm closure in the reposito
 | --- | --- | --- |
 | [`@babel/parser`](https://www.npmjs.com/package/@babel/parser/v/7.29.9) | 7.29.9 | MIT |
 | [`semver`](https://www.npmjs.com/package/semver/v/7.7.3) | 7.7.3 | ISC |
+| [`yaml`](https://www.npmjs.com/package/yaml/v/2.9.1) | 2.9.1 | ISC |
 
 ### Transitive runtime dependencies
 
@@ -27,7 +28,6 @@ These packages support repository-only tools and are not declared as npm plugin
 
 | Package | Locked version | License |
 | --- | --- | --- |
-| [`yaml`](https://www.npmjs.com/package/yaml/v/2.9.1) | 2.9.1 | ISC |
 
 ## Development-only dependencies