AdamPlatin123/dsh-plugin-radar

DSH Plugin Radar – 무엇인가요

DSH Plugin Radar는 DeepSeek Harness (DSH) — LLM 기반 에이전트 및 애플리케이션을 구축하기 위한 플랫폼 — 전용 플러그인을 지속적으로 탐지하고, 검증하며, 카탈로그화하는 오픈소스 "레이다"입니다. 이 프로젝트는 자동으로 다음 작업을 수행합니다:

1. GitHub을 6시간마다 스캔하여 DSH 플러그인으로 보이는 리포지토리(주제 및 키워드 기반)를 탐지.
2. 중복 제거 및 개인 또는 블랙리스트 등록된 리포지토리 필터링.
3. 각 후보를 검증(필수 DSH 엔트리 포인트가 package.json에 포함되어 있는지 확인).
4. 각 플러그인에 대해 가벼운 Kubernetes 포드를 실행(최대 10개 동시 실행)하여 Qwen 모델과 스트리밍 모드로 통신 가능한지 확인.
5. 결과를 네 가지 상태 버킷으로 분류 — ✅ 호환성 있음, ⚠️ 적응 필요, ⬜ 테스트 대기, ❌ 실패 — 15분마다 기계가 읽을 수 있는 스냅샷으로 기록.

이 모든 데이터는 사용자 친화적인 아티팩트로 변환됩니다:

• PLUGINS-ALL.md — 상태, 스타 수, 카테고리 포함 모든 발견된 리포지토리의 전체 목록.
• 추천 플러그인 목록 — 56개의 고품질 플러그인을 11개의 기능 영역으로 분류한 카테고리화된 목록.
• 번들 — 특정 용도(예: UI 스킨, 에이전트 기술 팩, 데스크톱 배포판)에 맞춰 미리 설치 가능한 플러그인 세트.
• JSON API — 두 개의 안정된 엔드포인트(plugins-all.json, plugins.json)를 제공하여 하류 도구(마켓플레이스, 커뮤니티 사이트)가 등록 없이 사용 가능.

레이다 자체는 레이다 엔진(engine/)과 테스트 엔진(아직 오픈소스화 중)으로 나뉩니다. 레이다 엔진은 리포지토리 탐지, 집계, 렌더링을 담당하고, 테스트 엔진은 Kubernetes 검증 포드를 실행합니다.

---

누구에게 유용할까?

• 플러그인 개발자 — 자동으로 노출됨. 리포지토리에 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초 드라이버를 사용해 포드 내부에서 Qwen 모델(de-stream)을 스트리밍.
• 결과는 불변의 스냅샷으로 저장된 후, 렌더러에 공급되어 Markdown 카탈로그와 JSON API 생성.

---

시작하기

1. 데이터 탐색 — PLUGINS-ALL.md 열기 또는 README에 표시된 URL로 JSON 가져오기.
2. 자신의 플러그인 추가 — 리포지토리에 dsh-plugin 주제 추가 후 푸시. 레이다가 자동으로 감지.
3. API 사용하기 — README에 리포지토리 이름을 호환성 판단으로 매핑하는 예제 Python 스크립트 제공.
4. 로드맵 확인하기 — 2단계(엔진 소스)는 이미 공개됨. 3단계(경량 및 완전 규모 테스트 엔진)는 안정화 후 공개 예정.

---

빠른 용어집

• DSH — DeepSeek Harness, LLM 기반 에이전트를 구축하기 위한 오픈소스 프레임워크.
• 레이다 엔진 — 리포지토리 탐지 및 카탈로그 구축을 담당하는 프로젝트 부분.
• 판단 버킷 — ✅ 호환성 있음, ⚠️ 적응 필요, ⬜ 테스트 대기, ❌ 실패.
• 번들 — 함께 설치 가능한 미리 정의된 플러그인 모음.

---

결론

DSH Plugin Radar는 DeepSeek Harness 플러그인 생태계의 건강 상태와 사용 가능성을 실시간으로 맵핑하는 실제 작동 중인 서비스입니다. 개발자 친화적인 파이프라인과 즉시 사용 가능한 카테고리화된 목록을 제공하여, DSH 플랫폼에서 AI 에이전트 플러그인을 개발하거나 사용하는 모든 사람에게 유용한 인프라입니다.