Foreword¶
The philosophy of DSH is “everything is a plugin,” and clients can extend the existing Web GUI through plugins. For scenarios where you need to continue operating DeepSeek Harness on a mobile device, the desktop layout is not directly usable on narrow screens: the sidebar, input area, settings panel, and trace details all need to be re-adapted.
dsh-client-ui-mobile-adapt solves this problem: it converges the interface into a single-column layout on mobile viewports while keeping it unchanged on desktop.
What is this¶
dsh-client-ui-mobile-adapt is a mobile adaptation client plugin for the DeepSeek Harness Web GUI, maintained by Hotsteel2901, and licensed under MIT.
It uses the official client plugin format: dsh.client declaration + window.__ModuleLoader__.load module, and can also be mounted as a profile bundle (dsh.bundle.patch). It is a pure client-side plugin that only takes effect under max-width: 768px viewports, leaving the desktop completely unaffected.
Core Features¶
- Converges the three-column desktop layout into a single-column mobile layout.
- The sidebar becomes a left drawer, and content components fill the drawer width.
- The hamburger button floats as a
shell.overlayslot button; clicking the overlay closes it. - The input toolbar is forced into a single line, with triggers limited to
112pxwidth. - Model selection, context details, and command menus are limited to
calc(100vw - 16px)width. - The settings panel displays in full screen, with a horizontally scrollable single-line top navigation and a scrollable content area.
- The plugin panel is
fixedand floating at the bottom130px, and can be opened or closed. - The trace table is full-width; the details panel is a fixed-height floating window
min(52vh, 460px)that is scrollable internally. - Bottom statistics are presented as a capsule summary; clicking expands the full statistics panel, which is scrollable.
- iOS uses
100dvhfor dynamic viewport height and adapts to the notch and bottom safe area.
Installation and Enabling¶
When installing, use the https tarball URL and avoid using the github: shorthand. According to the documentation, under npm 12 security policies, a standard https://.../archive/refs/heads/main.tar.gz URL can be installed normally.
Install into an existing profile:
dsh plugin --profile web <profile name> add https://github.com/Hotsteel2901/dsh-client-ui-mobile-adapt/archive/refs/heads/main.tar.gz
This step adds the plugin to the specified profile. Then start or restart the corresponding profile to use it.
You can also manually edit the profile’s cordis.patch.yml:
- insert:
- id: ui-mobile-adapt
name: 'dsh-client-ui-mobile-adapt'
To update to the latest version:
npm cache clean --force && rm -rf node_modules/dsh-client-ui-mobile-adapt && npm install
Typical Usage¶
One recommended approach is to create a dedicated profile, such as webmobile. In the profile dependencies, point to the plugin’s tarball URL, install dependencies, and start:
npm install
dsh --profile webmobile
This usage corresponds to mounting as a profile bundle (dsh.bundle.patch). After starting, the Web GUI will include mobile adaptation.
Applicable Scenarios and Notes¶
This plugin is suitable for viewing and operating the DeepSeek Harness Web GUI on mobile devices, such as continuing to handle sessions, input, settings, and trace details in Android Termux.
Usage Notes:
- The plugin runs with the permissions of the current
dshprocess; before installation, you should check the source code and license. - The license is MIT.
- The plugin depends on
react,@deepseek-ai/cordis, and host-side client servicesslots,layout, andlocale. - peerDependencies lock
@deepseek-ai/dsh-client-runtime,@deepseek-ai/dsh-client-ui-slots,@deepseek-ai/dsh-client-ui-layout, and@deepseek-ai/dsh-client-localeto exactly0.1.0-rc.6. - If the DSH frontend build or class names change, you need to re-verify against the new build artifacts and update peerDependencies accordingly.
Links¶
The community directory is an independent site and has no official affiliation with DeepSeek /幻方; the following links are only for plugin source and search clues.
- GitHub: https://github.com/Hotsteel2901/dsh-client-ui-mobile-adapt
- Directory Page Clue: https://www.skillhub.cn/plugins/Hotsteel2901/dsh-client-ui-mobile-adapt