DSH(DeepSeek Harness)采用插件化架构,现有的插件市场通常按名称或分类浏览。用户往往知道要解决的任务,但记不住具体的插件名。dsh-need-finder 通过本地语义匹配,让 Agent 直接理解需求,从精选目录中找出最合适的插件。
核心定位¶
本插件定位为“需求型插件导购”。它不是简单的目录索引,而是通过本地评分算法,将自然语言需求与插件目录进行匹配,给出匹配理由和安装命令。
安装¶
在 DSH 环境中安装该插件:
dsh plugin --profile <profile> add dsh-need-finder
功能概览¶
- 本地语义评分匹配:在精选目录中进行评分,无需联网或调用 LLM。
- 透明化评分明细:返回结果包含详细的匹配权重(如名称命中 +3,标签命中 +2)。
- 内置社区配方:提供 8 个经过筛选的插件组合(dotfiles 风格),支持一键安装整套环境。
- 提示词注入:自动向 Agent 注入提示词,引导其在用户描述需求时调用本工具。
使用方法¶
安装后,DSH 环境将提供两个工具:plugin_guide 和 recipe。
plugin_guide:按需查找¶
Agent 通过自然语言描述需求,插件会返回匹配度最高的插件列表。
plugin_guide need='任务完成时通知我' limit=5
参数说明:
* need(必填):自然语言需求,支持中英文。
* limit(可选):返回条数,默认 5。
* category(可选):分类精确过滤。
* tag(可选):标签子串过滤。
* diversify(可选):限制同分类条数。
* perCategory(可选):diversify 模式下的每分类上限。
结果中包含 details 字段,展示命中的字段及权重,方便 Agent 解释推荐理由。
recipe:按套安装¶
对于复杂的场景,可以使用内置的社区配方。
# 列出所有配方
recipe action=list
# 按需求搜索配方
recipe action=search need='手机远程'
# 应用指定配方(输出安装命令)
recipe action=apply id=notify-suite
内置配方包括通知全家桶、安全审计套装、移动远程套装等。
限制与依赖¶
- Schema 兼容性:工具 Schema 需兼容
@deepseek-ai/dsh-toolsvalue-schema DSL。旧版本可能因 Schema 问题导致 DSH 无法启动,若遇此情况需移除插件。 - 运行环境:插件在当前 DSH 进程权限下运行,无网络请求、无文件写入、无 secrets 操作。
- 依赖项:需要
@deepseek-ai/cordis和dsh-system-prompt环境。
生态与维护¶
- 所有者:863683348
- 开源协议:MIT
- 仓库:https://github.com/863683348/dsh-need-finder
- 目录:https://www.skillhub.cn/plugins/863683348/dsh-need-finder
总结¶
dsh-need-finder 通过本地化的语义匹配和配方管理,解决了 DSH 用户“记不住插件名”和“不知道如何组合插件”的痛点。它让 Agent 从“逛超市”转变为“点菜”,直接获取匹配的解决方案。