第11章 Browser Context Grab(浏览器上下文抓取):智能体前端调试新范式
# 第11章:浏览器上下文抓取(Browser Context Grab) 从 Jean 的嵌入式浏览器中,向聊天窗口发送具备源代码感知能力的 DOM 上下文。
Jean 的嵌入式浏览器能够抓取页面元素,并将其转化为聊天上下文。 这由 React Grab 提供支持,它会高亮页面中的 UI 元素,并为所选元素收集相关的 DOM 和 React 源代码元数据。
适用场景
在以下情况下使用浏览器上下文抓取:
* 你正在 Jean 的嵌入式浏览器中查看某个页面 * 你希望智能体(agent)理解特定的按钮、表单、卡片、错误状态或布局区块 * 直接复制整个页面会产生过多干扰信息 * 在 React 应用可用时,你需要具备源代码感知能力的上下文
这在 UI 调试、前端细节打磨以及向编程智能体解释具体屏幕状态时尤为实用。
如何抓取元素
1. 在 Jean 的浏览器面板中打开一个页面。 2. 点击浏览器工具栏中的“Grab DOM element”。 3. 将鼠标悬停在你想要发送的元素上。 4. 使用 React Grab 的“Send to Jean Chat”操作,或复制所选元素。 5. Jean 会将捕获的上下文作为文本附件附加到当前活动的聊天草稿中。
附件名称根据元素自动生成,例如 `dom-button-submit.txt`。
发送到聊天的内容
Jean 会为所选元素发送一个聚焦的上下文包,包含:
* 页面 URL 和标题 * 元素标签名称 * 生成的 CSS 选择器 * 可见文本 * 所选元素的 HTML * React 组件名称(如果 React Grab 能够解析) * 源文件和行号(如果可用) * React 堆栈上下文(如果可用)
这使智能体既能获取渲染后的 DOM,又能获得定位正确代码所需的源代码提示,从而更快地找到目标代码。
Jean 中 React Grab 的最新行为
Jean 在本地打包了最新的 React Grab 运行时,并仅在你使用抓取按钮时将其注入到嵌入式浏览器页面中。 当前 Jean 的行为包括:
* 页面内扩展后的 React Grab 工具栏 * Jean 主题的明/暗模式同步 * 切换式激活,确保在挑选元素期间抓取叠加层保持活动状态 * 来自 React Grab 的悬停标签和选择反馈 * 支持 React Grab 的多元素选择反馈 * 在右键菜单和工具栏中提供 Jean 专属的“Send to Jean Chat”操作 * 当 React Grab 处于活动状态时,使用 J 快捷键触发 Jean 操作 * 成功抓取/复制后自动创建聊天附件
Jean 将集成重点放在向聊天发送上下文上。它会禁用 React Grab 中评论、编辑页面样式或直接从嵌入页面打开源文件等操作。
隐私与安全
React Grab 在嵌入式浏览器页面内运行,Jean 将捕获的上下文存储为本地聊天附件。 请注意:
* 抓取的文本和 HTML 被视为不可信的页面内容 * 仅在你能接受将该上下文发送给所选后端时,才抓取敏感页面 * Jean 不会在运行时从 CDN 加载 React Grab * Jean 在嵌入式浏览器集成中禁用了 React Grab 的遥测和版本检查
延伸阅读
* 项目画布与聊天 * 本地优先与安全 * 后端、模型与 MCP
## 项目画布与聊天 在画布、会话标签页、终端、文件和快捷键之间切换,而不会丢失工作脉络。
## 魔术命令 使用 Jean 的内置命令来管理上下文、提交、审查、PR、笔记以及冲突解决。