에이전트 프레임워크도구/라이브러리TypeScript

deepseek-ai/deepseek-harness

DeepSeek Harness: Everything is a Plugin.

GitHub 에서 보기 ↗카드 기준일 2026-10-31 · 처음 작성 2026-10-28 · 갱신 2026-11-02
+7,321지난 주
2.8%규모 대비 성장률
267,642누적 스타

AI 작성이 카드는 AI(Claude)가 공개 자료(README·릴리스·HN·웹 글)로 쓴 요약입니다. 사람이 검토하지 않았으며, 주장마다 출처 링크와 확인·추정 표시를 붙였습니다. 숫자는 GitHub API 값을 코드가 채웁니다.

013줄 요약

  • 무엇인지 — deepseek-harness(dsh)는 DeepSeek AI가 공개한 MIT 라이선스 에이전트 하네스다. Cordis 위에서 모델 어댑터·도구·세션·에이전트 루프까지 모든 구성 요소를 플러그인으로 교체할 수 있다.
  • 왜 지금 떴나 — 뚜렷한 급등일은 없다. 8월 13일 공개 이후 이어진 관심 위에 10월 17일 v0.2.1-rc.1·rc.2(플러그인 인덱스, Claude Code·Codex 조합 패키지, DeepSeek-V4.1-Flash 지원)와 10월 23일 rc.3가 연달아 나오며 상위권을 유지한 것으로 보인다.
  • 어떤 의미인지 — 에이전트를 모델과 하네스로 나눠 보는 관점에서, 툴·샌드박스·루프를 직접 갈아 끼우거나 Claude Code·Codex를 하위 에이전트로 부리는 실험 기반이 생겼다는 뜻이다. 다만 아직 개발자 프리뷰라 운영 환경 도입은 이르다.

02숫자

누적 스타267,6422026-10-31
지난 주+7,321전주 8,558
규모 대비 성장률2.8%주 시작 260,321
생성08.132026년
주간 스타 · 최근 12주
12주 전10.25 주
이번 주 일별 스타 (UTC)
일 10.25토
항목값
누적 스타267,642 (2026-10-31 기준)
이번 주 증가+7,321
성장률+3% (주 시작 260,321)
AI 탭 순위지금 뜨는 11위 · 누적 TOP 6위
일별 증가10-25 +1,136 · 10-26 +1,239 · 10-27 +1,191 · 10-28 +1,138 · 10-29 +1,014 · 10-30 +787 · 10-31 +816
급등일없음
유형 · 카테고리도구/라이브러리 · 에이전트 프레임워크 (보조: 코딩 에이전트·IDE)
확인 필요없음

03왜 지금 떴나

  • 2026-08-13 DeepSeek이 저장소를 MIT 라이선스로 공개하고 v0.1 개발자 프리뷰로 출시했다. eigent.ai · deepinfra.com · andrew.ooo (확인)
  • 2026-08-19 r/LocalLLaMA와 YouTube에서 출시 소식과 설치·커스텀 플러그인 제작 영상이 퍼졌다. reddit.com · youtube.com (확인)
  • 2026-09-02 Wavect가 프로덕션 준비도 리뷰를 냈다. 제한된 엔지니어링 파일럿에는 적합하지만 운영 제어 평면으로는 이르다고 평가했다. wavect.io (확인)
  • 2026-10-06 eesel 블로그가 동작 방식과 비용을 정리하는 등 출시 두 달 뒤에도 해설 글이 계속 나왔다. eesel.ai (확인)
  • 2026-10-17 v0.2.1-rc.1과 rc.2가 나왔다. 커스텀 플러그인 인덱스, 에이전트가 플러그인을 만드는 기능, Claude Code·Codex 조합 패키지, Git Worktrees 플러그인, DeepSeek-V4.1-Flash-1017과 Search·Fetch API 지원이 들어갔다. GitHub 릴리스 · GitHub 릴리스 (확인)
  • 2026-10-23 주중에 v0.2.1-rc.3가 나와 플러그인 탐색용 More 메뉴를 추가하고 초안 유실 버그를 고쳤다. GitHub 릴리스 (확인)

04무엇인가

DeepSeek Harness(dsh)는 언어 모델을 감싸 실제 작업을 하게 만드는 런타임 계층이다. 모델이 환경을 이해하고, 도구를 쓰고, 여러 단계짜리 작업을 이어가도록 돕는다. DeepSeek은 이를 "Agent = Model + Harness"로 설명한다. 모델은 추론을 맡고, 하네스는 파일시스템·도구·세션·샌드박스·승인 흐름을 맡는다.

