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
- Open DSH settings → Mobile Share panel (or open the share URL in a phone browser → top bar ⇄).
- Click "Start sharing" (custom port/credentials optional; empty credentials generate a random password).
- 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-plugintopic for discoverability.
Contributing
See CONTRIBUTING.md.
Development
Read the development guide and the architecture document first.
For agents: follow AGENTS.md.
License
Third-party dependencies and their licenses are listed in THIRD_PARTY_NOTICES.md.