Skip to main content

How to use dsh-mobile

Bring DeepSeek Harness to mobile browsers and Android apps, securely access your computer's sessions and workspaces via home or office LAN, with support for on-demand mobile interface customization and extending computer capabilities.

This article is auto-derived from indexed fields (wiki / faq / compatibility_json), not freshly AI-generated.

This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.

Quick start

dsh-mobile

— source: plugin_wiki.wiki_content

Install & verify

dsh plugin --profile web add dsh-mobile

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

  • 在手机上继续电脑端的工作:同一份会话、工作区、消息和工具,实时同步。
  • 用对话定制手机端:直接在 DSH 对话里改手机页面的布局、交互和功能,几秒内刷新。
  • 专属触屏布局:会话抽屉、工具详情、设置和输入栏都按手机重新组织。
  • 自动发现、无需重新配对:切换 Wi-Fi、热点或 IP 后通常自动恢复。
  • 三种配对方式:扫码、配对链接、密钥。

— source: plugin_wiki.readme_en (fallback readme_raw)

FAQ

What needs to be done after installation to start using it?

The plugin only handles downloading and patch mounting; first use must execute dsh plugin --profile web exec dsh-mobile setup to generate self-signed HTTPS certificate and automatically select current LAN; then restart DSH, open "Mobile Access" card at bottom left to generate pairing key or QR code.

Can iOS client be used?

Currently only Android App can be downloaded in Release. iOS client is still an unreleased local development experiment, not included in builds, Release or support scope; iPhone users should first use mobile browser (HTTPS requires manually trusting the certificate for first use).

How is pairing completed? What methods are supported?

After generating one-time key or pairing link in computer-side "Mobile Access" card, Android App can scan QR code for pairing (no manual key entry), select computer via LAN discovery and paste key, or directly open pairing link (key automatically filled). First-time pairing establishes persistent device trust, then opening App no longer requires re-entry.

Will it disconnect when switching Wi-Fi/IP changes?

It will not require re-pairing. Setup automatically selects current LAN network card and solidifies interface name to $DSH_HOME/mobile-access/setup.json; plugin monitors network card address changes (DNS-SD/mDNS + periodic UDP announcement), usually auto-recovers after LAN switch, App also uses same stable installation identifier to locate this computer.

Can I customize the mobile interface and functionality in DSH?

You can customize mobile interface and functionality by entering /mobile <request> in DSH dialog (e.g., /mobile make phone look like old terminal), DSH will call dedicated agent to modify mobile.css, mobile.js or extensions/<id>/ directory under $DSH_HOME/mobile-access/, phone automatically applies within seconds. Changes do not modify DeepSeek Harness source code.

Can the mobile end invoke computer capabilities (like reading files)?

Yes. Create extension under $DSH_HOME/mobile-access/extensions/<id>/, host.mjs is computer-side Node.js code (has full local user permissions), mobile.js is phone-side script, invokes former via api.host.invoke() or api.host.fetch(). Can also use command to generate template: dsh plugin --profile web exec dsh-mobile extension create <id> --name "<name>".

Will data be cleared when uninstalling?

Only when executing dsh plugin --profile web remove dsh-mobile plugin process exits, but certificate, device, pairing info, custom files, extensions remain in $DSH_HOME/mobile-access/. To completely clean, need to first execute dsh plugin --profile web exec dsh-mobile purge --yes, then remove. On Windows, purge also attempts to remove two firewall rules it added.

What to do if DSH upgrade causes startup failure or compatibility errors?

Plugin checks DSH Host version on startup, only allows 0.1.0-rc.5/rc.6/rc.7; unverified versions directly report error instead of starting with issues. If error after upgrading DSH, first upgrade dsh-mobile to current supported alpha version (maintain strategy of plugin being newer than DSH).

Can this solution be exposed to the public internet?

Cannot. Paired device has full operation capabilities of computer-side DSH, equivalent to fully trusted computer user; must only use in trusted home/office LAN or trusted VPN, do not directly forward port 3443 to public network.

— source: plugin_wiki.faq_json

Compatibility

  • DSH: 0.1.0-rc.5 / 0.1.0-rc.6 / 0.1.0-rc.7(src/compatibility.ts:2-6 白名单;强制校验,未通过直接报错)
  • Node: ^22.19.0 || >=24.0.0(package.json:65-67 engines)

— source: plugin_wiki.compatibility_json

Pitfalls

Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.

— source: general rule