Preface

The DSH plugin ecosystem emphasizes “everything is a plugin.” dsh-pilot is a plugin designed for the DeepSeek Harness Web GUI, enabling DSH agents to drive the local Edge or Chrome browser via CDP within chat interactions.

It is tailored for browser operation tasks: opening pages, reading structured text, clicking and inputting via snapshot ref, filling forms, uploading files, and observing screenshots, URLs, status, and operation logs in the Web GUI through the cockpit panel. The plugin operates with zero runtime dependencies, requires no API key, and can be installed with a single command.

Positioning

Project Information

  • Repository: guo6x/dsh-pilot
  • Type: DeepSeek Harness plugin, installed to the web profile
  • License: MIT
  • Browser: Uses local Edge or Chrome via CDP
  • Dependencies: Zero runtime dependencies, no API key required

Runtime Requirements

  • Node >= 22
  • Edge or Chrome installed locally
  • After installation, the dsh web process must be restarted, then the page refreshed

Core Capabilities

Page Reading

The plugin can open pages from chat and read structured text, including title, URL, text, links, and a numbered list of elements.

Element Operations

Clicks and inputs are performed based on snapshot ref, not by guessing CSS selectors. Form filling can parse human-visible fields by label, aria-label, placeholder, name, or id. File uploads can specify a snapshot ref to locate the file input element.

Supports tools such as back, reload, wait, JS evaluation, screenshot, and download.

  • pilot_wait accepts a wait time of 1–30000 ms.
  • pilot_upload accepts 1–10 absolute path files.
  • Total upload file size limit is 100 MB.
  • Download limit is 20 MB.

Visualization and Session Isolation

The Web GUI provides a draggable cockpit panel displaying screenshots, URLs, status, and operation logs.

By default, the panel follows the most recently used session; when multiple sessions exist, it can also be pinned to another session. Each agent session uses an isolated browser instance, allowing parallel sessions without interference.

Installation and Enabling

First install the plugin, then restart the host process, and finally verify the installation result.

  1. Install from GitHub:
dsh plugin --profile web add github:guo6x/dsh-pilot

  1. Restart the running dsh web process, then refresh the page. Simply refreshing the browser page will not load the new host code.

  2. Check in the web profile:

dsh plugin --profile web list dsh-pilot
  1. If you are using a local checkout, you can also run this in the repository directory:
dsh plugin --profile web add .

Installing from GitHub uses the committed lib/ files and does not run build scripts.

Typical Usage

Read-Only Inspection

In a new chat, provide a task like this:

Open https://example.com, tell me what the page says, then verify that the Learn more link is visible.

This task only reads a public page; upon completion, you can verify the page title, text, and link information, and the cockpit will also display the screenshot, URL, status, and operation logs.

Form Filling

For a staging form, you can provide a bounded task:

Open our staging application form, fill the contact fields, upload the approved resume, verify the entered values, and stop before final submission.

Filling can parse human-visible field names, uploading locates the file input via snapshot ref, and stops before final submission.

Limitations and Notes

  • One tab per session; refs are fixed to the current page.
  • Only headless mode is supported; no headed mode is provided.
  • After installation, the dsh web process must be restarted; simply refreshing the page will not load the new host code.
  • The plugin runs with the permissions of the current dsh process; check the source code and MIT license before installation.
  • No additional accounts or API keys are required; documentation states that data does not leave the local machine.
  • Upload and download have size limits: total upload size limit is 100 MB, download limit is 20 MB.

Links

  • GitHub: https://github.com/guo6x/dsh-pilot
  • Community Directory Page: This article has verified facts but does not provide specific URLs, so none are listed.