用途:审查一个 DSH 插件是否声明与工件一致、对 harness 的引用真实存在、契约坑已规避、文档已同步、验收证据可绑定候选 commit。审查器与生产者职责分离,创建插件时先做设计预检,实现后回来做正式验收。
主要能力:分模式执行。设计预检(写代码前过契约节、事件与 slot 名先溯源)、快速审查(机械+事实+契约,结论带 NOT_VERIFIED)、正式验收(全部检查并绑定候选证据)。机械层 scripts/lint.mjs 覆盖 harness 溯源、package.json、dsh.bundle、exports["."]、dsh.client、client 工件、主题变量、文案与 locale、卫生、文档版本声明;§2 对照 harness 源码逐条核对事件、slot、工具 API、lossless JSON、生命周期与服务。
使用方式: node skills/dsh-plugin-lint/scripts/lint.mjs <插件目录> --harness-root <DSH 源码仓库> node skills/dsh-plugin-lint/scripts/test-lint.mjs 需要 Node ≥ 18.6,无第三方依赖。harness 根解析优先级为 --harness-root 参数、环境变量 DSH_HARNESS_ROOT、config/harness-path.local.yaml;三者皆缺时版本相关检查标 NOT_VERIFIED。--json 追加 DSH_LINT_JSON{...},退出码等于 FAIL 数。配套有报告模板 templates/plugin-quality-report.md。
适用场景:自查与发布前验收 DSH 插件,核对契约、主题变量与 locale 一致性,绑定 commit、boot 与浏览器渲染证据。
限制:正则级解析不构建 AST,复杂 patch、嵌套词典、非扁平 locale 转人工;bare builtin require 只能人工确认;CJK 检测为启发式;平台模块表、纯度正则、主题变量集等运行时读取,不预置版本;不自动执行目标仓库 build/test;harness 溯源需本地 DSH 源码仓库。HMR 边界等为历史结论,须按版本复核。