前言¶
DeepSeek Harness (DSH) Agent 在处理网页问题时，通常只能依赖截图或自然语言描述，难以深入排查 DOM 结构、网络请求或脚本逻辑。BrowserScope 将完整的 Chromium DevTools 工作台嵌入 DSH，赋予 Agent 30 个专用工具。Agent 现在可以直接读取页面结构、操作元素、查看 Console、追踪请求、下断点、解析 Source Map，并将操作前后的现场记录下来，从基础的点击滑动提升到深度的断点调试和性能瓶颈定位。
插件定位¶
这是一个由 HakureiMonika 独立开发的社区插件，适配 DSH 0.1.5-rc.2。它不修改 DeepSeek Harness 的核心代码，支持多插件共存。
安装与配置¶
安装前需确保环境满足以下要求：
* Node.js 版本：^22.19.0 或 >=24.0.0
* DSH Web Profile 已正常启动
执行以下命令安装 1.0.0-rc7 版本：
dsh plugin --profile web add dsh-browser-scope@1.0.0-rc7 --ignore-scripts --config.auto-install-peers=false
在 Profile 的 cordis.patch.yml 中启用插件：
- insert:
- id: browser-tools
name: dsh-browser-scope
核心能力¶
BrowserScope 提供了覆盖浏览、调试、网络、性能等维度的工具集：
- 浏览与操作：支持标签管理、页面导航、快照读取、元素点击/输入/悬停、滚动、截图、文件上传下载等。
- 调试与源码：通过 CDP Debugger 支持断点控制、单步执行、调用栈查看、变量读取及 Source Map 还原。
- 网络监控：捕获 Console 日志、网络请求列表、请求/响应 Body，支持请求拦截、重发、模拟响应和超时自动恢复。
- 诊断与性能：支持保存 Checkpoint 并对比生成诊断报告、采集 CPU/内存 Profile、分析 Trace。
典型用法¶
- 定位布局错乱：Agent 调用
browser_snapshot读取 DOM 结构，发现某个容器的display属性被异步脚本修改。接着使用browser_debugger结合 Source Map 找到原始代码位置，定位状态更新时序问题。 - 还原线上错误：Agent 使用
browser_debugger暂停脚本，读取 Source Map 将压缩代码映射回原始文件行列（如src/api/fetchUser.ts:23:15），定位异步请求的错误处理缺失。 - 捕获请求覆盖：Agent 调用
browser_network_requests捕获/api/user请求，发现同时发出两个请求但旧请求响应晚 200ms 到达，导致新请求结果被覆盖。 - 对比页面布局：Agent 使用
browser_split_view同时加载两个不同 Viewport 的页面，用browser_snapshot分别读取关键元素位置，发现移动端按钮被遮挡。
注意事项¶
- 非官方插件：这是独立开发的社区插件，不是 DeepSeek 官方发布、维护或背书的插件。
- 开发状态：插件仍在开发中，若遭遇 bug 或意料外情况，请通过 issue 向开发者汇报。
- Session 选择：每个正式 Session 第一次使用浏览器前，需在输入区的“浏览器”菜单中选择 BrowserScope。选定后，该 Session 会一直锁定使用 BrowserScope；其他 Session 可独立选择。
- 升级提示：从历史包
dsh-browser-tools升级时，需先移除旧包。保留id: browser-tools和$DSH_HOME/browser-tools，两个包不要同时安装。
总结¶
DSH BrowserScope 将浏览器调试能力下放给 Agent，解决了 Agent 在网页任务中“看得见但调不准”的痛点。对于需要深入排查前端问题或进行复杂网络操作的 DSH 用户，这是一个实用的工具箱。更多细节可查看 GitHub 仓库。
