Mac 잠자기 후 DeepSeek Harness 중단이 발생했다면, 먼저 작업 공간과 로그를 보존한 뒤 브라우저 단절, macOS 잠자기, 사용자 세션 종료, Harness 프로세스 종료를 나눠 확인해야 합니다. 프로세스가 실제로 살아 있고 작업 상태와 결과물을 추적할 수 있을 때만 기다리십시오. 장시간 무인 작업이라면 온라인 유지와 프로세스 복구를 검증한 독립 Mac 환경으로 옮기는 편이 안전합니다.

이 글은 다음 사용자를 위한 안내서입니다.

  • Mac을 덮거나 일정 시간 비운 뒤 작업이 사라진 개인 개발자
  • 원격 연결로 긴 빌드와 테스트를 실행하는 Agent 엔지니어
  • 지속 온라인 Mac 환경과 장애 복구를 담당하는 운영 담당자
01

화면이 끊긴 것과 작업이 죽은 것은 왜 다를까요?

가장 위험한 오판은 Web UI 연결 종료를 작업 종료로 보는 것입니다. 브라우저 탭, 원격 화면, SSH 연결은 모두 작업 프로세스와 별개일 수 있습니다. 반대로 세션 목록이 남아 있다고 해서 실제 Agent, 셸 명령, 빌드 하위 프로세스가 살아 있는 것도 아닙니다.

DeepSeek Harness의 실행 방식은 설치 형태와 실행 모드에 따라 달라질 수 있습니다. 확인 가능한 저장소 문서에서도 명령줄 도구, MCP 서버, 세션 저장 방식이 각각 구분되어 있습니다. 따라서 “세션이 보인다”는 화면 신호만으로 자동 재개를 판단해서는 안 됩니다. DeepSeek Harness의 실행 형태와 세션 관련 문서를 먼저 확인하십시오.

먼저 보존할 것

새 작업을 제출하기 전에 다음을 복사하거나 기록하십시오.

  • 마지막으로 확인된 이벤트 시간
  • 현재 로그의 마지막 구간
  • 변경된 파일 목록
  • 잠금 파일의 존재 여부
  • 생성된 결과물과 해시
  • 외부 저장소, 배포 도구, 티켓 시스템에 남은 부작용

로그가 멈췄더라도 즉시 재실행하지 마십시오. 이전 프로세스가 외부 제출을 끝냈는데 화면만 갱신되지 않은 경우, 중복 커밋이나 중복 배포가 발생할 수 있습니다.

주의: 세션 기록은 과거의 흔적입니다. 현재 프로세스의 생존을 증명하지 않습니다.

02

원인별 신호 확인 기준

가장 먼저 장애 유형을 나눠야 합니다. Web UI 연결 종료, Mac 잠자기, 사용자 로그아웃, Harness 프로세스 종료는 관찰 신호와 복구 절차가 서로 다릅니다.

증상 관찰 신호 우선 확인 중단 조건 복구 기준
Web UI만 끊김 Mac 접속 가능, 로그와 결과물 증가 다른 접속 경로와 프로세스 로그·결과물 모두 정지 프로세스와 부작용이 함께 추적됨
Mac 잠자기 뒤 정지 잠자기 시각과 마지막 이벤트가 겹침 전원 상태, 예약, 작업 공간 재개 지점이 불명확함 체크포인트 또는 새 기준 상태 확보
사용자 로그아웃 환경 변수와 권한이 달라짐 로그인 세션, LaunchAgent, Keychain 인증 정보를 재검증하지 못함 같은 사용자 맥락에서 실행 확인
프로세스 종료 세션은 남지만 자식 프로세스 없음 작업 차이, 잠금 파일, 외부 결과 완료 여부를 판정할 수 없음 멱등성에 따라 재실행 또는 수동 처리
재시동 뒤 이상 일부 파일만 변경됨 버전 관리 차이와 최소 테스트 이전 단계 완료 여부 불명 검증된 기준 커밋과 재현 로그 확보

