DeepSeek, Harness 프레임워크 업데이트? 14가지 변경 사항의 작동 방식

DeepSeek, Harness 프레임워크 업데이트? DeepSeek Harness v0.1.0-rc.8의 출시로 14가지 변경 사항이 도입되었습니다. 멀티모달 입력, 서브에이전트, 툴링, 런타임 성능 전반에 걸친 주요 업데이트를 통해 네이티브 이미지 요청을 통합하고 Claude Code 및 Codex와 같은 외부 도구를 모듈형 서브에이전트로 관리하는, 결합 해제된 플러그인 우선 스케줄링 레이어가 구축되었습니다. 인공지능 아키텍처가 단일 폐쇄형 소스 벤더 스택에서 분산형 에이전트 런타임으로 전환됨에 따라, 개발자에게는 작업 분할, 도구 오케스트레이션, 메모리 지속성을 관리할 수 있는 확장 가능한 프레임워크가 요구됩니다. 역사적으로 자율 코딩 어시스턴트를 배포하는 것은 엔지니어링 워크플로우를 단일 벤더 스택에 묶어두었습니다. 오늘날에는 오픈소스 런타임 프레임워크를 통해 개발자가 모델, 도구, 서브에이전트를 동적으로 교체할 수 있으므로, 기술 팀은 에이전트 오케스트레이션과 다운스트림 컨텍스트 핸드오프를 구성하는 방식을 평가하고 있습니다.

아키텍처 개요: 에이전트 오케스트레이션을 위한 DeepSeek의 Harness 프레임워크 업데이트 방식

한눈에 보기

DeepSeek Harness v0.1.0-rc.8은 네이티브 이미지 요청 지원을 도입하여 /goal 및 /plan과 같은 명령어가 텍스트와 이미지가 혼합된 입력을 직접 처리할 수 있도록 합니다.
Claude Code 및 Codex를 포함한 서브에이전트는 온디맨드 프로필 번들로 패키지되며, 비대화형 실행 모드와 상위 작업 웨이크업 기능을 제공합니다.
Cordis 플러그인 프레임워크 기반의 런타임은 모델, 도구, 메모리, 메인 에이전트 루프를 MIT 라이선스 하의 완전히 교체 가능한 플러그인으로 처리합니다.

기반 언어 모델과 자율 에이전트를 구분하는 엔지니어링 경계는 점점 더 명확해지고 있습니다. 기반 모델이 원시 추론 및 생성 기능을 제공하는 반면, 실제 작업 실행에는 파일 시스템 구문 분석, 셸 명령어 호출, 대화 기록 관리, 실행 재시도를 처리하기 위한 외부 엔지니어링 셸이 필요합니다. DeepSeek은 명확한 공식을 통해 이러한 관계를 정의합니다. 모델 + Harness = 에이전트.

2026년 8월 Harness v0.1의 초기 오픈소스 출시 이후, 해당 프로젝트는 개발자들로부터 빠르게 채택되었습니다. v0.1.0-rc.8의 출시는 이러한 기반을 바탕으로 하여 설정 가능한 이미지 요청 지원을 추가하고 서브에이전트 스케줄링 기능을 확장합니다.

DeepSeek Harness architectural overview showing the modular relationship between models and outer harness tooling

rc.8의 핵심 의미는 "모든 것이 플러그인이다"라는 설계 철학에 있습니다. Harness의 기반이 되는 컴포저블 플러그인 컨텍스트를 제공하는 Cordis를 기반으로 하므로, 영구적으로 하드코딩된 컴포넌트는 없습니다. 개발자는 기본 모델 어댑터를 교체하고, 로컬 스토리지 엔진을 대체하며, 독립된 샌드박스 환경을 마운트하거나 메인 에이전트 실행 루프를 커스터마이징할 수 있습니다.

DeepSeek Harness Git commit history and open-source development trajectory

내부 메커니즘: 멀티모달 툴체인, 서브에이전트, 런타임 파이프라인

프로토콜 수준에서 DeepSeek Harness v0.1.0-rc.8은 네이티브 멀티모달 처리, 서브에이전트 오케스트레이션, 툴체인 성능이라는 핵심 기능 영역에 걸쳐 업데이트를 구성합니다.

1. 설정 가능한 멀티모달 입력

업데이트된 어댑터는 네이티브 이미지 요청을 지원하여, 요청 본문에서 이미지 입력을 base64 데이터 URL로 직렬화하는 동시에 모델 응답은 서버 전송 이벤트(SSE)를 통해 계속 스트리밍합니다. /goal 및 /plan을 포함한 핵심 명령어는 이제 텍스트와 이미지 페이로드 혼합을 허용하며, 컴포저의 @ 메뉴는 활성 세션과 이미지 파일을 참조하도록 확장됩니다. 시스템은 표준 30 MiB 요청 제한 아래에 여유 공간을 두면서 base64 이미지 페이로드를 20 MiB(maxRequestImageBytes)로 제한합니다.

