DeepSeek Harness Alpha.2: 워크트리 및 업그레이드 점검

DeepSeek Harness dsh-v0.2.1-alpha.2 는 2026 년 10 월 9 일 출시되었으며, 에이전트에 별도의 Git 체크아웃을 제공하며 커스텀 런타임에서 사용하는 여러 인터페이스를 변경합니다. 이미 10 월 3 일 alpha.1 을 사용 중인 경우 필요한 기능을 기준으로 판단하면 됩니다. Worktrees, 특정 신뢰성 수정, 또는 새로운 SDK 동작이 필요한가요?

이 가이드는 처음에 alpha.1 용으로 게시되었으며 이제 alpha.2 를 포함합니다. 이는 공식 alpha.2 릴리스 노트 및 버전 고정 문서에 기반합니다. 아래는 각자의 설치 환경에서 실행할 수 있는 검증 절차입니다. 여러 플랫폼에서 측정한 벤치마크가 아니며, Harness 데스크톱 앱을 직접 실행해 검증했다는 뜻도 아닙니다.

작업에 영향을 미치는 변경 사항부터 시작하세요

새로운 Git Worktrees 플러그인은 에이전트가 브랜치를 생성하고 별도의 체크아웃을 만든 후 해당 세션을 계속할 수 있게 합니다. 이는 실험적이며 초기에는 비활성화됩니다. 처음에는 범위를 좁혀 시험해 보세요. 에이전트가 주요 작업 디렉토리에서 떨어진 작은 문서 파일을 편집하게 한 후 결과 diff 를 검사하세요.

Alpha.2 는 또한 플러그인을 통해 실험적 추론 번역을 추가합니다. 릴리스에는 Bing 및 Google 번역과 유료 DeepSeek Flash 옵션이 나열되어 있습니다. 이는 추론 콘텐츠의 표시와 관련이 있으며, 새로운 베이스 모델 릴리스나 더 나은 추론 정확도의 증거가 아닙니다. 실제로 읽는 번역, 특히 변경되지 않아야 할 기술 식별자를 평가하세요.

기존 워크플로우의 안정성을 위한 수정도 있습니다. 중단된 응답 스트림은 유휴 시간 초과를 적용할 수 있으며, 읽을 수 없는 플러그인 메타데이터는 더 이상 전체 요청을 차단하지 않으며, 백그라운드 작업은 부모 턴이 완료되었다는 이유만으로 중단된 것으로 표시될 가능성이 줄어듭니다. 이는 릴리스 노트 주장입니다. 해결되었다고 선언하기 전에 자체 실패 사례를 재현하세요.

직접 제작한 도식: 01은 워크트리 생성, 02는 하위 세션 완료 대기, 03은 작업 디렉터리 변경입니다. 날짜는 10월의 두 릴리스를 구분합니다.

현재 상황	첫 번째 평가 항목	유지할 증거
에이전트 편집이 로컬 작업과 충돌하는 경우	Git Worktrees	디렉토리, 브랜치, 베이스라인 및 diff
백그라운드 작업이 중단된 것으로 표시되는 경우	업그레이드 후 동일 작업	실제 결과 및 최종 작업 상태
커스텀 SDK 런타임을 유지 관리하는 경우	마이그레이션 요구 사항	통합 테스트 및 이벤트 처리
현재 워크플로우가 안정적인 경우	작은 회귀 세션 하나	동일 작업, 동일 예상 결과

Worktrees 는 파일을 분리하지 권한을 분리하지는 않습니다

alpha.2 Worktrees 문서 는 로컬 Git 리비전으로부터 생성된 체크아웃을 설명합니다. 원래 체크아웃의 수정된 파일은 함께 이동하지 않습니다. 에이전트에게 편집기에서만 존재하는 변경 사항이 필요한 경우, 워크트리를 열어 해당 변경 사항을 사용할 수 있게 되지는 않습니다.

이 작업은 또한 세션의 기존 파일 정책을 유지합니다. 새로운 경로는 새로운 보안 경계가 아니며 기존에 쓰기가 제한된 위치 에 쓸 수 있는 권한을 부여하지 않습니다. 대상과 공유 Git 관리 디렉토리 모두 기존 정책에 따라 쓰기 가능해야 합니다.

반환된 경로를 편집 전 확인해야 할 항목으로 취급하세요. 기본 풀은 현재 체크아웃 아래에 있으므로 기존 링크된 체크아웃 내부에서 시작하면 그 안에 중첩된 풀이 생성됩니다. 디렉토리를 떠나면 체크아웃과 브랜치 모두 유지됩니다. Worktrees 첫 실행 가이드 는 검토 가능한 작은 작업으로 이러한 결정을 안내합니다.

Start using DeepSeek Harness

커스텀 통합은 마이그레이션 요구 사항을 따로 확인하세요

가장 중요한 alpha.2 변경 사항들은 일반 인터페이스에서는 보이지 않을 수 있습니다. 하위 에이전트 도구는 이제 자식 세션 ID 를 즉시 반환합니다; 커스텀 SDK 런타임은 session/wait 를 지원해야 합니다. 첫 번째 결과를 완료된 작업으로 취급한 코드는 새로운 완료 확인이 필요합니다.

