딥시크 하네스 v0.1.0-rc.7 업그레이드 검증법

유일한 실행 환경에 딥시크 하네스 v0.1.0-rc.7을 바로 덮어쓰지 않고, 현재 환경을 기록한 뒤 격리된 맥에서 단계별로 검증하는 방법을 설명합니다. 세션, 플러그인, 배시 명령, 이미지 첨부, 웹 화면을 따로 시험하고 실패 시 즉시 되돌릴 수 있는 승인 기준까지 다룹니다.

오래된 세션은 열리지만 플러그인 설정 카드가 비어 있고, 배시 명령이나 웹 화면이 갑자기 멈춘다면 바로 덮어쓰기 업그레이드를 중단해야 합니다.

가장 빠른 해결책은 현재 버전과 설정을 기록한 뒤 격리된 환경에 v0.1.0-rc.7을 설치하고, 최소 작업과 기존 세션을 통과시킨 후 저위험 저장소부터 나누어 전환하는 것입니다.

마지막 갱신: 2026년 8월 18일. 버전 날짜와 개발자 미리보기 상태는 공식 릴리스 기록과 현재 저장소 문서를 기준으로 확인했습니다. 공식 릴리스의 수정 항목은 특정 환경의 통과를 보장하지 않으므로 별도 회귀 시험이 필요합니다. (github.com)

이 글은 딥시크 하네스를 매일 사용하는 개인 개발자, 원격 맥과 지속 작업을 관리하는 운영 담당자, 팀의 버전 변경을 승인해야 하는 플랫폼 책임자를 위한 내용입니다. 처음 설치하는 사람보다 이미 실행 중인 환경을 안전하게 바꾸려는 사람에게 적합합니다.

이번 주 업그레이드 시간표와 판단 기준

v0.1.0-rc.7은 2026년 8월 17일 공개된 공식 사전 배포 버전입니다. 아직 개발자 미리보기 단계이므로, “수정됨”이라는 문구를 “내 환경에서도 문제가 사라짐”으로 해석하면 안 됩니다. (github.com)

시점	해야 할 일	통과 신호	실패 시 행동
업그레이드 전	버전, 설치 방식, 설정 출처, 플러그인과 작업 목록 기록	현재 환경을 다시 만들 수 있음	기록이 끝날 때까지 업그레이드 보류
격리 설치	별도 작업 공간이나 독립 사용자 경로에 설치	실제 실행 버전과 작업 공간이 예상과 일치	정식 작업 공간에 접근하지 못하게 차단
첫 실행	웹 화면, 모델, 작업 공간, 제한된 명령, 결과 반환 확인	최소 작업이 끝까지 완료됨	설정을 더하지 말고 로그 저장
회귀 시험	과거 세션, 플러그인, 지속 배시, 이미지 첨부 확인	실제 업무 흐름이 재현됨	해당 기능만 격리해 원인 분리
단계 전환	저위험 저장소부터 순차 이동	승인 자료와 되돌리기 절차가 있음	이전 환경을 계속 유지

이번 주에는 정식 환경을 건드리지 말고, 먼저 기준 작업 하나를 고정하는 것이 좋습니다. 기준 작업은 파일 읽기, 제한된 명령 실행, 결과 파일 반환까지 포함해야 합니다. 단순히 프로그램이 켜지는 것만으로는 충분하지 않습니다.

딥시크 하네스 rc.7을 바로 덮어써도 됩니까?
유일한 실행 환경이라면 권하지 않습니다. 특히 플러그인, 세션 저장소, 배시 프로세스, 웹 화면을 함께 사용하는 경우에는 격리 설치가 우선입니다. 원격 맥이라도 같은 사용자 경로와 같은 설정을 공유하면 격리 효과가 줄어듭니다.

업그레이드 전에 보존해야 할 자산

백업은 환경 전체를 무차별 복사하는 작업이 아닙니다. 공식 문서에서 사용하는 저장 경로와 실제 환경에서 변경한 자산을 대조해 범위를 정해야 합니다. 설치 폴더만 복사하고 세션과 플러그인 설정을 빠뜨리면, 프로그램은 실행되어도 이전 작업을 이어갈 수 없습니다.

먼저 다음 정보를 한 장의 기록 파일에 남깁니다.

