dsh-zen-remote

dsh-zen-remote One DeepSeek Harness plugin, two roles. The host turns DSH into a phone-reachable PWA (mobile UI, pairing gateway, lock-screen push) and shares chosen sessions to paired desktops. The client runs inside another DSH desktop app and puts the host's shared sessions right into its own sidebar (up to 8 hosts connected simultaneously) — full history, live progress, messages, approvals, terminal, everything executes on the host.

中文文档 Screenshots are a 390×844 phone viewport in the light theme; both themes are supported. The pairing page is drawn by the gateway in DSH's official style, following the system light / dark appearance. Contents

1. Install 2. Quick Start (Unified Setup & Pairing Wizard) Scenario A: Set up as Host (Phone & Desktop Access) Scenario B: Set up as Desktop Client (Connect up to 8 Hosts) 3. Daily Usage: Session Sharing & Cross-Device Workflow 4. Lock-Screen Push: When Notifications Fire 5. Features 6. Advanced Settings & Field Reference 7. Security Model, Version Tolerance & Known Notes 1. Install Install from the UI (Recommended, Desktop App & Web UI)

Open the Plugins page in the DSH sidebar → click Add plugin → type dsh-zen-remote → click Enable now when the install finishes, then restart the DSH desktop app (or dsh web). Install from the CLI (Headless dsh web server) dsh plugin requires --profile to name the target profile. The desktop app's desktop profile is managed exclusively by the app (--profile desktop is refused on the CLI), so use the UI install above on the desktop app. Headless Server CLI Wizard (dsh-zen-remote)

The plugin ships a bundled CLI tool so remote VPS / headless servers (dsh web) can complete the entire setup, ingress configuration, three-light verification, and QR / desktop pairing flow in a terminal without opening a browser:

Expand full CLI subcommand reference ( host / client / non-interactive flags) Preflight & non-interactive automation: setup automatically scans candidate profiles for multi-select plugin installation (desktop is skipped) and launches the DSH daemon / app before starting the wizard. Pass --yes with the required flags (e.g. setup --role host --ingress lan --no-wait --yes) for unattended scripts. Architecture: the CLI communicates with the running plugin over a 0600 local IPC socket (~/.dsh/zen-remote-cli.sock); Caddy and cloudflared stay managed by the plugin process. Use --lang zh|en to switch output language.

Manual Profile Edit / Local Development ( link: ), Upgrading & Uninstall

Editing the profile by hand (local development, link: installs): add the dependency to the profile's package.json (~/.dsh/profiles/desktop for the desktop app, ~/.dsh/profiles/web for the web service) and append "dsh-zen-remote" to the dsh.profile.bundles array:

Upgrading & migration notes: Upgrading with HMR on: remove dsh-zen-remote first, then install the new version (dsh plugin --profile remove dsh-zen-remote → add dsh-zen-remote, or Uninstall → Add in the Plugins page). DSH 0.2.1-alpha.3+ profile reset: dsh --profile --from-default-profile replaces an existing custom profile with a fresh copy; back up ~/.dsh/profiles/ first. Upgrading from 1.x: since 2.0.0 the composition layer is a single row (dsh-zen-remote). Remove any legacy dsh-zen-remote-gateway, dsh-zen-remote-push, or manual dsh-push.mjs lines from cordis.patch.yml. Existing ~/.dsh/lan-gate.config.json settings and paired devices carry over automatically. Uninstalling: click Uninstall on the dsh-zen-remote plugin page and restart. To also wipe pairing and share state, delete ~/.dsh/lan-gate-state.json, ~/.dsh/lan-gate.config.json, and ~/.dsh/zen-remote-state.json (older versions also kept ~/.dsh/zen-remote-shares.json and ~/.dsh/zen-remote-server.json — they migrate into the state file automatically on first start and are then deleted). 2. Quick Start (Unified Setup & Pairing Wizard)