핵심 설계는 everything-is-a-plugin이다. 기존 플러그인 프레임워크 Cordis 위에 만들어졌다. 모델 어댑터, 도구 레지스트리, 세션 로그, 샌드박스, UI, 에이전트 루프 자체까지 모두 플러그인이라 따로 교체할 수 있다. 위임 백엔드로 subagent-claude-code와 subagent-codex가 들어 있어 다른 코딩 에이전트를 하위 에이전트로 호출할 수 있다. 실험적인 Claude Code Mods 호환 계층도 있다.

실행은 npx @deepseek-ai/dsh web 한 줄이면 된다. 기본으로 127.0.0.1:3080에 Web UI가 뜬다. 소스에서 pnpm으로 빌드할 수도 있고, 데스크톱 앱·headless·SDK(TypeScript/Python)·ACP 프로필도 있다. SSH 원격 실행용 helper 런타임도 제공한다. 서드파티 플러그인은 dsh-plugin 토픽과 커스텀 인덱스 소스로 찾아 설치하며, 호환 버전은 engines.dsh로 선언한다.

05비교

  • anthropics/claude-code — Claude Code가 하나로 고정된 코딩 에이전트라면 dsh는 Claude Code를 하위 에이전트로 호출하고 기존 hooks.json도 읽는 상위 런타임에 가깝다. mindstudio.ai · deepinfra.com (확인)
  • openai/codex — Codex도 subagent-codex 백엔드와 공식 조합 패키지로 dsh 안에서 위임 대상으로 쓸 수 있어, 경쟁 도구라기보다 조합 대상이 된다. GitHub 릴리스 · deepinfra.com (확인)
  • cordiverse/cordis — Cordis는 dsh보다 먼저 있던 범용 플러그인 프레임워크다. dsh는 그 위에 에이전트용 플러그인 묶음을 얹은 응용이다. GitHub · datacamp.com (확인)

06활용사례

  • npx 실행과 소스 빌드 두 가지 설치 경로를 따라가는 설치 가이드와 영상 튜토리얼이 나와 있다. youtube.com · atlascloud.ai (확인)
  • 설치·설정 후 첫 커스텀 플러그인을 직접 만들고, 요청의 전체 실행 궤적을 추적해 보는 실습 영상이 있다. youtube.com (확인)
  • DeepInfra가 dsh를 자사 모델 엔드포인트에 연결해 에이전트 루프와 플러그인 구조를 직접 시험한 리뷰를 냈다. deepinfra.com (확인)
  • Wavect는 저장소·프리셋·보안 문서를 검토한 뒤 제한된 범위의 엔지니어링 파일럿 기반으로 쓰기를 권했다. wavect.io (확인)
  • 도입 전에 코드와 경계를 먼저 점검하는 식으로, 모듈형 에이전트 하네스의 참고 설계로 읽는 사례도 있다. magnus919.com (확인)

07한계·리스크

항목값
라이선스MIT
기여자50
상위 1명 기여 비중29%
지난 30일 이슈이슈 꺼짐
릴리스 주기약 1일마다
열린 이슈+PR0
  • 개발자 프리뷰 단계라 호환성을 깨는 변경이 예고돼 있다. 버전을 고정하고 운영 릴리스 파이프라인에는 아직 연결하지 말라는 권고가 있다. GitHub · atlascloud.ai · deepseekagent.io (확인)
  • 파일시스템 샌드박스는 네트워크와 프로세스 가시성을 범위에서 제외한다. 자격 증명이 로컬에 평문으로 저장된다는 지적도 있어, 소스코드·셸·크리덴셜 가까이에서 돌릴 때 주의가 필요하다. wavect.io · atlascloud.ai · magnus919.com (확인)
  • Claude Code Mods 호환 계층, Session 상태 API, 개발자 도구 등 여러 기능이 실험적이다. Claude Code Mods 호환은 실제 완전 호환을 목표로 하지 않는다고 명시돼 있다. GitHub 릴리스 (확인)
  • 서드파티 플러그인의 호환 판정 규칙이 engines.dsh 기준으로 바뀌었다. 플러그인 생태계에서는 플러그인 작성자가 버전 선언을 계속 따라 고쳐야 하는 부담이 생길 수 있다. GitHub 릴리스 (추정)

08변경 기록

근거