Back to directory

dsh-pocket

Curated pickMaintenance: Active

shaobeichen/dsh-pocket

Mobile/remote access to dsh web: LAN + public cloudflared tunnel QR codes, real-time WS mirror, mobile drawer UI (ports dsh-web-mobile), a Settings '手机访问' page, auto-rotating public URLs

View on GitHub
$ dsh plugin --profile web add dsh-pocket -w

1,035

stars

48

forks

JavaScript

Language

GPL-2.0

License

2026-08-15

Created

2026-09-03

Last push

GPL-2.0 dsh web plugin installed via `dsh plugin --profile web add` that mirrors the DeepSeek Harness Web UI to your phone through LAN or cloudflared public-tunnel QR codes, with rotating 8-digit passwords and real-time bidirectional WebSocket sync.

DSH integration

Compatible

Author-claimed

Safety audit

Unaudited

Last verified

2026-08-21

License

GPL-2.0

01What can it help you accomplish?

  • Access and operate the DeepSeek Harness web UI from a phone while away from the computer

    The exact same DSH interface mirrored to the phone in real time via a LAN QR code, with bidirectional WebSocket pass-through so streaming output scrolls on the phone as it prints on the computer

    Individual DeepSeek Harness users who want to monitor or steer running agent sessions from a mobile device without remote desktop or SSH

  • Get password-protected remote access to dsh web from any network (4G, office, campus)

    A cloudflared public-tunnel QR code with a randomly assigned URL and an 8-digit password that rotates on every tunnel start; the tunnel auto-recovers after DSH restarts — no server and no account required

    DSH users who are away from their machine and need remote access without setting up a server, SSH, or remote desktop

02How to install into DeepSeek Harness

Prerequisites

  • DeepSeek Harness installed on the computer — the README requires the dsh CLI first (`npm install -g @deepseek-ai/dsh`, or prefix commands with `npx @deepseek-ai/dsh`)
  • A `dsh web` instance that can be restarted after installing the plugin

Installation steps

  1. 01

    Install the plugin into the web profile: `dsh plugin --profile web add dsh-pocket -w` (the trailing `-w` is required, e.g. for pnpm 9 workspace-root restrictions)

    $ dsh plugin --profile web add dsh-pocket -w

  2. 02

    Restart dsh web: `npx @deepseek-ai/dsh web`

    $ npx @deepseek-ai/dsh web

  3. 03

    To update later: `dsh plugin --profile web update dsh-pocket --latest -w` (`--latest` is required to cross major versions)

    $ dsh plugin --profile web update dsh-pocket --latest -w

Verify the integration

  • After restarting `dsh web`, open Settings — the left sidebar shows a 「手机访问」 entry at the same level as 「通用设置」 and 「模型」

03DSH integration and capability boundaries

DSH integrationCompatible

DSH web profile plugin installed via `dsh plugin --profile web add dsh-pocket -w` that adds a Settings → 「手机访问」 page mirroring the running dsh web UI to phones over LAN or a cloudflared public tunnel

  • LAN QR-code access

    dsh web running on the computer; a phone on the same WiFiScanning the LAN QR code opens the same DSH interface on the phone after entering the independent 8-digit LAN password (enabled by default; can be switched off for direct connect)

  • Public cloudflared tunnel with rotating password

    Clicking 「开启公网访问」 on the Settings pageA public QR code / randomly assigned URL accessible from 4G or any network, protected by an 8-digit password that changes on every tunnel start; previously open tunnels auto-recover after DSH restarts

    downloads the cloudflared binary on first enable (Tsinghua mirror first on macOS/Linux, direct download on Windows)exposes the DSH interface through a random Cloudflare tunnel URL (password required)
  • Real-time bidirectional sync with mobile-adapted UI

    An active dsh web sessionStreaming output forwarded via WebSocket pass-through — the phone scrolls as the computer outputs, and both sides can operate; narrow screens automatically switch to a drawer layout ported from dsh-web-mobile (MIT)

  • Transfer compression for mobile loading

    Large JSON responses (e.g. long sessions)Automatic gzip/brotli compression — a 17MB long session compresses to ~1MB (brotli quality 6), so the phone loads faster and saves mobile data

    persists passwords and toggle state on disk under `$DSH_HOME/dsh-pocket/` (token, token-lan, settings.json)

