A native DeepSeek Harness plugin that turns the harness into a shared real-browser operator: install with `dsh plugin add`, get 33 browser_* tools, human-in-the-loop takeover, task-level session isolation, and self-hosted Electron with no extra setup.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-09-03
License
MIT
01What can it help you accomplish?
Let an agent operate a real, visible browser inside DeepSeek Harness
A shared browser the human can see and take over at any time, driven through 33 `browser_*` tools (open, snapshot, click, fill, scrape, screenshot, download, auth)
Developers and agents running DeepSeek Harness (dsh) who need a real browser the user can watch and intervene in
Automate web tasks that need a real DOM and login state
Structured data extraction, form filling, logged-in downloads and persisted auth — isolated per DSH task session
Automation builders who script browser flows against authenticated sites inside DeepSeek Harness
02How to install into DeepSeek Harness
Prerequisites
- DeepSeek Harness (dsh) installed with the matching profile (`web` / `desktop` etc.)
- Electron runtime (required dependency, auto-installed with the plugin; >= 40 recommended; 44+ downloads its binary on first use, needs network)
- Verified only on Windows so far — macOS/Linux are unverified and not yet promised
Installation steps
- 01
Install from npm (published): `dsh plugin --profile web add dsh-builtin-browser`
$ dsh plugin --profile web add dsh-builtin-browser
- 02
Or install from a source checkout (one plugin per repo): `dsh plugin --profile web add <repo-path>`
$ dsh plugin --profile web add <repo-path>
Verify the integration
Not specified by the author
03DSH integration and capability boundaries
Native dsh plugin registered via `dsh plugin add`; exposes 33 `browser_*` tools through the ctx.browser seam, provider and tool layers of DeepSeek Harness
Shared real browser (visible, takeover-ready)
agent `browser_*` tool calls→a real WebContentsView the human sees and can take over; same page for human and agent
In self-hosted mode the plugin launches its own Electron child process and drives it over local TCP JSON-RPC (random token auth)33 `browser_*` tools (DOM-driven, framework-friendly)
page URLs / selectors / semantic targets→open, snapshot, a11y tree, click, type, fill, scrape, screenshot, download, auth and more
Task-level session isolation
each DSH task (session)→independent browser session (own tabs and history) per task; concurrent tasks do not collide
Auth persistence & logged-in download
`browser_auth` export/restore, `browser_download` with session cookie→persisted login state across restarts; files fetched with session cookies
Self-hosted cookies are stored on disk in plaintext (Electron default); `browser_download` writes files straight to disk (default ~/Downloads, overridable via downloadDir)
04Who is it for? When not to use it?
Good for
- Developers and agents running DeepSeek Harness (dsh) who need a real browser the user can watch and intervene in
- Automation builders who script browser flows against authenticated sites inside DeepSeek Harness
Not for
- 本插件当前仅在 Windows 环境实测,macOS/Linux 未验证、暂不承诺;需自备 Electron 运行时(随插件自动安装,建议 ≥ 40)。
- `browser_restrict` 白名单只是防误操作的软护栏,模型可自行解除,并非安全边界;敏感操作仍需人工确认。
- 自托管模式下 cookie 以明文落盘(Electron 默认行为),需要加密落盘的部署应在宿主层接入系统钥匙串 / DPAPI。
05Compatibility, maintenance and safety notes
- 本插件当前仅在 Windows 环境实测,macOS/Linux 未验证、暂不承诺;需自备 Electron 运行时(随插件自动安装,建议 ≥ 40)。
- `browser_restrict` 白名单只是防误操作的软护栏,模型可自行解除,并非安全边界;敏感操作仍需人工确认。
- 自托管模式下 cookie 以明文落盘(Electron 默认行为),需要加密落盘的部署应在宿主层接入系统钥匙串 / DPAPI。
MIT · GitHub stars 44 · latest release v0.1.0 (2026-08-14)
06Frequently asked questions
How do I install dsh-browser into DeepSeek Harness?
Run `dsh plugin --profile web add dsh-builtin-browser` to install from npm (already published), or `dsh plugin --profile web add <repo-path>` to install from a source checkout. It registers as a native dsh plugin and the agent gains the 33 `browser_*` tools automatically after install.
Do I need the DeepSeek Harness desktop shell?
No. With a desktop shell the browser view is embedded in it; under plain `dsh web` the plugin self-hosts by launching its own Electron window, so the `browser_*` tools work with zero extra configuration.
Which platforms are supported?
The plugin is verified only on Windows (10.0.26200) so far — macOS and Linux are unverified and not yet promised. It requires an Electron runtime (auto-installed with the plugin, >= 40 recommended; 44+ downloads its binary on first use, needs network).
What can the agent actually do with the browser?
33 tools: open/snapshot pages, read the a11y tree, click/type/fill forms (semantic `target` or coordinates), scroll, navigate back/forward, extract structured data (`browser_scrape`), screenshot, download with session cookies, manage auth (`browser_auth`), and detect CAPTCHA challenges for human takeover.
Can it solve CAPTCHAs automatically?
No. It detects Cloudflare / reCAPTCHA / hCaptcha / Turnstile challenges and flags them in the snapshot; you complete them in the shared window instead of letting the agent retry blindly. `browser_restrict` is only a soft guardrail the model can lift itself — not a security boundary.
07Related DSH workflows
dsh-better-sidebar
by omdsh-dev
Full sidebar workbench with file rendering and editing, terminal, Git, and subagents; third-party plugins can register new tabs.
dsh-tui
by ccch1mneyyy
Claude Code 风格全屏终端 TUI：像素鲸鱼顶栏、双流光大字、实时工作状态行、思考流式展开、双击 Esc 时间回溯、上下文进度条 + TPS 仪表；接入 Agent preset（standard/code/minimal/cordis）、Skills、MCP、Goals、Todos、子代理，/ 命令注册表与随附技能（audit/bug/review/practice/pr_comments/release-notes/vuln-check）；纯插件挂载零核心改动。
openpets
by alvinunreal
Local first, desktop companion platform with animated pets, plugin SDK and coding-agent integrations.
dsh-tianshu-tui
by huiliyi37
DeepSeek Harness 交互式终端 UI 插件：会话工作区、图片端到端（剪贴板/视觉桥）、slash 下拉、审批卡片、推理可视化，纯展示层
08Data and sources
dsh plugin --profile web add dsh-builtin-browser
纯 `dsh web` 也能**自托管**——插件自己拉起一个 Electron 窗口,不需要任何额外配置;
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-09-03. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.