进阶 jean.build 2026-10-18 10:33:18 · 25 阅读

第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、笔记以及冲突解决。

评论 (0)