Lightpanda
Lightpanda 是一个专为机器设计的无头浏览器引擎，完全用 Zig 语言从零构建。它启动速度极快，内存占用仅为 Chrome 的十分之一，执行速度提升十倍。
agent-browser 管理 Lightpanda 的方式与管理 Chrome 完全相同——通过进程启动、使用 CDP 连接并关闭。所有下游命令（如截图、点击、填写表单、屏幕截图等）都通过相同的 CDP 协议路径进行。
安装
在使用 agent-browser 之前，请先安装 Lightpanda 二进制文件：
| 平台 | 命令 |
|---|---|
| macOS (Apple Silicon) | curl -L -o lightpanda https://github.com/lightpanda-io/browser/releases/download/nightly/lightpanda-aarch64-macos && chmod a+x ./lightpanda |
| Linux (x86_64) | curl -L -o lightpanda https://github.com/lightpanda-io/browser/releases/download/nightly/lightpanda-x86_64-linux && chmod a+x ./lightpanda |
将二进制文件移动到你的 PATH 中的某个位置（例如 /usr/local/bin/lightpanda 或 ~/.local/bin/lightpanda）。
更多安装选项请参见 Lightpanda 安装文档。
使用方法
使用 --engine 标志选择 Lightpanda：
agent-browser --engine lightpanda open example.com
agent-browser --engine lightpanda snapshot
agent-browser --engine lightpanda screenshot或者通过环境变量设置为默认值：
export AGENT_BROWSER_ENGINE=lightpanda
agent-browser open example.com或在你的 agent-browser.json 配置文件中设置：
{
"engine": "lightpanda"
}自定义二进制路径
如果 lightpanda 二进制文件不在你的 PATH 中，请使用 --executable-path 参数：
agent-browser --engine lightpanda --executable-path /path/to/lightpanda open example.com与 Chrome 的差异
Lightpanda 是一个专为特定用途设计的无头引擎。部分 Chrome 特有的功能不被支持：
| 功能 | 状态 |
|---|---|
扩展程序 (--extension) | 不支持 |
持久化配置文件 (--profile) | 不支持 |
存储状态 (--state) | 不支持 |
文件访问 (--allow-file-access) | 不支持 |
有头模式 (--headed) | 不适用（仅支持无头模式） |
| 截图 | 取决于 Lightpanda 对 CDP 协议的支持情况 |
当您将 --engine lightpanda 与不支持的标志组合使用时，agent-browser 会返回明确的错误信息。
何时使用 Lightpanda
Lightpanda 适用于以下场景：
- 快速网页抓取与数据提取
- 对速度和低内存消耗要求高的 AI 代理工作流
- 资源受限的 CI/CD 环境
- 大规模并行自动化任务
当您需要完整的浏览器保真度、扩展程序支持或持久化配置文件时，请使用 Chrome。