dsh-mobileshare

# 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.

Where	What
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
Composer	Always 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):

Field	Default	Meaning
port	3081	Reverse-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.