插件发现 · DSH Plugin Discovery

中文 | English

最新版本 v1.5.0（2026-11-06）

Release 说明 · 本次改动：

• AUI 改为「模型静默判断」：本地先粗召回候选插件，再由当前 DSH 默认模型判断这条消息是否真的需要某个插件；判断值得且置信度达标才在右下角浮现，不再靠纯文本匹配硬推
• 安静优先的频率控制：默认冷却 240 秒、每小时最多 4 次、每会话最多 2 次；模型不可用/判断失败时保持静默，不退回文本匹配
• 黄金集评测：36 条真实用户意图（26 条正例 + 10 条负例，含小红书误报回归用例），当前准确率 94.4%、负例误报 0/10；仓库附带 tools/aui-golden.json、评测脚本与完整报告
• 插件管理页、安装失败处理、已安装标记等能力保持不变
• 当前收录 24,075 个插件，其中 639 个支持 npm 源一键安装

在 DSH 左侧栏「自动化任务」下方加一个「插件发现」页面：把 GitHub 上社区维护的 DSH 插件市场全量目录接进 Harness，2.4 万+ 插件一览无余，每个项目都配一句中文简介，还能直接点「安装」装进当前 DSH。

安装完成后的状态卡片（版本、安装源、使用位置）：

它做什么

• 全量目录：实时同步 GitHub 社区维护的 DSH 插件全量目录（dsh-plugin topic 核实收录，当前 24,075 个），按与上游相同的规则归入 10 个分类。
• 中文简介：每个项目一句中文说明它是干什么的。优先使用项目自带中文简介，其次是随仓库打包的 AI 中文简介；新收录的项目会先显示按分类与语言生成的中文归类摘要，英文原简介保留在下方。
• 头部类目筛选：只把头部 6 个分类做成筛选胶囊，长尾分类统一折叠进「其他」。
• 三种排序：全部（目录顺序）、最高 Star、最新更新；支持关键词搜索、每页 50 / 100 / 200 条分页。
• 每次打开自动刷新：先用本地缓存秒开，同时后台向 GitHub 同步一次，完成后自动替换为最新数据；右上角「刷新」可手动同步。
• 生态概况：收录总数、分类数、语言数、近 30 天更新数，一段自动生成的中文总结，以及头部分类的数量分布条。
• 查看项目：点击任意一行（或「打开项目 ↗」）会打开对应 GitHub 仓库，先看 README 再决定要不要装。
• 一键安装：每行都有「安装」按钮，点击后由 DSH 插件管理器把该插件装进当前 profile——优先使用目录里的 npm 安装源（639 个插件有 npm 源），没有时回退到 GitHub 仓库。安装期间显示进度；结束后页面内会出现状态卡片，说明装好了还是没有装好、安装的版本、以及大致在哪里使用（侧边栏 / 设置 / Agent 工具 / 斜杠命令 / 通知……），并给出常见失败的处理办法（构建脚本被拦、网络不可达、已安装、不是插件包）。
• 已安装标记：当前 profile 里已有的插件会显示「✓ 已安装」，不再重复安装。
• 安装失败可现场处理：构建脚本被拦截时状态卡提供「允许并重试」（自动写入当前 profile 的 pnpm-workspace.yaml allowBuilds）；GitHub 源码包不可用但存在同仓库 npm 包时提供「改用 npm 源安装」，无需构建脚本。
• AUI：对话中主动发现插件：先本地召回候选，再由模型静默判断是否值得打扰；值得且置信度达标才在右下角浮层浮现，确认前不会安装。可在页面「⚙ AUI」里配置开关、最低置信度与频率上限。
• 插件管理：顶部「管理」页集成官方插件与已安装第三方插件的启停 / 卸载，支持列表与网格视图。

AUI（Agent-facing UI）

当你在对话里描述一个需求（比如「帮我整理一下销售台账的 Excel，检查公式有没有算错」），AUI 分两步决定要不要打扰你：

1. 本地粗召回（不联网，几十毫秒）：从 2.4 万条目录里取最多 15 个候选，过滤掉已安装和你之前忽略过的插件
2. 模型静默判断（当前 DSH 默认模型，temperature 0，约 1–2 秒）：看懂你到底要做什么，判断候选里有没有能直接帮上忙的插件；没有就保持安静，不会为了「有结果」硬推一个

只有「判断值得 + 置信度 ≥ 0.6」时才在右下角浮现一张轻量卡片：

