DeepSeek Harness 데스크톱 앱 공개: 모든 게 플러그인인 오픈소스 에이전트 하네스

Who Should Read

코딩 에이전트 하네스를 골라 쓰거나 직접 확장하려는 LLM 실무 개발자

Core Mechanics

• DeepSeek Harness는 오픈소스 하네스다
  • 지금 전 세계 대상 퍼블릭 프리뷰이고 라이선스는 MIT다.
  • 하네스는 모델을 감싸 파일·셸·도구를 쓰게 해 주는 에이전트 실행 틀이다.
• 모든 기능이 플러그인이다
  • Cordis의 "everything is a plugin" 구조 위에 만들었다.
  • 플러그인으로 도구, 스킬, UI를 확장한다.
• 채팅으로 플러그인을 만든다
  • "Creator mode"에서 대화로 플러그인을 만들 수 있다.
  • 예시로 Pomodoro 타이머 플러그인을 만들고 설치·검증하는 데 5분 24초가 걸렸다.
• 공식·실험 플러그인이 따로 있다
  • Agent loop, Subagents, Terminal 등이 공식 플러그인으로 나온다.
  • Agent teams, Auto approval review, Scheduled tasks, Voice input은 Experimental이다.
• 예약 작업과 디버깅 도구가 있다
  • Scheduled tasks 플러그인으로 "매주 금요일 17:00 주간 보고 요약" 같은 반복 작업을 등록한다.
  • Developer tools에서 실행 트레이스와 툴 호출 상세를 볼 수 있다.

Community Reactions

• 데스크톱 빌드는 텔레메트리가 기본 켜짐이라는 의견
  • 일반 dsh web은 사용자가 직접 보내는 피드백만 수집한다는 지적이다.
  • $DSH_HOME/cordis.patch.yml에 desktop-product-telemetry, product-analytics를 disabled로, session-log-deepseek는 enabled: false로 두면 끈다는 팁이 나왔다.
• 코어도 플러그인이라 커스터마이징이 부담이라는 경험
  • 기존 동작을 바꾸려면 코어 플러그인에 다운스트림 패치를 유지해야 한다는 의견이다.
  • 한 사용자는 다운스트림 커밋이 약 25개이고 새 플러그인은 0개라고 했다.
• AI로 플러그인을 바로 만들었다는 경험
  • macOS에 설치해 보니 기존 설정과 워크스페이스가 그대로 넘어왔다는 후기다.
  • 글꼴 크기 조절과 작업 완료 알림음 플러그인을 DSH에 요청하니 바로 만들어 줬다고 한다.
• 서브에이전트 양방향 통신이 장점이라는 의견
  • 서브에이전트가 중간에 부모에게 메시지를 보내고 부모도 방향을 바꿀 수 있다고 한다.
  • 그동안 메인 스레드 대화도 계속 가능하다는 경험이다.
• 서드파티 플러그인과 가짜 사이트를 경계하는 의견
  • 악성코드나 지원 중단 위험 때문에 큐레이션된 기본 기능을 선호한다는 의견이 있었다.
  • 비공식 사이트 deepseekharness[.]io가 검색 상단에 뜬다는 경고도 나왔다.

How to Apply

• npx로 웹 UI 띄워 보기
  • Node.js를 설치한 뒤 npx @deepseek-ai/dsh web을 실행하라.
  • 데스크톱 앱 대신 웹 UI로 먼저 써 보면 텔레메트리 부담이 적다.
• 텔레메트리 끄고 시작하기
  • 데스크톱 앱을 쓸 거면 첫 실행 전에 $DSH_HOME/cordis.patch.yml에 댓글 팁의 세 항목을 넣어라.
  • 기본 $DSH_HOME은 ~/.dsh다.
• Creator mode로 사내 플러그인 만들기
  • 반복하는 작은 작업 하나를 골라 채팅으로 플러그인을 요청하라.
  • 설치 후 Developer tools의 트레이스로 툴 호출을 확인하라.
• 공식 사이트 URL 확인하고 설치하기
  • 다운로드는 deepseek.com 공식 페이지와 GitHub 저장소 deepseek-ai/deepseek-harness에서만 받아라.
  • 서드파티 플러그인은 소스를 읽고 설치하라.

Try It

# 셸에 붙여넣기 (Node.js 필요, 원문의 웹 UI 실행 명령)

npx @deepseek-ai/dsh web

# 이어서: 웹 UI에서 Creator mode로 아래처럼 요청해 보기
# Write a Pomodoro timer plugin for me.

# 텔레메트리 끄기 (댓글 팁, 첫 실행 전 $DSH_HOME/cordis.patch.yml에 추가)
# - id: desktop-product-telemetry
#   disabled: true
# - id: product-analytics
#   disabled: true
# - id: session-log-deepseek
#   config:
#     enabled: false

Terminology

관련 논문

• 같은 시뮬레이션, 다른 근거: 도구 출력을 파일로 넘기면 LLM 에이전트 정확도가 어디서 깎이나

  긴 툴 출력을 파일로 넘기자 GPT-5.1은 정확도 11.3%p 하락, 정식 출력 지정하니 회복

• 가짜 뉴스가 진짜 폭락을: LLM 트레이딩 에이전트 대상 정보 주입 공격

  가짜 헤드라인 한 줄로 LLM 트레이딩 에이전트 62%를 조종했다(프롬프트 주입은 14%)

• Harness Engineering 101: LLM은 뇌, harness는 몸

  에이전트는 JSON 배열을 관리하는 루프이고, 16개 챕터로 직접 만들어 본다

• Harness²: 에이전트 harness를 스스로 고쳐 쓰는 재귀 최적화 프레임워크

  모델은 고정하고 harness를 재귀로 고쳤더니 벤치마크 점수가 최대 11.8%p 올랐다

• 해고된 Savannah 경찰관, ICE 요원 남편에게 Flock 계정 공유

  경찰관이 Flock 계정을 남편(ICE 요원)에게 공유했고, 감사에서 983건 검색이 드러나 해고됐다

• tmux와 Claude Code: 세션, send-keys, 그리고 한계선

  tmux로 Claude Code 여러 개를 돌리면 편하지만 에이전트 4개쯤에서 한계가 온다

• Hybrid Reasoning Agents: 잠재 공간에서 생각하고 텍스트로 행동하는 LLM 에이전트

  잠재 공간 추론과 텍스트 도구 호출을 섞었더니 성능 10.4%↑, 토큰 최대 54.7%↓

Related Resources

• https://www.deepseek.com/en/harness/
• https://github.com/deepseek-ai/deepseek-harness
• https://arxiv.org/abs/2608.25512
• https://frontierharness.org/