네이티브 어댑터 아키텍처 하에서 이미지 기능이 설정된 모델은 base64 데이터 페이로드를 직접 수신하는 반면, 텍스트 전용 모델은 네트워크 전송 전에 이미지 입력을 거부합니다. 커뮤니티 개발자들은 텍스트 전용 백엔드에 외부 OCR 및 레이아웃 파싱을 제공하기 위해 타사 비전 플러그인을 개별적으로 연구했지만, 네이티브 rc.8 파이프라인은 비전 지원 모델 설정을 위한 직접적인 이미지 패스스루에 초점을 맞추고 있습니다.

DeepSeek Harness model selection and multimodal configuration interface

2. 서브에이전트 스케줄링 및 프로필 번들

외부 어시스턴트를 메인 코드베이스 내에 배포하는 대신, Claude Code와 Codex는 온디맨드 프로필 번들로 패키지됩니다. Codex는 무인 또는 헤드리스 실행 시나리오를 지원하는 비대화형 권한 모드와, 여러 개의 고유한 Codex 구성을 유지하기 위한 명명된 인스턴스를 제공합니다. reportDelivery 메커니즘은 서브에이전트 완료 시 상위 작업에 자동으로 알리고 깨워 지속적인 폴링 루프의 필요성을 줄여줍니다.

아래 다이어그램은 작업과 서브에이전트가 프레임워크를 통해 라우팅되는 방식을 보여줍니다.

[사용자 멀티모달 목표 / 계획 입력]
                │
                ▼
     [Cordis 플러그인 컨텍스트]
                │
  ┌─────────────┼─────────────┐
  ▼             ▼             ▼
[설정된 LLM 어댑터] [Claude Code] [Codex 번들]
(텍스트 또는 비전 모델) (서브에이전트) (서브에이전트)
  │             │             │
  └─────────────┼─────────────┘
                ▼
  [도구 / 플러그인 디스패치 레이어]
(동시 WebSearch / PTY 터미널)

3. 툴체인 동시성 및 전송 메타데이터

런타임은 web_search에 대한 동시 쿼리 지원, Windows PTY 터미널 내의 영구 PowerShell 세션, 최적화된 SQLite 읽기/쓰기 및 세션 포크 성능을 도입합니다. 전송 레이어에서 DeepSeek 어댑터는 모델에 표시되는 요청 내용 및 토큰 회계 외부에 해당 식별자를 유지하면서, @deepseek-ai/dsh-anonymous-user-id의 x-deepseek-harness-user-id를 포함하여 공급자 요청에 전송 수준 ID 및 세션 메타데이터를 전송합니다.

DeepSeek Harness subagent job management panel showing active Codex and Claude Code execution threads

개발자는 표준 구성 스키마를 사용하여 어댑터 설정을 동적으로 구성할 수 있습니다.

- id: llm-deepseek
  name: '@deepseek-ai/dsh-llm-deepseek'
  config:
    apiKeyEnv: DEEPSEEK_API_KEY
    baseURL: https://api.deepseek.com
    thinking: enabled
    reasoningEffort: high
    maxTokens: 256000
    streamIdleTimeoutMs: 300000
    maxRequestImageBytes: 20971520
    defaultContextWindow: 1000000
    models:
      - id: deepseek-v4-flash
        name: DeepSeek-V4-Flash
      - id: private-vision
        name: Private Vision
        inputModalities: [text, image]

상태 기반 워크플로우 오케스트레이션 대 모바일 배포 컨텍스트 연속성

DeepSeek Harness의 모듈형 아키텍처는 소프트웨어 실행이 분산형 멀티에이전트 워크플로우로 이동하고 있음을 보여줍니다. 기본 에이전트가 여러 도구와 모델에 걸쳐 하위 작업을 위임할 때, 하네스는 실행 컨텍스트를 유지하고, 서브에이전트 상태를 추적하며, 출력을 일관된 최종 결과로 집계합니다.

데스크톱 및 서버 측 에이전트 런타임이 활성 플러그인과 로컬 프로세스 전반에서 상태를 유지하는 반면, 자동화된 여정이 모바일 애플리케이션 배포 경계를 넘어 전환될 때 인접한 아키텍처 과제가 발생합니다.

수명 주기 경계를 넘는 컨텍스트 연속성 연결

Harness 내에서 세션 연속성은 런타임 세션 상태 및 지속성 레이어를 통해 유지됩니다. 그러나 모바일 앱 배포에서는 프로모션 캠페인, 웹 추천 또는 공유 추천을 통해 아직 설치되지 않은 애플리케이션으로 사용자가 유도될 때, 설치 전 캠페인이나 목적지 컨텍스트가 스토어 설치 및 최초 실행 전환 과정을 자동으로 거치지 못합니다.