04Who is it for? When not to use it?

Good for

  • Individual DeepSeek Harness users who want to monitor or steer running agent sessions from a mobile device without remote desktop or SSH
  • DSH users who are away from their machine and need remote access without setting up a server, SSH, or remote desktop

Not for

  • The public tunnel can fail with `error 1033` when a local proxy/VPN (Clash, Surge, v2ray, sing-box — especially TUN mode) intercepts cloudflared's edge connections; enterprise firewalls and campus networks may also block it. Workarounds: disable TUN mode, quit the proxy, add DIRECT rules for argotunnel.com/trycloudflare.com, or fall back to LAN mode via a phone hotspot.
  • DSH Desktop's advanced mode does not support mobile access — that mode disables the web layout so the phone cannot reach the layout service and shows a blank screen; switch back to compatibility mode and restart.
  • DSH can execute code on your computer, so the LAN/public QR code, URL and the 8-digit password together are the key to your machine — never share them. Public access always requires a password; the LAN password is on by default but can be disabled, and the tool is intended for personal use only.

05Compatibility, maintenance and safety notes

  • The public tunnel can fail with `error 1033` when a local proxy/VPN (Clash, Surge, v2ray, sing-box — especially TUN mode) intercepts cloudflared's edge connections; enterprise firewalls and campus networks may also block it. Workarounds: disable TUN mode, quit the proxy, add DIRECT rules for argotunnel.com/trycloudflare.com, or fall back to LAN mode via a phone hotspot.
  • DSH Desktop's advanced mode does not support mobile access — that mode disables the web layout so the phone cannot reach the layout service and shows a blank screen; switch back to compatibility mode and restart.
  • DSH can execute code on your computer, so the LAN/public QR code, URL and the 8-digit password together are the key to your machine — never share them. Public access always requires a password; the LAN password is on by default but can be disabled, and the tool is intended for personal use only.
2026-08-152026-08-19v1.9.2

GPL-2.0 · actively maintained (latest release v1.9.2, 2026-08-20)

06Frequently asked questions

How do I install dsh-pocket into DeepSeek Harness?

Install the dsh CLI first (`npm install -g @deepseek-ai/dsh`), then run `dsh plugin --profile web add dsh-pocket -w` and restart `dsh web`. A new 「手机访问」 entry appears in the Settings sidebar, where you get the LAN QR code and can enable the public tunnel.

Is it a native part of dsh, or an MCP server?

It is a plugin for the dsh web profile installed through the official `dsh plugin` CLI. It adds a Settings page plus a reverse proxy that mirrors the existing dsh web UI to your phone — no MCP configuration is involved.

Do I need a server or an account for public access?

No. Clicking 「开启公网访问」 starts a cloudflared tunnel with a randomly assigned URL, protected by an 8-digit password that changes every time public access is enabled — old links stop working immediately. The tunnel also auto-recovers after DSH restarts.

What are the security considerations?

DSH can execute code on your computer, so the QR code/URL plus the 8-digit password together are the key. Never share the LAN QR code, URL, or password; public access always requires a password, and the LAN password is on by default. It is designed for personal use.

Any known limitations?

DSH Desktop's advanced mode doesn't support mobile access (switch to compatibility mode); local proxies/VPNs in TUN mode can break the public tunnel with error 1033; and you must restart `dsh web` after installing or updating the plugin for changes to take effect.

08Data and sources

  • Author-claimedgithub.com4cdd3ec04ab8…

    DSH Pocket 就是干这个的:**装上它,手机扫个码,就能实时看到并操控电脑上的 DeepSeek Harness 界面**——人在外面也能用。

  • Author-claimedgithub.com4cdd3ec04ab8…

    # 1. 装插件(一个包全都有) dsh plugin --profile web add dsh-pocket -w # 2. 重启 dsh web npx @deepseek-ai/dsh web

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-21. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.