dsh-browser-scope

---

[!IMPORTANT] 这是独立开发的社区插件，不是 DeepSeek 官方发布、维护或背书的插件。它不会修改 DeepSeek Harness 的核心代码。
本插件仍在开发中，若遭遇bug或任何意料外的情况均可通过issue向开发者汇报。

如果该插件帮上你的忙了，还请点颗星让更多人看见~非常感谢 Thanks♪(･ω･)ﾉ

插件简介

前端调试最头疼的是什么？看不到页面结构、抓不到请求细节、断点打不进去、错误只有一句话。Agent 遇到复杂网页问题时更麻烦——只能截个图、描述几句,然后陷入"刷新试试""清缓存看看"的循环。

BrowserScope 在 DSH Web 右侧栏嵌入一个完整的 Chromium 工作台，配备 30 个专门定制的自动化工具。Agent 现在能直接读页面结构、操作元素、查看 Console、追踪请求、下断点、读调用栈、解析 Source Map、分析性能，并把操作前后的完整现场记录下来。从基础的点击滑动，到深度的断点调试和性能瓶颈定位，全在一个 Session 里完成。

支持多插件共存，适配 DSH 0.1.5-rc.2。每个正式 Session 第一次使用浏览器前，需要选择 BrowserScope 或当前 Profile 中已有的其他浏览器工具。选定后，该 Session 会一直使用同一套工具；其他 Session 可以独立选择。这样可以避免不同插件的页面、标签、元素引用和登录状态互相混用。

目录

• 能力测试结果
• 能力展示
• 安装
• 功能介绍
  • 浏览与操作
  • Console 与请求
  • 断点与源码
  • 性能与诊断
  • 实况与人工接管
  • 扩展与浏览器环境
  • Session 控制
• 技术细节
• 测试报告 (VALIDATION.md)
• English Version (README.en.md)
• 兼容范围
• 使用反馈
• License

能力测试结果

所有测试在真实 Chromium、真实 DSH Web 和实际生产代码环境中执行,不使用模拟器或简化场景。

核心能力

• 30 个浏览器工具在真实 Chromium 环境中全部跑通
• 9 个原生工作台视图在真实 DSH Web 中全部验收通过
• 多插件共存已通过单 Session 单浏览器锁定专项、真实 Agent Scope 集成和 DSH 0.1.5-rc.2 Web 验收
• 4 个 DSH 版本兼容性测试全线通过
• 长时间高强度运行(30 分钟 × 3 档),性能稳定,内存不漏

专项验证

完整测试报告见 VALIDATION.md。

能力展示

一个窗口，完整调试链路

Agent 对话、真实页面、标签栏、地址栏和调试结果全在 DSH 右侧栏。当页面出现异常时，不用在多个窗口来回切换——直接在原位查看 DOM 结构、Console 输出、Network 请求和脚本堆栈。

真实使用案例：页面布局突然错乱。Agent 调用 browser_snapshot 读取 DOM 结构，发现某个容器的 display 被异步脚本改成了 none。接着用 browser_debugger 在相关脚本里下断点，配合 Source Map 找到原始代码位置，最终定位到一个状态更新时序问题。全程无需人工介入，现场证据完整清晰。

首次选择，Session 内保持一致

正式 Session 第一次使用浏览器前，需要选择 BrowserScope 或当前 Profile 中已有的其他浏览器工具。选择前，当前 Session 暂时不向 Agent 暴露浏览器工具。

选择 BrowserScope 后，当前 Session 只使用 BrowserScope；选择其他浏览器工具后，BrowserScope 不会在该 Session 注册工具或创建浏览器资源。选定后不能中途更换，需要换插件时新建 Session。其他 Session 可以独立选择，第三方插件本身不被停止或修改。

释放 BrowserScope 资源只会关闭它自己的页面和调试状态，不会解除当前 Session 的工具选择。DSH 重启或 Agent Scope 替换后，原选择继续保持。

线上压缩代码？直接还原

代码被 Webpack 压缩成一行？没关系。连上 CDP Debugger，挂上 Source Map，直接在原始源码里找问题。调用栈、变量作用域、断点位置全都能准确映射回去。

真实使用案例：线上报错 Uncaught TypeError: Cannot read property 'data' of undefined，但堆栈指向的是压缩后的 bundle.min.js:1:47392。Agent 用 browser_debugger 暂停脚本，读取 Source Map，把这个位置映射到 src/api/fetchUser.ts:23:15，发现是异步请求的错误处理缺失。

请求时序，一清二楚

