插件发现 apeiria-network/dsh-plugin-discover

dsh-plugin-discover

用中文或英文口语找 DeepSeek Harness（DSH）插件。装好之后，直接对 AI 说"帮我找一个能……的插件"，它会返回排好序的候选和对应的安装目标。

- 本地运行：索引是你机器上的文件——不连服务端、不上传、不采集任何数据。
- 查询不调模型：排序由代码确定、可回归；AI 只负责解释结果。
- 插件不安装：只给安装目标；装不装、何时装由你和当前LLM会话决定，走 DSH 自己的插件管理与审批通道。
- 向量模型不自动下载：向量模型是独立可选包，只有你显式拉取才会安装。不使用向量增强时不需要下载向量模型。

安装

和装任何 DSH 插件一样：Web 端 插件 → 添加插件，或命令行

dsh plugin --profile web add dsh-plugin-discover

从本地目录安装（开发或试用未发布版本）：

dsh plugin --profile web add link:D:\dsh-plugin-discover

包里只有代码（约 72 kB）：不带索引数据、不带模型权重、不带原生二进制，安装是秒级的。

快速开始

1. 建索引（一次性）

安装阶段不下载任何东西，先建一次本地索引：

npx dsh-plugin-discover build

下载约 25 MB（dsh.so 插件目录），视网络通常一两分钟完成。也可以直接在会话里让 AI 建库——后台执行、立即返回，不阻塞对话。

索引按用户全局存放，所有 profile 共用，约占 20 MB 磁盘：

| 系统 | 目录 |
| Windows | %LOCALAPPDATA%\dsh-plugin-discover\ |
| macOS | ~/Library/Caches/dsh-plugin-discover/ |
| Linux | ${XDG_CACHE_HOME:-~/.cache}/dsh-plugin-discover/ |

构建总是写入新目录、成功后才切换，失败不影响现有索引；同一时刻只会有一份构建（锁保护）。想彻底重置，删掉整个目录再建即可。

2. 直接问

帮我找一个任务完成时能发微信通知的插件

AI 会调用 plugin_discover 检索并解释结果，例如：

🔍 10 个候选 · 过滤 balanced（排除 1094 条）

