前言¶
在 DeepSeek Harness (DSH) 的生态中，Agent 要处理复杂的网页交互（如登录态保持、验证码、动态渲染），仅靠命令行工具往往力不从心。通用浏览器是为人类设计的，Agent 难以精确控制。dsh-browser-cdp（原名 dsh-ego-browser）通过 Chrome DevTools Protocol (CDP) 接入真实 Chrome，为 Agent 提供了 38 个结构化工具，并配以实时观察窗，解决了 Agent 在浏览器中“看不见、插不上手”的问题。
核心能力¶
本插件提供以下核心功能：
- 38 个结构化工具：以
bcdp_*命名的一组工具，覆盖页面操作、截图、下载等具体行为，职责单一，确定性高。 - 实时观察窗：通过 SSE 实时视频流回传页面画面，支持鼠标在观察窗中直接操作真实浏览器、下载捕获。若安装了
dsh-better-sidebar，观察窗会以侧边栏 Tab 形式展示。 - 登录态导入：支持将 Chrome/Edge/Brave 的登录 Cookie 按域名复制进 Agent 浏览器，兼容 Chrome 127+ 的 App-Bound Encryption。
- Self-observation：Agent 操作 DSH 自身界面（如管理会话）时，同样通过观察窗可见，开发者可随时接手。
- 平台自适应：支持 Linux、macOS、Windows 自动探测，内置
--no-sandboxwrapper，适配 root/Docker/无显示器环境。 - 运维型工具：提供
bcdp_doctor（环境体检）、bcdp_captcha（人机验证探测）、bcdp_http（浏览器上下文请求）等辅助工具。
安装与前置要求¶
在使用前，请确保环境满足以下要求：
- Node.js：版本 >= 22
- DSH：版本 >= 0.2.0-rc.1
- 可选依赖：
dsh-better-sidebar>= 0.12.2（用于侧边栏支持）
安装插件：
dsh plugin --profile web add github:drscrewdriver/dsh-browser-cdp
插件包内置了预构建的运行时，无需额外的构建脚本。
典型用法¶
该插件适用于以下场景：
- 文献与数据抓取：让 Agent 登录知网或谷歌学术，通过翻页收集数据，开发者可实时观察抓取进度。
- 表单与登录：Agent 填表过程中遇到验证码，开发者可在观察窗中手动接管并完成验证，随后交还给 Agent。
- QA/冒烟测试：模拟用户操作产品，观察窗充当录屏与交互终端。
- Self-observation：观察 Agent 如何操作 DSH 的界面本身，便于调试交互逻辑。
注意事项¶
- Headless 模式：即使不启动观察窗，Headless 会话下的
bcdp_*工具依然可用，只是无法看到画面。 - 兼容性：Cookie 导入功能兼容 Chrome 127+ 的 App-Bound Encryption，无需离线解密。
- 权限：插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。
总结¶
dsh-browser-cdp 将一个“黑盒”的浏览器变成了“白盒”的观察与控制终端，让 Agent 在浏览器中的操作全程可见、可控。对于需要处理复杂网页交互的开发者而言，它提供了必要的抓手。
