Preface

If you’re only operating DeepSeek Harness (DSH) on a computer or tablet, the native Web Shell’s three-pane interface is sufficient. However, when viewing sessions, initiating tasks on your phone, or returning to collect results after waiting for an agent to complete, the interface presents several specific friction points: the sidebar and detail panel are difficult to manage on narrow screens, the input area doesn’t integrate seamlessly with the mobile keyboard, and the web page cannot be directly installed as a standalone entry point with task completion notifications.

Below, we introduce dsh-ui-mobile. It is a client-side plugin for the DeepSeek Harness Web Shell, enabling mobile adaptations only below 768px; computers and tablets continue using the native Harness three-pane interface.

What It Is

dsh-ui-mobile in one sentence: a mobile plugin for the DeepSeek Harness Web shell, providing off-canvas sidebar/details drawers, a bottom nav bar, and a touch-first responsive sheet.

The current repository path is jasondu/dsh-ui-mobile, licensed under MIT. It belongs to the client-side plugin ecosystem of DSH — it is not a standalone web application, nor is it a complete web service that can run independently of Harness. Once installed, it relies on a running DeepSeek Harness Web Shell.

Core Features

  1. Mobile Layout: The plugin activates below 768px; desktop and tablet layouts remain unchanged.

  2. Drawer-style Sidebar & Detail Panel: The sidebar and detail panel slide out from screen edges, suitable for touch interaction on phones.

  3. Bottom Navigation Bar: Provides a bottom nav bar for convenient access to common entries on mobile devices.

  4. PWA Installation: The plugin includes a manifest, icons, Service Worker, startup skeleton, and installation guide, allowing the page to be added to the home screen and launched standalone.

  5. Web Push Task Completion Notifications: In an installed PWA, notifications can be received when an agent completes successfully; notifications are only sent upon successful completion.

  6. Mobile Input Area Optimization: The input field is fixed at the bottom of the visible area, and the keyboard’s primary action displays as “Send.”

  7. Boundaries: The plugin does not replicate the Shell or modify Harness source code; it does not alter model requests, system prompts, tool schemas, or session content. KV Cache Impact: None — this plugin does not participate in request assembly.

Installation & Activation

First, ensure you have a running DeepSeek Harness Web Shell and determine the DSH profile where you want to install the plugin. Then execute the installation command:

dsh plugin --profile <profile> add dsh-ui-mobile

Replace <profile> with the actual DSH profile in use. After installation, access the Web Shell via your phone’s browser; when the window width drops below 768px, you will see the mobile layout.

Note: The plugin runs with the permissions of the current dsh process. Before installation, review the source code, dependency behaviors, and license; this plugin is MIT-licensed, but that does not replace a review of the specific runtime environment and permissions.

Typical Usage

Here is a set of operations you can verify on a phone.

  1. Open the sidebar: Tap the menu in the top-left corner, or swipe right from the leftmost 24px of the screen.

  2. Close the sidebar: Tap the menu or the dark area outside the drawer.

  3. Send a message: The phone keyboard shows “Send”; pressing Enter follows Harness’s normal send flow.

  4. Android Chrome / Edge: A one-time install prompt appears when the browser can install; tap “Install” to use the browser’s native flow.

  5. iOS Safari: The guide prompts “Share → Add to Home Screen.”

  6. Subscribe to task completion notifications: In the installed PWA, tap “Enable task completion notifications” and grant system permissions to subscribe.

Notes on Enabling Task Completion Notifications

Task completion notifications require HTTPS, valid VAPID configuration, and user authorization. Before enabling, you need to set up VAPID and subscription storage paths for the web service; all three VAPID environment variables must be set simultaneously.

Among them, DSH_WEB_PUSH_VAPID_SUBJECT must be a valid email or a real https:// URL; placeholder domains like .invalid are not acceptable. The private key and subscription files must not be committed to the repository, and file permissions should be set to 0600. iOS requires iOS 16.4 or later.

Known Limitations

  • The drawers are CSS-driven fixed-width panels; width adjustment by dragging is not supported on mobile.
  • The sidebar supports sliding in from the left edge; closing is done by tapping the overlay or menu — swipe-to-close is not supported.
  • The plugin activates only below 768px; desktop and tablet layouts remain unchanged.
  • This package is a client-side plugin, not a standalone web application; it requires a running DeepSeek Harness Web Shell.

Conclusion

dsh-ui-mobile addresses the everyday operational challenges of using DeepSeek Harness Web Shell on a phone: drawer-style navigation, bottom navigation, PWA installation, input area adaptation, and system notifications after successful agent completion. It does not alter model requests, system prompts, tool schemas, or session content, nor does it participate in request assembly.

Relevant links:

The catalog page above is an independent site and does not constitute an official affiliation with DeepSeek / High-Flyer.