The DeepSeek Harness (DSH) ecosystem is built around the core philosophy that “everything is a plugin.” When developing agents that need to access a real browser environment, preserving login sessions and performing page actions are common requirements. The following is the dsh-kimi-webbridge plugin maintained by Bernardxu123, which extends the capabilities of DSH agents to users’ real browsers through a locally running Kimi WebBridge daemon.

Core Features

This plugin provides 16 tools for DSH through the local Kimi WebBridge daemon, covering capabilities such as browser navigation, interaction, screenshots, script execution, and network monitoring.

  1. kimi_webbridge_navigate: Opens a URL and sets the tab group name on first use.
  2. kimi_webbridge_find_tab: Re-selects the task tab by URL; supports active:true to borrow the current tab.
  3. kimi_webbridge_list_tabs: Lists all tabs in the current session.
  4. kimi_webbridge_snapshot: Reads the page accessibility tree (including @e element references).
  5. kimi_webbridge_click: Clicks an element (supports @e references or CSS selectors).
  6. kimi_webbridge_fill: Enters content into input boxes, textareas, or rich text editors.
  7. kimi_webbridge_evaluate: Executes JavaScript in the page (async supported).
  8. kimi_webbridge_cdp: Passes through Chrome DevTools Protocol (advanced usage).
  9. kimi_webbridge_screenshot: Takes a screenshot of a tab or a single element and returns the file path.
  10. kimi_webbridge_network: Captures or inspects network requests for a tab.
  11. kimi_webbridge_upload: Uploads a file to <input type=file">.
  12. kimi_webbridge_save_as_pdf: Renders the current page to PDF and returns the file path.
  13. kimi_webbridge_close_tab: Closes the current tab.
  14. kimi_webbridge_close_session: Closes the entire tab group (execute only when needed).
  15. kimi_webbridge_status: Checks the health status of the daemon or extension.
  16. kimi_webbridge_start_daemon: Automatically starts the daemon when it is unavailable.

Installation and Activation

First, install the DeepSeek Harness (DSH) environment and ensure the Kimi WebBridge daemon (version v1.11.6) is installed.

  1. Run the following command in the terminal to install the plugin:
dsh plugin --profile demo add github:Bernardxu123/dsh-kimi-webbridge
  1. After installation is complete, start DSH Web interactive mode:
dsh --profile demo web

Typical Usage

After installation and startup, the agent can use the tools described above. For example, you can ask the agent to open a web page, read its content, and take a screenshot.

  1. Ask the agent: “Open example.com, tell me what is on the page, and take a screenshot.”
  2. The agent will perform the following actions:
    - Open a tab group (named using the language you specify).
    - Read the page content via snapshot.
    - Save the image via screenshot and display it to the user.

Use Cases and Notes

This plugin requires DSH to run on version 0.1.0-rc.7 and depends on Node.js 18+.

  • Known issue: In dsh 0.1.0-rc.7, if a rare transient pnpm failure occurs, the plugin entry may remain in dsh.profile.bundles, causing the profile to fail to start with the error cannot resolve profile bundle "dsh-kimi-webbridge". To recover, edit the profile’s package.json, remove the dsh-kimi-webbridge entry from dsh.profile.bundles, and then restart.
  • File structure: During installation, only runtime files are copied (index.js, cordis.patch.yml, READMEs, LICENSE); docs/ and tests/ in the repository are not installed.
  • Operating system support: The plugin has been tested on Windows; macOS/Linux code paths are supported but have not been fully verified.

Summary

With this plugin, DeepSeek Harness agents can safely control users’ real browsers. All operations are performed through the local daemon, so data does not pass through third-party services, enabling reuse of real sessions.