AdamPlatin123/dsh-plugin-radar

DSH Plugin Radar – 是什么

DSH Plugin Radar 是一个开源的「雷达」，持续发现、测试并归档 DeepSeek Harness (DSH) — 用于构建 AI 代理和 LLM 驱动应用的平台 — 的插件。该项目自动执行以下操作：

1. 每 6 小时扫描一次 GitHub，查找看起来像 DSH 插件的仓库（通过主题和关键词识别）。
2. 去重并过滤 私有或黑名单仓库。
3. 验证每个候选插件（检查 package.json 是否包含所需的 DSH 入口点）。
4. 为每个插件运行轻量级 Kubernetes Pod（最多 10 个并发），测试其是否能启动并与 Qwen 模型以流式模式通信。
5. 将结果分类为四种状态桶 — ✅ 兼容，⚠️ 需要适配，⬜ 等待测试，❌ 失败，并每 15 分钟记录一次机器可读的快照。

所有这些数据被转化为对人类友好的成果：

• PLUGINS-ALL.md — 包含每个发现仓库的状态、星标数和分类的完整列表。
• 精选插件榜 — 56 个高质量插件的精选列表，按 11 个功能领域分组。
• 整合包 — 针对特定用途（如 UI 皮肤、代理技能包、桌面发行版）预安装的一组插件。
• JSON API — 两个稳定端点（plugins-all.json 和 plugins.json），下游工具（市场、社区站点）可无需注册直接消费。

雷达本身分为 雷达引擎（engine/）负责发现、聚合和渲染，以及 测试引擎（仍在开源中）负责运行 Kubernetes 验证 Pod。

---

谁会用它？

• 插件开发者 — 获得自动曝光；只需在仓库中添加 dsh-plugin 主题，雷达将在数小时内发现。
• DSH 高级用户 — 浏览精选列表，找到已验证可运行的插件，无需试错。
• 市场运营者 — 获取 JSON 判定结果，显示兼容性徽章或过滤列表。
• 研究者 — 通过公开快照研究 DSH 生态系统的健康状况（增长、失败率、分类）。

---

如何工作（简化版）

flowchart TB
  A[GitHub 搜索] --> B[去重 & 过滤]
  B --> C[静态检查 (package.json)]
  C -->|插件| D[K8s 运行时测试]
  D --> E{判断结果}
  E -->|兼容| F[✅]
  E -->|需要适配| G[⚠️]
  E -->|等待测试| H[⬜]
  E -->|失败| I[❌]
  F & G & H & I --> J[快照 (data/snapshots/)]
  J --> K[渲染 Markdown 与 JSON]

• 发现 每 6 小时运行一次，每 15 分钟进行一次更细粒度探测。
• 测试 使用 20 秒驱动程序，在 Pod 内部流式传输 Qwen 模型（de-stream）。
• 结果 以不可变快照形式存储，然后输入渲染器，生成 Markdown 目录和 JSON API。

---

快速上手

1. 探索数据 — 打开 PLUGINS-ALL.md 或通过 README 中显示的 URL 获取 JSON。
2. 添加自己的插件 — 在仓库中添加 dsh-plugin 主题并推送；雷达将自动发现。
3. 消费 API — README 中提供 Python 示例代码，用于将仓库名映射到其兼容性判断。
4. 关注路线图 — 第二阶段（引擎源码）已公开；第三阶段（轻量级与全规模测试引擎）将在稳定后发布。

---

快速术语表

• DSH — DeepSeek Harness，用于构建 LLM 驱动代理的开源框架。
• 雷达引擎 — 项目中负责发现仓库并构建目录的部分。
• 判断桶 — ✅ 兼容，⚠️ 需要适配，⬜ 等待测试，❌ 失败。
• 整合包 — 可一起安装的预定义插件集合。

---

总结

DSH Plugin Radar 是一个真实运行的持续服务，用于映射 DeepSeek Harness 插件生态系统的健康状况和可用性。它既提供开发者友好的流水线，也提供即用型的精选列表，是任何在 DSH 平台上构建或使用 AI 代理插件的人不可或缺的基础设施。