文件与剪贴板

agent-browser 可以上传文件、捕获下载、通过 file:// URL 读取本地文件、写入 PDF 和截图，并与浏览器剪贴板交互。

上传文件¶

agent-browser snapshot -i
agent-browser upload @e4 ./invoice.pdf
agent-browser upload @e4 ./front.png ./back.png

选择器必须解析到一个文件输入。多文件输入可以接受多个文件路径。

下载¶

agent-browser download @e5 ./report.csv
agent-browser wait --download ./archive.zip --timeout 30000

当某个特定元素触发下载时，使用 download。当另一个操作启动下载且你需要等待完成时，使用 wait --download。

这两个命令仅在 agent-browser 启动的浏览器中保存到本地路径。在 --cdp、--auto-connect 或 provider 方式下，远程端点会指定保存文件的名称，因此 download 和 wait --download <path> 会被拒绝。不带路径的 wait --download 仍会报告浏览器保存文件的位置。

为浏览器发起的下载设置默认下载目录：

agent-browser --download-path ./downloads open https://app.example.com

如果没有 --download-path，下载内容将保存到临时目录，并在浏览器关闭时清理。

截图与 PDF¶

agent-browser screenshot ./page.png
agent-browser screenshot --full ./page-full.png
agent-browser screenshot --if-changed
agent-browser screenshot --threshold 0.01
agent-browser screenshot --screenshot-format jpeg --screenshot-quality 80 ./page.jpg
agent-browser pdf ./page.pdf

对于重复捕获，建议优先使用 --if-changed：跳过未变化的图像是最节省 token 的选项。历史记录按标签页和捕获范围区分。第一次捕获会返回路径；之后未变化的捕获会省略该路径。JSON 中包含 changed、revision 和 pixelChangeRatio。--threshold <0-1> 隐含启用 --if-changed，并将低于或等于该比例的变化视为未变化。

截图默认值也可以通过以下方式配置：

设置	描述
`--screenshot-dir` / `AGENT_BROWSER_SCREENSHOT_DIR`	默认截图输出目录
`--screenshot-format` / `AGENT_BROWSER_SCREENSHOT_FORMAT`	`png` 或 `jpeg`
`--screenshot-quality` / `AGENT_BROWSER_SCREENSHOT_QUALITY`	JPEG 质量，取值范围为 0 到 100

本地文件¶

agent-browser --allow-file-access open file:///Users/me/report.pdf
agent-browser --allow-file-access open file:///path/to/page.html
agent-browser screenshot ./local-file.png

--allow-file-access 仅适用于 Chromium。它允许 file:// 页面加载并通过 fetch、XHR 等浏览器 API 访问其他本地文件。

剪贴板¶

agent-browser clipboard read
agent-browser clipboard write "Hello, world"
agent-browser clipboard copy
agent-browser clipboard paste

copy 和 paste 会模拟当前选中内容或焦点元素的平台键盘快捷键。当你希望直接设置剪贴板文本时，请使用 write。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 agen/agent-browser