抓包列表按时间排列，mode 和 generation 的变化直接标出异步任务的先后顺序。专治状态覆盖、响应迟到这类时序 Bug。

真实使用案例：页面偶尔显示错误的用户信息。Agent 用 browser_network_requests 捕获所有 /api/user 请求，发现同时发出了两个请求，但旧请求的响应比新请求晚 200ms 到达，覆盖了正确结果。定位到根因是组件快速切换时没有取消前一个请求。

双页实况，同时盯梢

两个真实页面，独立画面，独立焦点。做响应式检查时上下排列，跨页面对比时左右排列。

真实使用案例：验证移动端和桌面端的布局一致性。Agent 用 browser_split_view 同时加载两个不同 Viewport 的页面，用 browser_snapshot 分别读取关键元素的位置和样式，发现移动端某个按钮被遮挡。

保护现场，有据可查

Debug Session 把页面身份、操作时间线、Context Topology 和 Build Identity 打包在一起。

操作前后各存一个 Checkpoint，直接 Compare 生成 Incident 报告。图中是 BrowserScope 精准识别出演示应用预埋故障的实况。

真实使用案例：用户反馈"点击提交后页面没反应"。Agent 用 browser_diagnose 在点击前后各保存一个 Checkpoint，Compare 发现提交按钮的 disabled 属性被设为 true 但从未恢复。结合 Network Journal 发现请求返回了 500 错误，但前端没有处理，导致按钮永久禁用。

性能问题，无处藏身

CPU 飙高？内存泄漏？用 Trace 看主线程阻塞，用 CPU Profile 找热点函数，用 Heap Snapshot 查对象保留。所有大文件自动存入 Session 隔离的 Artifact Store，不会撑爆 AI 的上下文。

真实使用案例：页面滚动卡顿。Agent 用 browser_profile 采集 CPU Profile，发现某个图片懒加载函数在每次滚动事件中都被调用，且没有节流。定位到性能瓶颈后，建议加入 debounce 处理。

安装

需要 Node.js ^22.19.0 或 >=24.0.0，以及一个可以正常启动的 DSH Web Profile。

1.0.0-rc7 面向已验证的 DSH 0.1.7-rc.1 和 0.1.7-rc.2，与 RC6 使用相同的浏览器业务源码。安装前请核对 npm Registry 已发布该精确版本；未发布时可使用与候选身份文件及 SHA-256 核对过的本地 tarball。候选冻结与公开发布是独立步骤，不能仅从包内版本号推断发布状态。

dsh plugin --profile web add dsh-browser-scope@1.0.0-rc7 --ignore-scripts --config.auto-install-peers=false

或使用本地 tarball：

dsh plugin --profile web add ./dsh-browser-scope-1.0.0-rc7.tgz --ignore-scripts --config.auto-install-peers=false

在 Profile 的 cordis.patch.yml 中启用：

- insert:
    - id: browser-tools
      name: dsh-browser-scope

启动 DSH Web，新建 Session 并发送一条消息。打开输入区的“浏览器”菜单，选择“使用 DSH BrowserScope”或“使用其他浏览器工具”。确认后，该 Session 的选择会保持锁定。

从历史包 dsh-browser-tools 升级时，先移除旧包。保留 id: browser-tools 和 $DSH_HOME/browser-tools。两个包不要同时安装在同一个 Profile 中。

功能介绍

浏览与操作

Console 与请求

断点与源码

性能与诊断

实况与人工接管

扩展与浏览器环境

Session 控制

技术细节

完整配置、工具注册模式、状态模型、安全边界、内部标识和工具清单见 TECHNICAL.md。

测试报告

多环境真实工况实测记录见 VALIDATION.md。

兼容范围

版本 1.0.0-rc7 的目标宿主范围为 DSH 0.1.5-rc.2、0.1.6-alpha.1、0.1.6-alpha.2、0.1.7-rc.1 和 0.1.7-rc.2，要求 Cordis >=4.0.2 <5、Schemastery >=3.18.2 <4。RC7 沿用 RC6 的浏览器业务代码；公开 npm 安装命令是否可用应以 Registry 精确版本为准，候选冻结和 GitHub 发布状态应分别核验。

候选状态以外部 candidate-identity.json 和 tarball 摘要为准。

使用反馈

遇到缺陷、兼容问题或有新功能建议，请提交 GitHub Issue。带上 DSH 版本、BrowserScope 版本、操作系统、Node.js 版本和同时加载的浏览器插件，可以更快定位问题。

安全漏洞请按 安全策略 私密报告。不要把凭据、Cookie、会话数据或未脱敏日志放进公开 Issue。

License

MIT