dsh-plugin-recommend

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.