• 不打断对话：卡片在 frame 级浮层里，不进入主对话流
• 必须由你确认：点「安装」才真正安装；「忽略 / 不再提示」随时可用
• 安静优先：默认冷却 240 秒、每小时最多 4 次、每会话最多 2 次；模型不可用或判断失败时保持静默，不退回文本硬匹配
• 可配置：页面右上角「⚙ AUI」里可开关、调最低置信度 / 冷却时间 / 每小时上限 / 每会话上限，也可以「试一下」用一句话预览
• 可跳转：卡片里的「看看同类插件」会带着关键词跳到插件发现搜索页

黄金集与评测

仓库带着 tools/aui-golden.json：26 条真实用户意图 + 10 条应当保持安静的负例，来源包括插件市场精选场景、DSH 社区讨论，以及用户实际遇到的误报（「小红书视频」曾经被推成视频帧理解插件）。tools/aui-eval.py 会把黄金集打到真实的 /aui/eval 接口上并输出指标：

阈值	命中	选错	漏报	负例误报	准确率
0.5	24/26	1	1	0/10	94.4%
0.6（默认）	24/26	1	1	0/10	94.4%
0.7	22/26	0	4	0/10	88.9%

完整报告见 tools/aui-eval-report.md。目前唯一明显偏低的是与内置 office 能力重叠的「Excel 公式审计」（判断对了但置信度 0.58，默认被静默）；把最低置信度调到 0.5 可以覆盖它。

插件管理

顶部导航的「管理」页把 DSH 自带的插件管理能力集成进来：

• 官方插件：随 DSH 提供的组合包（含实验性可选插件），可直接开关，停用的会标记
• 已安装的第三方插件：装进当前 profile 的插件，可开关或卸载（两步确认）
• 列表 / 网格：默认列表，可一键切换网格；支持搜索过滤
• 开关、卸载都直接走 DSH 插件管理器，需要重启时会明确提示

安装

要求 DSH V0.2.1-rc.5 及以上。

1. 打开 DSH 左侧「插件」→「添加插件」→「安装第三方插件」。

2. 在输入框填入本仓库的 Git 地址：

   https://github.com/HiddenPuppy/dsh-plugin-discovery
   

3. 安装完成后，左侧栏「自动化任务」下方会出现「插件发现」。若没有立即出现，刷新一下窗口即可。

也可以让 Agent 代为安装（plugin_manager 的 install_bundle 指向 Git 地址或本地绝对路径），或先 git clone 本仓库，再把本地绝对路径填进安装对话框。

安装失败怎么办

状态卡会尽量给出可以直接点的操作：

情况	状态卡提示	处理方式
依赖的安装脚本被 pnpm 拦截	「允许并重试」	写入当前 profile 的 allowBuilds 后自动重试；允许会执行插件自带的脚本，请确认来源可信
GitHub 源码包需要 prepare / 构建失败	「允许并重试」；仍失败时给 npm 方案	若同一仓库发布了 npm 包，改用「改用 npm 源安装」，无需构建脚本
检测到同仓库的官方 npm 包	「改用 npm 源安装（包名@版本）」	直接用 npm 包安装，例如 dsh-market → dshmarket@1.73.12
GitHub 无法访问（网络超时）	提示网络不可达；有 npm 包时提供 npm 方案	换成 npm 源，或稍后重试
已经安装过 / 不是 DSH 插件包	明确说明原因	无需重复安装，或去仓库确认是否为插件

说明：DSH 自带「插件」页只对 npm 依赖的构建脚本提供「允许这些脚本并重试」，对 Git 源码包的 prepare 脚本没有对应按钮（只能手动改 pnpm-workspace.yaml）。本插件把这个流程做进了状态卡，所以不需要自己去改配置文件。

数据来源

