@dsh-so/dsh-plugin-advisor

3. Usage

plugin_advisor 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 plugin_advisor 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 插件?
• 助手: 自动调用 plugin_advisor,query 为 "terminal TUI" → 返回 dsh-tianshu-tui、dsh-whale-tui、dsh-tui 等结果
• 你: 帮我装第一个
• 助手: 执行 dsh plugin --profile web add dsh-tianshu-tui,然后重启 dsh web。

Capability-gap auto search & install confirmation

When your request cannot be handled by any installed tool, the agent automatically calls plugin_advisor with a description of the missing capability. Results pass a default quality gate — L5 (run-tested) verification and an audited security scan (warning-level findings are kept; high/critical risk is excluded). The tool then highlights the single best match, prints its install command, and asks the user to confirm before installing — nothing is installed without consent.

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-so/dsh-plugin-advisor
      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
minVerificationLevel	5	Minimum verification level (L1–L5) a result must have; 0 disables the filter / 结果最低验证等级，0 表示不过滤
requireLowRisk	true	Only audited plugins; warning-level findings are kept, high/critical risk excluded / 仅保留已审计插件，warning 可接受，排除 high/critical

---