deepseek-harness
무엇인가
DeepSeek Harness는 DeepSeek AI가 개발한 오픈소스 에이전트 하네스이고 실행 명령 이름은 dsh다. 에이전트를 구동하는 런타임과 그 확장 지점을 하나의 CLI 프로세스로 묶는다. 저장소의 주 언어는 TypeScript다.
어떻게 동작하나
구조의 중심에는 everything-is-a-plugin 원칙이 있다. 코어와 모든 기능이 플러그인으로 분리되고, 플러그인 런타임인 Cordis가 이들을 조립한다. 실행하면 로컬 HTTP 서버가 127.0.0.1:3080에서 웹 UI를 띄운다. 로컬 실행에서는 기본 브라우저가 자동으로 열리고, SSH 실행에서는 SSH 클라이언트나 편집기가 포워딩 주소를 소유하므로 호스트 URL만 출력한다. --no-open을 넘기면 브라우저를 열지 않고 서버만 실행한다.
무엇과 다른가
일반적인 코딩 에이전트 CLI는 기능이 배포 바이너리에 고정되어 있어 동작을 바꾸려면 코어를 수정해야 한다. DeepSeek Harness는 기능의 추가와 교체를 플러그인 단위로 처리한다. Cordis의 설계는 논문 「A Programming Paradigm for Spatiotemporal Composability」에 정리되어 있다.
어떻게 쓰나
Node.js를 설치한 뒤 npm으로 실행한다. 소스 체크아웃에서 실행할 때는 pnpm run build로 저장소 산출물을 준비하고, pnpm dsh web으로 빌드된 산출물을 재빌드 없이 사용한다. 플러그인 저장소에는 dsh-plugin 토픽을 붙여 검색되게 한다.
전제와 한계
개발자 프리뷰 단계이며 빠르게 반복되고, 호환성을 깨는 변경이 예고되어 있다. 실행 전에 안전 고지를 확인해야 한다. 라이선스는 MIT이고, 서드파티 의존성과 그 라이선스는 THIRD_PARTY_NOTICES.md에 공개되어 있다.
관련 논문 1
유사 도구
- open-multi-agent자체 호스팅 TypeScript 에이전트 런타임이다. 승인이 필요한 동작은 내구성 있는 승인 게이트에서 멈추고, 모든 실행은 오프라인에서 검증 가능한 기록을 남긴다.
- maka모든 모델 메시지·도구 호출·권한 결정을 append-only RuntimeEvent 로그로 남기는 에이전트 워크스페이스다. 데스크톱·TUI·CLI가 하나의 런타임을 공유한다.
- deer-flow샌드박스·메모리·서브에이전트·스킬을 묶어 수 분에서 수 시간 걸리는 작업을 수행하는 오픈소스 슈퍼 에이전트 하네스다.
- continueCLI·VS Code 확장·JetBrains 플러그인으로 배포되는 오픈소스 코딩 에이전트다. 2.0.0을 끝으로 저장소가 읽기 전용으로 전환됐다.
- obsidian-copilotObsidian 볼트 안에서 opencode·Claude Code·Codex 에이전트를 실행하는 TypeScript 플러그인이다. 노트를 읽고 파일을 만들며 여러 턴에 걸쳐 작업을 이어간다.
- difyLLM 애플리케이션을 워크플로·RAG·에이전트·모델 관리·관측까지 한 워크스페이스에서 만들고, 클라우드나 셀프호스팅으로 배포하는 오픈소스 플랫폼이다.