news 2026/3/24 19:18:03

【Nanobrowser源码分析2】架构篇: 探究 Nanobrowser 的核心组件与通信模型

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
【Nanobrowser源码分析2】架构篇: 探究 Nanobrowser 的核心组件与通信模型

欢迎来到《Nanobrowser 源码分析》系列的第二篇文章。在上一篇中,我们对 Nanobrowser 的基本功能和安装进行了快速上手。今天,我们将深入底层,剖析其多智能体(Multi-Agent)架构通信模型

作为一款开源的 AI 浏览器自动化工具,Nanobrowser 的精妙之处在于它并非简单的“提示词转发器”,而是一个运行在浏览器侧边栏中的微型操作系统


一、 整体架构概览

Nanobrowser 采用了典型的Chrome Extension V3架构,并在此基础上构建了一套复杂的智能体协作逻辑。其核心设计哲学是Local-first(本地优先):所有的逻辑调度、状态管理和 DOM 操作都在用户的本地浏览器中完成。

1.1 三层逻辑架构

从逻辑上看,Nanobrowser 可以分为以下三层:

  • UI 层 (Sidebar & Options):提供用户交互界面,负责任务输入、实时状态展示及配置管理(如 LLM API Key)。

  • 调度层 (Agent Core):整个系统的“大脑”。负责将复杂任务拆解,并驱动智能体进行“思考-行动-观察”的循环。

  • 执行层 (Content Scripts):注入到目标网页的脚本,负责真实的 DOM 读取、点击、输入等操作。


二、 核心组件:多智能体协作模型

Nanobrowser 的核心竞争力在于其Planner-Navigator-Validator(规划者-执行者-验证者)模型。这种分工避免了单个 LLM 调用在处理复杂长链路任务时的“幻觉”和失控。

1.Planner (规划者)

  • 职责:任务分解。

  • 逻辑:当用户输入“在京东搜索并购买最便宜的机械键盘”时,Planner 会将其拆解为:1. 导航至京东;2. 搜索关键词;3. 筛选并排序;4. 识别目标商品并点击。

2.Navigator (导航/执行者)

  • 职责:环境感知与动作执行。

  • 逻辑:它是唯一直接与网页结构打交道的智能体。它会获取当前页面的Accessibility Tree (无障碍树)简化信息,决定点击哪个选择器(Selector)。

3.Validator (验证者)

  • 职责:质量控制。

  • 逻辑:在每个关键动作结束后,Validator 会检查当前页面状态是否符合预期(例如:登录是否成功?搜索结果是否加载?)。如果失败,它会触发重试或反馈给 Planner 调整策略。


三、 通信模型:消息传递机制

由于 Chrome 扩展的沙箱机制,Sidebar(侧边栏)、Background Service Worker(后台脚本)和 Content Script(页面脚本)运行在不同的环境中。Nanobrowser 构建了一套高效的通信链路。

3.1 内部消息总线 (Chrome Message Passing)

Nanobrowser 使用chrome.runtimeAPI 进行跨环境协作:

发起方接收方目的
SidebarBackground启动任务,传递用户指令。
BackgroundContent Script执行具体的clicktype动作。
Content ScriptBackground返回当前页面的 DOM 结构和执行结果。
BackgroundSidebar实时推送 Agent 的思考状态和日志。

3.2 外部通信 (LLM & MCP)

  • LLM API:Nanobrowser 支持 OpenAI、Claude、Gemini 以及通过 Ollama 运行的本地模型。它通过标准的 HTTPS 请求与这些 API 通信,关键的System Prompt会在 Background 阶段完成组装。

  • MCP (Model Context Protocol):Nanobrowser 正在引入 MCP 支持,这允许 Agent 调用外部工具(如本地文件读写、数据库查询),将浏览器自动化的边界扩展到操作系统层面。


四、 核心工作流:从 Prompt 到 Action

一个典型的自动化循环如下:

  1. 感知 (Observe):Content Script 提取当前页面的 DOM/无障碍树,并进行“瘦身”处理(减少 Token 消耗)。

  2. 决策 (Think):调度层将页面信息 + 用户目标发送给 Navigator。

  3. 行动 (Act):Navigator 生成特定指令(如click("#buy-btn")),通过消息总线发送至 Content Script 执行。

  4. 校验 (Validate):Validator 观察行动后的页面变化,决定进入下一步还是重试。


五、 源码中的关键路径

如果你想深入代码库,可以重点关注以下目录:

  • src/agents/: 包含各智能体的 Prompt 定义和逻辑逻辑。

  • src/background/: 负责扩展的生命周期管理和消息中转。

  • src/content/: 实现具体的浏览器操作(模拟点击、滚动、表单填充)。


结语

Nanobrowser 的架构展示了如何通过模块化智能体高效的浏览器消息机制,在有限的扩展环境中实现强大的 AI 自动化。这种“分而治之”的设计,不仅提升了任务的成功率,也极大地降低了开发者二次开发的难度。

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/3/22 18:05:58

开源社区精选:最受欢迎的TensorFlow-v2.9实战案例合集

TensorFlow-v2.9 深度学习镜像:从环境构建到实战落地的完整实践 在深度学习项目开发中,最让人头疼的往往不是模型设计本身,而是“为什么代码在我机器上跑得好好的,换台设备就报错?”——这种典型的“依赖地狱”问题&am…

作者头像 李华
网站建设 2026/3/21 11:19:35

终极指南:深度解析SwiftSoup如何实现高效HTML解析

终极指南:深度解析SwiftSoup如何实现高效HTML解析 【免费下载链接】SwiftSoup SwiftSoup: Pure Swift HTML Parser, with best of DOM, CSS, and jquery (Supports Linux, iOS, Mac, tvOS, watchOS) 项目地址: https://gitcode.com/gh_mirrors/sw/SwiftSoup …

作者头像 李华
网站建设 2026/3/22 19:02:22

Windows系统下Keil4下载及安装核心要点解析

Keil4在现代Windows系统下的部署实战:从下载到调试的完整通关指南 你有没有遇到过这样的场景? 手头要维护一个老项目,客户只给了一个 .uvproj 工程文件,打开一看——是Keil Vision4写的。你兴冲冲去官网想找安装包&#xff0c…

作者头像 李华
网站建设 2026/3/22 8:23:40

Android证书管理终极解决方案:MoveCertificate模块实战指南

Android证书管理终极解决方案:MoveCertificate模块实战指南 【免费下载链接】MoveCertificate 支持Android7-15移动证书,兼容magiskv20.4/kernelsu/APatch, Support Android7-15, compatible with magiskv20.4/kernelsu/APatch 项目地址: https://gitc…

作者头像 李华
网站建设 2026/3/20 21:11:09

通俗解释JLink工作原理及其基础应用方式

深入浅出JLink:不只是烧录器,更是嵌入式开发的“听诊器”你有没有过这样的经历?代码写得信心满满,编译通过,点击下载——结果板子毫无反应。串口没输出,LED不闪,复位也没用。这时候你开始怀疑人…

作者头像 李华