Introduction

The plugin ecosystem for DeepSeek Harness (DSH) has been expanding rapidly, and the community-maintained catalog (awesome-dsh-plugin) provides a large number of plugin resources. However, directly browsing an external catalog during local development is inefficient. dsh-plugin-recommend embeds this external catalog into DSH, providing a local plugin search and recommendation engine. It helps developers quickly locate the tools they need through keyword matching, tag-based classification, and real-time catalog refreshes.

Plugin Overview

  • Plugin Name: dsh-plugin-recommend
  • Maintainer: 863683348
  • Category: Web Tools
  • Open Source License: MIT

Core Features

The plugin implements plugin discovery and retrieval in the following ways:

  1. Embedded Catalog: Ships with 1135 plugin entries (from awesome-dsh-plugin), including names, repositories, categories, descriptions, and automatically generated tags.
  2. Full-Text Scoring and Ranking: Supports free-text search. Match priority is: plugin name > tags > description. Category filtering is also supported; results are deduplicated and support diversity filtering to prevent too many results for a single category.
  3. Real-Time Refresh: When the plugin starts, it attempts to fetch the latest catalog from the awesome-dsh-plugin README over HTTPS. If the network request fails, it falls back to the built-in embedded catalog.
  4. Tool Validation: When loaded, the plugin uses the value-schema DSL from @deepseek-ai/dsh-tools to validate tool schemas, ensuring tool definitions conform to the specification.

Tool Commands and Usage

The plugin provides 5 core tool commands for retrieving catalog information:

Search Plugins

Search plugins by a requirement description and return match scores with reasons.

recommend search "browser automation with screenshots"
recommend search "网页浏览" category tools

View Categories

List all categories in the catalog and the number of plugins in each.

recommend categories

View Details

Retrieve the full catalog entry for a single plugin.

recommend detail dsh-plugin-gate

Find Similar Plugins

Find the closest alternatives to a specified plugin based on overlap in tags, categories, and descriptions.

recommend similar <plugin-name>

Refresh Catalog

Force a re-fetch of the latest catalog data from the remote source.

recommend refresh

Notes

  • Schema Validation: Early versions had compatibility issues between JSON-Schema and DSL that could prevent DSH from starting. If you encounter a startup failure, try removing this plugin from the configuration (data will not be lost), or upgrade to the latest version.
  • Security Checks: Before installing a recommended plugin, always use the gate_scan tool in dsh-plugin-gate to perform a security scan and cross-check the plugin source before installing.