omdsh-dev/dsh-plugin-check11

@deepseek-ai/dsh-plugin-check

DSH 插件健康检查器:扫描插件仓库的清单协议、构建缺陷及注册合规性

AI 分析

提供零依赖的只读诊断工具,用于扫描和验证 DSH 插件的合规性与潜在构建问题。适合插件开发者在发布或调试本地插件时进行静态健康检查。

套件
@deepseek-ai/dsh-plugin-check
版本
0.0.1
授權
MIT
最近更新
2026年8月14日

安裝

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:omdsh-dev/dsh-plugin-check

一次性任务(headless)profile —— dsh run 默认使用 headless

dsh plugin --profile headless add "C:/path/to/dsh-plugin-check"


包内 `dsh.bundle.patch` 会在安装后自动把插件加入 profile 的 layer stack(row id:`tool-plugin-check`)。插件缺失的 peer 依赖(`cordis`、`@deepseek-ai/dsh-tools`)由 profile 的 healed `profiles/node_modules` 回退安装提供。

> ⚠️ web 与 headless 是**不同 profile**:web 安装不会自动覆盖 headless;`dsh run` 默认使用 headless profile。Windows 路径使用正斜杠(`C:/...`)。

### 验证安装

```sh
dsh --profile web --dump-config | grep tool-plugin-check

运行验证

dsh run "使用 plugin_check 工具检查一个插件仓库"

手动安装与旧版本兼容

仅适用于不支持 Profile Bundle 的旧快照或插件开发调试环境(本地 junction/symlink、手动编辑 profile 层)。

测试

node /node_modules/vitest/vitest.mjs run tests   # 38 用例
  • manifest.spec.ts / patch.spec.ts / build-check.spec.ts:每项检测的命中与不误报(fixtures 临时目录生成)
  • report.spec.ts:verdict 判定(含 strict 升级)、suggestions 模板、hub-skipped 不升级
  • register.spec.ts:注册契约(AUDIT-CROSS-02 风格)

自检基线(2026-08-08 实测)

组织内 8 个插件(time/encoding/json/calculator/csv/regex/markdown/session-health)全部 pass、零 error、零 warning。检查过程发现并修复了 4 个旧插件的真实合规缺陷(tsconfig 缺三件套——重建会产生坏产物;缺 build/prepack scripts)。

许可

MIT