dsh-mobileshare

Readme

# DeepSeek Harness MobileShare

English | [中文](README.zh.md)

`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](https://github.com/cordiverse/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):

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

Install from a local checkout:

```sh
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](https://github.com/menghuanshiguang/dsh-mobileshare/issues).
- This repository carries the [`dsh-plugin`](https://github.com/topics/dsh-plugin) topic for discoverability.

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md).

## Development

Read the [development guide](docs/development.md) and the [architecture document](docs/architecture.md) first.

For agents: follow [AGENTS.md](AGENTS.md).

## License

[MIT](LICENSE)

Third-party dependencies and their licenses are listed in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).