**DeepSeek Harness(dsh)**는 DeepSeek AI가 공개한 에이전트 하네스다. 모델 호출 루프에 도구, UI, 상태, 확장 기능을 덧붙이는 일을 “모든 것은 플러그인”이라는 구조로 풀며, 고정된 에이전트 제품보다 조립 가능한 실행 환경이 필요한 개발자에게 맞는다.
무엇이 다른가
하네스는 모델 자체가 아니라 모델이 일하는 환경이다. agent-harness가 프롬프트·도구·컨텍스트·검증을 포괄하는 설계 방법론이라면, dsh는 그 환경을 Cordis 기반 플러그인으로 구현한 프로젝트다. 특정 기능을 코어에 추가하기보다 플러그인을 교체·조합하는 것을 기본 단위로 둔다.
| 항목 | DeepSeek Harness의 접근 | 도입 시 의미 |
|---|---|---|
| 확장 단위 | 모든 기능을 플러그인으로 취급 | 조직별 도구·정책을 분리해 추가하기 쉽다 |
| 기반 | Cordis의 조합성(composability) 모델 | 의존성과 기능 경계를 명시적으로 관리한다 |
| 실행 방식 | 로컬 Web UI 제공 | 초기 실험을 브라우저에서 빠르게 시작할 수 있다 |
| 성숙도 | 개발자 프리뷰 | 호환성 깨짐을 전제로 버전 고정과 테스트가 필요하다 |
빠르게 실행하기
Node.js가 준비되어 있다면 설치 없이 다음 명령으로 Web UI를 실행할 수 있다.
npx @deepseek-ai/dsh web
# 기본 주소: 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언제 쓰면 좋은가
- 에이전트 플랫폼 팀: 도구·메모리·UI·정책을 제품마다 다르게 조합해야 할 때
- 플러그인 개발자: 재사용 가능한 능력을 dsh 생태계에 배포하고 싶을 때
- 연구·프로토타입 팀: 모델보다 실행 환경 변화가 성능에 주는 영향을 빠르게 실험할 때
반대로 안정적인 운영 환경을 즉시 확보해야 하거나 호환성 보장이 중요하다면, 개발자 프리뷰인 dsh를 바로 핵심 업무에 넣기보다 격리된 실험 프로젝트에서 플러그인 경계와 업그레이드 절차를 먼저 검증하는 편이 낫다.
관련 문서
- agent-harness — 모델 외부 실행 환경을 설계·개선하는 방법론
- microsoft-agent-framework-harness — Python·.NET용 배터리 포함 에이전트 하네스
- agent-plugins — Skills와 MCP 서버를 배포 단위로 묶는 플러그인 표준
참고 자료
- deepseek-ai/deepseek-harness — GitHub 공식 저장소