aust24lzy
dsh-plugin-hub
DeepSeek Harness (DSH) 开源插件导航站 —— 实时同步 dsh-plugin 生态,按 Stars 动态排行
- Stars
- 1
- Language
- JavaScript
- Created
- Aug 15, 2026
- Updated
- Aug 16, 2026
Introduction
🐋 DSH Plugin Hub
DeepSeek Harness(DSH)开源插件导航站 —— 实时同步 GitHub dsh-plugin 生态,按 Stars 动态排行、智能分类,帮助开发者 30 秒定位所需插件、快速上手 DSH。
🌐 在线访问(国际):https://aust24lzy.github.io/dsh-plugin-hub/ 🇨🇳 在线访问(国内):https://1d6da375127842fe97d4a7e3e98c670b.app.workbuddy.link/
📖 目录
✨ 功能
- 🔍 实时数据:定时抓取 GitHub
dsh-plugin话题全部公开仓库,浏览器端每 30 分钟实时刷新 Top 100 星标 - 🗂️ 智能分类:10 个分类(UI 界面 / Agent 编排 / 记忆知识 / 视觉多模态 / 开发工具 / 数据搜索 / 集成迁移 / 效率 / 娱乐彩蛋 / 安全)
- 📊 多维度筛选:分类 + 排序(Stars / Forks / 更新时间 / 收录时间)+ 关键词搜索 + 快捷筛选
- 🏆 排行榜:Top 10 Stars 榜单
- 🤖 智能问答助手:自然语言推荐插件,支持意图识别(10 类)、插件对比、多轮上下文与约束筛选(中文 / 高星 / 活跃 / 语言 / 协议)
- 🌐 英文描述一键翻译:插件描述为英文时,一键翻译为中文
- 📦 安装命令一键复制:
dsh plugin --profile web add github:owner/name - ⌨️ 键盘快捷键:⌘K / Ctrl+K 快速聚焦搜索
- 🌗 暗 / 亮主题、插件详情弹窗
- 🚀 双线部署:GitHub Pages(国际,自动)+ CloudStudio(国内,手动快照)
🏗️ 技术架构
- 零依赖原生 JS:无构建工具、无框架,纯 HTML + CSS + 原生 JS,可直接静态托管
- 共享问答引擎:
chat-engine.js抽离为纯逻辑(无 DOM 依赖,全局window.DSHChat),主站悬浮窗与全屏聊天页(assistant.html)复用同一套「意图识别 + 约束抽取 + 相关性评分」引擎 - 数据管道:
sync.mjs抓取 GitHub Search API → 相关性过滤 + 智能分类 → 生成plugins.json快照 → 前端渲染;浏览器端再对 Top 100 星标做 30 分钟级实时刷新 - 双线部署:GitHub Actions 每小时同步后自动部署到 GitHub Pages(国际);国内访问经 CloudStudio 分享链接(手动部署快照)
🚀 快速开始
本仓库为纯静态站点(HTML + CSS + 原生 JS),无需构建,任何静态服务器均可运行。
1. 前置要求
| 依赖 | 版本 | 用途 |
|---|---|---|
| Node.js | ≥ 18 | 运行数据同步脚本(可选) |
| Python 3 | 任意 | 本地起一个静态服务器(可选,也可用 npx serve 等) |
2. 克隆仓库
git clone https://github.com/aust24lzy/dsh-plugin-hub.git
cd dsh-plugin-hub
3. 本地运行
进入 web 目录,起一个静态服务器:
cd web
python -m http.server 8099
然后浏览器打开 http://127.0.0.1:8099 即可。
💡 也可以用任意静态服务器替代,例如:
npx serve web注:建议用本地服务器而非直接双击
index.html,部分浏览器下fetch本地 JSON 会受限。
4. 同步插件数据(可选)
站点默认读取 web/plugins.json 快照;如需刷新最新数据,运行同步脚本:
node scripts/sync.mjs
详见下方 数据同步。
🎯 使用示例
示例 1:本地启动站点
git clone https://github.com/aust24lzy/dsh-plugin-hub.git
cd dsh-plugin-hub/web
python -m http.server 8099
# 浏览器打开 http://127.0.0.1:8099
示例 2:搜索插件
在顶部搜索框输入关键词即可实时过滤:
- 输入
侧边栏→ 定位 Sidebar / UI 增强类插件 - 输入
视觉→ 找到能看图、OCR、多模态相关插件 - 输入
记忆→ 跨会话记忆、知识库类插件 - 输入
多 Agent→ 团队协作、编排类插件
示例 3:筛选与排序
- 点击分类标签(如
🎨 UI 与界面增强)查看对应类别 - 使用快捷筛选:
🔥 高星榜 (≥100)/🆕 近 7 天新增/🇨🇳 中文友好/🟢 近 30 天活跃 - 切换排序方式:
Stars/最近更新/Forks/最新收录
示例 4:查看详情 + 复制安装命令
点击任意插件卡片打开详情弹窗,可查看:简介、分类、语言、Stars、开源协议等,并一键复制安装命令:
dsh plugin --profile web add github:owner/name
将
owner/name替换为插件仓库的实际所有者与名称(弹窗内已自动生成完整命令)。
示例 5:智能问答助手
点击右下角悬浮球,用自然语言提问;也可点右上角「全屏聊天」进入独立聊天页:
- 🔍 找插件:「找能看图的插件」
- 🏆 推荐:「推荐高星插件」
- ⚖️ 对比:「对比 open-design 和 dsh-agent-teams」
- 📊 统计:「一共有多少插件」
- 📂 分类:「有哪些分类」
- 💬 多轮:「换一批」
示例 6:同步数据(带 Token 提升配额)
# 未认证(10 请求/分钟,脚本内置限流)
node scripts/sync.mjs
# 使用 GitHub Token 提升 API 配额(推荐)
GITHUB_TOKEN=ghp_xxx node scripts/sync.mjs
🔄 数据同步
同步脚本通过 GitHub Search API 抓取所有 topic:dsh-plugin 的公开仓库,做相关性过滤 + 智能分类后,生成 web/plugins.json 快照:
node scripts/sync.mjs [--out ../web/plugins.json]
- 支持环境变量
GITHUB_TOKEN认证(更高 API 配额) - 未认证限 10 req/min,脚本内置限流(约 7s/请求)
- GitHub Actions 每小时自动同步,并部署到 GitHub Pages(国际)
📁 目录结构
.
├── scripts/sync.mjs # 数据同步脚本(抓取 + 相关性过滤 + 智能分类)
├── web/ # 站点源码(纯静态,无需构建)
│ ├── index.html # 主页结构
│ ├── styles.css # 样式(含暗/亮主题)
│ ├── app.js # 主页逻辑(筛选 / 排序 / 排行榜 / 详情弹窗)
│ ├── chat-engine.js # 智能助手共享引擎(纯逻辑,无 DOM 依赖)
│ ├── assistant.html # 智能助手全屏聊天页
│ └── plugins.json # 数据快照(由 sync.mjs 自动生成)
├── .github/workflows/ # 自动同步 + 部署到 GitHub Pages(另含 COS 上传)
└── LICENSE # MIT 协议
🚀 部署
本项目通过 GitHub Actions 自动部署,并额外提供国内访问通道:
| 通道 | 平台 | 访问地址 | 更新方式 |
|---|---|---|---|
| 🌍 国际 | GitHub Pages | https://aust24lzy.github.io/dsh-plugin-hub/ | 每小时自动 |
| 🇨🇳 国内 | CloudStudio | https://1d6da375127842fe97d4a7e3e98c670b.app.workbuddy.link/ | 手动部署快照 |
1. GitHub Pages(国际,自动)
- 启用 Pages:仓库
Settings → Pages选择Deploy from a branch,分支设为gh-pages、目录/(root) - 授权 Action:
Settings → Actions → General勾选Read and write permissions - 推送代码到
main分支,或手动在Actions页运行Sync & Deployworkflow(每小时第 30 分钟自动执行一次)
2. CloudStudio(国内,手动)
国内访问使用 WorkBuddy CloudStudio 部署的分享链接(免备案、国内直连):
https://1d6da375127842fe97d4a7e3e98c670b.app.workbuddy.link/
⚠️ CloudStudio 是静态快照,GitHub Actions 每小时自动同步不会更新到此处;
web/有改动后需重新部署一次。
3. 腾讯云 COS(可选,需备案域名)
deploy.yml 已配置每小时同步上传到腾讯云 COS 桶 mfnx-1469339292(ap-guangzhou)。但注意:腾讯云 COS 规定 2024 年 1 月 1 日后创建的桶,用默认域名(含 cos-website 静态网站域名)访问会强制下载、无法预览。
如需通过 COS 正常访问,需绑定已备案的自定义域名(或接 CDN 域名)。所需 4 个密钥:
| 密钥名 | 说明 |
|---|---|
TENCENT_SECRET_ID | 腾讯云 API 密钥 SecretId |
TENCENT_SECRET_KEY | 腾讯云 API 密钥 SecretKey |
COS_BUCKET | COS 存储桶名称(mfnx-1469339292) |
COS_REGION | 存储桶地域(ap-guangzhou) |
🤝 贡献指南
欢迎任何形式的贡献!无论是修复 Bug、优化分类规则、改进界面,还是补充文档,都非常感谢 🙏
贡献方式
- Fork 本仓库到你的账号
- 创建特性分支:
git checkout -b feat/your-feature - 提交改动:
git commit -m "feat: 描述你的改动" - 推送到远端:
git push origin feat/your-feature - 发起 Pull Request,描述清楚改动内容与动机
提交规范
- 提交信息建议遵循 Conventional Commits:
feat:/fix:/docs:/chore:/refactor:等 - 一次提交尽量只做一件事,保持变更聚焦
主要贡献方向
| 方向 | 说明 | 涉及文件 |
|---|---|---|
| 分类规则 | 优化 dsh-plugin 生态的分类关键词与命中精度 | scripts/sync.mjs |
| 前端交互 | 新功能、性能优化、无障碍、主题适配 | web/app.js、web/styles.css |
| 智能助手 | 意图识别、约束抽取、推荐评分逻辑 | web/chat-engine.js |
| 文档 | 完善说明、示例、FAQ | README.md |
| Bug 修复 | 同步脚本、前端逻辑 | 任意 |
代码约定
- 前端保持零依赖、原生 JS(不引入构建工具 / 框架)
- 同步脚本使用 Node.js 内置 API(
node:fs/node:path/node:url/fetch),不引入第三方依赖 - 智能助手引擎(
chat-engine.js)保持纯逻辑、无 DOM 依赖,便于主站与全屏页复用 - 中文注释与文案,语义化命名,遵循 DRY 原则
提交前请确认
- 本地运行无报错
- 数据同步脚本可正常生成
web/plugins.json - 不影响现有暗/亮主题与筛选排序功能
所有贡献默认遵循本仓库的 MIT 协议。
📄 说明
本项目为非官方社区项目,数据源自 GitHub dsh-plugin 生态。DeepSeek Harness 由 DeepSeek 官方开源(MIT 协议)。