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 代理外掛程式的人不可或缺的基礎設施。