현재 딥시크 하네스 버전과 확인 명령의 결과
설치 방식과 실행 파일 위치
노드 실행 환경과 패키지 관리자
환경 변수, 사용자 설정, 프로젝트별 설정의 출처
플러그인 이름, 버전, 사용 프로필과 권한
진행 중인 작업, 작업 공간, 연결된 저장소
최근 성공한 세션의 식별 정보와 입력·출력 결과
배시 명령이 접근하는 경로와 생성되는 결과 파일

보존 대상	확인할 내용	복구에 필요한 이유
실행 파일	실제 경로와 현재 버전	다른 설치 경로를 잘못 실행하는 문제 방지
사용자 설정	설정 파일 위치와 적용 순서	새 버전이 다른 설정을 읽는지 비교
플러그인	설치 목록과 프로필별 활성 상태	플러그인 누락과 권한 변화를 구분
세션	오래된 세션과 최근 성공 세션	형식 변환과 이어 하기 문제 확인
작업 공간	저장소 경로와 미완료 작업	시험 요청이 정식 저장소에 들어가는 문제 방지
복구 자료	이전 실행 방식과 되돌리기 명령	실패 후 신속한 원복

설정 파일을 복사하기 전에 비밀 키와 접근 토큰이 포함되어 있는지 확인해야 합니다. 원격 맥을 여러 사람이 함께 사용한다면 백업 파일의 읽기 권한도 별도로 점검해야 합니다. 전체 홈 폴더를 그대로 복사하는 방식은 불필요한 캐시와 오래된 인증 자료까지 옮길 수 있어 권하지 않습니다.

공식 저장소의 읽기 문서와 v0.1.0-rc.7 릴리스 항목을 서로 대조해 실제 경로와 기본 동작을 확인합니다. 공식 설치 및 실행 문서와 v0.1.0-rc.7 릴리스 기록을 같은 날짜에 확인하는 편이 안전합니다.

첫 번째 단계: 격리 환경에서 실제 버전 확인

가장 안전한 시험 장소는 별도 작업 공간, 독립 사용자 경로, 또는 다시 만들 수 있는 원격 맥입니다. 현재 프로젝트 폴더에서 실행 파일만 바꾸는 방식은 격리 설치처럼 보이지만, 사용자 설정과 세션을 그대로 물려받을 수 있습니다.

설치 순서는 다음과 같이 진행합니다.

시험용 작업 공간을 만듭니다.
정식 저장소와 다른 경로를 연결합니다.
독립된 설정 경로를 지정합니다.
v0.1.0-rc.7을 설치합니다.
실행 파일이 실제로 새 버전을 가리키는지 확인합니다.
현재 작업 공간과 설정 출처를 화면과 로그로 기록합니다.

설치 후에는 버전 문자열만 보지 말고 다음 세 가지를 확인해야 합니다.

실행한 파일의 실제 경로
읽은 설정 파일의 위치
현재 작업 공간의 절대 경로

이 세 값 중 하나라도 예상과 다르면 테스트를 중지합니다. 특히 원격 맥에서는 터미널 세션, 웹 화면, 백그라운드 프로세스가 서로 다른 사용자 경로를 바라볼 수 있습니다. 화면에 새 버전이 표시되어도 지속 작업 프로세스가 이전 실행 파일을 사용하고 있을 수 있습니다.

두 번째 단계: 첫 실행은 최소 작업 하나로 제한

첫 시작부터 플러그인과 이미지 첨부, 여러 하위 작업을 모두 켜면 실패 원인을 찾기 어렵습니다. 처음에는 기능을 다섯 구간으로 나누어 확인합니다.

웹 화면이 열리고 입력창이 정상적으로 작동하는지 확인합니다.
사용 가능한 모델 목록과 선택한 모델이 일치하는지 확인합니다.
시험 작업 공간의 파일을 읽게 합니다.
위험하지 않은 명령 하나만 허용합니다.
결과가 화면과 지정된 결과 파일에 모두 남는지 확인합니다.

각 구간에는 성공 신호를 미리 정해야 합니다. 예를 들어 파일 읽기 단계는 올바른 경로와 파일 일부가 표시되어야 하며, 명령 단계는 예상한 종료 상태와 결과 파일이 있어야 합니다. 단순히 오류가 나오지 않았다는 이유로 통과 처리하면 안 됩니다.

