DeepSeek Harness node-pty 업그레이드

터미널 호환 문제를 겪는 Mac 사용자라면 업그레이드 검증 범위를 정할 수 있습니다.
원격 Mac에서 장시간 작업을 유지하는 운영 담당자라면 연결 종료와 프로세스 종료를 분리해 확인할 수 있습니다.
기술 책임자라면 rc.7의 제한적 적용과 롤백 기준을 세울 수 있습니다.

주의: 공식 릴리스는 v0.1.0-rc.7에서 node-pty 1.2 beta로 올려 PTY 플랫폼 호환성을 넓혔다고 설명합니다. 동시에 개발 미리보기 단계이며 호환성이 다시 바뀔 수 있다고 안내합니다. 따라서 “Bash 문제가 모두 해결됐다”는 결론으로 확대하면 안 됩니다. (공식 릴리스 노트)

마지막 업데이트: 2026년 8월 18일. 공식 릴리스와 공개 저장소, node-pty 상위 프로젝트 기록을 기준으로 확인했습니다.

공식 릴리스가 확인한 변경은 세 가지로 나뉩니다.

• 극간단 모드의 지속형 Bash 지연 수정
• 대화형 세션에 사용되는 node-pty 1.2 beta 업그레이드
• 큰 기록 목록, 토큰 잘림, 사파리 입력창과 관련된 별도 수정

이 중 첫 번째는 극간단 모드의 지속형 Bash 호출에 대한 수정입니다. 모든 빌드 명령, 모든 Mac 운영 체제, 모든 원격 네트워크 조건의 지연을 없앤다는 뜻은 아닙니다. node-pty 상위 프로젝트의 베타 릴리스도 운영 체제별 수정 사항을 계속 포함하고 있으므로, 특정 Mac에서의 장기 안정성은 별도 검증이 필요합니다. (node-pty 릴리스 기록, node-pty 저장소)

또 하나의 제한은 연결 상태입니다. 브라우저 화면이 끊겼다는 사실만으로 PTY 프로세스가 종료됐다고 볼 수 없습니다. 반대로 프로세스가 살아 있어도 재접속 뒤 같은 입력 제어권이나 전체 출력을 보장하지는 않습니다. 이 부분은 DeepSeek Harness의 화면과 실제 Mac 프로세스를 따로 확인해야 합니다.

아래 표의 목적은 성능 점수를 만드는 것이 아닙니다. 같은 명령을 양쪽 버전에서 실행하고, 어느 계층에서 차이가 났는지 기록하기 위한 판단 도구입니다.

Bash 카동 여부는 세 구간으로 나눠 봅니다

node-pty 업그레이드가 Bash 카동을 해결하는지 보려면 “명령이 끝났다”만 확인해서는 부족합니다. 다음 세 구간을 따로 기록하십시오.

1. 입력한 문자가 화면에 즉시 나타나는지 확인합니다.
2. 명령이 여러 줄의 출력을 내는 동안 화면이 계속 갱신되는지 확인합니다.
3. 종료 코드가 표시되고 다음 명령을 받을 수 있는지 확인합니다.

예를 들어 짧은 환경 조회, 파일 목록 출력, 의도적으로 실패하는 명령을 연속 실행합니다. 입력 회신은 정상인데 출력만 늦다면 화면 갱신 계층을 의심해야 합니다. 출력은 보이지만 다음 입력을 받지 못한다면 PTY 세션 또는 프런트엔드 제어 문제일 수 있습니다.

공식 릴리스가 고친 것은 극간단 모드의 지속형 Bash 지연입니다. 이 사실은 우선순위를 낮출 근거는 되지만, 원격 Mac의 모든 Bash 카동이 사라졌다는 증거는 아닙니다. (v0.1.0-rc.7 공식 변경 내역)

원격 터미널 재설정은 먼저 보류합니다

DeepSeek Harness 원격 터미널을 다시 설정해야 하는지는 첫 테스트 결과로 판단하십시오. 기존 실행 방식, 작업 공간, 셸 경로, 환경 변수를 유지한 채 버전만 바꾸는 것이 좋습니다. 설정까지 동시에 바꾸면 node-pty 변경의 영향과 환경 변경의 영향을 분리할 수 없습니다.

다음 결과라면 재설정보다 원인 분리가 우선입니다.

• 입력은 정상이고 긴 출력만 멈춤
• 화면은 끊겼지만 Mac에서 프로세스가 계속 실행됨
• 재접속은 되지만 이전 출력 일부가 사라짐
• 취소 버튼은 사라졌지만 하위 빌드 프로세스가 남음

