Back to directory

dsh-browser

Curated pickMaintenance: Active

lum1104/dsh-browser

让 DSH 读取/点击/填表/滚动/导航当前 Chrome 标签页(文本优先,保留登录态)

View on GitHub
$ curl -fsSL https://raw.githubusercontent.com/Lum1104/dsh-browser/refs/heads/main/scripts/install.sh | bash

599

stars

38

forks

TypeScript

Language

MIT

License

2026-08-06

Created

2026-09-08

Last push

MIT-licensed dsh bridge plugin + Chrome MV3 extension that lets DeepSeek Harness read, click, type and navigate your real Chrome tab — installed into dsh with a one-line script, text-only and vision-free.

DSH integration

Compatible

Author-claimed

Safety audit

Unaudited

Last verified

2026-08-21

License

MIT

01What can it help you accomplish?

  • Operate your real Chrome tab from DeepSeek Harness — read pages, click controls, fill forms, scroll and navigate for ai web search and browser tasks

    Browser actions executed in the tab you already use, with login state, session and cookies preserved; conversation UI in the Chrome side panel

    DSH users who want AI web browsing and automation on their own logged-in browser instead of a headless copy

  • Run text-first browser automation in dsh without any vision capability

    Pages converted to structured text with a numbered inventory of interactive elements; the model addresses elements by number — screenshots never enter the pipeline

    Developers building browser workflows on DeepSeek Harness who want fast, token-efficient automation without vision models

02How to install into DeepSeek Harness

Prerequisites

  • Node.js `^22.19` or `>=24`
  • Corepack/pnpm
  • Google Chrome

Installation steps

  1. 01

    Run the one-line installer: `curl -fsSL https://raw.githubusercontent.com/Lum1104/dsh-browser/refs/heads/main/scripts/install.sh | bash` — it downloads main, builds and registers the bridge plugin, and builds the Chrome extension into ~/.dsh/browser-extension

    $ curl -fsSL https://raw.githubusercontent.com/Lum1104/dsh-browser/refs/heads/main/scripts/install.sh | bash

  2. 02

    When the installer opens chrome://extensions, load ~/.dsh/browser-extension as an unpacked extension (first install) or click Reload (updates); restart dsh if it is already running

  3. 03

    Start the managed installation with `cd ~/.dsh/dsh-browser && pnpm start` (or `npx @deepseek-ai/dsh web` to use the latest public dsh release)

    $ npx @deepseek-ai/dsh web

  4. 04

    Open an http:// or https:// page, click the DeepSeek whale icon, and wait for Connected

Verify the integration

  • The side panel shows Connected after clicking the DeepSeek whale icon on an http:// or https:// page
  • Open http://127.0.0.1:3080/ext/bridge-config — it should return JSON such as {"wsUrl":"ws://127.0.0.1:3080/ext/bridge"}; if it returns a web page instead, restart dsh and refresh

03DSH integration and capability boundaries

DSH integrationCompatible

dsh bridge plugin + Chrome MV3 extension installed into DeepSeek Harness via a one-line installer; exposes browser tools (snapshot/click/type/scroll/navigate) inside dsh

  • Text-first page reading

    any http:// or https:// page in the controlled Chrome tabstructured text snapshot — title, URL, main text, numbered controls, and masked form fields; `delta: true` returns only changes

    read page text is sent to the selected model
  • Interactive control by element number

    numbered inventory from browser_snapshotclicks on links/buttons/checkboxes, React/Vue-compatible typing, keyboard events (Enter, Tab, Escape, arrows), and viewport scrolling

    acts on your real browser tab; click, type, keypress, navigation, history, and reload calls fail closed until the user approves them
  • Login-preserving navigation

    URLs, back/forward history, or reload commands in the controlled tabnavigation inside the tab you already use, retaining logins, sessions and cookies

  • Guarded local bridge

    local dsh web server (default http://127.0.0.1:3080)authenticated bridge connection; the extension binds tools to one user-controlled tab and probes ports 3080, 3081, 3090 automatically

    privileged gateway methods such as settings.*, credentials.*, and host.open* reject non-loopback sources

04Who is it for? When not to use it?

Good for

  • DSH users who want AI web browsing and automation on their own logged-in browser instead of a headless copy
  • Developers building browser workflows on DeepSeek Harness who want fast, token-efficient automation without vision models

Not for

  • Chrome-only: works on http:// and https:// pages; protected pages such as chrome:// and the Chrome Web Store are not supported.
  • Requires Node.js ^22.19 or >=24, Corepack/pnpm and Google Chrome; not published on npm — the unscoped dsh-browser package on npm belongs to a different project, so use the repository installer.

05Compatibility, maintenance and safety notes

  • Chrome-only: works on http:// and https:// pages; protected pages such as chrome:// and the Chrome Web Store are not supported.
  • Requires Node.js ^22.19 or >=24, Corepack/pnpm and Google Chrome; not published on npm — the unscoped dsh-browser package on npm belongs to a different project, so use the repository installer.
  • Read page text is sent to the selected model; the default auto mode reads the controlled tab without an extra prompt (ask for per-read confirmation or off to block reads). Passwords and payment-card values are masked and never leave the page.
2026-08-062026-08-19Not specified by the author

MIT · actively maintained (last push 2026-08-19)

06Frequently asked questions

How does dsh-browser integrate with DeepSeek Harness?

It ships a dsh bridge plugin plus a Chrome MV3 extension in one pnpm workspace. The one-line installer downloads main, builds and registers the bridge plugin into dsh, and builds the extension into ~/.dsh/browser-extension; you then load it in chrome://extensions and restart dsh if it is running.

Is it an MCP server or a native dsh plugin?

It is a dsh plugin (browser bridge) that registers with the running dsh web server — default http://127.0.0.1:3080 — and exposes browser tools such as browser_snapshot, browser_click, browser_type and browser_navigate, not an MCP server.

What do I need before installing?

Node.js ^22.19 or >=24, Corepack/pnpm, and Google Chrome. Local use requires no configuration; the extension probes ports 3080, 3081 and 3090 automatically. For remote or custom-port deployments, set the address and bridge token in the side panel settings.

Where does my page data go?

The model-facing pipeline is text-only — pages become structured text with numbered controls, and screenshots never enter the pipeline. Read page text is sent to the selected model, while passwords and payment-card values are always masked and never leave the page.

What are the limitations?

Only http:// and https:// pages work — protected pages such as chrome:// and the Chrome Web Store are not supported. Click, type, keypress and navigation calls fail closed until you approve them, and the assistant binds to one user-controlled tab.

08Data and sources

  • Author-claimedgithub.com71a1cac63f33…

    `dsh` is DeepSeek AI's open-source, plugin-based agent harness. This repository provides a companion browser bridge plug…

  • Author-claimedgithub.com71a1cac63f33…

    The installer downloads `main`, builds and registers the bridge plugin, builds the Chrome extension into `~/.dsh/browser…

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-21. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.