前言¶

在使用 DSH 构建应用时，管理插件生态往往需要在不同网站间切换，手动复制仓库地址，并在客户端界面中填写安装信息。dsh-plugin-top 是一个侧边栏插件，旨在解决这一痛点。它将插件目录、榜单搜索和一键安装流程集成在浏览器侧边栏中，由维护者 yhbd-top 开发。

功能介绍¶

该插件在浏览器侧边栏提供了一套完整的插件浏览与安装入口：

1. 侧边栏入口
   安装后，浏览器侧边栏底部会出现 plugin_top 按钮。宽栏显示完整名称，窄栏仅显示图标。

2. 大面板与榜单
   点击按钮打开大面板（最大 880×700）。面板包含顶层“全部”（3900+ 插件全集）以及五个榜单：原生星榜、飙升、今日新秀、兼容工具、分类冠军。

3. 联动过滤与搜索
   分类条会随榜单联动。切到不同榜单时，分类仅统计该榜内的插件分布。点击分类可在当前榜单内进行过滤。同时支持本地即时搜索，可叠加关键词、仓库名或分类进行筛选。

4. 一键安装
   面板内每行右侧有“安装 ->”按钮。点击后会依次执行：复制 GitHub 仓库地址到剪贴板、打开客户端自带的“插件”页、自动填充“添加插件”的输入框并触发安装流程。

5. Agent 工具
   在对话中可直接调用 Agent 工具进行插件检索与趋势查看。

安装与启用¶

通过官方命令行安装：

dsh plugin --profile web add github:yhbd-top/dsh-plugin-top

安装完成后，必须重启 DSH 进程并硬刷新页面，侧边栏才会出现 plugin_top 按钮。

Agent 工具调用¶

插件为 Agent 提供了两个工具接口：

• plugin_top_search：按关键词、分类或星数搜索插件，返回简介、安装命令及详情页链接。
• plugin_top_trending：获取当日新入库、近期飙升或原生总星榜的插件列表。

注意事项¶

1. 环境要求：Node.js 版本需 >= 18.17.0。
2. 重启与刷新：安装后务必重启 DSH 并执行硬刷新。
3. 数据源与隐私：插件内置反向代理拉取数据，无需用户配置 CORS。浏览器端数据缓存于 sessionStorage（6h），无上传或遥测行为。
4. 配置覆盖：Agent 侧可通过 cordis.patch.yml 覆盖 baseUrl、cacheTtlHours 和 timeoutMs。

结尾¶

dsh-plugin-top 将目录浏览与客户端安装流程打通，适合需要频繁查找和安装 DSH 插件的开发者。更多细节可访问 GitHub 或 目录页。