Apple은 Mac이 잠자기 상태에서도 켜져 있지만 전력 소비가 줄어든다고 설명합니다. 그러나 전력 절약 상태가 특정 Agent 작업의 네트워크 연결이나 하위 프로세스 진행을 보장하지는 않습니다. Apple의 Mac 잠자기 및 깨우기 안내를 기준으로 전원 상태를 확인하되, Harness의 실제 동작은 동일한 버전과 실행 모드에서 시험해야 합니다.

03

첫 단계: Mac과 작업 프로세스를 따로 확인하세요

다른 연결이 가능하다면 브라우저를 새로 고치는 대신 터미널에서 확인하십시오.

date
pmset -g
pmset -g sched
ps aux | grep -i harness

pmset -g는 현재 전원 관리 상태를 확인하는 데 사용하고, pmset -g sched는 예약된 잠자기·깨우기·재시동 계획을 확인하는 데 사용합니다. Apple은 pmset으로 Mac의 시작, 잠자기, 재시동, 종료 예약을 조회하거나 설정할 수 있다고 안내합니다. Apple의 pmset 예약 명령 안내

그다음 로그가 실제로 변하는지 확인하십시오.

tail -f /경로/작업로그
git status --short
find /경로/결과물 -type f -mmin -30

마지막 명령의 시간 범위는 작업 특성에 맞게 조정하십시오. 중요한 점은 최신 파일이 있다는 사실이 아니라, 해당 파일이 이번 실행에서 생성됐다는 근거입니다. 로그의 이벤트 순서와 결과물의 생성 시각이 일치해야 합니다.

다음 조건을 모두 만족하면 잠시 기다릴 수 있습니다.

  • Harness 관련 프로세스가 계속 존재합니다.
  • 최근 로그에 새로운 이벤트가 기록됩니다.
  • 작업 공간의 변경이 예상된 단계와 맞습니다.
  • 외부 부작용이 한 번만 발생했습니다.

하나라도 맞지 않으면 새 작업을 제출하지 말고 중단 상태로 분류하십시오.

04

Mac 잠자기 뒤에는 무엇부터 복구해야 할까요?

macOS 잠자기는 단순한 화면 꺼짐과 다릅니다. 전원 정책, 네트워크 접근, 로그인 상태가 함께 영향을 받을 수 있습니다. Apple의 시스템 설정에서도 전원 연결 상태와 비활성 시간을 기준으로 화면 끄기와 잠자기 조건을 따로 조정할 수 있다고 설명합니다. Apple의 잠자기 및 깨우기 설정 문서

깨운 직후에는 다음 순서로 진행하십시오.

둘째 단계: 복구 전 기준 상태 만들기

  • 현재 시간을 기록합니다.
  • 마지막 이벤트와 잠자기 시작 시각을 비교합니다.
  • 작업 폴더를 별도 위치에 복사합니다.
  • git diff와 git status로 파일 차이를 확인합니다.
  • 잠금 파일과 임시 파일을 삭제하지 않고 목록화합니다.
  • 테스트 결과가 완전한지, 중간 산출물인지 구분합니다.
  • 외부 시스템의 제출·게시·배포 기록을 확인합니다.

작업이 잠자기 직전 명령을 수행 중이었다면, 그 명령이 완료됐는지 추정하지 마십시오. 명령 결과 코드, 로그의 종료 이벤트, 결과물 검증이 모두 있어야 완료로 표시할 수 있습니다.

운영 기준: “마지막 로그가 오래됐다”는 사실 하나만으로 자동 재개를 결정하지 마십시오. 잠자기 시간, 프로세스 상태, 작업 공간 차이를 함께 보아야 합니다.

05

사용자 로그아웃과 프로세스 종료은 어떻게 구분할까요?

다음 행동은 서로 다른 장애입니다.

  • 브라우저를 닫음
  • 원격 연결을 끊음
  • macOS 사용자에서 로그아웃함
  • Mac을 재시동함

