Kitesurf 开放代码:面向 AI 智能体的轻量浏览器引擎
Cloudflare 宣布,面向 AI 智能体的实验性无状态浏览器引擎 Kitesurf 已以 Apache 2.0 许可开放代码。开发者可以查看、修改代码,在本地运行,也可以将其部署到自己的 Cloudflare Workers 账户。
不依赖浏览器容器,支持 CDP
Kitesurf 完全运行在 Cloudflare Workers 上,能够解析 HTML、应用 CSS、执行页面 JavaScript,并渲染截图,无需运行浏览器容器。
它支持 Chrome DevTools Protocol(CDP),因此可以连接 Puppeteer 等客户端,也可以供支持 CDP 的 AI 智能体工具调用。
项目的目标是为智能体提供更轻量的网页交互能力:在加载网站、执行脚本和操作页面时,争取比 Chromium 等完整浏览器消耗更少的 CPU 与内存,并通过 Workers 网络按需扩展。这是项目的设计目标,并不意味着它已经具备完整浏览器的兼容性。
引擎由哪些部分组成?
Kitesurf 结合了 Cloudflare 开发平台能力,以及编译为 WebAssembly 的 Rust 生态组件:
| 组件 | 主要职责 |
|---|---|
| Blitz | HTML 解析、DOM、布局与绘制 |
| Stylo | CSS 解析、层叠与计算样式 |
| Boa | 当 JavaScript 无法在 Dynamic Workers 中运行时,作为后备方案在 WebAssembly 中执行 |
| Linebender 系列库 | 文本布局与二维图形 |
| Krilla | 生成 PDF 输出 |
这些第三方项目保留各自的许可,相关声明记录在仓库的 NOTICE 文件中。
从整体架构看,Kitesurf 分为三个主要部分:
- Engine:管理浏览器会话与客户端连接。
- PageScript:运行页面及其 JavaScript。
- PageRenderer:绘制页面结果。
引擎、Rust 核心、DOM 兼容层、渲染器和 Kitesurf CLI 等模块分别放在仓库的 packages 目录下。
如何在本地运行?
先满足项目规定的构建要求并获取代码,再进入项目目录执行:
cd kitesurf
pnpm install --frozen-lockfile
pnpm run dev
首次构建需要编译 Rust 核心及其依赖,耗时会较长;后续构建会复用缓存。启动后,Wrangler 会在 http://127.0.0.1:8787 提供本地开发服务。
开发者可以在该地址通过 Chrome DevTools 调试页面,也可以用 Puppeteer 连接:
import puppeteer from "puppeteer-core";
const browser = await puppeteer.connect({
browserWSEndpoint: "ws://127.0.0.1:8787/devtools/browser",
});
try {
const page = await browser.newPage();
await page.goto("https://example.com/");
await page.screenshot({ path: "page.png" });
} finally {
await browser.disconnect();
}
支持 CDP 的智能体运行框架也可以连接上述本地端点,对 Kitesurf 进行控制。
部署到自己的 Cloudflare 账户
完成本地修改与测试后,可以在仓库根目录执行:
pnpm run deploy
部署后,可直接使用自己账户中的 Kitesurf 实例,而不是使用 Cloudflare 提供的 Browser Run 托管 API。
部署需要 Workers 付费套餐,因为 Kitesurf 使用 Dynamic Workers 为页面创建隔离的 Worker。
使用前需要了解的限制
Kitesurf 仍处于密集开发阶段,团队当前重点是提升兼容性、可靠性和效率。因此,评估时应针对实际需要访问的页面与自动化流程进行测试,不宜默认其行为与 Chromium 完全一致。
项目接受代码和非代码贡献。提交改动前,应先阅读贡献指南,通过 issue 提供最小复现或拟议方案,并在获得维护者认可后再提交拉取请求。范围明确、附带测试和清晰证据的修复,比大规模重写或无关清理更容易评审;渲染异常的最小页面、失败的自动化流程和文档纠错也有帮助。
