수록 현황:313 건의 뉴스/102 개의 AI 도구/397 개의 오픈소스 프로젝트/74 개의 학습 자료
홈뉴스오픈소스모델AI 도구학습 자료
홈 / 오픈소스 / deepseek-harness

deepseek-harness

DeepSeek AI의 오픈소스 플러그인 기반 에이전트 프레임워크로, 모델, 도구, 샌드박스, 스토리지 및 UI를 모두 교체 가능한 Cordis 플러그인으로 구성하여 완전한 세션 추적성을 제공합니다.

TypeScriptMITAgent
⭐ GitHubhttps://github.com/deepseek-ai/deepseek-harness
57,398
스타 수
+0
스타 증가율
2026년 8월 13일
최근 업데이트
2
클릭 수

1. 프로젝트 개요

DeepSeek Harness(dsh)는 DeepSeek AI가 개발한 오픈소스 플러그인 기반 에이전트 프레임워크입니다. 개발자는 이를 통해 모든 모델 호출과 도구 실행부터 샌드박스 내 코드 실행에 이르기까지 AI 에이전트를 구축, 실행 및 완벽하게 추적할 수 있으며, 시스템의 모든 부분을 플러그인으로 교체하거나 재구성할 수 있습니다.

2. 배경 및 포지셔닝

DeepSeek Harness는 모든 팀이 모델 라우팅, 도구 실행, 샌드박싱, 세션 저장, 스케줄링과 같은 동일한 에이전트 스캐폴딩을 처음부터 다시 구축해야 하는 부담을 덜고, 커뮤니티에게 실제 환경에서 AI 에이전트의 가능성(및 한계)을 탐구할 수 있는 개방적이고 재사용 가능하며 조합 가능한 인프라를 제공하기 위해 만들어졌습니다.

핵심 미션은 프로젝트 자체의 표현대로 "모든 것은 플러그인이다"라는 점에 명확히 드러납니다. 이 프레임워크는 Cordis를 기반으로 구축되었습니다. Cordis는 제작자들이 "시공간적 조합 가능성(spatiotemporal composability)"이라고 부르는 개념을 위해 설계된 플러그인 런타임으로, 주변 시스템을 재설계하지 않고도 기능(모델, 도구, 스킬, 샌드박스, 스토리지)을 추가, 제거 또는 핫스왑할 수 있는 능력을 의미합니다.

다른 많은 에이전트 프레임워크와 구별되는 점은 엔드투엔드로 적용되는 이 일관된 플러그인 모델입니다. 모델, 도구, 스킬, 세션, 샌드박스, 스토리지, 스케줄링 루프, 심지어 웹 UI까지 모두 동일한 기반 위에 구축된 일급 플러그인이며, 몇 개의 확장 포인트가 덧붙여진 고정된 코어가 아닙니다. 완전한 추적성을 위한 추가 전용 세션 로깅과 결합되어, 단순히 답변을 생성하는 에이전트가 아닌 행동을 검사하고 재생하며 감사할 수 있어야 하는 팀을 대상으로 합니다.