이 릴리스는 또한 both 도구 표시 값을 제거하며 native 와 ptc 만 남깁니다. Python PTC 는 이제 세션 파일 시스템 샌드박스를 사용합니다; 커스텀 구성은 샌드박스 및 샌드박스 정책 서비스를 제공해야 합니다. 이는 설정을 대체하는 것이 아니라 구성 및 수명 주기 변경 사항이며, 일치하는 단어가 포함된 모든 파일에서 무차별적으로 대체해서는 안 됩니다.

에이전트 팀 메시징은 대상 인박스로의 직접 전달로 변경됩니다. 이전 아웃박스, 자동 재시도 또는 재전송 중복 제거에 의존하는 커스텀 플러그인은 마이그레이션 노트에 대해 확인해야 합니다. 예외가 없는 것보다 성공적인 전송 후 예상된 수신 측 결과가 더 강력한 증거입니다.

마지막으로, 공유 에이전트 디렉토리는 AGENTS.md 를 허용하며, DSH_AGENTS_HOME 을 오버라이드로 사용할 수 있습니다. 릴리스는 별도로 에이전트 지침에 대한 행별 dshHome 옵션을 제거하고 프로세스 수준 DSH_HOME 기본값을 선호합니다. 기존 배포를 검토할 때 이 두 설정을 구분하여 유지하세요.

더 나은 작업 라벨이라도 결과 확인이 필요합니다

수정된 백그라운드 작업 표시는 유용하지만 실패를 진단하기 쉽게 만들 뿐입니다. 이는 작업의 요청된 출력이 존재함을 증명하지는 않습니다. 보고서 작성 작업의 경우 보고서를 검사하세요; 코드 변경의 경우 diff 와 테스트 결과를 검사하세요. 표시된 상태를 해당 증거 옆에 유지하세요.

직접 제작한 검증 도식: 01에서 표시된 세션 상태를 확인하고, 02에서 실제 보고서·변경 사항·테스트 결과를 확인합니다. ID는 예시입니다.

예를 들어, 작업이 예상한 디렉토리와 다른 디렉토리에 보고서를 작성하면서 완료될 수 있습니다. 완료 상태와 누락된 파일은 프로세스가 실행된 위치를 확인하기 전까지는 양립 가능한 관찰 결과입니다. Alpha.2 의 working_directory 도구와 SDK 디렉토리 작업은 세션 위치를 이 조사의 명시적인 부분으로 만듭니다.

기존 예약된 워크플로우도 동일한 처리가 필요합니다. 알림이 전달되었는지와 알림에서 요청한 작업이 완료되었는지를 따로 확인하세요. 자동화 검증 튜토리얼 는 해당 구분을 다루며, 표시 수정 후에도 관련성이 있습니다.

alpha.1 변경 사항은 원래 컨텍스트에 유지하세요

10 월 3 일 alpha.1 릴리스 는 플러그인 생성 진입점, 내장 웹 자동화 및 실험적 Claude Code Mods 호환성을 도입했습니다. 이는 이전 빌드에서 업그레이드하는 독자에게 유용한 배경이지만 10 월 9 일 추가 사항은 아닙니다.

플러그인을 유지 관리한다면, 이전 마이그레이션 노트를 건너뛰지 말고 두 릴리스 모두 확인하세요. Alpha.1 은 런타임 invariant 플러그인을 제거하고 메시지 입력 상자 통계를 activity 와 usage 로 분리했습니다. 또한 설치 프로그램은 릴리스 시기 정책이 이전 패키지를 선택한 경우를 포함하여 설치된 버전을 더 명확하게 보고하기 시작했습니다. 요청된 버전과 설치된 버전은 별개의 사실로 유지됩니다.

초기 설정의 경우, 로컬 퀵스타트 가이드 부터 시작하세요. 플러그인 생성의 경우, Creator 튜토리얼 를 사용하세요. 두 워크플로우 모두 모든 실험적 기능을 동일한 업그레이드 테스트의 일부로 취급해야 하지는 않습니다.

범위를 좁힌 세션으로 업그레이드 여부를 판단하세요

현재 Harness 버전을 기록하고 의존하는 구성 및 세션 데이터를 보존하세요. 알려진 예상 결과가 있는 일반 작업을 선택한 후 업그레이드 후 반복하세요. 해당 베이스라인이 작동한 후에야 필요한 실험적 플러그인을 활성화하거나 변경한 통합을 테스트해야 합니다.

Worktrees 의 경우, 검증하려면 알려진 커밋, 새로운 브랜치, 올바른 현재 디렉토리 및 검토된 diff를 확인해야 합니다. SDK 통합의 경우, 하위 작업이 실제로 완료되었는지 확인하고 사용하는 인터페이스를 테스트해야 합니다. 어느 이점도 작업에 중요하지 않다면, 아직 alpha 버전인 만큼 일상 작업 환경과 분리해서 시험하는 편이 합리적입니다.