@onkernel/browser-loop
Kernel 官方浏览器工具框架与 Pi 扩展,按模型能力编译 GUI 动作并在云端浏览器执行。
pi install npm:@onkernel/browser-loop pi -e npm:@onkernel/browser-loop 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。 |
看完「@onkernel/browser-loop」后的下一步
可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)
从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频
已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)
说明:此处未向后台提交个人资料或邮件表单。配置单与实机演示视频正在制作中,你的匿名点击已计入站点热度,用于排定优先录制方向。
Coding Agent 实战交付课:如何可控地把想法做成线上产品
由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。
说明:此处未向后台提交报名或收集任何个人信息。课程模块仍在筹备阶段,你的匿名点击将作为模块排期的优先参考。