dshmobile — Remote Mobile Client for DeepSeek Harness

中文文档

Zero-friction: one command installs the plugin → scan a QR code → keep working from your phone. A true Remote Client for DSH — no Tailscale, tunnels, port forwarding, NAT, or networking knowledge required, no DSH modifications, cross-platform.

Control your local DeepSeek Harness (DSH) from your phone: scan to pair → device → session tree → chat, approvals, question answering, model switching, file browsing.

Architecture

┌──────────────┐   WSS    ┌───────────────────┐   WSS    ┌───────────────────────────┐
│ Android App  │ ───────▶ │  Cloud Relay       │ ◀─────── │ PC Bridge (DSH plugin)     │
│ (signed APK) │          │ (hosted service)   │          │ (open source)              │
└──────────────┘          └───────────────────┘          └────────────┬──────────────┘
                                                                       │ 127.0.0.1:3080
                                                             ┌─────────▼──────────┐
                                                             │ DeepSeek Harness   │
                                                             └────────────────────┘

Business content (prompts / replies / sessions / files) is protected by E2EE end-to-end encryption: the relay only sees routing metadata — it can neither read nor tamper with your session content. The connection layer self-heals: after a DSH restart or a network hiccup it re-handshakes automatically, no manual steps required.

Open Source & Security

The protocol and crypto implementations are fully public and independently auditable; business content is end-to-end encrypted, and the relay only forwards routing metadata — it cannot read your sessions.

Installation

PC (Bridge plugin)

npx -y @deepseek-ai/dsh plugin --profile web add @zdx8637/dshmobile-bridge@latest

Requires pnpm. After restarting DSH, a ▶ panel appears at the bottom of the web sidebar: ① login / grant code, ② encrypted pairing code. Current plugin version: 0.1.0-beta.20.

Phone (Android App)

Scan the QR code on the PC panel → download the signed APK from the landing page (current version v0.2.12). Then scan in the App: ① first to log in, ② then for E2EE pairing — once paired, a key icon appears in the device list (E2EE is active).

DSH Version Compatibility (dual-protocol auto-detection)

Since 0.1.0-beta.18 the plugin auto-detects the DSH generation — upgrade order doesn't matter:

So you can upgrade the plugin first, DSH first, or either way — or leave an old DSH untouched; everything keeps working.

Directory

Trust & Self-hosting (roadmap)

• Today the relay is a hosted service operated by the author; content privacy is guaranteed by E2EE, and the relay only routes and forwards metadata.
• A reference self-hosted relay (reference implementation, ≠ the production service) will be released later so you can self-host: Android → self-hosted relay → Bridge → DSH. Account system, monitoring, and scaling remain the operator's concern.

Privacy & Secrets

This repository contains no real credentials. Android signing keys, relay account passwords, and server SSH credentials live only in local/private channels — always injected via environment variables and referenced as placeholders in docs.