지연된 딥 링크 및 매개변수 패스스루 기능을 갖춘 OpoInstall과 같은 특화된 모바일 링크 아키텍처는 이러한 컨텍스트 단절 문제를 해결합니다. 이러한 프레임워크는 설치 전에 캠페인 또는 목적지 메타데이터를 캡처하고 애플리케이션의 최초 실행 시 해당 매개변수를 복원하여 즉각적인 컨텍스트 라우팅을 가능하게 합니다. 두 메커니즘은 서로 다른 수명 주기 단계에서 서로 다른 기술적 문제를 해결하지만, 모두 단편화된 애플리케이션 경계를 넘어 신뢰할 수 있는 컨텍스트 연속성에 대한 증가하는 요구를 강조합니다.

엔지니어링 체크리스트: 프로덕션 환경에 모듈형 에이전트 하네스 배포하기

프로덕션 환경에 확장 가능한 에이전트 런타임을 배포하려면 실행 유연성과 운영 안정성의 균형을 맞추기 위한 체계적인 거버넌스가 필요합니다.

개발자 구현 체크리스트

SQLite 스키마 마이그레이션 관리: 호환되지 않는 테이블 구조로 인한 데이터 오류를 방지하기 위해 마이너 버전 간 업그레이드 시 데이터베이스 스토리지 형식이 깔끔하게 업데이트되도록 보장합니다.
서브에이전트 실행 모드 구성: 무인 프로세스를 실행할 때 자동화된 Codex 인스턴스에서 비대화형 권한 플래그를 활성화합니다.
이미지 페이로드 제한 설정: 다중 턴 대화 중 공급자 본문 제한 초과를 방지하기 위해 수신되는 base64 이미지 페이로드를 20 MiB(maxRequestImageBytes)로 제한합니다.

아키텍처 및 성장 전략 체크리스트

전송 식별자 감사: 익명 식별자(x-deepseek-harness-user-id) 및 세션 헤더가 로컬 개인정보 보호 정책을 준수하는지 확인합니다.
멀티에이전트 토큰 예산 최적화: 복잡한 계획을 위해 최첨단 모델을 예약하면서 하위 작업을 비용 효율적인 모델로 라우팅하는 모델 중재를 구현합니다.
크로스 플랫폼 컨텍스트 보존 보장: 웹 진입점과 네이티브 모바일 애플리케이션 간에 사용자 워크플로우를 연결할 때 서버 측 매개변수 복원 프레임워크를 배포합니다.

자주 묻는 질문 (FAQ)

DeepSeek Harness의 핵심 아키텍처 철학은 무엇인가요?

DeepSeek Harness는 Cordis 플러그인 프레임워크 기반의 "모든 것이 플러그인이다" 설계를 기반으로 합니다. 모델, 도구, 실행 루프, 샌드박스, 메모리 스토리지, 사용자 인터페이스 모두 MIT 라이선스 하에 상호 교환 가능한 플러그인으로 구현되어 개발자가 모든 컴포넌트를 커스터마이징하거나 교체할 수 있습니다.

DeepSeek Harness는 모델 구성에서 시각적 입력을 어떻게 처리하나요?

DeepSeek Harness v0.1.0-rc.8은 비전 지원 모델의 어댑터 구성을 통해 네이티브 이미지 요청 처리를 지원합니다. 이미지 모달리티가 설정된 모델의 경우 `/goal` 및 `/plan`과 같은 명령어가 텍스트와 이미지가 혼합된 페이로드를 직접 처리할 수 있으며, 이미지는 요청 본문에서 최대 20 MiB 제한의 base64 데이터 URL로 직렬화됩니다.

서브에이전트 프로필 번들은 상위 작업에 어떻게 다시 통신하나요?

Claude Code 및 Codex와 같은 서브에이전트는 실행 환경 내에서 격리된 작업으로 실행됩니다. 할당된 작업량을 완료하면 `reportDelivery` 메커니즘이 구조화된 결과를 상위 작업에 자동으로 전송하고 대기 중인 프로세스를 깨워 지속적인 폴링의 필요성을 줄여줍니다.

엔지니어링 팀을 위한 주요 시사점

DeepSeek Harness와 같은 오픈소스 에이전트 런타임의 급격한 진화는 모델 중심 경쟁에서 워크플로우 및 오케스트레이션 레이어 우위로의 전환을 나타냅니다. 모듈형 에이전트 아키텍처 내에서 모델 백엔드가 점점 더 상호 교환 가능해짐에 따라, 서브에이전트를 조율하고, 도구를 관리하며, 실행 상태를 유지하는 소프트웨어 레이어가 개발자 제어의 주요 거점이 됩니다.

차세대 에이전틱 시스템을 구축하는 엔지니어링 팀은 모듈성, 명시적 권한 경계, 강력한 상태 관리를 우선시해야 합니다. 에이전트 오케스트레이션을 확장 가능한 플러그인으로 분리하고 웹과 모바일 터치포인트 전반에 걸쳐 탄력적인 컨텍스트 핸드오프 메커니즘을 구현함으로써, 조직은 적응 가능하고 벤더 중립적인 자동화 파이프라인을 구축할 수 있습니다.