세 가지 지연을 따로 측정합니다

장시간 작업에서는 지연을 하나의 숫자로 합치지 마십시오.

첫 번째는 지속형 Bash 지연입니다. 셸이 명령을 받고도 늦게 반응하는지 봅니다.
두 번째는 PTY와 터미널 의존성 지연입니다. 프로세스는 출력하지만 화면 전달이 늦는지 확인합니다.
세 번째는 모델 대기 시간입니다. 명령 자체가 아니라 다음 도구 호출이나 판단을 기다리는 구간입니다.

빌드 명령을 실행할 때는 다음 순서로 기록합니다.

1. 명령을 보낸 시각을 기록합니다.
2. 첫 출력이 나타난 시점을 기록합니다.
3. 출력이 연속으로 진행되는지 확인합니다.
4. 중간에 입력을 보냈을 때 세션이 응답하는지 확인합니다.
5. 취소를 실행합니다.
6. 화면 종료 뒤에도 실제 하위 프로세스가 남아 있는지 확인합니다.

한 번 성공한 빌드로 장시간 안정성을 판정하지 마십시오. 같은 저장소에서 정상 빌드, 경고가 많은 빌드, 실패하는 빌드를 각각 실행해야 합니다. 특히 로그가 많은 작업은 화면이 멈춘 뒤에도 프로세스가 살아 있을 수 있으므로, Mac에서 프로세스 목록과 작업 폴더의 결과 파일을 함께 확인하십시오.

백그라운드 작업의 인수 조건을 정리할 때는 DeepSeek Harness 백그라운드 작업 검수 기준처럼 “화면에 보였는가”가 아니라 “프로세스가 끝났고 결과가 저장됐는가”를 기준으로 삼아야 합니다.

대화형 프로그램을 무작정 많이 나열할 필요는 없습니다. 실제 업무에서 DeepSeek Harness가 호출하는 프로그램만 고르십시오. 예를 들어 입력을 계속 받아야 하는 셸 도구, 터미널 크기에 따라 화면을 다시 그리는 도구, 특정 종료 키를 받아야 하는 도구가 대상입니다.

각 프로그램에서 다음 다섯 항목을 체크합니다.

• [ ] 시작 직후 프롬프트가 표시됩니다.
• [ ] 입력 문자가 예상한 위치에 나타납니다.
• [ ] 터미널 크기 변경 뒤 화면이 깨지지 않습니다.
• [ ] 중단 입력이 프로그램에 전달됩니다.
• [ ] 정상 종료 뒤 셸로 돌아옵니다.

실패하면 전체 환경을 보존하려 하지 말고 최소 재현 환경을 만드십시오. 같은 Mac 운영 체제, 같은 DeepSeek Harness 버전, 같은 셸, 같은 명령만 남겨야 합니다. 그래야 node-pty 상위 프로젝트의 이슈와 연결해 설명할 수 있습니다. 베타 버전에서 발견한 문제를 일반적인 Mac 호환성 문제로 확대하지 않는 것도 중요합니다.

원격 터미널 단절이 작업을 중지시키는 것은 아닙니다

브라우저나 네트워크가 끊긴 뒤에는 네 가지를 별도로 확인하십시오.

1. 화면 연결이 끊겼는지 확인합니다.
2. PTY 세션이 남아 있는지 확인합니다.
3. 실제 Bash와 하위 프로세스가 실행 중인지 확인합니다.
4. 재접속 뒤 출력과 입력 제어가 복구되는지 확인합니다.

재접속에 성공했더라도 작업 복구가 완전하다고 기록하지 마십시오. 마지막 로그가 누락됐을 수 있고, 입력 제어만 복구되지 않을 수도 있습니다. 장시간 빌드는 결과 파일, 종료 코드, 프로세스 상태를 함께 확인해야 합니다.

이 문제를 원격 환경 전체의 장애로 착각하면 안 됩니다. 화면 연결 문제를 먼저 분리하고, 그다음 백그라운드 작업의 실제 상태를 대조하는 방식이 안전합니다. 원격 접근 장애를 함께 점검해야 한다면 화면, 연결, 프로세스를 별도 항목으로 기록하십시오.

