How awesome-dsh-plugin/dsh-find-plugin works
This is a DSH agent plugin for discovering third-party DSH plugins. A user asks the agent for a capability; the registered tool searches GitHub, ranks live results by stars, enriches matching entries with curated bilingual descriptions, and returns install commands. If GitHub search fails, it searches the curated registry instead. The registry refreshes from the curated-list service and can use disk or bundled data offline. The excerpts show the tool orchestration and cache fallback; some registry and presentation details are documented rather than fully excerpted.
Main entry points: index.ts Find Tool · registry.ts Registry Loader · github.ts GitHub Search · registry-snapshot.json Bundled Snapshot
Components 10
Discovery
- Find Tool
src/index.ts - GitHub Search
src/github.ts
Curated Catalog
- Registry Loader
src/registry.ts - Registry Cache
src/registry.ts - Bundled Snapshot
data/registry-snapshot.json
External Services
- Credential Service
- GitHub API
- Curated Registry
Other components
- User
- DSH Agent
Connections 10
- User → DSH Agent: asks discovery
README.md - DSH Agent → Find Tool: calls tool
README.md - Find Tool → DSH Agent: returns results
README.md - Find Tool → Credential Service: resolves token
src/index.ts - Find Tool → GitHub Search: searches query
src/index.ts - GitHub Search → GitHub API: requests repositories
src/github.ts - Find Tool → Registry Loader: loads descriptions or fallback
src/index.ts - Registry Loader → Curated Registry: fetches and revalidates
README.md - Registry Loader → Registry Cache: reads and writes
src/registry.ts - Registry Loader → Bundled Snapshot: falls back to
src/registry.ts