dsh-need-finder — 需求型插件导购 (Requirement-driven plugin guide) "点菜，不是逛超市。" 现有 DSH 插件市场都是按名称/分类浏览；本插件让 agent 直接听懂你的需求，从精选目录里语义匹配最合适的插件，给出匹配理由和安装命令。 ## 为什么需要它 - 用户说的是任务（"任务完成通知我"、"手机上看 DSH"、"抓取网页内容"），不是插件名。 - plugin_guide 用本地语义评分（英文词 + 中文子串 + 分类词典）在 84 个精选插件（覆盖 14 个分类）中匹配，零网络、零 LLM 调用、零外部依赖。 - 输出即"点菜单"：插件名、分类、双语描述、匹配理由、dsh plugin add 安装命令。 ## 安装 bash dsh plugin --profile <profile> add dsh-need-finder # npm 发布后 # 或本地：dsh plugin --profile <profile> add <本目录> ## 用法（模型侧） 工具 plugin_guide： | 参数 | 说明 | | --- | --- | | need（必填） | 自然语言需求，中英文皆可，如 notify me when a task finishes、抓取网页 | | limit（可选） | 返回条数 1-10，默认 5 | 示例需求与命中分类： | 需求 | 命中分类 | | --- | --- | | "任务完成时通知我" / "notify when done" | notify | | "记不住上下文，换个会话就忘了" | memory | | "在手机上远程看 DSH" | ui / usage | | "抓取网页/截图给 agent 看" | vision | | "多会话管理/状态切换" | session | | "检查插件安全性" | dev | 插件还会注入 plugin-guide:instructions 提示词段落，教 agent 在用户描述需求而非插件名时调用本工具。 ## 目录 内置精选目录 lib/guide-data.json：84 个真实插件，从 awesome-dsh-plugin 的 1019 个条目按分类均匀采样生成，含双语描述与标签。可按需增删（纯数据文件，改完即生效）。 ## 设计 - 纯逻辑分离：lib/match.js 零依赖（分词/评分/排序），lib/guide-data.json 纯数据，lib/index.js 才是 Cordis 插件。 - 评分：名称命中 +3、标签命中 +2、描述命中 +1；中文 2-gram 子串匹配；分类词典兜底。 - 安全：无网络请求、无文件写入、无 secrets。 ## 测试 bash node test/match.test.mjs ## Recipes — 插件界的 dotfiles 从"装单个"到"装环境"：recipe 工具内置 8 个社区配方（JSON：插件清单 + 安装顺序 + 配置说明），一键生成整套有序安装计划： | id | 套装 | | --- | --- | | notify-suite | 通知全家桶 | | security-audit | 安全审计套装 | | remote-mobile | 移动远程套装 | | dev-tools | 开发效率套装 | | memory-set | 记忆与上下文套装 | | im-bridge | IM 桥接（三选一） | | vision-lab | 视觉实验室 | | research-stack | 浏览器研究环境 | recipe action=list 看全部；recipe action=search need="手机远程" 按需求找配方；recipe action=apply id=notify-suite 输出按依赖顺序排列的 dsh plugin add 命令（DAG 友好，可被工作流/编排引擎消费）。配方数据在 lib/recipes.json，可自行增删。 ## Relationship to dsh-recipe This plugin bundles 8 curated recipes (guide-first). If you want a dedicated recipe tool (list/search/apply/compose custom environments), install dsh-recipe separately (dsh plugin add dsh-recipe). The two complement each other. ## License MIT