前言¶
DeepSeek Harness 的生态理念是「一切皆插件」。随着插件数量增加，开发者需要在官方目录与本地环境之间频繁切换，管理效率受到影响。dsh-top-leaderboard 旨在解决这一问题，它将插件发现与管理流程集成到 Web GUI 的侧栏中，提供浏览、搜索、权限检测与一键安装的一站式能力。
是什么¶
dsh-top-leaderboard 是一个客户端插件，由开发者 l541402398 维护，基于 MIT 许可证开源。
它为 DeepSeek Harness 的 Web 界面侧栏底部增加了一个「🏆 榜单」入口。点击后弹出的窗口允许用户查看和搜索插件，区分插件类型，检测访问权限，并直接完成安装。插件内置了实时安装日志功能，能够显示仓库大小预估和下载进度。
核心功能¶
侧栏入口与弹窗交互
在 Web GUI 侧栏底部增加「🏆 榜单」按钮，点击唤起弹窗。弹窗内支持搜索与排行展示，支持查看插件详情。
双源榜单数据
弹窗包含两个 Tab：
* 热度榜：展示 dsh-external 生态榜单，数据基于本地快照 data/leaderboard.json。
* 官方 dsh-plugin：实时拉取 GitHub 上带有 dsh-plugin topic 的公开插件，按 Star 数排序。
信息展示与预警
每个条目展示插件类型徽章（技能 / Bundle / Cordis / Marisa）以及仓库大小。
* 当仓库大小 ≥ 100MB 时，显示橙色警示。
* 热度榜的大小数据会渐进式补全并缓存。
一键安装流程
* 优先策略：HTTPS 浅克隆优先，强制使用 HTTP/1.1 以规避 HTTP/2 断流问题。若失败，自动重试 3 次并退回 SSH 方式。
* 路径映射：技能类插件安装至 ~/.dsh/skills/；Bundle 和 Cordis 类插件安装至 web profile。
* 下载前日志：安装前先报告仓库大小，大仓库会预估下载时间，避免用户在不知情的情况下等待过大文件。
* 信任配置：安装接口会自动信任 loopback 与部署声明的 trusted-host，通过域名访问不会出现 403 错误。
权限检测与持久化
* 私有仓库条目前显示 🔒，点击可检测访问权限。检测通过后显示绿色 🔓，结果在跨刷新后保持持久化。
实时反馈
安装过程中显示实时日志，支持展开查看失败原因。安装完成后状态标记为「已安装」，并跨刷新持久化。
安装与启用¶
前置条件¶
- 已安装 DeepSeek Harness 命令行工具（
dsh）。 - 已安装
pnpm。 - 若需安装私有仓库，需配置好 GitHub SSH 密钥（确保
~/.ssh/config指向正确的密钥，且ssh -T git@github.com能登录）。
安装步骤¶
- 在终端执行安装命令：
dsh plugin --profile web add github:l541402398/dsh-top-leaderboard
- 重启 Web 服务以加载插件：
dsh web
- 在浏览器访问 http://127.0.0.1:3080，刷新页面后，侧栏底部会出现「🏆 榜单」按钮。
适用场景与注意¶
该插件适合需要频繁探索和安装 DSH 插件的开发者。由于插件以当前 dsh 进程的权限运行，安装前建议检查源码与许可证，避免引入不安全内容。对于需要访问私有仓库的场景，必须提前配置好 SSH 密钥认证。
总结¶
dsh-top-leaderboard 通过侧栏按钮和弹窗交互，将插件管理从外部目录迁移到了本地 Web 界面。它通过 HTTPS 浅克隆优先策略规避网络断流风险，并提供下载预估与权限检测，提升了插件安装的可靠性与可控性。
更多细节与源码请访问：GitHub 仓库
