@firefly0621/dsh-remote-app

English | 中文

PWA for remote dsh control: pair once with a QR scan or a 6-digit code, browse the plugin inventory, and view settings — all over the shared remote-control protocol. It is a plain Vite static site with no framework; the phone browser's "add to home screen" makes it app-like.

Run

pnpm --filter @firefly0621/dsh-remote-app dev

Deploy

pnpm --filter @firefly0621/dsh-remote-app build
# serve apps/remote-app/dist from any static host, ideally HTTPS so the browser
# can reach the WSS relay

Flow

1. Open the app: it auto-resumes a previously paired session from its stored token; otherwise it shows the pairing screen.
2. Pair once — tap 扫码连接 to scan the QR shown in the host's Settings → Remote Control panel, or enter the relay URL and the 6-digit code manually.
3. The app shows the plugin inventory; the sessions screen lists the host's conversations (create and delete phone-created ones), and the conversation screen loads the history, sends messages, and streams the assistant reply with tool-call rows; the settings tab renders every namespace as a JSON view (editing is not implemented yet).

The pairing token is kept in localStorage, so refreshing or reopening the app resumes the session without re-pairing. Re-pair only becomes necessary when the host removes the device (Settings → Remote Control → paired devices), resets its identity, or the relay loses its persisted sessions (DSH_RELAY_DATA_DIR not set and restarted).