shaobeichen/dsh-pocket

해결하는 문제

DSH Pocket을 사용하면 컴퓨터에서 실행 중인 DeepSeek Harness (DSH) 인스턴스를 모바일 기기에서 원격으로 접근하고 제어할 수 있습니다. 복잡한 원격 데스크톱이나 SSH 설정이 필요 없으며, 책상에서 떨어져 있어도 에이전트 작업을 모니터링하고, 명령을 전송하며 실시간으로 출력을 확인할 수 있습니다.

작동 방식

이 프로젝트는 DSH 웹 인터페이스용 프록시 및 터널 제공자로 작동합니다. 주로 두 가지 접근 방식을 제공합니다:

• 로컬 영역 네트워크 (LAN): 컴퓨터의 로컬 IP를 자동 감지하고, 동일한 WiFi에 연결된 기기용 QR 코드를 생성합니다.
• 공개 인터넷: cloudflared 터널을 사용하여 보안된 공개 URL과 QR 코드를 생성하여, 어떤 네트워크(4G/5G/외부 WiFi)에서도 접근 가능하게 합니다.

DSH 설정 페이지에 직접 "모바일 접근" 항목으로 통합되며, 모바일 최적화된 UI(드로어 레이아웃, 터치 최적화)를 통해 작고 작은 화면에서도 사용이 가능하도록 설계되어 있습니다.

대상 사용자

자택이나 사무실 컴퓨터에서 실행 중인 AI 에이전트와 작업을 관리하고 싶지만, 이동 중에도 제어 기능을 잃고 싶지 않은 DeepSeek Harness 사용자.

주요 기능

• 실시간 동기화: WebSockets를 사용하여 컴퓨터에서 스트리밍되는 출력을 모바일 기기에도 즉시 반영합니다.
• 보안 접근: LAN과 공개 접근용으로 별도의 비밀번호를 구현하며, 공개 비밀번호는 자동으로 회전되고 브루트 포스 공격 방지 기능도 포함합니다.
• 사용자 정의 도메인: 영구적이고 변경되지 않는 공개 URL이 필요한 사용자를 위해 Cloudflare Named Tunnels를 지원합니다.
• 의존성 없는 설치: 단일 npm 패키지로 설치되며, DSH에 설정 페이지와 프록시 서비스를 추가합니다.
• 트래픽 최적화: 장시간 모바일 접속 시 데이터 사용량을 줄이기 위해 gzip/brotli 압축을 사용합니다.