📦 bundle-lint — DSH 插件 bundle 结构校验器 + awesome 收录预检

Overview

发布 DSH 插件前，校验 bundle 三件套（cordis.patch.yml / package.json dsh 配置 / 入口）是否自洽。规则：

• BND-001 cordis.patch.yml 存在且可解析（insert 结构完整）
• BND-002 package.json dsh 插件配置完整（plugin:true / kind / bundle.patch）
• BND-003 files 清单覆盖 cordis.patch.yml 与入口（npm 发布后 bundle 不丢）
• BND-004 入口文件存在（main / exports 指向的文件）
• BND-005 bundle id/name 与 package name 一致（装进去的包名对得上）
• BND-006 结构符合 DSH STANDARD（关键词标识便于生态发现）
• BND-007 插件 name 导出与包名一致（防复制遗留导致身份错乱）

v2.0 新增 awesome-lint（对齐 awesome-dsh-plugin 2026-08-17~08-24 规则变更）：

• AWD-001 条目文件名必须 .yml（官方 readEntries 只读 *.yml，#2495/#2140 教训）
• AWD-002 category 必须在官方枚举内（含 08-20 新增 identity/communication）
• AWD-003 url 指向路径须存在（monorepo 子包指向子目录）
• AWD-004 条目文件拒绝未知字段（官方只认 url/name/category/description/tarball）
• AWD-005 description 只允许 en/zh（官方 08-19 起拒绝不渲染 locale）
• AWD-006 描述卖点词（trust/verify/audit/security）须有边界声明（fkysly 审阅标准）
• AWD-007 README 边界声明（非安全保证/服务方可见/实验性）应体现在条目描述
• AWD-008 仓库须添加 dsh-plugin topic

Usage

python3 scripts/bundle-lint.py --dir <插件目录> --format text   # 终端报告
python3 scripts/bundle-lint.py --dir <插件目录> --format json   # JSON 报告
python3 scripts/awesome-lint.py --entry <条目yml> --dir <插件目录>   # awesome 收录预检（本地）
python3 scripts/awesome-lint.py --entry <条目yml> --github <owner/repo>  # 含远程仓库检查

输出（JSON 摘要）

{
  "score": 100,
  "conclusion": "PASS",
  "issues": [
    { "rule": "BND-001", "severity": "high", "found": "...", "recommendation": "..." }
  ]
}

与其他工具的关系

• skill-compliance：内容合规（披露/免责/红线）
• dependency-scan：依赖供应链
• malware-scan：恶意代码
• bundle-lint：bundle 结构（"装得进去"的前置检查）
• awesome-lint：awesome-dsh-plugin 收录规则（"不被审阅打回"的前置检查）