Jet Browser 是一个面向 AI 智能体的可移植 WPE WebKit 运行时,将 WPE WebKit 与 Rust WebDriver 桥接打包为独立运行时。一个容器运行一个隔离的浏览器会话,控制端(harness)发送有序 JSONL 命令并接收机器可读结果。它不需要账户、API 密钥、模型、数据库或托管控制平面,适合任何模型、智能体循环、CI 任务或确定性测试运行器。
【用途】Jet Browser 定位为需要清晰、可检查浏览器边界的运行执行层。当隔离性重要时,每个容器使用一次性浏览器会话,具有明确的生命周期与资源限制;当证据需要一致时,原生输入、DOM 状态与新截图来自同一运行时,而非分离的回放路径;当控制端应保持可替换时,有序 JSONL 可与任意模型、智能体循环、CI 任务或确定性测试运行器配合;当需要非 Chromium 运行时,WPE WebKit 提供第二个引擎,而无需再引入另一个浏览器智能体框架。它不附加到日常使用的 Chrome,也不包含模型或智能体。若需要浏览器矩阵、扩展生态或已登录的 Chrome 配置文件,则应继续使用 Playwright、CDP 或现有浏览器栈。
【主要能力】支持原生输入、DOM 与文本读取、新截图,以及有序 JSONL、MCP 和 JavaScript SDK 接口。每个输入行是一条 JSON 命令,每个输出行是一条 JSON 响应。提供版本化工具声明(sdk/tools.mjs)与框架无关的绑定模式。Python 应用可监督同一容器与有序 JSONL 边界,无需第三方包。附带可复现的运行时基准:Jet Browser 在 1,445.25 毫秒内到达已验证页面,活动内存 189.6 MiB,就绪时间比下一个结果低 72.7%,内存低 33.2%。提供稳定性运行命令 npm run stability,默认 10 秒场景在两个切换周期内创建三个隔离页面,验证原生输入、JavaScript 状态、语义 DOM 与每个页面的新 PNG,采样内存与运行时进程健康,并写出机器可读报告。
【使用方式】仅需 Docker 可运行已验证的冒烟测试,无需克隆、Node.js、账户、API 密钥或出站浏览器网络。可审查脚本会下载发布锁定的 seccomp 策略,验证其 SHA-256,从不可变多平台镜像选择原生 linux/amd64 或 linux/arm64,并测试浏览器启动、原生输入、DOM 状态与 PNG 捕获;它启动一个一次性、资源受限、禁用网络的容器,不挂载 Docker 套接字或主机目录。完整源码检出与 SDK 路径需要 Docker 和 Node.js 24+。提供 VS Code MCP 安装链接(带审阅提示)、Cursor 一键安装、Codex 与 Claude Code 的 Jet Browser 技能;仓库本地技能位于 .agents/skills/jet-browser/SKILL.md。Hermes 插件注册一个有界验证工具,运行不可变公共镜像、禁用浏览器网络,返回启动、原生输入、DOM 与 PNG 证据,属于运行时验证器而非 CDP 浏览器提供者。MCP 验证器以 io.github.masakaai/jet-browser 发布在官方 MCP Registry,通过本地 stdio 服务器与版本化 OCI 包暴露相同的有界证明,声明不可变运行时契约,在禁用网络下运行验收,不接受 URL、配置文件、凭据或任意命令。Docker 套接字授予主机级控制,仅应为受信任的本地 MCP 客户端安装。
【部署与边界】发布的多平台清单提供原生 linux/amd64 与 linux/arm64 镜像及每平台来源证明,生产环境应固定清单摘要。冒烟测试禁用出站网络,启动真实浏览器,打开本地页面,通过原生输入路径输入,验证 DOM,捕获 PNG,关闭会话。GitHub Marketplace Action 无需仓库或账户密钥即可运行相同验收,选择运行器的原生发布镜像,在 GitHub 托管 Linux 运行器上准备 WPE 沙箱,启动禁用出站网络的真实浏览器,验证原生输入与 DOM 状态,捕获 PNG,清理容器;自托管运行器须已允许非特权用户命名空间。分布式预览、人工接管、持久化与调度是围绕同一运行时的可选组件,独立使用不需要。每个互不信任的会话应使用专用容器;在自身集成中,将 evaluate、导入配置文件、下载与出站网络访问视为特权能力。仅当 JET_BROWSER_SMOKE=1 时启动仅冒烟的环回页面。包含的 seccomp 配置文件允许 WPE WebKit 自身 bubblewrap 沙箱所需的用户与挂载命名空间操作;在 AppArmor 主机上,外层容器配置文件被禁用,因为其会阻止内层沙箱,但进程仍不获得 SYS_ADMIN 能力、启动后无有效能力,也无特权模式。
【开发与许可】可仅构建独立运行时,也可构建可选分布式工作器。仓库结构:rust/ 为原生 WebDriver 桥接与浏览器辅助;src/ 为可选分布式工作器、预览、输入、状态与安全边界;sdk/ 为客户端传输与智能体工具声明;scripts/standalone-smoke.mjs 为离线端到端验证;test/ 为 Node 回归测试(Rust 测试位于各模块旁);docs/ 为协议、架构与集成说明。Jet Browser 是浏览器基础设施,不是 LLM 或智能体框架;核心暴露 JSONL 动作协议,而非假装 WPE 实现仅 Chromium 的扩展、策略或 CDP 契约。采用 Apache License 2.0 许可。