• 目录：bruc3van/awesome-dsh-plugin，GitHub dsh-plugin topic 的社区维护全量目录。
• 直接下载仓库归档包（GitHub codeload，一次约 10 MB 请求），读取其中全部 catalog/*.md 分类分册；上游会随目录增长拆分、改名分册文件，所以文件名是运行时发现的，不会因为上游改名而失效。
• 归档包不可达时，退化为读取 CATALOG.md 索引，再按索引逐个下载分册，依次尝试 raw.githubusercontent.com → jsDelivr → GitHub 加速镜像（gh-proxy.com / ghfast.top / ghproxy.net）；页面底部会标注快照日期与上次同步时间。
• 目录每天由上游刷新一次，本插件每次打开页面都会尝试同步。

中文简介是怎么来的

来源	数量	说明
项目自带中文	约 1.19 万	仓库自己的中文简介
AI 生成中文	约 1.18 万	缓存在 zh-descriptions.json，可自行修订，刷新页面后生效
自动归类摘要	新增项目	收录后暂无中文时，按分类与开发语言生成一句中文概括

简介由项目作者原文与模型生成结果组成，仅供参考；以项目仓库为准。

目录结构

.
├── index.js              # Host 半侧：拉取分册、解析、中文兜底、磁盘缓存、API 路由
├── client.js             # 浏览器半侧：侧边栏入口 + main 面板页面
├── cordis.patch.yml      # bundle 补丁：插入 plugin-discovery 一行
├── locale/{zh,en}.json   # 插件管理器中展示的标题与描述
├── icon.svg              # 插件图标（拼图 + 放大镜）
├── zh-descriptions.json  # AI 中文简介缓存（owner/repo → 中文）
├── docs/screenshot.png   # 使用截图
└── tools/                # 离线归一化检查、路由端到端检查、真实上游联调、预热缓存

Host 半侧在 DSH 的鉴权 API 通道上注册两条路由：

• GET /api/plugin-discovery/feed —— 归一化后的插件目录；?refresh=1 触发后台刷新，?wait=1 等待进行中的刷新结束后返回
• GET /api/plugin-discovery/meta —— 同步状态（上次同步时间、是否刷新中、错误信息）
• POST /api/plugin-discovery/install —— 通过 ctx.pluginManager 开始安装一个目录里的插件，返回任务 id
• POST /api/plugin-discovery/install/approve —— 对上一次失败的安装执行授权重试（写入 allowBuilds / 批准构建脚本 / 改用 npm 源）
• GET /api/plugin-discovery/bundles、POST …/bundles/enable、POST …/bundles/remove —— 管理页使用的官方 / 已安装插件列表、启停与卸载
• GET/POST /api/plugin-discovery/aui、GET …/aui/suggestion、POST …/aui/dismiss、POST …/aui/test、POST …/aui/eval —— AUI 设置、待确认推荐、忽略、预览与黄金集评测
• GET /api/plugin-discovery/install/status?id=… —— 任务状态与最终结果（友好错误信息 + 使用位置提示）
• GET /api/plugin-discovery/installed —— 当前 profile 已安装的 bundle（用于「✓ 已安装」标记）

浏览器半侧从不直连 GitHub：下载、解析、分类与缓存都在 Host 完成，浏览器只渲染结果。

开发与验证

node tools/live-test.mjs                     # 直连上游跑一次真实同步并打印统计
node tools/route-test.mjs /path/to/catalog   # 用本地分册快照测试路由、缓存与失败降级
node tools/warm-cache.mjs                    # 预热当前 profile 的磁盘缓存

License

MIT

更新记录

• 1.5.0 — AUI 从纯文本匹配升级为「本地召回 + 模型静默判断」：模型判断不值得或置信度不足时保持安静，频率控制默认冷却 240 秒 / 每小时 4 次 / 每会话 2 次；新增 36 条黄金集与评测脚本，当前准确率 94.4%、负例误报 0/10。
• 1.4.0 — 新增 AUI：对话中本地匹配并右下角推荐插件（用户确认后才安装，可配置开关 / 灵敏度 / 冷却，可在设置里「试一下」）；新增「插件管理」页，集成官方插件与已安装第三方插件的启停 / 卸载与列表 / 网格视图。
• 1.3.0 — 安装失败可直接处理：状态卡提供「允许并重试」（自动写 allowBuilds）与「改用 npm 源安装」（同一仓库有 npm 包时），并持久化「✓ 已安装」标记。修复 DSH「插件」页找不到构建授权入口的问题（Git 源码包 prepare 脚本没有对应 UI）。
• 1.2.0 — 一键安装：每行新增「安装」按钮，点击后通过插件管理器把插件装进当前 DSH profile（优先 npm 安装源），并给出安装成功/失败、版本与大致使用位置；已安装插件显示「✓ 已安装」。失败原因会归类成可操作的中文提示（构建脚本被拦 / 网络不可达 / 已安装 / 不是 DSH 插件包）。当前收录 24,075 个插件。
• 1.1.0 — 修复点击「刷新」报 upstream 404 的问题：上游目录会拆分/改名前缀分册文件，旧版本硬编码了分册文件名。现在改为运行时发现分册（优先下载仓库归档包，失败时读 CATALOG.md 索引再按镜像链逐一下载），目录增长后也不会失效。
• 1.0.0 — 首次发布。