Skip to content
dsh-market Browse plugins GitHub 中文

Blank-not-black/dsh-Remote#plugin

Mobile remote-control suite: bundle plugin with native sidebar entry and admin drawer, self-healing bearer-token gateway over LAN/Tailscale, Android app (sessions/approvals/questions/goals), /fs/* file transfer (Range resume, 2GB upload), latency-based multi-server auto-switch, offline chat cache.

Stars ★ 10 Category Remote & Mobile Listed 2026-08-15 npm dsh-remote-plugin

Install

Inside DeepSeek Harness, with dsh-market

dsh plugin --profile web add dshmarket

Or from the command line

dsh plugin --profile web add dsh-remote-plugin

Installing runs third-party code with your own permissions — it can read your files, use your credentials and reach the network. Review the source first, and pin a commit (github:owner/repo#sha) when you can.

Screenshots

README

English · 中文

The DSH bundle plugin for DSH Remote: registers a native entry in DSH's left sidebar and opens an admin drawer from the right. The plugin bundles the gateway and auto-starts/stops it with DSH (standalone systemd unit); the drawer shows the token, host IP and device monitor. Works with the dsh-Remote Android app for remote control and file transfer (/fs/list, /fs/file, /fs/upload). The panel ships four themes (Deep Space / Sunset / Elbphilharmonie / Prairie Tower) — light / dark / neutral, following the system preference automatically.

Install

dsh plugin --profile web add dsh-remote-plugin
# or pin a version
dsh plugin --profile web add dsh-remote-plugin@0.5.0

Restart DSH Web and hard-refresh (Ctrl+F5); the app icon entry appears at the bottom of the left sidebar.

git source install (equivalent):

dsh plugin --profile web add "github:Blank-not-black/dsh-Remote#main&path:/packages/plugin"

Gateway

  • Auto-start by default: on DSH startup or drawer refresh, the plugin launches the built-in gateway.cjs (0.0.0.0:8787), independent of the DSH process; Linux uses a standalone systemd unit, and environments without systemd (e.g. macOS) automatically fall back to a resident child process.
  • On/off intent persists in ~/.dsh-remote/gateway.enabled; it can be stopped/started from the drawer.
  • Token lives in ~/.dsh-remote/token (auto-generated on first run, reused and never overwritten), shown in the drawer and copyable; supports QR pairing and one-click rotation.
  • Env var DSH_REMOTE_AUTOSTART=0 disables auto management.
  • File endpoints: /fs/list (list directory), /fs/file (download with Range support), /fs/upload (chunked resume with pause/cancel, SHA-256 verified before writing to disk); default root is ~, and DSH_REMOTE_FS_ROOT opens multiple roots (:-separated).
  • Feedback endpoint: POST /feedback (the app / desktop "Write feedback" dialog), forwarded by the gateway to the feedback collector; default http://100.84.128.29/submit (Tailscale internal network), overridable via DSH_REMOTE_FEEDBACK_URL — no tokens to configure.

Mobile App

The app is embedded in the plugin package (apk/dsh-remote.apk) — install the plugin and you have it, no GitHub needed:

  • Tap QR code in the desktop drawer → scan it with the phone to open the admin page → download the app from that page
  • Or open http://<gateway-IP>:8787 in a browser to download
  • App updates are pushed by the gateway too (update.json relative path), never touching GitHub
  • A desktop browser opening http://<gateway-IP>:8787 auto-enters the desktop WebUI (sidebar sessions + files + settings + stats + approval notification stack)

The app has built-in multi-server latency switching and offline chat history caching; downloaded files are stored in the system Download/dsh-remote folder.

License

MIT

Content from the project README on GitHub ↗