블로그하네스·Pi3분 읽기

DeepSeek이 스타 17만 개짜리 하네스를 통째로 풀어버렸습니다

DeepSeek이 모델 어댑터부터 UI까지 전부 플러그인으로 바꿔 끼우는 하네스를 MIT로 공개했습니다.

DeepSeek이 스타 17만 개짜리 하네스를 통째로 풀어버렸습니다 대표 이미지

DeepSeek이 GitHub에 레포 하나를 올렸습니다. 스타 17만 개, 포크 1.8만 개. 자기 코딩 에이전트의 몸통을 통째로 MIT 라이선스로 풀어놓은 겁니다.

이름은 DeepSeek Harness(dsh). 공식 슬로건은 한 줄입니다. "Everything is a Plugin." 모델 어댑터, 도구, 루프, UI까지 전부 교체 가능한 플러그인 구조입니다.

DeepSeek Harness GitHub 레포

하네스가 뭔가

모델은 뇌입니다. 하네스는 몸이에요.

도구, 메모리, 권한, 작업 루프, 워크스페이스, UI. 모델이 실제로 일하는 데 필요한 걸 전부 하네스에 담습니다. 같은 뇌라도 어떤 몸을 입히느냐에 따라 전혀 다른 일을 해내요.

DeepSeek은 이 몸을 통째로 MIT 라이선스 오픈소스로 풀었습니다.

Everything is a Plugin

DeepSeek은 dsh를 원칙 하나로 설계했습니다. 모든 것이 플러그인이다.

모델 어댑터, 도구 레지스트리, 에이전트 루프, 저장소, 스킬, 서브에이전트, 샌드박스, 컨텍스트 압축, 시스템 프롬프트, UI까지. 전부 교체 가능한 플러그인으로 만듭니다.

플러그인은 capability(능력)를 등록하고, 다른 컴포넌트는 구체 클래스 대신 그 능력에 의존해요. 플러그인은 등록을 전부 되돌릴 수 있는 effect로 처리해서, 내렸다 올려도 흔적을 깔끔하게 지웁니다.

덕분에 코어를 포크하지 않고도 에이전트의 행동을 바꿀 수 있어요. 모델, 도구, 루프, 메모리 전략을 전부 설정에서 바꿉니다.

# 플러그인 예시 (개념)
plugin:
  register: llm.adapter        # 능력 등록
  depends: [sandbox, storage]  # 의존성 선언
  effects:                     # 되돌릴 수 있는 effect
    - register_tools
    - register_hooks

컨텍스트 엔지니어링이 구조가 되는 순간

저는 dsh에서 pre-step 훅을 가장 흥미롭게 봤어요.

dsh는 모델이 응답하기 전 매 단계마다 훅을 실행합니다. 플러그인은 이 지점에서 보낼 메시지를 검사하고, 다시 쓰고, 거부할 수 있어요. 시스템 프롬프트를 수정하거나, 도구 목록을 제한하거나, 컨텍스트를 주입하거나, 압축을 교체할 수 있죠.

즉, 컨텍스트 엔지니어링을 구조 안에 넣을 수 있어요. "잘 시키는 법"을 코드로 박아 두는 거죠.

세션도 특이합니다. 세션은 타입이 있는 이벤트의 append-only 로그예요. dsh는 모델이 볼 히스토리를 이 로그에서 다시 만듭니다. 모델이 본 모든 것을 세션 기록에서 재구성할 수 있어야 하죠. **"로그가 기억한다"**는 원칙입니다.

모델과 하네스의 분리

DeepSeek은 이 설계로 시장에 분명한 메시지를 던집니다.

지금까지는 에이전트 품질 차이를 "어느 모델이냐"로 설명했습니다. 하지만 하네스를 열어 두니 같은 모델로도 훨씬 나은 결과를 만들 수 있어요. 저는 이제 모델보다 하네스를 더 큰 변수로 봅니다.

저도 이 글을 쓸 때 같은 원리로 에이전트를 돌립니다.

  • 출처가 검증된 사실만 쓰는 리서치 게이트
  • em dash 같은 금지어를 잡는 리뷰 게이트
  • 한 줄 한 메시지의 가독성 규칙
  • 발행 후 링크를 검증하는 파이프라인

모델은 하나지만, 저는 이 과정으로 품질을 끌어올립니다. 모델을 바꾸기 전에 프로세스를 먼저 바꿔야 하는 이유예요.

그래서 뭘 하면 되나

모델을 바꾸기 전에 프로세스를 먼저 보세요.

체크리스트 하나만 더해도 모델을 바꾸는 것보다 결과를 크게 바꿀 수 있어요. DeepSeek은 그걸 하네스 코드로 보여 주고 있습니다.

원문과 참고 자료

FAQ

자주 묻는 질문

DeepSeek Harness를 지금 바로 써볼 수 있나요?
네. MIT 라이선스 오픈소스라 GitHub에서 받아 바로 쓸 수 있어요. 모델 어댑터부터 도구, 루프, UI까지 전부 플러그인으로 교체할 수 있는 구조예요.
하네스가 왜 모델보다 중요해지나요?
같은 모델을 써도 하네스(도구, 메모리, 권한, 작업 루프)를 어떻게 꾸미느냐에 따라 팀마다 전혀 다른 결과를 얻어요. DeepSeek이 하네스를 공개하면서, 개발자는 이제 모델 대신 작업 과정을 손봐서 품질을 끌어올릴 수 있어요.
컨텍스트 엔지니어링이 구조가 된다는 건 무슨 뜻인가요?
dsh는 모델이 응답하기 전 매 단계 pre-step 훅을 실행해요. 개발자는 이 지점에서 메시지를 검사하고 다시 쓰고 거부할 수 있습니다. '잘 시키는 법'을 요령으로 두지 않고 코드로 박아 두는 셈이죠.
원고, 봉투, 책자가 오렌지 리본 하나로 이어진 모습

SEASON 3

시즌3 「콘텐츠로 팔기」

AI와 콘텐츠를 만들고 고객에게 연결하는 4주

제가 에이전트로 조사하고 쓰고 파는 과정을 그대로 보여 드려요. 그다음 각자의 주제로 같이 만들어 봐요.

10월 2일 OT · 10월 5일부터 월·수 4주 · 10월 31일 오프라인

시즌3 커리큘럼 보기