Skip to content
Back to search

dsh-find-plugin

Find DSH plugins inside the agent — live GitHub dsh-plugin topic search, star-ranked / 会话内搜索发现 DSH 插件

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/awesome-dsh-plugin--dsh-find-plugin/badge.svg)](/listings/awesome-dsh-plugin--dsh-find-plugin)

HTML

<a href="/listings/awesome-dsh-plugin--dsh-find-plugin"><img src="/api/listings/awesome-dsh-plugin--dsh-find-plugin/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# from npm (prebuilt, recommended)
dsh plugin --profile web add dsh-find-plugin

# or from GitHub
dsh plugin --profile web add github:awesome-dsh-plugin/dsh-find-plugin

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 92 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # dsh-find-plugin [![awesome · DSH plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
  2. English | [中文](README.zh.md)
  3. **A plugin that finds plugins** — think [`/find-skills`](https://skills.sh) from skills.sh, for DSH.
  4. Tell your agent what you want ("notify me on WeChat when a task finishes"),
  5. and it searches the DSH plugin ecosystem on GitHub for you — top results by
  6. stars, each with a one-line description and an install command.
  7. <img src="https://raw.githubusercontent.com/awesome-dsh-plugin/dsh-find-plugin/main/assets/demo-en.png" alt="find_dsh_plugin in action" width="640">
  8. ## Install
  9. ```sh
  10. # from npm (prebuilt, recommended)
  11. dsh plugin --profile web add dsh-find-plugin
  12. # or from GitHub
  13. dsh plugin --profile web add github:awesome-dsh-plugin/dsh-find-plugin
  14. ```
  15. ## Usage
  16. Restart `dsh web` after installing, then just talk to the agent — it calls
  17. `find_dsh_plugin` on its own whenever plugin discovery helps:
  18. - "What terminal TUI plugins are there?"
  19. - "I want to get a WeChat notification when a task finishes — any plugin for that?"
  20. - "Find me something for reviewing git diffs inside DSH."
  21. Each result comes back with stars, a description, the repo link, and a
  22. ready-to-run `dsh plugin add` command — ask the agent to install one and
  23. it can run the command for you.
  24. ## How it works
  25. - Live GitHub repository search scoped to the official `dsh-plugin` topic,
  26. re-ranked by stars (5-minute per-query cache).
  27. - When a result is also listed on
  28. [awesome-dsh-plugin](https://awesome-dsh-plugin.com), its hand-written
  29. bilingual description from `plugins.json` replaces the GitHub one (the
  30. `lang` parameter picks the language) — ranking is untouched.
  31. - Every result comes with a ready-to-run `dsh plugin add` command. Plugins
  32. are third-party code — review the source and pin a commit.
  33. ### Rate limits and offline fallback
  34. GitHub's **search** API allows only 10 requests/minute per public IP when
  35. unauthenticated, and that quota is shared by every host behind the same egress
  36. IP (carrier CGNAT, corporate NAT, …), so a search can fail with `HTTP 403` for
  37. reasons outside your control. The plugin therefore:
  38. - uses the **`GITHUB_TOKEN` DSH credential** when one is configured (30
  39. req/min, account-scoped, immune to shared-IP exhaustion). Optional — without
  40. it the tool still works, just closer to the anonymous limit;
  41. - retries a rate-limited (403/429) or failed request once, then degrades
  42. instead of failing: it falls back to **keyword matches from the curated
  43. list** and says so in the result note;
  44. - caches the curated list on disk (`$DSH_HOME/cache/dsh-find-plugin/`) and
  45. revalidates it with `If-None-Match` / `If-Modified-Since`, so restarts and
  46. offline runs use the full ~3400-entry list instead of the small bundled
  47. snapshot.
  48. - says *why* a request failed. Node reports every transport failure as a bare
  49. `fetch failed` and hides the useful part in `cause`, so the plugin surfaces
  50. the chain (`fetch failed ← certificate has expired (CERT_HAS_EXPIRED)`) and
  51. names the one trap that otherwise looks like a plugin bug: a system proxy or
  52. VPN accelerator, which Node's `fetch` ignores unless DSH itself was started
  53. with `NODE_USE_ENV_PROXY=1` (or `--use-env-proxy`). A browser has no such
  54. rule — which is why GitHub opens fine and this still fails.
  55. ## Compatibility
  56. DSH plugin APIs are prerelease-versioned, and node-semver only lets a
  57. prerelease satisfy a range that carries a prerelease on the *same*
  58. major.minor.patch — so a peer range pinned to one host line silently stops
  59. matching the next one. The declared `@deepseek-ai/dsh-tools` range therefore
  60. names every shipped line through `0.1.7`, and `npm run check:peers` (run in CI)
  61. resolves the current `latest`/`next` host lines from the registry and fails the
  62. day a new one is not covered.
  63. ## Development
  64. ```sh
  65. npm run typecheck # tsc --noEmit
  66. npm test # offline tests (mocked fetch)
  67. FINDP_LIVE=1 npm run test:live # opt-in real-network cases
  68. ```
  69. ## License
  70. MIT © awesome-dsh-plugin

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.