DeepSeek Harness — 하루 만에 2.6만 별, "모든 것이 플러그인"인 에이전트 하네스

핵심 요약

• DeepSeek AI가 공개한 오픈소스 에이전트 하네스(harness), dsh (DeepSeek Harness) — 공개 하루 만에 26,746★ / 1,957 포크 (2026-08-13 실측)
• "Everything is a Plugin" 아키텍처 — 코어 기능조차 플러그인으로 조립, 기반은 Cordis의 "시공간 합성성" 패러다임
• 앞서 다룬 Reasonix가 "DeepSeek API 하나에 특화"라면, Harness는 정반대로 "무엇이든 플러그인으로 범용화" — DeepSeek 생태계의 두 갈래 길
• 설치·실행이 한 줄: npx @deepseek-ai/dsh web → 브라우저 Web UI (127.0.0.1:3080)
• 현재 developer preview — 공식적으로 "호환성을 깨는 변경이 있을 것" 경고

---

1. Reasonix와 정반대 지점에 선 도구

지난 글 「스타 33,240개 받은 DeepSeek 코딩 에이전트 Reasonix」에서 확인한 건 하나의 명확한 설계 선택이었다. Reasonix는 DeepSeek API 하나에 루프 전체를 맞췄다. 멀티 프로바이더를 포기하는 대신 prefix-cache 안정성(ImmutablePrefix·AppendOnlyLog·VolatileScratch)을 불변식으로 삼아, 캐시 히트 99.82%로 하루 $3 미만을 실현했다.

2026년 8월 13일 DeepSeek AI가 공개한 DeepSeek Harness는 같은 회사의 기술을 쓰지만 정반대 지점에 서 있다.

Reasonix: "DeepSeek 하나에 특화해 극한의 효율" DeepSeek Harness: "무엇이든 플러그인으로 범용화"

이 대비가 이 글의 핵심이다. Reasonix가 서드파티(esengine)가 만든 "단일 프로바이더 특화 에이전트"라면, Harness는 DeepSeek 공식이 만든 "플러그인 중심 범용 하네스"다.

2. 공개 하루 만에 2.6만 별

반응은 즉각적이다.

Reasonix가 생성 후 110일 동안 일평균 +302개로 쌓은 속도라면, Harness는 공개 당일 단 하루에 이 규모를 찍었다. DeepSeek의 공식 채널 + "에이전트 하네스"라는 시의적절한 주제가 맞물린 결과다.

3. 핵심 아키텍처 — "모든 것이 플러그인"

DeepSeek Harness의 핵심 명제는 한 문장이다:

Everything is a Plugin.

Reasonix가 "캐시를 깨지 않는 불변식"이라는 단일 목표에 전부를 정렬했다면, Harness는 목표조차 플러그인으로 조립한다. 도구(tool), 모델 프로바이더, UI, 명령어까지 전부 플러그인이고, 이들을 조립해 하네스를 만든다.

이 설계의 이점:

• 특정 기능을 제거/교체해도 나머지가 무너지지 않음
• 커뮤니티가 dsh-plugin 토픽을 달고 플러그인을 독립 배포 가능 (공식 권장)
• 사용자가 자기 워크플로에 맞게 하네스를 재구성

즉 Reasonix는 "DeepSeek API를 가장 싸게 쓰는 법"을 설계로 풀었고, Harness는 "에이전트의 골격 자체를 확장 가능하게 만드는 법"을 설계로 푼 것이다.

4. 기반 기술 — Cordis와 "시공간 합성성"

dsh는 Cordis라는 프레임워크 위에서 동작한다. DeepSeek 공식 README가 Cordis의 설계 논문을 가리키는데, 핵심 개념은 "시공간 합성성(Spatiotemporal Composability)" 이다.

• 공간(spatial): 여러 플러그인이 동시에 활성화되어 병렬로 조합
• 시간(temporal): 플러그인의 생명주기(로드/언로드)를 선언적으로 관리
• 합성성: 개별 플러그인의 독립성을 깨지 않고 유연하게 결합

"모든 것이 플러그인"이 가능한 기술적 근거다. 단순히 "플러그인을 지원한다"가 아니라, 플러그인 자체가 시스템의 기본 단위가 되는 패러다임이다.

5. 실행 — 한 줄로 시작

Reasonix도 npm 한 줄(npm install -g reasonix)이었지만, Harness는 설치조차 필요 없다:

npx @deepseek-ai/dsh web

Node.js만 있으면 이 한 줄로 Web UI가 뜨고, 기본 http://127.0.0.1:3080에서 서비스된다. 소스에서 돌리려면:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install && pnpm run build
pnpm dsh web

Python SDK 문서(python-sdk.md)도 있어 파이썬 워크플로에서도 하네스에 접근할 수 있다.

6. 주의 — 아직 developer preview

공식 README가 명확히 경고한다:

DeepSeek Harness is currently in developer preview and is iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES.

Reasonix가 v1.21.3까지 안정판을 내며 실사용자 기반을 쌓은 것과 달리, Harness는 아직 프로덕션에 쓰기엔 이르다. 오픈이슈 0건은 "안정적"이라기보다 "공개 직후"라는 뜻에 가깝다.

7. 판단 — 두 갈래 길의 의미

둘은 경쟁이 아니라 DeepSeek 생태계의 두 계층이다. Reasonix는 "DeepSeek API를 가장 효율적으로 소비하는 클라이언트"이고, Harness는 "에이전트를 조립하는 골격"이다. 하나가 다른 하나를 대체하지 않는다.

가장 흥미로운 지점은 "코어조차 플러그인" 이라는 극단적 모듈화다. Reasonix가 보여준 것처럼 "하나에 특화하면 극한의 효율이 나온다"가 한 갈래라면, Harness의 "전부 조립 가능하게 만들면 뭐든 된다"가 다른 갈래다. 이 선택이 실제 유연성을 가져올지, 조립 복잡도만 높일지는 앞으로의 채택률이 보여줄 것이다.

표본 한계

• 별/포크 수는 공개 당일(8/13) 시점 스냅샷 — 시간에 따라 변함
• developer preview라 실제 동작·안정성은 검증 전
• Cordis 설계 논문의 기술적 세부는 간접 확인 (레포 README 기준)