本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-plugin-check

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:omdsh-dev/dsh-plugin-check

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 只读：仅 readdir/stat/readFile，绝不修改或构建被检查仓库
• 零业务依赖：仅 node 内置模块（fs/path/child_process）
• hub 检查离线优先：先读本地 hub catalog（DSH_HUB_SOURCE 或 cwd/hub/ 下），再通过 gh 读取公开 omdsh-dev/dsh-hub-workshop/catalog.json；兼容 dsh-hub-index/v0.4 与旧 repos[].name；全部失败静默降级 skipped（报告如实标注，不算警告）
• 不执行 tsc：构建陷阱全部静态文本扫描（快、无副作用）
• core-row-id：patch 条目使用官方核心 row（tools/session/llm/web/permission）；

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件是干什么用的？

用来对 DSH 插件仓库做健康检查，按形态（registry / skill / collection / bundle / tool-bundle / unknown）分流，输出含 verdict、errors、warnings、suggestions 的合规报告，并附带修复建议。

它会修改或构建被检查的仓库吗？

不会。安全模型为只读，仅使用 readdir/stat/readFile 等 Node 内置 API；构建陷阱全部通过静态文本扫描识别，不执行 tsc，不会留下任何副作用。

提供的 plugin_check 工具有哪些 action？

三个：check 检查单个仓库目录、scan 扫描父目录下所有 dsh-* 插件仓库并汇总、schema 输出全部检查项与按形态适用矩阵。

strict 参数有什么用？

开启后所有 warning 会升级为 error 影响 verdict。默认 false；CI 门禁场景建议设为 true。

它如何判断仓库被收录进 hub？

优先读本地 hub catalog（DSH_HUB_SOURCE 环境变量或 cwd/hub/ 下），失败再通过 gh 命令读取公开的 omdsh-dev/dsh-hub-workshop/catalog.json；全部失败时静默降级为 skipped，不会误报。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.1-rc.1+（peerDependencies 锁定 dsh-tools / dsh-invariants 在 0.0.1-rc.1–0.2.0；cordis ^4.0.1）
• Node: ^22.19.0 || >=24.0.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则