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 "" \
  --out /tmp/shot.png \
  [--mobile] [--wait 4000] [--eval ""]

输出 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（复用日常登录态； 强制重同步）