@onkernel/browser-loop

Kernel 官方浏览器工具框架与 Pi 扩展,按模型能力编译 GUI 动作并在云端浏览器执行。

安装命令
pi install npm:@onkernel/browser-loop
临时试用 / 替代安装命令
pi -e npm:@onkernel/browser-loop
挂接事件钩子与注册入口
session_startmodel_selectbefore_agent_startbefore_provider_headersbefore_provider_requesttool_callsession_shutdown
pi.registerTool() / pi.setActiveTools()pi.registerCommand("browser" / "browser-tools")pi.registerFlag()pi.registerProvider()pi.appendEntry()ctx.ui.setStatus() / notify()

1. 是什么

@onkernel/browser-loop 是 Kernel(onkernel)推出的浏览器控制包。

代码包分为两层导出:框架无关的核心层 @onkernel/browser-loop(仅依赖 typebox 定义规范动作和工具目录),以及面向 @earendil-works/pi-agent-core 的绑定与 Pi 扩展(./src/pi-extension/index.ts)。

2. 解决什么问题

让模型像人一样操作真实浏览器(点击坐标、输入、拖拽、等待、截图回看),不同模型家族(如 Claude Computer Use 与通用工具调用模型)期望的工具格式和坐标参数并不一致。

同时在开发者本机起无头浏览器既占内存又难保证会话隔离。browser-loop 把动作规范统一编译到当前所选模型,再把执行转发给 Kernel 云端浏览器。

3. 作用原理(事件钩子与工具注册层)

在模型切换与每次请求前动态编译浏览器工具目录,并在 tool_call / provider 请求层注入传输与重试逻辑。

  • 扩展在 session_start 与 model_select 监听当前激活模型,调用核心层的 per-model compiler 生成适配该模型的浏览器动作 schema,并通过 setActiveTools 更新暴露给模型的工具列表。
  • 若模型需要特定请求头或 Computer Use beta 标识,扩展在 before_provider_headers 与 before_provider_request 钩子中按模型协议改写请求。
  • 模型发起工具调用后,扩展将其转发到 Kernel SDK 驱动的云端浏览器实例执行,返回最新页面状态与截图,并通过 appendEntry 记录会话关联的浏览器实例状态。
  • 提供 /browser 与 /browser-tools 命令供用户在会话中查看或管理当前浏览器实例与工具集。

4. 怎么装与基本配置

  • 运行要求 Node.js 22.19 或更高版本,并在环境变量中配置 KERNEL_API_KEY。
  • 通过 pi install npm:@onkernel/browser-loop 安装后,Pi 会自动加载 ./src/pi-extension/index.ts。
  • 如果是将能力嵌入自研 Agent 宿主,可直接安装核心库与 @earendil-works/pi-agent-core 后调用 @onkernel/browser-loop/pi 导出的 attach()。

5. 和同类怎么选

相比抓取静态文本的 pi-web-access,@onkernel/browser-loop 面向需要真实鼠标/键盘交互与视觉闭环的网页操作场景。

与同类方案的选型对照

聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。

对比对象 机制差异 怎么选
pi-web-access 主要面向搜索、网页正文/字段提取、PDF 与视频理解,不执行复杂多步页面点击或登录后表单提交。 只做资料检索和页面内容读取时选 pi-web-access;需要真实浏览器点击交互与视觉验证时选 @onkernel/browser-loop。
pi-agent-browser-native 社区包将本地 agent-browser 暴露为工具,而 @onkernel/browser-loop 绑定 Kernel 云端浏览器运行时。 希望浏览器运行在隔离云端环境且需跨模型自动编译动作目录时选 @onkernel/browser-loop。

同方向对比包与顺序阅读

pi-mcp-adapter

用按需激活和结果裁剪接入外部 MCP 服务,避免工具定义撑爆上下文。

阅读该包机制详评

pi-web-access

零配置起步的 Pi 联网套件:多引擎搜索回退、页面结构化抽取、PDF 与视频理解。

阅读该包机制详评

01 接外部世界

回到该演进方向总论,查看完整痛点拆解、通用安装注意事项与全部收录清单。

返回方向总论页

看完「@onkernel/browser-loop」后的下一步

可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)

从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频

已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)

出口 1(配置单与实机演示制作中)

Coding Agent 实战交付课:如何可控地把想法做成线上产品

由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。

出口 2(实战交付课筹备中)