jackxu925/dsh-pwa

dsh-pwa is a phone-first Progressive Web App plugin built specifically for DeepSeek Harness (dsh). It ships as the npm package dsh-pwa and integrates by adding it to a web profile at ~/.dsh/profiles/web/package.json: the user lists dsh-pwa under dependencies and registers it inside dsh.profile.bundles alongside @deepseek-ai/dsh-base and @deepseek-ai/dsh-web-app, then runs npm install and starts the server with dsh --profile web --host 0.0.0.0 --port 3080 --trusted-host <your-access-domain>. The plugin mounts the bundled web/ directory as static files at the /m path, while the in-page client speaks the exact same /api protocol that the desktop GUI already uses, including POST /api/<ns>/<method>, POST /api/respond, and downstream frames over ws://…/api/events.mux, so no business logic is duplicated and updates move with the upstream DSH version. It also injects a dedicated "手机端 / Phone" entry into the desktop GUI settings panel that surfaces the mobile URL with a copy-to-clipboard button, removing the need to type addresses on a phone keyboard.

The intended workflow is for users who want to drive an existing desktop dsh agent session from iPhone or Android without installing a native application. After starting dsh web on a workstation, the user opens http://<host>:3080/m/ in mobile Safari or Chrome and uses the share menu's "Add to Home Screen" action to obtain a full-screen, app-like launcher icon. For remote access over an untrusted network, Tailscale can be installed on both the server and phone under the same account, the Tailscale hostname appended to --trusted-host, and the page reached at http://<tailscale-hostname>:3080/m/. Capabilities cover workspace-grouped session lists with search, pull-to-refresh, and a "needs attention" filter for pending approvals and questions; streaming chat with optimistic send, queued-message visibility, per-day dividers, timestamps, code-copy buttons, and a full-screen image viewer; tappable approval and agent-question cards with a red double-confirm path for dangerous commands; image attachment from camera, photo library, or clipboard paste with automatic compression to model limits; haptics, dark and light themes, per-session draft autosave, and a connection-status pill with manual reconnect.

Dependencies and limits: the only prerequisite is a working desktop dsh CLI installation, and the codebase is vanilla JavaScript with no build step or framework, split across web/ for the front end, lib/routes.js for the mount route, and client/ for the desktop settings injection. Security inherits the same trusted-host fence as dsh web, meaning anyone able to reach the URL on the LAN, tailnet, or reverse proxy can drive the agent, so it must not be exposed to the public internet. First-run caveats include the absence of system push notifications on iOS PWA (the README explicitly contrasts this with the Android-only saya-ch/dsh-mobile), the lack of any offline shell until HTTPS is in place, and the developer-preview status of DSH itself, which may ship breaking API changes and require a matching dsh-pwa update. Upgrades are handled with npm update dsh-pwa followed by a dsh web restart, and the project is released under the MIT license.