Eternalloveone/dsh-palm#dsh-palm

dsh in your palm — the standalone mobile surface for the dsh web GUI: scan-to-pair device trust, the /m/ phone UI, the /m/api RPC channel with a realtime SSE mux bridge, and a polished desktop pairing panel.

Derived from dsh-remote-web-ui — see NOTICE for attribution.

Install

Requires dsh >= 0.1.5-rc.1 (tested against 0.1.5-rc.2). See the repository-level COMPATIBILITY.md for the version matrix.

dsh plugin --profile web add @eternalloveone/dsh-palm

v1.3.0 note: devices paired by older dsh-palm / dsh-remote-web-ui versions do not carry over (the store moved to dsh-palm-devices.json, the settings namespace was renamed) — re-pair phones once after upgrading.

Highlights

• Standalone /m/ mobile UI — an independent phone bundle, not a CSS-injected adaptation
• Desktop-phone live sync — one shared host event stream (measured: loopback 4 ms / public tunnel 9 ms / Tailscale 13 ms median)
• SSE mux bridge with polling fallback — stall detection (36 s) arms adaptive history polling; events are never lost
• Windowed streaming renderer — inline-markdown tail preview, no typewriter cursor, collapsible reasoning blocks
• Interactive diff cards, code actions, command cards, realtime approval panels, image attach, voice transcription, plugin market
• PWA + offline outbox + gzip-compressed API responses — weak-network friendly
• Completion notifications — task-finished and long-reply alerts through three layers: in-app system notifications (SSE), Web Push (VAPID), and third-party channels (WxPusher, Server酱 / Bark / Telegram, plus a demoted legacy PushPlus) for when the app is closed; thresholds and cooldowns are configurable from the phone, with per-kind gates (plan-complete / background-task / long-reply) and a lock-screen privacy toggle
• Global search with message-level locate — search workspaces and every session from the home page, or the current workspace from the session list; hits open the chat and scroll to the matched message with a one-shot highlight (Chinese short words covered by a substring backfill)
• Pending-message queue dock — messages sent while a turn is running queue in the host and show as a dock above the composer (desktop QueueDock parity): editable, removable, or steered in as an interrupt
• Turn navigation — a floating handle (当前 / 总轮) appears once you scroll away from the newest message: tap it for the turn list (prompt + reply previews, unloaded turns paged in first) or drag sideways to scrub and release on the turn you want; the list merges the host turnOutline projection with local turns, so the whole session — 172 turns included — is reachable
• Global run overview — a full-screen cross-session view of running sessions, live background jobs and the subagents a session is waiting for, reachable from the home page's quick chip with a live badge
• Error self-rescue — a render crash shows a readable error page with retry / reload instead of a white screen; window errors, unhandled rejections and failed resource loads collect into a bounded ring that the host can forward to your configured channel
• Eviction-resistant storage — after the first cache write the app asks for persistent storage, so a backgrounded PWA does not silently lose its history cache
• Jank vs suspension — a Long Task observer plus hidden-window bookkeeping reports suspension.hiddenMs, so "the app stuttered" and "the phone froze us" stop being the same measurement; a capture carries the error ring and the storage picture too
• In-chat file & image preview — file-path links open a bottom sheet: markdown renders formatted, HTML renders in a sandboxed iframe, code highlights, images display inline; message images open a full-screen lightbox
• Per-provider usage & balances — one settings card per provider: consumed-quota meters, account balances and OpenRouter's spent-vs-limit, refreshed on demand
• Six-digit pairing code — type a code on the phone instead of scanning
• Three-step pairing wizard — configure → pair → use, with tunnel detection (Tailscale one-click, frp entry from frpc.toml), reachability-checked saving, and a clean device-management view once paired
• Workspace-native theming — the panel follows the system light/dark scheme via prefers-color-scheme

Full feature list, measured data and architecture docs: see the repository README.

Remote access setup

The desktop pairing panel (the phone icon in the sidebar) walks you through three steps: configure → pair → use. To reach this computer from your phone you need an address the phone can reach:

• Same network — start dsh web bound to your LAN address; the phone pairs over Wi-Fi with zero configuration.
• Tailscale — install Tailscale on this computer and your phone; the panel detects it and fills your tailnet address with one click.
• Cloudflare Tunnel / frp — run a tunnel to this machine and enter its public URL in the panel's public-address card. Saving verifies reachability first, so a dead tunnel is caught before it is persisted.

A full walkthrough with a worked frp topology (server frps + nginx TLS, client frpc, panel configuration, verification, and FAQ) lives in the remote access guide.

License

Apache-2.0 — see LICENSE.