3. 기능 카테고리

  • 🧩 플러그인 시스템 — 기초 레이어입니다. 모든 기능(모델, 도구, 스킬, 세션, 샌드박스, 스토리지, 루프, 스케줄링, UI)은 독립적으로 교체 가능한 Cordis 플러그인으로 구현되어, 팀이 코어를 포크하지 않고도 컴포넌트를 자유롭게 혼합하여 사용할 수 있습니다.
  • 🤖 모델 및 도구 오케스트레이션 — 파일 편집, 셸 접근, 웹 검색을 포함한 코딩 에이전트를 위한 플러그인 가능한 모델 백엔드와 완전한 도구 세트를 제공하여, 에이전트가 실제 코드베이스와 실제 환경에서 작동할 수 있게 합니다.
  • 📝 세션 기록 및 재생 — 추가 전용 세션 로그가 모든 모델 상호작용을 캡처하여, 디버깅 및 감사를 위해 과거 에이전트 실행의 검사, 재개, 포크 및 재생을 가능하게 합니다.
  • 🖥️ 다양한 런타임 모드 — Standard(완전한 코딩 에이전트 도구 세트), Code(TypeScript 기반 도구 오케스트레이션), Minimal(경량 벤치마킹 환경), Creator(실시간 런타임 검사가 가능한 커스텀 프리셋 개발) 모드를 제공하여, 프로덕션 에이전트부터 제어된 벤치마크까지 다양한 사용 사례를 지원합니다.
  • 🌐 웹 UI — 추가 도구 없이 실행 중인 에이전트와 상호작용하고 관찰할 수 있는 내장 브라우저 인터페이스(로컬에서 서비스됨, 예: http://127.0.0.1:3080)입니다.
  • 🔌 커뮤니티 플러그인 생태계 — GitHub에서 dsh-plugin 태그가 지정된 수백 개의 서드파티 플러그인으로, 비전/멀티모달 확장, 샌드박스, MCP 통합, 터미널 UI 및 워크플로우 도구에 이르기까지 다양합니다.

4. 주요 하이라이트

  • 모든 것은 플러그인 — 모델, 도구, 스킬, 세션, 샌드박스, 스토리지, 루프, 스케줄링 및 UI가 모두 동일한 방식으로 구현되고 교체되므로, 시스템을 확장하기 위한 단일 멘탈 모델을 가질 수 있습니다.
  • 설계 단계부터 완벽한 추적성 — 세션 상태가 추가 전용이므로 모든 에이전트 실행을 검사, 재개, 포크 또는 재생할 수 있으며, 이는 비결정적 에이전트 동작을 디버깅하는 데 필수적입니다.
  • Cordis 기반 — 임시 변통의 확장 메커니즘이 아닌 전용 플러그인 런타임(논문 A Programming Paradigm for Spatiotemporal Composability에 문서화됨) 위에 구축되어, 플러그인 시스템에 형식적인 이론적 토대를 제공합니다.
  • 호스트/클라이언트 집계 아키텍처 — 코드베이스가 호스트 패키지(tsconfig.host.json)와 클라이언트 패키지(tsconfig.client.json)를 명확히 분리하여, 양측이 타입 충돌 없이 동일한 Cordis Context 인터페이스를 서로 다른 서비스로 안전하게 확장할 수 있습니다.
  • 기본 제공되는 다중 런타임 프리셋 — Standard, Code, Minimal, Creator 모드가 추가 설정 없이 코딩 에이전트, TypeScript 오케스트레이션 도구 사용, 경량 벤치마킹 및 커스텀 프리셋 작성을 지원합니다.
  • 설치 없는 퀵 스타트 — npx @deepseek-ai/dsh web 명령어로 즉시 작동하는 웹 UI를 실행하여 초기 사용 장벽을 낮췄습니다.

5. 역할별 사용 사례

  • 일반 개발자: Standard 런타임 모드를 사용하여 파일 편집, 셸 및 웹 검색 도구를 갖춘 코딩 에이전트를 구동하고, 웹 UI를 통해 일상적인 개발 작업을 수행합니다.
  • DevOps/SRE: 샌드박스화된 실행과 추가 전용 세션 로그를 활용하여 자동화된 운영 에이전트를 실행하고 감사하며, 인시던트 진단 시 과거 실행을 재생합니다.
  • 데이터/연구 과학자: Minimal 모드를 제어된 벤치마킹 환경으로 사용하여 축소되고 재현 가능한 도구 세트 하에서 에이전트나 모델의 동작을 평가하고, 분석을 위해 세션 재생을 사용합니다.
  • 프로젝트 매니저 / 플랫폼 팀: Creator 모드를 채택하여 팀의 워크플로우에 맞는 커스텀 에이전트 프리셋을 조립하고 검사한 다음, 재사용 가능한 플러그인으로 배포합니다.

6. 시작하기

필요한 것 찾기 — 공식 문서, 개발 가이드 및 GitHub에서 dsh-plugin 태그가 지정된 커뮤니티 플러그인을 탐색하세요.

설치 / 통합 — 가장 빠른 방법은 npm이며 클론이 필요 없습니다:

npx @deepseek-ai/dsh web

이 명령은 http://127.0.0.1:3080에서 웹 UI를 시작합니다. 대신 소스에서 빌드하려면:

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

기여하기 — 리포지토리의 CONTRIBUTING.md와 AGENTS.md를 읽고, 변경 사항을 제출하기 전에 관련 검사를 실행하세요:

pnpm run typecheck
pnpm run lint
pnpm run check:all

7. 프로젝트 구조

deepseek-harness/
├── tsconfig.json          # 솔루션 루트 / tsserver 검색 진입점
├── tsconfig.base.json      # 공유 컴파일러 옵션 및 경로 해석
├── tsconfig.host.json      # Host 집계: 호스트 패키지, 예제, 테스트, 스크립트, 웹사이트
├── tsconfig.client.json    # Client 집계: packages/client/* 및 브라우저 앱
├── api/remotes/            # Host 및 Client 설정 모두에 걸쳐 있는 유일한 패키지
├── docs/                   # 개발, 아키텍처 및 사용자 가이드
└── AGENTS.md                # 에이전트 관련 기여를 위한 규칙

패키지는 Host 또는 Client 중 정확히 하나의 집계에만 등록되며 둘 다에는 등록되지 않습니다. 이는 양측이 함께 컴파일될 때 선언 병합된 Cordis Context 인터페이스가 충돌하는 것을 방지합니다.

8. 관련 생태계

  • Cordis — DeepSeek Harness가 구축된 기반 플러그인 런타임 프레임워크로, 플러그인을 위한 "시공간적 조합 가능성" 모델을 제공합니다.
  • Model Context Protocol (MCP) — 통합 레이어로 지원되어 외부 도구(예: 통계 또는 데이터 분석 도구)를 MCP 서버를 통해 에이전트에 노출할 수 있습니다.
  • 커뮤니티 플러그인 — dsh-plugin GitHub 토픽 아래 800개 이상의 리포지토리로 구성된 성장하는 생태계로, 비전/멀티모달 플러그인, 샌드박스 제공자, 터미널 UI 및 웹 UI 스킨 등을 포함합니다.

9. 라이선스

  • ✅ 관대한 MIT 라이선스에 따라 상업적 목적을 포함하여 코드를 사용, 수정 및 배포할 수 있습니다.
  • ✅ 라이선스 및 저작권 표시를 유지하는 조건으로 DeepSeek Harness를 독점 제품에 통합할 수 있습니다.
  • ❌ 보증은 제공되지 않으며, 소프트웨어는 "있는 그대로(as is)" 제공됩니다.
  • ℹ️ 서드파티 의존성은 자체 라이선스를 가지며, THIRD_PARTY_NOTICES.md에 별도로 문서화되어 있습니다.

10. 자주 묻는 질문

Q: DeepSeek Harness는 프로덕션 사용 준비가 되었나요?
A: 현재 개발자 프리뷰 단계이며 빠르게 반복되고 있으므로, 유지 관리자들은 호환성을 깨는 변경 사항에 대해 명시적으로 경고하고 있습니다. 프로덕션에서 의존하기 전에 신중하게 평가하십시오.

Q: Cordis란 무엇이며 왜 프로젝트가 이것에 의존하나요?
A: Cordis는 DeepSeek Harness의 "모든 것은 플러그인" 아키텍처의 기반이 되는 플러그인 런타임 프레임워크입니다. 설계 근거에 대해서는 리포지토리에서 참조된 논문 A Programming Paradigm for Spatiotemporal Composability를 참고하십시오.

Q: 소스에서 빌드하지 않고 사용해 볼 수 있나요?
A: npx @deepseek-ai/dsh web을 실행하여 http://127.0.0.1:3080에서 로컬로 웹 UI를 시작하십시오.

Q: 나만의 플러그인을 작성할 수 있나요?
A: 네 — 플러그인은 @Remote 또는 @RemoteScope 데코레이터를 사용하여 호스트 서비스에 선언되고, 클라이언트 측에서는 ctx.remote를 통해 소비됩니다. 자세한 내용은 개발 가이드를 참조하십시오.

Q: 커뮤니티에서 만든 플러그인은 어디에서 찾을 수 있나요?
A: GitHub의 dsh-plugin 토픽을 탐색하십시오. 여기에는 비전, 샌드박스, 터미널 UI 등을 위한 서드파티 플러그인이 나열되어 있습니다.

11. 빠른 링크

12. 요약

DeepSeek Harness는 AI 에이전트 구축을 위한 일관되고 완전히 추적 가능한 플러그인 아키텍처를 제공하여, 팀이 스택을 재설계하지 않고도 모델, 도구, 샌드박스 및 스토리지를 교체할 수 있게 합니다. 이는 감사 가능하고 재생 가능한 에이전트 실행이 필요하며, 안정적인 장기 지원 릴리스보다는 빠르게 변화하는 개발자 프리뷰 환경에서 작업하는 것에 익숙한 개발자 및 팀에게 가장 적합합니다.