DeepSeek Harness · 개발자 프리뷰

DeepSeek Harness 모든 것이 플러그인 · Agent 런타임

모델은 Agent의 영혼이고, Harness는 Agent가 환경을 이해하고 도구를 쓰며 실제 장면에서 계속 일하게 합니다. DeepSeek Harness(dsh)는 이미 오픈소스입니다. 먼저 DeepSeek 웹 버전을 열고 DeepSeek-V4와 대화해 작업을 검증한 뒤, 필요에 따라 로컬에서 플러그인으로 완전한 Agent를 조합하세요.

MIT

오픈소스 라이선스

DeepSeek Harness는 상업 이용에 친화적

플러그인

모든 것이 플러그인

모델부터 UI까지 모두 교체 가능

4

실행 모드

표준 / PTC / 미니멀 / 크리에이트

V4

DeepSeek-V4

먼저 웹 버전에서 검증한 뒤 로컬 실행

Agent = Model + Harness

Harness는 DeepSeek Agent가 실제 장면에서 계속 일하게 합니다

DeepSeek-V4는 추론과 대화를 제공하고, DeepSeek Harness는 환경·도구·추적 가능한 실행을 제공합니다. 둘을 겹쳐야 현장에 올릴 수 있는 Agent가 됩니다.

Cordis 커널

Cordis는 플러그인 로드, 언로드, 의존성만 담당하며 Agent의 구체적 역량은 담지 않습니다. DeepSeek Harness는 「무엇을 할 수 있는지」를 전부 플러그인에 맡깁니다.

DeepSeek Harness Cordis

플러그인이 역량을 제공

모델, 도구, 스킬, 세션, 샌드박스, 저장, 루프, 스케줄링, UI 등 모든 Agent 역량은 플러그인이 제공하며 Cordis 서비스와 이벤트로 서로 협업합니다.

DeepSeek 모든 것이 플러그인

구성 계층에서 자유롭게 조합

개발자는 DeepSeek Harness 소스를 바꾸지 않고도 구성 계층에서 어떤 역량이든 선택·교체·확장할 수 있어, DeepSeek-V4에 맞는 도구 조합을 빠르게 시험할 수 있습니다.

DeepSeek Harness 조합 가능
DeepSeek Harness 핵심 역량

여섯 가지 역량이 오픈소스 Agent 런타임을 정의합니다

Harness 개발자를 위한 프리뷰: 오픈소스, 교체 가능, 추적 가능. DeepSeek 웹 버전과 DeepSeek-V4로 「대화로 검증 + 로컬 실행」 워크플로를 구성하기에 적합합니다.

모든 것이 플러그인

DeepSeek Harness는 Cordis 플러그인 시스템 위에 구축됩니다. 모델 어댑터, 도구 등록, 세션 로그, Agent 루프, UI까지 모두 플러그인이며 구성에서 자유롭게 교체할 수 있습니다.

DeepSeek Harness 플러그인

실행은 추적할 수 있습니다

모델이 본 모든 것은 추가 전용 세션 로그에 기록됩니다. 시스템 프롬프트, 사고 사슬, 도구 호출과 결과, 서브 Agent 스케줄링, 컨텍스트 주입. Trajectory 뷰는 출처별로 재생합니다.

DeepSeek Trajectory

네 가지 실행 모드

표준 모드는 전체 도구를 제공합니다. PTC(Code) 모드는 생성 코드로 다단계 호출을 편성합니다. 미니멀 모드는 벤치마크용입니다. 크리에이트 모드는 플러그인을 시험하고 새 preset을 만들기 위한 것입니다.

DeepSeek Harness 모드

DeepSeek-V4와 서로 보완

DeepSeek 웹 버전은 작업을 먼저 명확히 하고 Pro / Flash를 비교하기에 적합합니다. Harness는 같은 작업을 샌드박스와 도구가 있는 로컬 Agent에 올려 연속 실행하기에 적합합니다.

DeepSeek-V4 Agent

Web UI를 한 명령으로 띄우기

Node.js를 설치한 뒤 npx @deepseek-ai/dsh web을 실행하면 기본적으로 로컬 Web UI(127.0.0.1:3080)가 열립니다. 소스 설치는 pnpm으로 빌드한 뒤 같은 명령을 실행하면 됩니다.

DeepSeek dsh web

열린 플러그인 생태계

플러그인 저장소에 GitHub topic 「dsh-plugin」을 추가하면 발견하기 쉽습니다. 핵심 플러그인과 API는 아직 반복 중이며, 공식은 파괴적 변경이 있을 것이라고 분명히 안내합니다.

dsh-plugin 생태계
DeepSeek Harness 한눈에

개발자 프리뷰에서 기억해야 할 사실

정보는 DeepSeek 공식 소개 페이지와 GitHub 저장소 README에서 왔으며, DeepSeek Harness / dsh 관련 질문을 검색하기 쉽게 정리했습니다.

dsh

명령줄 이름

DeepSeek Harness의 CLI와 패키지 이름 단서: npx @deepseek-ai/dsh web

Cordis

플러그인 커널

로드 / 언로드 / 의존성만 관리하고, Agent 역량은 전부 플러그인이 제공

