DeepSeek Harness Plugin

863683348/dsh-plugin-recommend

Stars ★ 0 Downloads (30d) 678 Category Plugin Markets & Managers Added 2026-08-17 npm dsh-plugin-recommend

Plugin recommender for DSH: search and rank plugins from an embedded 1100+ entry marketplace catalog by need description, category and tags, with match reasons and a live catalog refresh from the awesome-dsh-plugin README.

Install

# from npm (prebuilt)

dsh plugin --profile web add dsh-plugin-recommend

# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)

dsh plugin --profile web add github:863683348/dsh-plugin-recommend

Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).

README

Plugin recommender for DeepSeek Harness — search and rank DSH plugins from a marketplace catalog by need description, category and tags, with match reasons.

Compatibility

Tool schemas are validated against the @deepseek-ai/dsh-tools value-schema DSL at plugin load (checked against dsh-tools 0.1.0-rc.6 and 0.1.1-rc.2). Earlier releases used JSON-Schema required at the root of output.schema and closed nested objects without declared properties, which made the host abort the whole profile boot with unsupported JSON schema: schema.required is not supported by the value schema DSL and could reject the tool's own results. Current releases fix both; if an affected version left your DSH unable to start, remove the plugin from the profile (or upgrade) — no data is lost.

Features

  • Embedded catalog: 1135 entries generated from the awesome-dsh-plugin data (name, repo, category, description, auto-derived tags).
  • Free-text scoring: name matches weigh most, then tags, then description; category filter narrows results.
  • Live refresh: pulls the latest catalog from the awesome-dsh-plugin README over HTTPS (fallback: embedded catalog).

Tools

Tool Action What it does
recommend search Top-N plugins for a need description (query), optional category / topN; each result includes score + match reasons
categories List catalog categories with counts
detail Full catalog entry for one plugin name
similar Nearest alternatives to a plugin (shared tags / category / description overlap)
refresh Fetch the latest catalog from the awesome-dsh-plugin README

Usage

recommend search "browser automation with screenshots"
recommend search "网页浏览" category tools
recommend detail dsh-plugin-gate
recommend categories
recommend refresh

Search results include a details breakdown (name +3 / tags +2 / description +1 / category +2), are deduplicated by repository url, and support diversify + perCategory so one category cannot fill the list.

Always cross-check a recommendation with the installation safety gate (gate_scan from dsh-plugin-gate) before installing.

Development

node --check lib/*.js
node test/recommend.test.mjs
node scripts/gen-catalog.mjs   # rebuild lib/catalog.json from awesome data

License

MIT

Roadmap

See ROADMAP.md — next five versions (v1.1.0 – v1.5.0): similar & dedupe, popularity ranking, incremental refresh, requirement clarification, environment presets.

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.