시험 항목	최소 입력	통과 기준	즉시 중단 조건
웹 화면	새 대화 열기와 짧은 입력	입력, 응답, 새로 고침이 정상	빈 화면 또는 입력 유실
모델 선택	기본 모델 변경	선택값과 실제 응답 모델이 일치	모델 표시와 실행 모델 불일치
작업 공간	작은 파일 읽기	지정 경로만 읽음	다른 저장소 파일 접근
배시	읽기 전용 명령	예상 결과와 종료 상태 기록	권한 오류 또는 무한 대기
결과 반환	작은 결과 파일 생성	화면과 파일에 결과 존재	결과 누락 또는 중복 생성

오류가 발생하면 설정을 추가해서 해결하려 하지 말고 먼저 로그를 저장합니다. 설정을 계속 바꾸면 원래 실패 조건이 사라져 나중에 원인을 재현하기 어려워집니다.

세 번째 단계: 세션과 플러그인 회귀 시험

업그레이드의 핵심은 새 대화가 열리는지가 아니라 기존 업무가 이어지는지입니다. 짧은 새 대화 하나를 통과한 뒤에는 오래된 세션을 별도로 열어야 합니다.

다음 순서가 안정적입니다.

최근 성공 세션 하나를 읽기 전용으로 엽니다.
대화 기록이 잘리는 지점까지 이동합니다.
최대 토큰 제한 뒤에도 이어 하기가 되는지 확인합니다.
지속 배시 프로세스가 이전 상태를 유지하는지 확인합니다.
플러그인 설정 카드가 열리고 저장되는지 점검합니다.
사파리에서 입력, 붙여 넣기, 긴 응답 스크롤을 시험합니다.
이미지 첨부가 필요한 업무라면 작은 파일 하나만 따로 보냅니다.

업그레이드 후 플러그인이 열리지 않으면 어떻게 되돌립니까?
먼저 플러그인을 다시 설치하거나 설정을 덮어쓰지 말고, 새 버전 프로세스를 종료한 뒤 이전 실행 파일과 이전 설정 경로를 복원합니다. 그 다음 동일한 세션을 이전 환경에서 열어 문제가 플러그인 자체인지 새 실행 버전과의 연결 문제인지 나눕니다. 복구 후에는 실패 로그, 플러그인 목록, 설정 차이를 함께 보관해야 합니다.

플러그인 시험은 한 번에 하나만 진행합니다. 설정 카드, 실행 권한, 외부 연결, 결과 표시를 각각 확인하면 어느 단계에서 깨졌는지 구분할 수 있습니다. 릴리스 기록에 특정 수정이 적혀 있어도 네가 사용하는 플러그인의 저장 방식과 권한 구조가 같다고 단정하면 안 됩니다. (github.com)

네 번째 단계: 새 기능은 독립 작업으로 승인

새 기능을 복잡한 실제 업무 안에서 한꺼번에 시험하면 실패 원인을 찾을 수 없습니다. 다음처럼 최소 작업을 따로 만듭니다.

기능	별도 시험	기록할 값	승인 조건
작업 패널 하위 에이전트	한 개의 작은 작업만 전달	생성, 실행, 완료 상태	상태가 순서대로 갱신됨
이미지 첨부	작은 이미지 한 개 전달	첨부 인식과 응답	입력 누락 없이 결과 반환
외부 도구 연결	읽기 전용 도구 하나 호출	호출과 반환 내용	권한 범위가 예상과 일치
낮은 추론 강도	짧은 결정 작업 실행	선택값과 응답 형태	설정이 다음 작업에 섞이지 않음
사파리 입력	붙여 넣기와 긴 입력	입력 길이와 화면 반응	글자 유실이나 멈춤 없음

이 표에서 하나라도 실패하면 새 기능 전체를 실패로 처리하지 말고 해당 기능만 보류합니다. 반대로 일부 기능이 통과했다고 해서 장시간 작업까지 승인해서도 안 됩니다. 지속 작업은 세션 보존, 배시 상태, 네트워크 재연결이 함께 작동해야 하기 때문입니다.

다섯 번째 단계: 점수로 전환 순서 정하기

전환 대상은 기능이 아니라 위험도와 복구 가능성으로 나눕니다. 저위험 저장소, 짧은 작업, 민감하지 않은 자료부터 옮깁니다. 장시간 작업과 접근 권한이 큰 프로젝트는 마지막으로 남겨야 합니다.

