Preface

If you need to run DSH on your computer while also wanting to view sessions, switch models, and control operations from your phone or external network, the common approach is to prepare your own public IP, register for tunnel services, configure certificates, and modify ports.

dsh-web-remote combines these tasks into a single DSH plugin: it provides zero-configuration Cloudflare Quick Tunnel, LAN HTTPS direct connection, customizable public links/ports, and WeChat and Feishu (Lark) bots.

What Is This

dsh-web-remote is a DeepSeek Harness (DSH) plugin maintained by godchen520, licensed under MIT.

Its core purpose is to enable locally running DSH Web to be accessed and controlled from a phone, external network, WeChat, or Feishu.

Core Capabilities

  • Public Network Access: Uses Cloudflare Quick Tunnel, requiring no public IP or registration; automatically downloads cloudflared if missing.
  • LAN Direct Connection: Supports HTTP + HTTPS direct connections; HTTPS automatically generates a self-signed certificate, zero configuration.
  • Secure Authentication: Generates a random token on each startup; uses HttpOnly Cookies; LAN can bypass token requirements.
  • Performance Acceleration: Reverse proxy automatically applies gzip compression, making large historical sessions load faster.
  • Sidebar Icon: A persistent mobile quick-access button in the bottom-left corner that survives page refreshes.
  • Custom Public Links: Supports entering custom public URLs (e.g., ngrok); can be edited or cleared in the panel and takes effect after restart.
  • Custom Ports: Allows modifying the HTTPS port number in LAN mode, with port conflict detection.
  • WeChat Bot: Connects directly to WeChat via the iLink protocol, supporting AI conversations, session control, and model switching.
  • Feishu Bot: Uses a WebSocket long connection for command control and session monitoring notifications.
  • Session Monitoring: Use the /monitor command; automatically notifies via WeChat or Feishu when the agent finishes thinking.

Installation and Enablement

The documentation lists multiple installation and enablement methods, which can be chosen based on your local DSH environment.

Install via DSH Conversation

Send the following message to DSH:

Please help me install the dsh-web-remote remote access plugin (https://github.com/godchen520/dsh-web-remote) and tell me how to restart DSH Web after installation.

Command Line Installation

Run:

dsh plugin --profile web add github:godchen520/dsh-web-remote && dsh web

GitHub Package Installation

First, enter the web profile directory:

cd $DSH_HOME/profiles/web
pnpm add github:godchen520/dsh-web-remote

Then, add "dsh-web-remote" to the dsh.profile.bundles array in package.json, and restart DSH.

Manual Patch

Place the package into the profile’s node_modules directory and append a web-remote entry to cordis.patch.yml.

The bundle method requires a restart; the cordis.patch.yml method is hot-reloaded via HMR.

How to Access After Startup

  1. After startup, look for the mobile icon in the bottom-left corner of the DSH page.
  2. Click the icon to open the remote panel.
  3. On your phone, open the public or LAN link provided in the panel.

Public access uses Cloudflare Quick Tunnel, requiring no public IP or registration. If the local machine lacks cloudflared, it will download approximately 10MB on the first startup (requires internet), then reuse the cached version.

LAN access uses HTTP/HTTPS direct connections; HTTPS automatically generates a self-signed certificate. LAN sources are exempt from token requirements by default.

WeChat and Feishu

WeChat Bot

dsh-web-remote supports direct connection to WeChat via the iLink protocol for AI conversations, session control, and model switching.

The documentation lists the following commands:

/connect
/stop remote
/monitor
/session list
/select N
/switch model
/set strength N

/monitor enables or disables session monitoring; the agent will automatically send notifications to WeChat or Feishu when thinking is complete.

WeChat-bound tokens are automatically persisted and restored.

Feishu Bot

The Feishu bot supports WebSocket long connections for command control and session monitoring notifications.

Binding Steps:

  1. Open the DSH Web panel.
  2. Navigate to the “Bots” tab and select “Feishu.”
  3. Enter the App ID and App Secret.
  4. Click “Bind.”

Notes

  • All configurations are optional; the plugin can be used without configuration.
  • A random token is generated on each startup; remote access relies on HttpOnly Cookies.
  • LAN mode allows private network sources to bypass token requirements.
  • HTTPS uses a self-signed certificate; browsers may warn about security—proceed as prompted. Edge requires disabling “Enhanced Security.”
  • The public tunnel generates a new address on each restart; WeChat-bound tokens are automatically persisted and restored.
  • Custom public links (e.g., ngrok) can be edited or cleared in the panel and take effect after restart.
  • The LAN HTTPS port is modifiable and includes port conflict detection.
  • The plugin runs with the current dsh process permissions; review the source code and license before installation.

Links

  • GitHub: https://github.com/godchen520/dsh-web-remote
  • License: MIT