동시 작업은 처음부터 많이 실행하지 마십시오. 작업 수의 일반적인 한도를 정하는 것이 아니라, 대표 작업을 소수만 동시에 실행해 격리 여부를 보는 단계입니다. 사이트 실측 자료가 없는 상태에서 특정 동시 수나 메모리 기준을 일반값처럼 제시하면 안 됩니다.

다음 항목을 작업별로 기록하십시오.

• 출력이 다른 세션에 섞이지 않는지
• 한 작업의 취소가 다른 작업에 영향을 주지 않는지
• 각 작업이 올바른 작업 폴더에서 실행되는지
• 재접속 뒤 세션 이름과 결과 파일이 일치하는지
• 한 작업의 실패가 전체 화면을 잠그지 않는지

출력 혼선이 보이면 성능 문제가 아니라 세션 식별과 상태 관리 문제일 수 있습니다. 이 경우 작업 수를 늘려 재현성을 높이기보다, 최소한의 두 작업으로 로그를 고정하는 편이 낫습니다.

업그레이드 후 어떤 명령을 회귀해야 하는지는 기능 목록이 아니라 실제 사용 경로로 정하십시오.

1. 기존 버전의 짧은 Bash 명령을 저장합니다.
2. 같은 Mac과 작업 폴더에서 rc.7을 실행합니다.
3. 긴 출력과 정상 빌드를 실행합니다.
4. 실패하는 빌드와 사용자 취소를 실행합니다.
5. 대화형 프로그램을 실행합니다.
6. 네트워크를 끊고 재접속합니다.
7. 소수 병렬 작업을 실행합니다.
8. 기존 버전으로 되돌린 뒤 같은 작업을 반복합니다.

판정은 세 단계면 충분합니다.

• 계속 사용: 핵심 작업에서 입력, 출력, 취소, 종료 상태가 모두 기존 버전과 같거나 개선됨
• 제한 사용: 짧은 명령은 통과하지만 장시간 작업이나 재접속 복구가 불확실함
• 롤백: 프로세스가 남거나 출력이 섞이거나 작업 폴더가 틀리거나 종료 상태를 확인할 수 없음

DeepSeek Harness는 현재 개발 미리보기이며, 공식 저장소도 호환성이 깨지는 변경이 있을 수 있다고 명시합니다. 따라서 rc.7 통과만으로 구매나 전면 확장을 결정하지 말고, 고정된 회귀 기록을 다음 후보 버전과 다시 비교하십시오. (공식 저장소의 개발 미리보기 안내)

• [ ] 사용 중인 DeepSeek Harness 버전과 Mac 운영 체제를 기록했습니다.
• [ ] 기존 버전과 rc.7에서 같은 작업을 실행했습니다.
• [ ] Bash 입력 회신과 연속 출력을 따로 확인했습니다.
• [ ] 정상 종료와 실패 종료 코드를 확인했습니다.
• [ ] 긴 출력 중 화면 조작이 가능한지 확인했습니다.
• [ ] 취소 뒤 Bash와 하위 프로세스가 모두 정리됐는지 확인했습니다.
• [ ] 실제 업무에 필요한 대화형 프로그램만 검증했습니다.
• [ ] 원격 단절 뒤 화면, PTY, 프로세스, 재접속 상태를 분리했습니다.
• [ ] 병렬 작업에서 출력과 작업 폴더가 섞이지 않았습니다.
• [ ] 롤백 후 동일 작업이 다시 실행됐습니다.
• [ ] 결과를 계속 사용, 제한 사용, 롤백 중 하나로 기록했습니다.

현재 방식이 브라우저 세션에만 의존한다면 단절 뒤 프로세스 상태를 확인하기 어렵고, 장시간 로그가 누락되며, 작업별 격리도 불분명해질 수 있습니다. 반면 원격 Mac 환경을 고정해 두면 같은 명령과 같은 작업 폴더로 버전 차이를 비교하기 쉽습니다. 일회성 검증이나 임시 테스트가 필요하다면 원격 Mac 환경을 먼저 고정하고, 같은 회귀 목록을 반복 실행하는 방식이 적합합니다. 장기 중부하 작업이나 물리 장치 접근이 필수인 경우에는 직접 보유한 Mac이 더 적합할 수 있습니다.

이번 업그레이드에서 확인해야 할 결론은 “node-pty가 바뀌었으니 터미널 문제가 끝났다”가 아닙니다. 2026년 8월 18일 기준으로는 rc.7을 제한된 원격 Mac에 적용하고, 위 체크리스트의 결과가 쌓일 때까지 전면 확대를 보류하는 것이 안전합니다.