dsh-need-finder — 需求型插件导购 (Requirement-driven plugin guide)

"点菜，不是逛超市。" 现有 DSH 插件市场都是按名称/分类浏览；本插件让 agent 直接听懂你的需求，从精选目录里语义匹配最合适的插件，给出匹配理由和安装命令。

Compatibility

Tool schemas are validated against the @deepseek-ai/dsh-tools value-schema DSL at plugin load (checked against dsh-tools 0.1.0-rc.6 and 0.1.1-rc.2). Earlier releases used JSON-Schema required at the root of output.schema and closed nested objects without declared properties, which made the host abort the whole profile boot with unsupported JSON schema: schema.required is not supported by the value schema DSL and could reject the tool's own results. Current releases fix both; if an affected version left your DSH unable to start, remove the plugin from the profile (or upgrade) — no data is lost.

为什么需要它

• 用户说的是任务（"任务完成通知我"、"手机上看 DSH"、"抓取网页内容"），不是插件名。
• plugin_guide 用本地语义评分（英文词 + 中文子串 + 分类词典）在 84 个精选插件（覆盖 14 个分类）中匹配，零网络、零 LLM 调用、零外部依赖。
• 输出即"点菜单"：插件名、分类、双语描述、匹配理由、dsh plugin add 安装命令。

安装

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
category（可选）	分类精确过滤（notify / memory / vision / dev / ui…）
tag（可选）	标签子串过滤
diversify（可选）	限制同分类条数（默认 false）
perCategory（可选）	diversify 时每分类上限（默认 2）

结果附带 details：命中字段与权重的透明明细（name +3 / tags +2 / description +1 / category +2），模型可以解释"为什么推荐它"。

示例需求与命中分类：

需求	命中分类
"任务完成时通知我" / "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。

测试

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

Roadmap

See ROADMAP.md — next five versions (v0.3.0 – v0.7.0): match transparency & filters, directory refresh, recipe solving, combo recommendations, personalisation.