dsh-plugins-finder

3. Usage

find_plugin is an agent tool — no manual command; just tell the agent what you need and it calls the tool automatically. A few example prompts (Chinese works too):

• "Find me a plugin for OCR / screenshots"
• "I need a terminal TUI plugin"
• "What dsh plugins exist for memory / RAG?"
• "Find me a plugin for price tracking"
• "帮我找支持 OCR / 截图转文字的 dsh 插件"
• "有没有能识别图片内容的插件?"

Example conversations

English — OCR / screenshots

• You: Find me a plugin for OCR / screenshots
• Agent: automatically calls find_plugin with {"query": "vision OCR screenshots", "limit": 3} and returns a ranked list — see Output Format
• You: How do I install the top one?
• Agent: Run dsh plugin --profile web add dsh-vision-router, then restart dsh web.

中文 — 终端 TUI

• 你: 有没有终端 TUI 插件?
• 助手: 自动调用 find_plugin,query 为 "terminal TUI" → 返回 dsh-tianshu-tui、dsh-whale-tui、dsh-tui 等结果
• 你: 帮我装第一个
• 助手: 执行 dsh plugin --profile web add dsh-tianshu-tui,然后重启 dsh web。

Tool parameters

Parameter	Required	Type	Description
query	✅	string	The need, e.g. "vision OCR screenshots", "memory rag". Chinese and English both work; English matches better
limit	❌	number	Max results; defaults to the maxResults config (5), clamped to 1–10

---

6. Configuration

Configure in the host composition or an agent preset's cordis.yml (defaults are fine, usually no change needed):

- insert:
    - id: dsh-plugin-finder
      name: dsh-plugins-finder
      config:
        indexUrl: https://www.dsh.so/plugins-index.json   # override for self-host / testing
        maxResults: 5                                      # default result count
        cacheTtlMs: 600000                                 # cache the index for 10 min
        timeoutMs: 15000                                   # fetch timeout (ms)

Config	Default	Description
indexUrl	https://www.dsh.so/plugins-index.json	Machine-readable dsh.so plugin index URL
maxResults	5	Default result count when limit is not passed
cacheTtlMs	600000 (10 min)	How long to reuse the fetched index before refetching
timeoutMs	15000	Fetch timeout in milliseconds
attribution	true	Append a "Powered by dsh.so" promotion and copyright footer to every result

---