Mobile UI adaptation plugin for DeepSeek Harness - overlay drawer navigation, glassmorphism design, safe-area coverage, PWA support.
Install
# from npm (prebuilt)
dsh plugin --profile web add dsh-mobile-xc
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:xchannel1987/dsh-mobile-xc
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
The ultimate mobile UI adaptation plugin for DeepSeek Harness — integrating the best designs from multiple mobile plugins to deliver a native mobile experience.
DSH 0.1.7 compatible (
>=0.1.7-rc.1): settings now live on the new Plugins page under thedsh-mobile-xcpackage (plugins.bundle.config, same mechanism as modsearch / official subagent); the old Settings → Plugins entry was removed in the 0.1.7 settings rework.
✨ Core Features
📱 Mobile Drawer Navigation
- Overlay Drawer: Sidebar slides out as an overlay without affecting the main content area
- Scrim Backdrop: Tap the scrim to close the drawer, following mobile interaction patterns
- Gesture Support: Swipe to open/close drawer (configurable)
- Escape Key Close: Keyboard-friendly
- Swipeable Session Header: the header keeps a single row on narrow screens; the title and PTC/usage badges overflow into a horizontal swipe, with a right-edge fade that clears at the end
🎨 Glass Card Design
- Glassmorphism Style: Modern frosted glass visual effect
- Single-line Input: Compact input area layout for mobile
- FLIP Animations: Smooth state transition animations
- 44px Touch Targets: Meets mobile touch interaction standards
📐 Safe Area Coverage
- Notch Adaptation: Properly handles safe areas on iPhone X and similar devices
- Home Indicator: Prevents content from being obscured by gesture bar
- Dynamic Viewport: Supports
dvhunit, auto-adjusts when keyboard appears
🔄 Smart Compatibility System
- Version Mismatch Detection: Automatically checks DSH version compatibility
- Soft Warning: Compatibility issues don't block usage, only notify
- Fallback Degradation: Auto-degrades in extreme cases to ensure usability
- Third-party Plugin Compatibility: Adapted for dshmarket, dsh-better-sidebar, etc.
📲 PWA Support
- Official Whale Icon: Uses DSH official favicon
- Offline Ready: Service Worker precaches critical resources
- Installable: Supports "Add to Home Screen"
🎯 Breakpoint Design
| Breakpoint | Behavior |
|---|---|
| ≤1023px | Mobile adaptation activated |
| ≥1024px | Desktop mode, zero impact |
Aligned with DSH built-in SIDEBAR_AUTO_COLLAPSE=1024 for seamless switching.
📦 Installation
# Using DSH CLI
dsh plugin --profile web add dsh-mobile-xc
# Or using npm
npm install dsh-mobile-xc
Restart DSH after installation.
⚙️ Configuration
Configure via DSH Settings → "Mobile UI" section:
| Option | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | true | Enable/disable mobile adaptation |
| gestureMode | 'swipe' | 'follow' | 'off' |
| compatFixes | boolean | true | Third-party plugin compatibility fixes |
🔗 Compatibility Matrix
| Package | Verified Version | Status |
|---|---|---|
| DSH (vendor) | 0.1.1-rc.2 | ✅ 18 selector mappings |
| dshmarket | 1.20.x | ✅ Nav dead-end fix |
| dsh-better-sidebar | 0.15.2 | ✅ Peaceful coexistence |
| dsh-token-usage | 0.2.16 | ✅ Compatibility registered |
🛠️ Development
pnpm install
pnpm verify # Type check + lib drift check
pnpm test # Unit tests
pnpm build # Build artifacts
📄 License
🔗 Links
Links
More in this category
zhu1090093659/dsh-web#packages/dsh-remote-web-ui★ 8801
Remote control of a dsh web workspace from phone or PC: QR-code pairing through a token-gated channel, SSE real-time sync, and separate mobile and full desktop GUI modes.
zhu1090093659/dsh-web#packages/dsh-ssh★ 8801
SSH ops panel for DSH: web terminal, SFTP transfer with progress, local port forwarding, and one-command cluster execution across hosts; agents share the same host config.
saya-ch/dsh-mobile★ 469
Access DeepSeek Harness from the Android app or a mobile browser with secure LAN and remote connections, persistent device pairing, and a customizable mobile interface.
liguobao/ds-harness-remote★ 336
Multi-device remote access for DeepSeek Harness: continue an active session from your phone, tablet, browser, or another computer over an end-to-end encrypted channel (Noise IK + adaptive relay/WebRTC transport), with device authorization, ApiProxy-only remote capabilities, and read-only file preview via dsh-file-viewer — no shell, remote desktop, or write access.
ZSeven-W/dsh-ios★ 326
A live iOS Simulator or USB-connected iPhone inside the conversation: 22 agent tools for booting, building, driving the UI by accessibility identity or OCR text, list-row actions and SwiftUI preview hot reload, plus a streaming sidebar panel you can tap and drag on.
wenbin-wb/dsh-bridge★ 199
Remote and mobile access for DeepSeek Harness: provides LAN QR code connection, Cloudflare/custom tunnels, WeChat, QQ, Feishu, Telegram bot integration, and security authentication.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.