前言

DeepSeek Harness (DSH) web shell uses a desktop-first design by default. In viewports smaller than 1024px, the sidebar only collapses into a rail; on phones, an expanded drawer squeezes the main column to about 110px, causing input box buttons to overlap and the settings dialog to shrink into a thin strip.

dsh-mobile specifically completes the adaptation logic for mobile viewports below 768px. It is introduced as a client-side plugin and does not depend on modifying shell source code or server components.

插件简介

Name: dsh-mobile
Maintainer: TecFancy
Category: Client
License: MIT

It is a plugin that provides mobile adaptation for the DSH web shell, mainly solving layout squeezing issues in narrow viewports.

核心功能

  1. Floating sidebar drawer: When opening the sidebar, it overlays content with a mask instead of squeezing the main column.
  2. Floating detail panel: The tool detail panel is displayed as a right-side overlay, preventing chat content from being squeezed.
  3. Non-overlapping input layout: Mode buttons and the model selector wrap to multiple lines, avoiding occlusion.
  4. Settings dialog rearrangement: Dialog items are stacked vertically, the label bar supports horizontal scrolling, and the content area is full width.
  5. Zero desktop regression: All rules are based on narrow-viewport markers, and desktop behavior (≥ 1024px) remains consistent with the native shell.

安装与启用

Prerequisites: Node.js version >= 22 and DSH installed.

Install the plugin into the current profile and restart the service:

dsh plugin --profile web add @tecfancy/dsh-mobile
# Restart service
dsh web

The plugin automatically activates when the viewport width is below 768px and remains idle on desktop.

注意事项

  1. Installation source: If the npm mirror prevents package download, add the official registry parameter:
   dsh plugin --profile web add --registry=https://registry.npmjs.org/ @tecfancy/dsh-mobile
  1. Coexistence: It can coexist with other shell-level plugins (e.g., dsh-better-sidebar).
  2. Version compatibility: Verified compatible with DSH 0.1.0-rc.6.

结语

By introducing dsh-mobile, you can get a complete DSH interaction experience on mobile devices without forking the shell source. The plugin is released under the MIT License.

Plugin Directory
GitHub Repository