브라우저 종료와 원격 연결 해제는 Mac 안의 프로세스를 남길 수 있습니다. 사용자 로그아웃은 사용자별 환경 변수, Keychain, 그래픽 권한, 사용자 영역의 LaunchAgent에 영향을 줄 수 있습니다. Apple 문서에 따르면 사용자별 LaunchAgent는 사용자의 Library/LaunchAgents 경로에서 관리되며, 시스템 수준 데몬과 실행 맥락이 다릅니다. Apple의 LaunchAgent 및 LaunchDaemon 문서

다음 명령으로 등록 상태를 확인하십시오.

launchctl print gui/$(id -u)
launchctl list | grep -i harness

재시동 뒤에는 자동 로그인이 되지 않을 수 있습니다. FileVault가 켜진 Mac에서는 시작할 때 로그인이 필요할 수 있다는 Apple 안내도 있습니다. Apple의 전원 예약 및 로그인 조건을 확인하십시오.

사용자 세션이 바뀐 뒤에는 기존 API 키나 자격 증명을 그대로 재사용하지 마십시오. 환경 변수와 Keychain 접근 권한을 새 세션에서 검증해야 합니다. 그래픽 권한이 필요한 도구라면 원격 셸에서는 성공해도 화면 기반 작업은 실패할 수 있습니다.

06

셋째 단계: 자동 복구 여부를 결정하는 체크리스트

아래 항목을 순서대로 확인하십시오.

  • [ ] 원래 작업 폴더를 복사해 보존했습니다.
  • [ ] 마지막 Harness 이벤트와 Mac 전원 이벤트를 비교했습니다.
  • [ ] Web UI가 아닌 별도 연결로 Mac 접근을 확인했습니다.
  • [ ] Agent 본체와 하위 프로세스의 존재를 확인했습니다.
  • [ ] 로그가 새로 기록되는지 확인했습니다.
  • [ ] 잠금 파일을 지우기 전에 생성 프로세스를 확인했습니다.
  • [ ] 변경 파일과 결과물의 생성 원인을 확인했습니다.
  • [ ] 외부 제출·배포·게시가 이미 실행됐는지 확인했습니다.
  • [ ] 작업이 중복 실행돼도 안전한지 판단했습니다.
  • [ ] 재개 명령이 이전 단계의 완료를 추측하지 않는지 확인했습니다.
  • [ ] 불확실한 상태라면 최소 테스트로 기준 상태를 만들었습니다.

작업이 멱등적이고 체크포인트가 있다면 새 실행으로 이어갈 수 있습니다. 반대로 파일 수정과 외부 게시가 한 명령에 묶여 있거나 완료 표시가 불명확하다면 수동 승인을 거쳐야 합니다.

07

장기 백그라운드 작업은 어떤 Mac 환경이 맞을까요?

로컬 Mac은 짧은 개발 작업과 직접 확인이 필요한 작업에 적합합니다. 전원, 네트워크, 로그인 상태를 직접 통제할 수 있기 때문입니다. 하지만 합을 닫는 습관이 있거나, 밤새 빌드와 테스트를 돌리거나, 재시동 뒤 자동 복구가 필요하다면 운영 부담이 커집니다.

이때는 다음 기준으로 나누십시오.

  • 중단 후 재실행 가능: 로컬 Mac에서 체크포인트와 로그를 강화합니다.
  • 프로세스 유지가 중요함: 잠자기와 사용자 세션을 통제할 수 있는 독립 Mac을 선택합니다.
  • 외부 부작용이 큼: 자동 재개를 금지하고 승인 단계와 결과 검증을 둡니다.

KVMNODE의 맥 미니 렌탈 요금과 운영 조건을 비교할 때도 단순한 사양보다 온라인 유지, 원격 접속 방식, 재시동 뒤 인계 절차를 먼저 확인하십시오. 한국에서 사용할 환경이 필요하다면 한국 원격 맥 주문 안내에서 전달 방식과 접속 조건을 함께 검토할 수 있습니다.

현재 Mac에서 네 가지 시험을 통과하지 못한다면, 문제는 DeepSeek Harness 명령 하나가 아니라 실행 환경의 책임 경계에 있습니다.

  1. 원격 연결만 끊기기
  2. 시스템 잠자기
  3. Harness 프로세스 종료
  4. Mac 재시동

