跳到正文
  • 首页
  • 插件说明
  • dsh-plugin-check

omdsh-dev/dsh-plugin-check

210最近提交 2026年8月14日

dsh-plugin-check DSH 插件

dsh-plugin-check 扫描插件仓库，检查清单协议、patch 格式、构建陷阱和生态合规性，输出合规报告（含错误、警告和建议）。工具为只读，不修改或构建被检查仓库。

developer-toolsskills-workflows

如何安装 dsh-plugin-check DSH 插件

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

复制不会执行命令。安装 dsh-plugin-check DSH 插件前请核对仓库和版本。

dsh-plugin-check DSH 插件数据来源

dsh-plugin-check DSH 插件快照日期：2026年8月16日

discovered

dsh-plugin-check DSH 插件能做什么

  • 检查清单协议（manifest 缺失、名称无效、缺少 main/types、无 patch 等）
  • 验证 patch 格式（格式错误、名称不一致、row id 重复等）
  • 检测构建陷阱（无 source entry、无 tsconfig、缺少 ts 扩展导入、产物布局不匹配、残留 ts 导入等）
  • 评估生态合规性（核心 row id、缺少 profile 安装示例、仅手动安装、需修改核心等）
  • 检查 hub 收录状态（未收录标记为 warning，hub 检查失败降级为 info）
  • 支持单仓库检查、递归扫描和输出 schema 三种模式

dsh-plugin-check DSH 插件适合哪些场景

  • 插件作者在提交前进行自检，确保合规
  • CI 流程中作为门禁，自动拦截不合规的插件仓库
  • 批量扫描指定目录下的所有插件仓库，生成汇总报告
  • 学习 DSH 插件常见陷阱和最佳实践

dsh-plugin-check DSH 插件适合谁

  • DSH 插件作者和维护者
  • CI/CD 工程师集成插件质量门禁
  • 插件仓库管理员

dsh-plugin-check DSH 插件的限制

  • 只读，不修改或构建被检查的仓库
  • 构建陷阱检测基于静态文本扫描，而非运行 tsc
  • hub 收录检查依赖本地 hub 目录（DSH_HUB_SOURCE 或 cwd/hub/）或 GitHub API，失败时静默降级为 skipped
  • 仅支持本地文件系统路径，不支持远程仓库 URL

dsh-plugin-check DSH 插件的仓库 README 摘录

以下文字摘自 dsh-plugin-check DSH 插件的上游仓库 omdsh-dev/dsh-plugin-check 的 README，版权归原作者，仅作引用。

DSH 插件健康检查工具 —— 扫描插件仓库，诊断**清单协议 / patch 格式 / 构建陷阱 / hub 收录状态**，输出合规报告与修复建议。**只读**，不修改、不构建被检查仓库。 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) ## 动机 组织内插件仓库持续增长，作者踩过的坑（cordis 双副本、tsconfig 三件套、patch name 不一致、产物 `.ts` 残留——运行时必崩）本可以自动化拦截。本工具把全部实测踩坑变成**可自动检查的门禁**：模型或 CI 直接对仓库目录跑一次 `plugin_check`，拿合规报告与修复建议。 ## 安全模型 - **只读**：仅 `readdir/stat/readFile`，绝不修改或构建被检查仓库 - **零业务依赖**：仅 node 内置模块（fs/path/child_process） - **hub 检查离线优先**：先读本地 hub catalog（`DSH_HUB_SOURCE` 或 cwd/hub/ 下），gh 调用作 fallback；全部失败静默降级 `skipped`（报告如实标注，不算警告） - **不执行 tsc**：构建陷阱全部静态文本扫描（快、无副作用） ## 工具声明 注册 `plugin_check` 工具（`@deepseek-ai/dsh-plugin-check`，row id `tool-plugin-check`），统一输出 JSON 文本。 | 参数 | 类型 | 必填 | 说明 | |---|---|---|---| | `action` | string | ✅ | `check` / `scan` / `schema` | | `path` | string | | 插件仓库目录（check）或父目录（scan）；默认当前工作目录 | | `strict` | boolean | | strict 模式：warning 升级为 error 影响 verdict，默认 false | ## Actions | action | 功能 | |---|---| | `check` | 检查单个插件仓库目录 → 合规报告（verdict/errors/warnings/suggestions） | | `scan` | 扫描父目录下所有 `dsh-*` 插件仓库（有 package.json 者）→ 汇总报告 | | `schema` | 输出全部检测项清单与判定标准（按形态适用的检测项矩阵，供模型/人核对） | ## 形态识别与检测项（按形态适用，33 项） | 类别 | error | warning | |---|---|-

阅读完整 README仓库许可: MIT

dsh-plugin-check DSH 插件常见问题

如何安装 dsh-plugin-check？

推荐通过 Profile Bundle 安装：`dsh plugin --profile web add github:omdsh-dev/dsh-plugin-check`（web 配置文件）或 `dsh plugin --profile headless add github:omdsh-dev/dsh-plugin-check`（headless 配置）。你也可以本地构建后用 `npm pack` 生成 tarball，然后运行 `dsh plugin --profile <profile> add <tarball 路径>` 安装。

这个工具检查哪些内容？

它检查四个方面：清单协议（如缺失 manifest、名称无效、缺少 main/types）、patch 格式（如格式错误、名称不一致、row id 重复）、构建陷阱（如无 tsconfig、缺少 ts 扩展导入、产物布局不匹配）和生态合规性（如核心 row id、缺少 profile 安装示例、仅手动安装）。还会检查 hub 收录状态。

这个工具安全吗？会不会修改我的插件仓库？

请放心，工具是只读的。它只会执行 readdir、stat 和 readFile 操作，不会修改或构建仓库，也不会运行 tsc。所有检查都是静态文本扫描，无副作用。

我可以在 CI 中使用这个工具吗？

可以，工具专为 CI 集成设计。使用 action `check` 检查单个仓库，或 `scan` 扫描目录。输出为 JSON 格式报告，CI 流水线可以解析结果来实施插件质量门禁。

如何验证安装是否成功？

安装后运行 `dsh --profile <profile> --dump-config | grep tool-plugin-check`，确认插件 row 已注册。然后可以用一个示例命令测试：`dsh run "使用 plugin_check 工具检查一个插件仓库"`。