Plugin directory / Developer / dsh-browser-control
dsh-browser-control
Verified · install-tested on dsh PangYiMing
What it does
DSH plugin for controlling browsers (CDP/Playwright) — DeepSeek Harness browser control plugin
Works — verified, early-stage project
DSH plugin for controlling browsers (CDP/Playwright) — DeepSeek Harness browser control plugin It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
dsh-browser-control
DeepSeek Harness 插件 · 操控浏览器 / DSH plugin for controlling browsers
通过 CDP（Chrome DevTools Protocol） 驱动浏览器：复用日常 Chrome 登录态、导航、抓 console / pageError / networkError、截图、执行任意 JS。
核心资产：
scripts/launch.sh— 登录态复用的 CDP 启动器（起:9222调试实例）scripts/drive.mjs— CDP 驱动：导航 / 截图 / console / eval / mobile 仿真
Drives browsers over CDP (Chrome DevTools Protocol): reuse your everyday Chrome login state, navigate, capture console / pageError / networkError, screenshot, and eval JS.
快速开始 Quick start
./scripts/launch.sh # 起 :9222 调试实例（复用日常 Chrome 登录态；已在跑则复用）
node scripts/drive.mjs "<url>" \
--out /tmp/shot.png \
[--mobile] [--wait 4000] [--eval "<expr>"]
输出 JSON：title / url（注意 SPA 跳转后的最终地址）/ bodyPreview / console / pageErrors / networkErrors / screenshot 路径。
为什么绕这一圈（登录态复用原理）
新版 Chrome 禁止在默认 user-data-dir 上开 --remote-debugging-port。launch.sh 的做法：把日常 Chrome 的登录态文件（Cookies / Login Data / Local Storage / IndexedDB 等）只读拷贝到隔离目录 /tmp/chrome-e2e-profile，再用隔离目录起调试实例。单向不回写、懒同步（仅首次或 --refresh）、端口探测复用、精确 pkill——详见 docs/cdp-login-reuse.md。
能力与避坑
- canvas / 可视化库（G6 / echarts / D3 / WebGL）截图：后台 tab 的 raf 会被节流导致截图空白，修法是新建 tab +
Page.bringToFront+ 踢 raf，且别用getImageData判渲染——见 docs/cdp-canvas-pitfalls.md --mobile：390x844 视口 + iPhone UA 仿真--eval：在页面执行任意 JS（验证 DOM 状态 / 读 window 全局 / 调库 API）
DSH 工具 Tools
安装插件后，以下 browser_* 工具自动注册进 agent 的工具集：
| 工具 | 说明 |
|---|---|
browser_status |
探测 CDP 实例是否在跑（默认 9222） |
browser_launch |
幂等启动 CDP 调试 Chrome（复用日常登录态；refresh 强制重同步） |
browser_kill |
关闭 CDP 调试实例 |
browser_open |
导航到 URL 并返回 title / 最终 URL / 文本预览 / console / pageError / networkError / 截图 |
browser_screenshot |
导航并截图，返回截图路径 |
browser_eval |
导航后在页面执行 JS 表达式并返回结果 |
# 安装后直接在 agent 会话里用自然语言触发：
# "browser_launch 起 Chrome，然后 browser_open 打开 https://example.com 截图给我看"
dsh plugin --profile demo add dsh-browser-control
路线图 Roadmap
- 登录态复用启动器（
scripts/launch.sh，含--refresh/--kill/--status） - CDP 驱动（
scripts/drive.mjs：导航 / 截图 / console / eval / mobile） - 封装为 DSH 工具（6 个
browser_*tools） - 点击 / 填表 / 表单交互
- Playwright 后端
- 多标签 / 多窗口管理
安装 Install
# 发布到 npm 后
dsh plugin --profile demo add dsh-browser-control
# 或从 GitHub 安装（源码安装需要 prepare 构建）
dsh plugin --profile demo add github:PangYiMing/dsh-browser-control
许可证 License
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-browser-control for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
Web profile:
dsh plugin --profile web add dsh-browser-controlHeadless (CLI) profile:
dsh plugin --profile headless add dsh-browser-controlPackage
npm: dsh-browser-control · version 0.1.0 · tested on dsh 0.1.0-rc.6
Test report
Verified end-to-end: L1 install + L2 load + L3 runtime Q&A on dsh 0.1.0-rc.6.
When to use it
Extend the agent's coding surface — give it a new tool, workflow, or integration so it handles a dev task it couldn't before.
Who it's for
Developers who want dsh to behave like a teammate on real codebases — editing, running, and verifying changes rather than just answering.
For developers — extending it
The tool/command surface is the seam: expose more of the SDK, add smarter context wiring, or tighten the loop between code changes and verification.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-browser-control/)<a href="https://dshbase.com/plugins/dsh-browser-control/"><img src="https://dshbase.com/badges/dsh-browser-control.svg" alt="dshbase install-tested"></a>