dsh-plugin-check: A Plugin Health Check Tool for DeepSeek Harness
omdsh-dev/dsh-plugin-check
DSH plugin health checker that scans plugin repos for manifest protocol, patch format, build pitfalls, and hub status, outputting compliance reports.
Provides compliance scanning for DeepSeek Harness DSH plugins, diagnosing manifest protocol, patch format, build pitfalls, and hub inclusion status, with fix suggestions.
dsh plugin --profile web add github:omdsh-dev/dsh-plugin-check- Category
- Development & Operations
- Platform
- DSH-Plugin
- Author
- omdsh-dev
- Distribution
- Plugin
dsh-plugin-check Key Features
dsh-plugin-check Repository
dsh-plugin-check Repo Summary
dsh-plugin-check is a plugin health check tool for DeepSeek Harness (DSH), maintained by omdsh-dev, licensed under MIT, and last updated in 2026-08. It scans plugin repositories to diagnose manifest protocol, patch format, build pitfalls, and hub inclusion status, outputting compliance reports and fix suggestions. The tool is read-only, never modifying or building the checked repository, with zero business dependencies (only Node built-in modules), ensuring safety and no side effects. Its core capability is registering the plugin_check tool, supporting three actions: check, scan, and schema, covering 33 check items applied per plugin kind (registry, skill, collection, tool-bundle, etc.), and producing a verdict (pass/fail/warn).
What core actions does the dsh-plugin-check DSH plugin support?
The plugin_check tool provides three actions: check inspects a single plugin repository directory and outputs a compliance report (verdict, errors, warnings, suggestions); scan scans all dsh-* plugin repositories (those with package.json) under a parent directory and aggregates reports; schema outputs the full list of check items and criteria for model or human review. Parameters include action (required), path (defaults to current working directory), and strict (upgrades warnings to errors affecting verdict).
How does dsh-plugin-check ensure safety and compatibility?
The plugin is read-only, only performing readdir/stat/readFile, never modifying or building the checked repository; hub checks are offline-first, reading local catalog (DSH_HUB_SOURCE or cwd/hub/) with gh calls as fallback, and silently degrade to skipped on total failure. Build pitfalls are all statically scanned from text, no tsc execution, fast and side-effect-free. The plugin has migrated to the npm 0.1.0-rc.6 dependency line and has been fully validated in an isolated consumer of @deepseek-ai/[email protected], no longer depending on unscoped cordis.
How to install dsh-plugin-check?
It is recommended to install via Profile Bundle into a profile (DSH 0.1.0-rc.6 npm). The bundled dsh.bundle.patch automatically adds the plugin to the profile's layer stack (row id: tool-plugin-check), and missing peer dependencies are provided by the profile's healed profiles/node_modules fallback installation.
dsh plugin --profile web add github:omdsh-dev/dsh-plugin-check
What categories of check items does dsh-plugin-check have?
Check items fall into five categories: manifest protocol (e.g., no-manifest, invalid-name, missing-main-or-types), patch format (e.g., malformed-patch, patch-name-mismatch, duplicate-row-id), build pitfalls (e.g., no-source-entry, no-tsconfig, missing-ts-ext-imports), ecosystem compliance (Profile Bundle, e.g., core-row-id, missing-profile-install-example), and hub inclusion (not-in-hub). Verdict rules: 0 errors → pass, any error → fail, only warnings → warn.
What are example outputs of dsh-plugin-check?
For instance, plugin_check { action: "check", path: "C:/Users/admin/Desktop/dshext/dsh-tool-csv" } returns {"repo":"dsh-tool-csv","kind":"tool-bundle","verdict":"pass","checks":{"total":24,"passed":24,...}}; the scan action returns root, scanned count, and report list, with non-compliant repositories carrying errors and suggestions.