Introduction¶
The DeepSeek Harness (DSH) Web interface is designed for desktop. When opened in a mobile browser, common issues include the sidebar taking up the entire screen, misaligned modals, clipped input boxes, and limited usable space in the chat area. Similar problems occur when the window is resized to a narrow width.
Below introduces the community plugin dsh-mobile-hanui. It automatically adjusts the layout when the viewport width is ≤ 1023px, modifying only the mobile display without affecting the desktop version.
What Is This¶
dsh-mobile-hanui is a DSH client plugin released by maintainer Z-6354, categorized as a client plugin. The project is hosted on GitHub, with the current npm version 0.2.5, using the MIT license.
The plugin injects a mobile UI shell via DSH’s bundle mechanism, adapting the interface for touch-screen operation on narrow screens and fixing compatibility issues between the DSH webpage and mobile devices.
Core Features¶
Based on the positioning described above, the plugin primarily does the following:
- The sidebar and detail panels are converted to left/right drawers that slide out on tap, no longer squeezing the chat area.
- Modals such as permission confirmations and settings are displayed centered and full-screen on mobile.
- A draggable floating menu button is provided; tap or swipe down to open the sidebar.
- Swiping up to the top automatically loads earlier conversation history.
- When switching conversations, the soft keyboard no longer pops up automatically.
- Sub-agent directories, model selection, reasoning levels, and mode selection display correctly on small screens.
All these capabilities are derived from the project’s README, and the plugin does not alter the desktop layout.
Installation and Enabling¶
DSH adopts an “everything is a plugin” extension approach; the community directory SkillHub is an independent site, with no official affiliation to DeepSeek or High-Flyer. Before installation, it is recommended to review the source code and MIT license; the plugin runs with the current dsh process permissions.
- Navigate to the DSH Web profile directory and install the npm package:
cd ~/.dsh/profiles/web
pnpm add dsh-mobile-hanui
-
Edit
~/.dsh/profiles/web/package.jsonand add"dsh-mobile-hanui"to thedsh.profile.bundlesarray. -
Restart the
dsh webservice.
After installation and restarting, simply open the DSH webpage in a mobile browser; no additional configuration is needed.
Typical Usage¶
Daily Use¶
After installation, access the DSH Web address on a mobile phone. The mobile layout will automatically activate on narrow screens. When the desktop browser window width exceeds 1023px, the original layout is maintained.
Temporarily Disabling the Mobile Shell¶
To compare with the original interface, use either of the following methods:
- Add the query parameter
?mobileShell=0to the URL. - Execute in the browser console:
localStorage.setItem('dsh-mobile-shell', '0')
Refresh the page after execution. For the disabling logic, refer to the project’s README.
Use Cases and Notes¶
Who is this for: Developers who frequently use the DSH Web interface on mobile phones or users who need to view DSH in a narrow window.
Notes:
- The activation condition is viewport width ≤ 1023px; there are no changes on wide-screen desktops.
- The plugin integrates with DSH via
cordis.patch.ymland client inject. For detailed deployment, loading mechanisms, development and publishing, and troubleshooting, see the repository’s AGENTS.md. - npm package page: dsh-mobile-hanui
Conclusion¶
dsh-mobile-hanui specifically addresses layout issues with the DSH webpage on mobile devices, featuring a short installation process and no need for additional configuration after enabling. If you primarily use DSH on mobile, you can follow the steps in this article to integrate it.
- Community directory page: https://www.skillhub.cn/plugins/Z-6354/dsh-mobile-hanui
- GitHub repository: https://github.com/Z-6354/dsh-mobile-hanui