① dsh-wecom-notify · 1★ · L5 已验证 · 低风险 DSH 插件：任务完成 / 报错 / 需要用户选择时，自动通过企业微信群机器人 webhook 发送通知 [装: github:ljnljn2005/dsh-wecom-notify] ② dsh-clawbot · 11★ · L5 已验证 · 低风险在 DSH 里接入微信官方 ilink 机器人网关：扫码绑定后，AI 能主动给自己发微信通知 [装: github:cryjkd/dsh-clawbot#1.5.0] ③ @chenweigao/dsh-perch-notify · L5 已验证 · 低风险 Webhook notifications for DSH sessions — POST on approval requests and turn ends [装: github:chenweigao/dsh-perch-notify]

数据截至 2026-10-25 · Powered by dsh.so

每条带星数、验证等级、安全风险、更新时间和安装目标；描述保持英文，由 AI 在回答里翻译。想装哪个，把安装目标交给 DSH 的插件管理即可——本工具自己永远不装。

3.（可选）开启向量模式：见可选向量模式与模型包。

它怎么工作

你的原话 + AI 给的最多 3 条改写 → 本地 BM25 词面检索（4 路查询分别检索，RRF 融合，同仓库的多个包合并成一张卡） → 质量过滤（安全 / 验证等级 / 兼容性） → 筛去不相关的候选 → 返回候选 + 安装目标

- 中文查询需要英文改写：目录里的插件名、标签、描述都是英文，AI 会自动补英文/术语改写，你不用管。
- 不要求所有词都命中：词面检索按 OR 组合，中文长句也能出结果；名称和标签的权重高于描述。
- noMatch 是正确结果：没有足够证据表明存在匹配插件时，工具返回空并建议换说法，而不是硬凑一个。宁可空，不误导。
- 重复条目会合并：同一个安装目标、同一个上游仓库只保留一张卡；fork、重传的副本并入上游，不再分别出现。同名但描述不同的独立项目不会被强行合并。
- 无法安装的条目不返回：上游仓库已删除、且只能从 GitHub 安装的插件不进入结果。
- 本地索引数据会过期：报告头部带"数据截至"；索引超过更新周期（默认一周）时，下次检索会先自动刷新、等待成功后再出结果；刷新失败才用旧索引兜底，并明确提示。

工具参数

plugin_discover 的参数由会话模型填写，你不需要手工构造；列出供集成与排查参考：

| 参数 | 类型 | 语义 |
| query | string | 用户原话，不转述。检索必填；explain / refresh 时传 ""。 |
| queryAlts | string[] | 最多 3 条改写：英文/术语版（中文查询必需）、3–5 个能力词、一句使用场景。 |
| limit | integer | 返回条数，1–20；省略时用配置值。 |
| explain | string | 传结果 id / 精确名称 / 安装目标，返回该条完整记录，不检索。 |
| readme | boolean | 与 explain 同用：同时返回该插件的 README 原文。 |
| readmeMaxChars | integer | 与 explain 同用：README 字符上限，默认 200000。 |
| refresh | boolean | 立即返回，后台建/更新索引。 |
| filters | object | 临时覆盖 preset（strict/balanced/loose/off）与 minVerificationLevel（0–5）。 |

配置

打开插件管理页里本插件的详情页，配置区直接显示在页面中。保存即生效——宿主只重载本插件，进程与会话不重启。

| 配置项 | 默认 | 说明 |
| 索引目录 | 系统默认路径 | 见上表。改后 CLI 需用 --index-dir 指向同一目录。 |
| 索引更新周期 | 周（7 天） | 天 / 周 / 月（30 天）/ 3 个月（90 天）。检索时发现超过周期，先刷新并等待成功再出结果。 |
| 过滤档位 | 均衡（balanced） | 严格 / 均衡 / 宽松 / 关闭，见下表。 |
| 最低验证等级（仅均衡档） | 4 | 0 = 不限；1–5 要求验证等级 ≥ N。验证等级未知的条目不因此被删。 |
| 结果返回数量（top N） | 10 | 范围 1–20。 |
| 无关结果筛选强度 | medium | none（关闭）/ low / medium / high。越高越不容易硬凑结果，也越可能对边缘需求返回空。 |
| 向量化检索增强 | off | off / balance（字段向量）/ high（README 向量），见可选向量模式与模型包。 |
| 向量化范围（top N） | 50 | 参与向量重排的候选数，范围 2–200；增强为 off 时不生效。 |
| 单请求超时（秒） | 30 | README 单请求超时，范围 5–300。 |
| README抓取总超时时长（分钟） | 5 | 范围 1–10；超时后剩余记录跳过 GitHub、走 npm CDN。 |
| GitHub 请求并发 | 4 | 范围 1–8；速率固定为每 worker 1 次/秒，不可配置。 |

过滤档位：

| 档位 | 安全 | 验证 | 兼容 |
| strict | audited + low | L5 | 必须通过 |
| balanced（默认） | 排除 audited high/critical；未审计放行并标注 | ≥ L4（可配）；缺失放行 | 通过或未知 |
| loose | 只排除 high/critical | 不限 | 只标注 |
| off | 只排除 critical | 不限 | 不判断 |

"未知"不等于"不达标"：字段缺失的条目降权并标注，不过滤。过滤后不足 3 条时自动放宽一档，报告中注明。

CLI

dsh-plugin-discover build [--index-dir <dir>] [--json] [--quiet]
dsh-plugin-discover status [--index-dir <dir>] [--json]
dsh-plugin-discover search <query> [--alt <text>]... [--limit <n>] \
[--preset strict|balanced|loose|off] \
[--min-verification <0-5>] [--explain <id>] \
[--readme] [--readme-max-chars <n>] [--json]
dsh-plugin-discover model status [--index-dir <dir>] [--profile <name>] [--json]
dsh-plugin-discover model pull [--spec <spec>] [--profile <name>] \
[--index-dir <dir>] [--dry-run] [--no-verify] [--json]

- build / status：建索引、看状态。
- search：不进会话直接试查询；--alt 可重复最多 3 次给改写。
- model pull / model status：可选模型包的显式拉取与状态，见下节。

DSH 插件不能向 dsh 命令注册子命令，所以 CLI 作为包自带的 bin 提供。链接安装（link:）时没有全局 bin，用 node lib/cli.js build 代替。

可选向量模式与模型包

词面检索（默认）已覆盖大多数需求。向量模式用本地嵌入模型对候选做语义重排，能改善"说法不同但意思相近"的匹配；实测中它对多数查询没有明显优势（部分场景略优、部分略劣），所以默认关闭，想试再开。

代价是一个独立模型包 dsh-plugin-discover-model（int8 量化的 multilingual-e5-small，384 维）：下载约 80 MB，连同 ONNX 运行时装完约 420 MB；运行时内存约 400–500 MB。模型跑在子进程，空闲 5 分钟自动退出，不开向量时零开销；ONNX 默认 4 线程（可用环境变量 DSH_MODEL_THREADS 覆盖）。它不是主插件的依赖，只有 model pull 才装：

默认：从 npm 安装 dsh-plugin-discover model pull

备用：从 GitHub Release 资产安装 dsh-plugin-discover model pull --spec "https://github.com/apeiria-network/dsh-plugin-discover/releases/download/model-v0.1.0/dsh-plugin-discover-model-0.1.0.tgz"

开发：从本地目录或 tarball 安装 dsh-plugin-discover model pull --spec "link:D:\dsh-plugin-discover\models\multilingual-e5-small" dsh-plugin-discover model pull --spec "file:D:\path\to\dsh-plugin-discover-model-0.1.0.tgz"

dsh-plugin-discover model status

model pull 把模型包装进当前 DSH profile，按 manifest 逐文件校验（默认 SHA-256），并在索引目录写 model.json 指针。安装时 pnpm 可能以 ERR_PNPM_IGNORED_BUILDS 警告 onnxruntime-node 的构建脚本被跳过——预编译 CPU 二进制仍然可用，这是警告不是失败；其他安装失败会返回非零退出码，并保留已安装的版本。

装好后，在插件详情页把「向量化检索增强」改为：

| 模式 | 行为 |
| off（默认） | 不加载模型、不算向量。 |
| balance | 字段向量重排：把候选的目录字段——名称、标题、标签（topics）、能力标签、描述——拼成文本算语义相似度，与词面名次加权融合。 |
| high | 字段 + README 向量重排：在字段向量之外，额外抓取候选的 README 做语义比对。 |

网络行为（仅 high 模式联网）：

- README 来源顺序：GitHub raw → npm CDN 精确版本 → 字段向量兜底；命中缓存不联网。
- 固定限速（全局 4 req/s）、单请求 30 秒保护、总预算默认 5 分钟；超时自动降级，不影响整次查询。
- 无法直连 GitHub 的网络环境下自动走 npm CDN，再不行回退字段向量。
- GitHub 连续返回 403/429 或连续超时会熔断 10 分钟；结果带 readme.circuit 提示，AI 会转告你。
- 向量缓存放本地（<indexDir>/cache/），随数据更新自动失效。
- 模型缺失或启动失败时自动降级为词面排序并附提示，不会静默出错，也不会自动下载。

数据与隐私

- 主源：dsh.so 插件目录，CC-BY-4.0。每份报告带 Powered by dsh.so — DSH Developer Hub 与源数据时间戳。
- 补充：dsh-plugin-catalog，CC0-1.0（兼容信息与仓库地址）。
- npm registry 只用于解析 README 的精确版本，不参与收录与排序。
- 只收录有安装目标的条目——每条结果都能回答"怎么装"。
- 索引只是本机缓存：不上传、不共享、不作为服务分发。

已知限制

- 中文查询依赖 AI 补英文改写；改写偏了会带进相邻插件或漏掉目标。判断门槛能压掉一部分，压不干净。
- 某些泛化场景（如"手机上用"类需求）召回可能偏弱。
- updatedAt 来自目录数据；不在目录里的条目不显示更新时间。
- 上游仓库判定依赖 catalog 的 title；没有 title 的副本可能仍作为独立条目出现。
- 向量模式默认关闭；开启前需先显式拉取模型包。
- 目前仅在 Windows 上验证过；macOS / Linux 理论可用，未实测。

许可

代码 MIT。索引数据保留源许可与署名（dsh.so CC-BY-4.0，catalog CC0-1.0）。