MIT

오픈소스 라이선스

공식 저장소 deepseek-ai/deepseek-harness는 MIT 라이선스로 소스를 공개

4

내장 모드

표준, PTC(Code), 미니멀, 크리에이트——코딩 Agent부터 벤치마크까지

3080

기본 Web 포트

npx 시작 후 로컬 Web UI는 기본적으로 127.0.0.1:3080을 수신

프리뷰

개발자 프리뷰

전 세계 Harness 개발자 테스트용. 핵심 플러그인과 API는 계속 반복

플러그인

모델도 교체 가능

모델 어댑터와 UI 포함

로그

추가 전용 세션

재개 / 포크 / 재생이 같은 출처

V4

DeepSeek-V4

웹 버전에서 먼저 의도를 검증

오픈소스

GitHub 동기화

Discussions에서 피드백 수집

DeepSeek Harness는 아직 개발자 프리뷰이며, 공식은 호환성을 깨는 변경이 있을 것이라고 강조합니다. 프로덕션 시스템에서 버전을 무작정 고정하지 마세요. 대화와 방안 검증은 먼저 이 사이트의 DeepSeek 웹 버전을 사용하세요.

먼저 DeepSeek 웹 버전에서 작업을 명확히 하세요

DeepSeek Harness는 로컬 Agent 실행에 맞습니다. 의도, 프롬프트, DeepSeek-V4 효과는 웹 버전에서 먼저 검증하는 것이 좋습니다.

DeepSeek Harness 실행 모드

네 가지 모드로 벤치마크부터 커스텀 Agent까지

소스를 바꾸지 않고 모드를 전환할 수 있습니다. 자세한 비교와 적용 장면은 「실행 모드」 하위 페이지를 보세요.

표준 모드

기능이 완전한 코딩 Agent입니다. 파일 편집, Shell, 파일과 웹 검색, Skills, 계획, 목표, 서브 에이전트와 워크플로. 일상 연구개발 작업에 적합합니다.

DeepSeek Harness 표준 모드

PTC / Code 모드

표준 모드의 모든 역량을 갖추고 Code Mode SDK로 도구를 제시해, 모델이 TypeScript 프로그램 하나로 다단계 작업을 조합하고 도구 호출 왕복을 줄입니다.

DeepSeek PTC Code Mode

미니멀 모드

지속 bash와 str_replace_editor만 제공하는 이중 도구 코딩 Agent로, 최소화된 환경에서 모델 벤치마크(DeepSeek-V4 관련 평가 장면 포함)에 사용합니다.

DeepSeek Harness 미니멀 모드

크리에이트 모드

커스텀 Agent preset을 만들기 위한 모드입니다. 표준 모드 역량에 런타임 검사, 메모리에서 Cordis 플러그인 시험, preset 창작 안내를 더합니다.

DeepSeek Harness 크리에이트 모드

실행 모드

설계 생각

모든 것이 플러그인, 매번 실행은 추적할 수 있습니다

이것은 DeepSeek 공식이 Harness에 대해 말하는 핵심이며, 「DeepSeek Harness란 무엇인가」를 검색할 때 기억해야 할 세 가지입니다.

01

모든 것이 플러그인

DeepSeek Harness는 Cordis 플러그인 시스템 위에 구축됩니다. 모델, 도구, 스킬, 세션, 샌드박스, 저장, 루프, 스케줄링, UI는 모두 플러그인이 제공하며 서비스와 이벤트로 협업합니다. 개발자는 소스를 fork하지 않고도 구성 계층에서 역량을 재구성할 수 있습니다.

02

매번 실행은 추적할 수 있습니다

시스템 프롬프트, 사고 사슬, 도구 호출과 결과, 서브 Agent 스케줄링, 매번 컨텍스트 주입은 추가 전용 세션 로그에 기록됩니다. 재개, 포크, 검색, 재생은 같은 이벤트 스트림을 공유하고, Trajectory 뷰에서 출처별로 검사할 수 있습니다.

03

여러 실행 모드

표준 모드는 완전한 도구 조합을 줍니다. PTC 모드는 모델이 생성한 코드로 여러 턴 도구를 잇습니다. 미니멀 모드는 shell과 파일 편집만 남겨 평가에 씁니다. 크리에이트 모드는 런타임을 검사하고 플러그인을 시험하며 새 모드를 조합합니다.

빠르게 체험

로컬에서 Web UI를 띄우거나 소스에서 설치

아래 명령은 공식 문서에서 왔으며 개발자가 대조할 수 있게 했습니다. 작업 표현과 DeepSeek-V4 효과를 먼저 확인하고 싶다면, 이 사이트의 DeepSeek 웹 버전에서 대화를 시작하는 것을 권합니다.

빠르게 체험

Node.js를 설치한 뒤 npx로 Web UI를 시작할 수 있습니다.

npx @deepseek-ai/dsh web

소스에서 설치

전체 프로젝트 소스를 받고 저장소 안내에 따라 설치를 완료합니다.

git clone https://github.com/deepseek-ai/deepseek-harness
DeepSeek Harness FAQ

