saya-ch/dsh-mobile

DeepSeek Harness 的 Android App 与安全远程访问插件，支持局域网/远程连接和高度自定义的移动界面与扩展能力。

DSH Mobile이란?

DSH Mobile은 DeepSeek의 오픈소스 채팅 어시스턴트 플랫폼인 DeepSeek Harness (DSH) 용 플러그인입니다. 이 플러그인은 메인 DSH 서버가 컴퓨터에서 계속 실행되는 동안 Android 휴대폰(또는 휴대폰 브라우저)에서 동일한 DSH 세션, 작업 공간 및 채팅을 계속할 수 있도록 모바일 액세스 레이어를 추가합니다.

이 플러그인은 컴퓨터 측에서 실행되며 모바일 최적화 UI를 제공하는 작은 HTTPS 게이트웨이(기본 3443)를 만듭니다.
Android 앱(경량 Kotlin WebView 래퍼) 또는 휴대폰 브라우저는 LAN 또는 원격 터널(Tailscale Funnel, cpolar, Cloudflare Tunnel, 자체 호스팅 FRP 또는 사용자 지정 역방향 프록시)을 통해 해당 게이트웨이에 연결됩니다.
페어링은 QR 코드 또는 43자 키로 한 번만 수행됩니다. 휴대폰은 Android Keystore에 자격 증명을 저장하고 자동으로 다시 연결할 수 있습니다.

주요 기능

기능	설명
원활한 세션 동기화	모바일 UI에는 데스크톱 DSH 인스턴스와 정확히 동일한 채팅 기록, 작업 공간 및 도구가 표시됩니다.
터치 친화적 레이아웃	UI 구성 요소(사이드바, 도구 세부 정보, 입력 표시줄 등)는 작은 화면에 맞게 재배치됩니다. 앱은 시스템 언어를 따릅니다.
다중 터널 옵션	LAN, Tailscale Funnel, cpolar, Cloudflare(빠른 또는 명명된 터널), 자체 호스팅 FRP 또는 자체 HTTPS 역방향 프록시를 선택할 수 있습니다.
기기 페어링 및 관리	QR 코드를 스캔하거나 키를 붙여넣습니다. 앱은 페어링된 모든 컴퓨터를 나열하고 연결 가능 여부를 표시하며 다시 페어링하거나 항목을 삭제할 수 있습니다.
원클릭 진단	버전, 네트워크 인터페이스, 방화벽, 터널 상태를 확인하고 편집된 보고서를 생성합니다. 차단된 타사 WebSocket 경로를 자동으로 허용할 수 있습니다.
시스템 알림	작업 완료 및 입력 필요 알림이 Android 알림으로 표시됩니다(선택 사항, 잠금 화면에서 마스킹 가능).
보안 우선 설계	LAN 게이트웨이는 개인 CA를 사용합니다. 원격 게이트웨이는 신뢰할 수 있는 공개 인증서를 사용합니다. 자격 증명은 Android Keystore에 보관되며 정확한 출처로만 전송됩니다.
확장 시스템	`/mobile <request>` 명령을 통해 DSH 에이전트에 `mobile.css`, `mobile.js`를 수정하거나 컴퓨터 측에서 실행되는 JavaScript 확장(`host.mjs`)을 추가하도록 요청할 수 있습니다. 변경 사항은 즉시 휴대폰으로 푸시됩니다.
워커 모드(선택 사항)	확장은 UI 정지를 방지하기 위해 비차단 워커 스레드에서 실행될 수 있습니다.

시작하기(빠른 단계)

컴퓨터에 플러그인 설치
- 공식 DSH 데스크톱 앱에서 플러그인 → dsh-mobile을 추가하고 활성화합니다. 또는
- DSH 웹 설치에서 다음을 실행합니다:
```
dsh plugin --profile web add dsh-mobile@latest
dsh plugin --profile web exec dsh-mobile setup
```
연결 구성
- DSH에서 모바일 액세스를 열고 LAN 액세스를 켭니다(또는 선택한 원격 터널을 활성화). 플러그인은 개인 인증서와 QR 코드를 생성합니다.
Android 앱 설치
- 릴리스 페이지에서 APK를 다운로드합니다(예: dsh-mobile-android-v0.6.3.apk).
휴대폰 페어링
- 앱에서 LAN 또는 원격을 선택하고 QR 코드를 스캔하거나(또는 43자 키를 붙여넣기)합니다. 기기는 신뢰되며 자동으로 다시 연결됩니다.
휴대폰에서 DSH 사용 시작
- 앱에 동일한 채팅 작업 공간이 표시됩니다. 모든 모바일 브라우저에서 동일한 URL을 열 수도 있습니다.

모바일 UI 확장/사용자 지정

모든 DSH 대화에서 메시지를 보냅니다:

/mobile 把手机端做成老式终端的样子，让消息像终端输出一样逐行滚动

DSH 에이전트는 요청된 변경 사항을 $DSH_HOME/mobile-access/(CSS/JS 파일 또는 새 extensions/ 폴더)에 기록합니다. 플러그인은 이러한 파일을 감시하고 몇 초 내에 휴대폰으로 업데이트를 푸시합니다.
더 복잡한 논리를 위해 사용자와 동일한 권한으로 컴퓨터에서 실행되는 host.mjs 파일이 있는 JavaScript 확장을 추가할 수 있습니다.
선택적 워커 모드(확장별로 활성화)는 코드를 별도의 스레드에서 실행하여 UI 응답성을 유지합니다.

보안 고려 사항

LAN 모드는 신뢰할 수 있는 가정/사무실 네트워크에서만 사용해야 합니다. 게이트웨이는 인터넷에 노출되지 않습니다.
원격 터널은 공용 CA(cloudflare, Tailscale) 또는 앱이 고정하는 개인 CA와 함께 HTTPS를 사용합니다. 터널 바이너리(cloudflared, cpolar, frpc)는 공식 릴리스에서 다운로드되고 SHA-256으로 검증됩니다.
페어링된 휴대폰은 DSH 인스턴스를 완전히 제어할 수 있습니다. 신뢰할 수 있는 기기로 취급하십시오. 휴대폰을 분실한 경우 컴퓨터 측에서 즉시 해지하십시오.
모든 쓰기 작업(설정, 확장)은 페어링된 세션 토큰 및 CSRF 보호 출처에 대해 확인됩니다.

혜택을 받을 수 있는 사람은?

로컬에서 DeepSeek Harness를 실행하고 책상에서 떨어져 있을 때 반응형 UI를 원하는 개발자 또는 파워 사용자.
별도의 DSH 서버를 실행하지 않고 동일한 채팅 작업 공간을 휴대폰에서 빠르게 확인해야 하는 팀.
클라우드 기반 AI 채팅 앱의 안전한 자체 호스팅 대안을 원하고 모바일 액세스가 필요한 모든 사람.

위의 모든 정보는 리포지토리의 README에서 직접 가져온 것입니다. 추가 기능은 추론되지 않았습니다.