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 the community catalog 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 the community catalog README over HTTPS (fallback: embedded catalog).

Tools

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.