DeepSeek Harness에 대한 자주 묻는 질문

DeepSeek 웹 버전, DeepSeek-V4와는 어떤 관계인가요? 프로덕션에 쓸 수 있나요? 아래는 공식 입장에 맞춰 정리했습니다.

01 DeepSeek Harness란 무엇인가요?

DeepSeek Harness(명령 이름 dsh)는 DeepSeek AI가 오픈소스한 Agent 런타임(agent harness)입니다. 모델이 환경을 이해하고 도구를 호출하며 실제 장면에서 계속 일하게 합니다. 아키텍처 슬로건은 「모든 것이 플러그인」이고, 커널은 Cordis입니다.

02 Harness와 DeepSeek 웹 버전, DeepSeek-V4는 무엇이 다른가요?

DeepSeek 웹 버전과 DeepSeek-V4는 「대화, 추론, 긴 컨텍스트」를 해결하고, Harness는 「도구, 샌드박스, 세션 로그, 교체 가능한 런타임」을 해결합니다. 권장 경로: 먼저 웹 버전에서 작업을 명확히 한 뒤, 필요하면 dsh로 도구가 있는 Agent를 로컬에서 실행하세요.

03 지금 프로덕션 환경에 쓸 수 있나요?

공식 위치는 개발자 프리뷰이며, 호환성을 깨는 변경이 있을 것이라고 분명히 경고합니다. 플러그인 시험, 평가, 아키텍처 학습에는 맞지만, 핵심 프로덕션 시스템을 현재 버전에 고정하는 데는 맞지 않습니다.

04 DeepSeek Harness를 가장 빨리 체험하려면?

Node.js를 설치한 뒤 npx @deepseek-ai/dsh web을 실행하면 기본적으로 http://127.0.0.1:3080이 열립니다. 공식 저장소를 git clone한 뒤 README에 따라 pnpm으로 설치·빌드할 수도 있습니다. 먼저 대화로 검증하려면 이 사이트의 「지금 체험」으로 DeepSeek 웹 버전에 들어가세요.

05 Cordis란 무엇인가요?

Cordis는 DeepSeek Harness가 사용하는 플러그인 커널로, 플러그인 로드·언로드·의존성을 담당합니다. Agent의 모델, 도구, UI 등 구체적 역량은 커널이 아니라 플러그인에 있으며 서비스와 이벤트로 협업합니다.

06 PTC 모드와 Code 모드는 같은 것인가요?

공식 중국어 페이지는 PTC 모드, 영어 페이지는 Code mode라고 부릅니다. 둘 다 모델이 생성한 코드(Code Mode SDK를 거쳐)로 여러 턴 도구 호출을 조합하면서 표준 모드 역량을 유지한다는 뜻입니다.

07 미니멀 모드는 어디에 쓰나요?

미니멀 모드는 지속 bash와 str_replace_editor만 남겨, 최소화된 환경의 모델 벤치마크에 씁니다. 공개 평가 설명에서 DeepSeek-V4-Flash의 일부 Code Agent 점수는 미니멀 모드 프레임워크와 관련이 있습니다.

08 커뮤니티 플러그인은 어떻게 게시하나요?

플러그인 저장소에 GitHub topic 「dsh-plugin」을 추가하면 발견되기 쉽습니다. 피드백과 결함은 공식 GitHub Discussions로 보내세요. 핵심 플러그인과 기반 API는 계속 반복됩니다.

09 세션을 재생할 수 있나요?

가능합니다. 모델이 본 프롬프트, 사고 사슬, 도구 결과, 서브 Agent 스케줄링은 모두 추가 전용 로그에 기록됩니다. 재개, 포크, 검색, 재생은 같은 이벤트 스트림을 공유하며 Trajectory 뷰에서 출처별로 볼 수 있습니다.

10 모델이나 도구를 바꾸려면 소스를 고쳐야 하나요?

아닙니다. 공식은 개발자가 DeepSeek Harness 소스를 바꾸지 않고도 구성 계층에서 모델 어댑터와 UI를 포함한 어떤 역량이든 선택·교체·확장할 수 있다고 강조합니다.

11 오픈소스 라이선스는 무엇인가요?

공식 저장소는 MIT 라이선스로 오픈소스입니다. 제3자 의존성은 저장소의 THIRD_PARTY_NOTICES를 보세요. 상업 이용 전에 라이선스와 프리뷰 면책 조항을 직접 읽어 주세요.

12 로컬 환경을 설치하지 못할 때 DeepSeek를 먼저 쓰려면?

먼저 이 사이트의 DeepSeek 웹 버전을 열고 DeepSeek-V4와 바로 대화해 프롬프트와 작업 분해를 확인하세요. 로컬 도구와 샌드박스가 필요하면 Node.js를 설치하고 dsh를 실행합니다. 두 경로는 서로 보완하며 서로를 대체하지 않습니다.

DeepSeek-V4 + Harness, 대화에서 실행 가능한 Agent로

웹 버전에서 생각을 검증하고, Harness에서 플러그인과 도구를 조합합니다. 이 사이트에서 한 번에 DeepSeek 웹 버전으로 이동하세요.