How saya-ch/dsh-mobile works
DSH Mobile is a DeepSeek Harness plugin plus an Android client for securely continuing desktop sessions on a phone. The principal flow is desktop setup and pairing, LAN or remote connection, gateway authentication, then access to the existing DSH web experience; Android stores paired devices and reconnects to gateways. Separate product branches provide remote-channel management, mobile UI customization, diagnostics, extensions, and task notifications. README capabilities inform several branches whose implementation was not sampled; those links are shown only where the documented responsibility is clear.
Main entry points: gateway.ts HTTPS gateway · client.ts Mobile panel · remote.ts Remote channel manager · MainActivity.kt Android app
Components 27
DSH integration
- Plugin entry
src/plugin.ts - Access control
src/control.ts - Mobile panel
src/client.ts
Access gateway
- HTTPS gateway
src/gateway.ts - Pairing and sessions
src/access.ts - Browser pairing
src/auth-pages.ts - Device records
src/storage.ts - Request security
src/network.ts
Connectivity
- LAN setup
src/lan-setup.ts - Remote channel manager
src/remote.ts - FRP support
src/frp.ts - Cloudflared support
src/cloudflared.ts - Cpolar support
src/cpolar.ts - Tailscale Funnel
src/funnel.ts - Funnel host
native/funnel-host/main.go
Mobile clients
- Android app
apps/mobile/android/app/src/main/java/io/github/sayach/dshmobile/MainActivity.kt - Native authentication
apps/mobile/android/app/src/main/java/io/github/sayach/dshmobile/NativeAuthClient.kt - QR scanner
apps/mobile/android/app/src/main/java/io/github/sayach/dshmobile/ScanActivity.kt
Product features
- Touch layout
src/mobile-layout.ts - Mobile customization
src/mobile-compat.ts - Diagnostics
src/diagnostics.ts - Mobile extensions
src/extensions.ts - Task events
src/task-events.ts - Task notifications
src/task-notify.ts
Other components
- Computer user
- Phone user
- DSH runtime
Connections 29
- Computer user → Mobile panel: configures access
- DSH runtime → Plugin entry: loads plugin
- Plugin entry → Access control: registers controls
- Access control → HTTPS gateway: manages gateway
- Mobile panel → Access control: manages settings
- Mobile panel → LAN setup: sets up LAN
- Mobile panel → Remote channel manager: selects channel
- Remote channel manager → FRP support: manages FRP
- Remote channel manager → Cloudflared support: manages tunnel
- Remote channel manager → Cpolar support: manages tunnel
- Remote channel manager → Tailscale Funnel: manages Funnel
- Tailscale Funnel → Funnel host: controls process
- Phone user → QR scanner: scans pairing QR
- QR scanner → Android app: returns scan
- Android app → Native authentication: pairs and renews
- Native authentication → HTTPS gateway: authenticates device
- Android app → Device records: stores pairing
- HTTPS gateway → Pairing and sessions: checks sessions
- Pairing and sessions → Device records: reads and writes
- HTTPS gateway → Browser pairing: serves pairing
- HTTPS gateway → Request security: checks requests
- Phone user → HTTPS gateway: opens mobile access
- HTTPS gateway → DSH runtime: proxies web access
- HTTPS gateway → Touch layout: serves mobile view
- Computer user → Mobile customization: requests layout
- Mobile panel → Diagnostics: runs checks
- Mobile panel → Mobile extensions: manages extensions
- Task events → Task notifications: emits task events
- Task notifications → Android app: signals app