전환 선택	적합한 상황	장점	약점
즉시 전환	시험 환경과 정식 환경이 완전히 분리됨	관리가 단순함	회귀 문제 발생 시 영향이 큼
단계 전환	저장소와 작업 위험도가 서로 다름	문제 범위를 좁힐 수 있음	두 환경을 잠시 함께 관리해야 함
병행 유지	장시간 작업과 민감한 프로젝트가 있음	되돌리기와 비교가 쉬움	자원과 설정 관리가 필요함
업그레이드 보류	핵심 세션이나 플러그인이 실패함	정식 작업을 보호함	새 버전 기능을 바로 쓰지 못함

간단한 승인 점수도 유용합니다. 웹 화면, 모델 선택, 작업 공간, 제한 명령, 세션, 플러그인, 지속 배시, 이미지 첨부를 각각 통과 또는 실패로 기록합니다. 핵심 업무에 필요한 항목이 하나라도 실패하면 전체 승인 점수와 관계없이 보류합니다.

서명 자료에는 다음을 포함합니다.

시험 날짜와 실제 실행 버전
설치 방식과 실행 파일 경로
설정 차이와 플러그인 목록
기준 작업의 입력과 결과
실패 로그와 재현 순서
현재 정식 환경으로 되돌리는 방법
다음 재시험 날짜와 담당자

원격 맥에서 검증할 때 달라지는 점

원격 맥은 화면 연결이 끊겨도 백그라운드 프로세스가 남을 수 있습니다. 따라서 웹 화면을 닫는 것만으로 실행이 끝났다고 판단하면 안 됩니다. 터미널 프로세스, 세션 저장 위치, 작업 공간 잠금, 네트워크 연결 상태를 함께 확인해야 합니다.

원격 맥에서 새 버전을 검증하려면 무엇부터 확인해야 합니까?
먼저 독립된 사용자 경로 또는 다시 만들 수 있는 작업 공간을 배정합니다. 그 다음 원격 접속 방식과 웹 화면 접속 방식을 분리해 각각 시험합니다. 같은 작업을 터미널에서 한 번, 웹 화면에서 한 번 실행해 결과가 같은지 비교하면 접속 방식에 따른 차이를 찾기 쉽습니다.

원격 환경을 별도로 준비해야 한다면 맥 원격 실행 환경 구성 안내를 먼저 확인하고, 테스트 위치가 필요한 경우 서울 맥 노드 선택 기준을 참고할 수 있습니다. 장시간 회귀 시험은 접속이 끊겨도 작업 상태와 로그를 보존할 수 있는지 먼저 확인해야 합니다.

개발자 미리보기는 반복 검증이 기본

개발자 미리보기에서는 한 번 통과한 환경도 다음 릴리스에서 다시 확인해야 합니다. 특히 플러그인 인터페이스, 세션 저장 형식, 기본 모델 선택, 웹 화면 입력 동작은 변경 영향이 넓습니다.

운영 주기는 다음처럼 단순하게 잡는 편이 좋습니다.

새 릴리스가 나오면 공식 변경 기록과 현재 문서를 대조합니다.
깨끗한 환경에서 기준 작업을 한 번 실행합니다.
현재 운영 환경에서 같은 작업을 한 번 실행합니다.
플러그인 목록과 세션 복구 시험을 반복합니다.
결과와 설정 차이를 승인 자료에 추가합니다.
문제가 없을 때만 저위험 작업을 다음 환경으로 옮깁니다.

여기서 중요한 기준은 성능이 아니라 재현성과 복구성입니다. 작업을 다시 만들 수 있고, 이전 세션을 열 수 있으며, 실패한 실행을 안전하게 중단할 수 있어야 장기 운영에 적합합니다.

현재 컴퓨터 한 대에만 딥시크 하네스를 설치한 상태라면, 정식 환경과 시험 환경을 분리하기 어렵고 업그레이드 중 장애가 곧 작업 중단으로 이어집니다. 특히 세션과 플러그인을 함께 보존해야 할 때는 로컬 환경만 고집하는 것보다 독립된 원격 맥을 시험용으로 두는 편이 관리가 쉽습니다. VPSMAC의 원격 맥 환경 선택 페이지에서 별도 검증 환경을 마련한 뒤, 통과한 버전만 정식 작업으로 옮기는 방식이 더 안전합니다. 다만 장기간 고정된 고부하 작업이나 특정 물리 장치가 필요한 경우에는 별도 장비를 직접 운영하는 편이 더 적합할 수 있습니다.