DeepSeek Harness를 휴대폰에서 제어하는 DSH Pocket

핵심 요약

• 전자 기기에 설치된 DeepSeek Harness를 휴대폰에서 실시간으로 접근·조작할 수 있는 npm 플러그인으로, 동일한 WiFi 네트워크의 휴대폰에서 QR 코드를 스캔하거나 공인망을 통해 4G 등 외부 네트워크에서도 접속 가능하다.
• 로컬 네트워크 모드는 설정 페이지에서 바로 사용 가능하며, 장치 IP를 자동 감지하고 WSL 환경에서 Windows 물리 네트워크 카드 IP를 자동으로 선택한다.
• 공인망 접근은 cloudflared 터널을 통해 작동하며, Cloudflare Tunnel Token과 도메인명을 설정해 고정된 공인 주소를 사용할 수 있는 '명명된 터널' 옵션을 제공한다.
• 기본적으로 로컬 네트워크에는 독립적인 8자리 무작위 비밀번호(수동 갱신 가능)가 있고, 공인망은 기본적으로 매번 개입할 때마다 새로운 8자리 무작위 비밀번호가 생성되지만, 사용자 정의 8~64자 비밀번호로 변경 가능하다.
• 휴대폰 로그인 후에는 전자 기기의 dsh web 프로세스가 재시작될 때까지 비밀번호를 다시 입력할 필요 없으며, WebSocket을 통한 스트림 출력으로 실시간 양방향 작동이 가능하고 대용량 JSON 응답을 자동으로 gzip/brotli 압축한다.
• 로컬 네트워크 접근 해제, 공인망 접근 시작/중단, 비밀번호 갱신, 포트 변경 등을 설정 페이지에서 한 클릭으로 제어할 수 있다.
• 보안 측면에서 공인망 접근 전 필수 면책 성명 동의를 요구하며, 같은 IP에서 5회 연속 오류 시 60초간 잠금, 전역 임계값 초과 시 일시적 전체 잠금으로 무력 공격을 방지한다.
• 공인망 주소는 cloudflared가 무작위로 할당하며, 재시작 시마다 변경되어 자동으로 순환되고(명명된 터널 모드는 변경 안 됨), 공인망 판정은 loopback과 사설 주소를 제외한 모든 도메인에 공인망 비밀번호를 강제한다.
• 모바일 화면에 맞춘 적응형 레이아웃(서랍형 사이드바, 전체 폭 세션, 터치 최적화)을 제공하고, v2.11.1부터는 cloudflared 시작 시 프록시 환경 변수를 자동으로 제거해 프록시 소프트웨어로 인한 터널 오류를 방지한다.
• CLI 모드(`dsh-pocket` 직접 실행)에도 기본 8자리 무작위 비밀번호 보호가 있으며 터미널에 출력되고 QR 코드에 내장되며, `--pin` 옵션이나 환경 변수로 커스터마이징 가능하다.
• 데스크톱 버전(DSH Desktop) 환경에서도 휴대폰 스캔 동기화가 정상 작동하며, 업데이트·재시작은 데스크톱 버전이 관리한다.
• 공인망 터널 오류(error 1033)의 주요 원인은 로컬 프록시/VPN(Clash TUN 모드 등)이 cloudflared 연결을 차단하는 것으로, TUN 모드 비활성화, 프록시 소프트웨어 종료, 또는 로컬 네트워크 모드로 우회 가능하다.