安装认证数据接口
单插件安装验证等级查询（L5 冒烟优先、退回 L4 沙盒安装）。一次只查一个插件。
接口地址
| URL | 说明 | 更新 |
|---|---|---|
/data/install/@作者/插件名.json | 单插件安装验证结果（L5 冒烟优先、退回 L4）——passed / failed / unknown / stale / untested 五态、verified 标记与证据元数据 | 随站点构建重建（记录只追加） |
/data/install.schema.json | 安装接口对应的 JSON Schema | 随字段新增更新 |
JSON 接口支持跨域读取：Access-Control-Allow-Origin: *，无需 API Key 或注册。
安装验证状态
单插件安装验证（L5 冒烟优先、退回 L4 沙盒安装），构建时从只追加的验证记录派生。「当前 dsh 版本上最新真测获胜：有 L5 真测取 L5，否则取该版本最新 L4」——后续聚焦运行把某层留成未测时，绝不掩盖更早的判定；仅有旧版本判定时如实返回并标记 stale。
| 状态 | 含义 |
|---|---|
passed | 安装命令在隔离沙盒内成功运行且无依赖错误（level=L4）；若 L5 冒烟也通过则为 level=L5 的安装已验证 |
failed | 沙盒内实际执行安装/冒烟且失败——记录为质量信号，供安装决策参考 |
unknown | 有记录但无法得出结论（保持未知，不悄悄升级） |
stale | 判定来自旧 dsh 版本——历史保留但当前无效，待复测（此时 installTest.staleVersion=true） |
untested | 无安装验证记录——通常因为没有可解析的安装命令（L2 未通过）或待补扫。未实测不等于失败。 |
响应字段
| 字段 | 类型 | 语义 |
|---|---|---|
schema | string | 校验该记录的 JSON Schema 绝对地址 |
id | string | 插件 id（与 plugins.json 的 id、artifact slug 一致） |
name | string | 插件展示名 |
installTest.state | passed|failed|unknown|stale|untested | 派生的安装验证状态（见上方状态表） |
installTest.level | L4|L5 | 供给该判定的运行等级：有 L5 真测即 L5，否则退回 L4；生态插件（装得上但未声明 dsh.bundle、站内显示 L5 · 生态插件）统一报 L5 |
installTest.verified | boolean | true = L5 真测通过（站内唯一计为「安装已验证」的判定） |
installTest.staleVersion | boolean（可选） | true = 判定来自旧 dsh 版本，历史保留、待复测 |
installTest.verdict | passed|failed|unknown（untested 时缺省） | 获胜记录里的原始判定结论 |
installTest.channel | npm|source（可选） | 来自已发布 npm 包还是直接来自 GitHub 仓库 |
installTest.profileId | string（可选） | 产出该结果的验证档案（如 l4-sandbox） |
installTest.checkedAt | string (ISO)（可选） | 获胜记录的采集时间 |
installTest.sourceRecordId | string（可选） | 支撑该判定的只追加记录 id（审计溯源） |
installTest.environment | object（可选） | 记载的环境——dshVersion / dshCliVersion / os / arch / adapterId，原样引用，绝不编造。adapterId 标识验证档位（如 dsh-0.1-sandbox），不代表沙箱实现细节 |
links | object | 插件详情、分版本安装徽章 SVG（badgeVersioned，2026-09-20 起插件名级徽章冻结停更）、验证等级页 |
license | object | 数据来源与复用条款——CC BY 4.0（SPDX CC-BY-4.0），需注明来源，再分发须保留新鲜度标记（checkedAt） |
诚实原则：state 为 untested 时省略 verdict / checkedAt / environment，不用默认值填充。
使用方式
查询一个插件（或在浏览器打开 /data/install/@dsh-so/dsh-plugin-finder.json）：
安装实测状态派生自随站点构建打包的只追加沙盒验证记录（spec v1.1）。字段只增不删：既有字段不会移除或改名。JSON 可免费引用，需注明来源 dsh.so；新增字段见 更新日志。