각 시험 뒤에 프로세스, 세션, 작업 공간, 결과물을 기록하십시오. 한 번의 성공만으로 자동 복구를 보장하지 마십시오. 반대로 이 네 시험을 반복해도 결과가 재현되고, 재시동 뒤 로그인과 인증까지 확인된다면 로컬 환경을 계속 사용할 수 있습니다.

FAQ

Mac을 덮어도 DeepSeek Harness 작업이 계속 실행되나요?

보장되지 않습니다. 화면을 닫은 뒤 Mac이 잠자기에 들어가면 네트워크 연결과 실행 중인 하위 프로세스가 영향을 받을 수 있습니다. 잠자기 전 마지막 이벤트, 로그 증가, 작업 결과물을 함께 확인해야 합니다. 작업이 계속된다고 가정하지 말고, 깨운 뒤 작업 공간과 프로세스를 먼저 검증하십시오.

Web UI 연결이 끊기면 Agent 작업도 끝난 것인가요?

아닙니다. 브라우저나 원격 화면만 끊기고 Mac과 Agent 프로세스가 계속 실행되는 경우가 있습니다. 다른 연결 방식으로 Mac에 접속해 프로세스 목록, 최근 로그, 생성된 결과물을 확인하십시오. 세 가지 신호가 모두 이어질 때만 기다리고, 그렇지 않으면 새 작업을 제출하지 말고 원인을 분리해야 합니다.

Mac을 깨운 뒤 기존 DeepSeek Harness 작업을 이어가도 되나요?

마지막 이벤트와 현재 작업 공간이 일치할 때만 이어가십시오. 변경된 파일, 잠금 파일, 테스트 결과, 외부 제출 기록을 먼저 비교해야 합니다. 일부 단계의 완료 여부가 불명확하면 자동 재개를 중단하고 최소 테스트로 기준 상태를 만든 뒤 새 실행 또는 수동 복구를 선택해야 합니다.

원격 Mac을 재시동하면 DeepSeek Harness 세션이 자동으로 복구되나요?

자동 복구를 전제로 운영하면 안 됩니다. 재시동 뒤에는 로그인 여부, 사용자 권한, LaunchAgent 등록 상태, 환경 변수, Keychain 접근, 그래픽 권한을 다시 확인해야 합니다. 세션 기록이 보인다는 사실만으로 실행 프로세스가 살아 있다고 판단할 수 없습니다. 같은 버전에서 재시동 복구 시험을 별도로 통과해야 합니다.

장시간 Agent 작업이 macOS 잠자기로 끊기지 않게 하려면 어떻게 해야 하나요?

작업을 중단해도 되는지부터 분류하십시오. 재실행이 안전한 작업은 체크포인트와 로그를 남기고 재시작 가능한 방식으로 구성합니다. 중단되면 손실이 큰 작업은 잠자기 정책을 통제할 수 있는 독립 온라인 환경으로 옮깁니다. 전원 설정만 바꾸는 것보다 프로세스 복구와 재시동 후 검증까지 시험하는 편이 안전합니다.

현재 Mac에서 페이지 단절, 잠자기, 프로세스 종료, 재시동 시험을 통과하지 못한다면 장시간 백그라운드 작업을 계속 맡기기 어렵습니다. 로컬 환경은 전원과 로그인 상태를 직접 관리해야 하고, 일반 원격 서버는 그래픽 권한이나 Mac 전용 개발 도구에서 추가 제약이 생길 수 있습니다. 반면 독립 클라우드 맥은 작업 시간 동안 온라인 상태와 접속 책임을 분리해 운영하기 쉽습니다.

다만 짧은 테스트나 물리 장치가 필요한 작업은 직접 보유한 Mac이 더 적합합니다. 장시간 무인 실행, 원격 접속, 재시동 뒤 검증이 핵심이라면 KVMNODE의 클라우드 맥 환경을 후보로 두고 네 가지 중단 시험부터 요청 조건에 포함하십시오.