Back to home

menghuanshiguang

dsh-mobileshare

No description

Stars
0
Language
JavaScript
Created
Aug 15, 2026
Updated
Aug 15, 2026

Introduction

DeepSeek Harness MobileShare

English | 中文

dsh-mobileshare is a dsh profile bundle: it turns the PC into a server so an iPhone / Android / tablet can reach the local DeepSeek Harness Web UI from a browser (LAN or public), served with a mobile-optimized UI. All PC Web UI features remain available on the phone.

It uses a plugin-everything architecture driven by Cordis.

Features

  • Mobile access to the Web UI: zero-dependency reverse proxy (Node.js standard library only), LAN addresses auto-detected
  • Injected mobile UI: server-side viewport + CSS + JS injection, present on open, no install, no approval
    • Top bar: ☰ sidebar, ⇄ share panel
    • Composer fixed at the bottom, lifts above the keyboard, typed text shows where it is typed
    • Sidebar "select workspace directory" entry (mobile picker: drive / desktop / last workspace shortcuts, new folder)
    • Desktop "Conversation / Trajectory" tab bar hidden, single top bar
  • Share management: port, access credentials, Windows firewall rule, loopback/LAN self-test, QR code
  • Public access: one-click cloudflared tunnel (winget install cloudflared), no shared LAN required
  • Auto-restore: the last share config is restored on plugin restart; the phone's session cookie survives restarts (WebSocket downlink keeps working)
  • Directory picker swap: the desktop dialog picker is replaced by an in-browser browse picker (usable on phones)

Running

Install

Requires a DeepSeek Harness checkout with the Web profile initialized (run npx @deepseek-ai/dsh web once).

Install from GitHub (pnpm ≥10 asks you to allow the prepare build script on first install; copy the package key pnpm prints into the profile's pnpm-workspace.yaml under allowBuilds and re-run):

dsh plugin --profile web add github:menghuanshiguang/dsh-mobileshare
dsh --profile web

Install from a local checkout:

pnpm install
pnpm run build
dsh plugin --profile web add file:.
dsh --profile web

Installing activates the plugin: the dsh.bundle manifest inserts cordis.patch.yml as a configuration layer, and dsh-client-modules loads the browser half automatically from the dsh.client declaration.

Usage

  1. Open DSH settings → Mobile Share panel (or open the share URL in a phone browser → top bar ⇄).
  2. Click "Start sharing" (custom port/credentials optional; empty credentials generate a random password).
  3. Connect the phone to the same Wi-Fi, scan the QR code, or open the printed LAN URL.
WhereWhat
Top bar ☰Toggle the conversation sidebar
Top bar ⇄Share status, QR code, firewall, public tunnel
Sidebar "📁 Select workspace directory"Mobile directory picker, switch the current workspace
ComposerAlways pinned to the bottom, lifts above the keyboard

iPhone: in Safari, Share → Add to Home Screen. Android: Chrome menu → Add to Home Screen.

Configuration

The plugin row accepts these config fields (override by row id mobileshare in the profile's cordis.patch.yml or $DSH_HOME/cordis.patch.yml):

FieldDefaultMeaning
port3081Reverse-proxy listen port

Community and support

  • Feedback and bug reports are welcome via GitHub Issues.
  • This repository carries the dsh-plugin topic for discoverability.

Contributing

See CONTRIBUTING.md.

Development

Read the development guide and the architecture document first.

For agents: follow AGENTS.md.

License

MIT

Third-party dependencies and their licenses are listed in THIRD_PARTY_NOTICES.md.