feat(browser): reuse system Chrome/Edge, bundle playwright for desktop

This commit is contained in:
zhayujie
2026-07-14 18:02:27 +08:00
parent eeb4b7981e
commit 5d55ec0f8c
17 changed files with 676 additions and 62 deletions

View File

@@ -49,6 +49,12 @@ description: 控制浏览器访问和操作网页
2. 浏览器工具依赖较重约300MB为可选安装。轻量的网页内容获取可使用 `web_fetch` 工具。
</Note>
<Note>
**桌面客户端用户**playwright 已内置于安装包,无需单独安装。首次使用浏览器工具时:
- 若系统已安装 **Google Chrome / Edge**,会直接驱动系统浏览器,**无需任何下载**(推荐);
- 若未安装,可在对话中发送 `/install-browser`,自动下载一个精简浏览器内核到 `~/.cow`。
</Note>
## 工作流程
Agent 使用浏览器的典型流程:
@@ -105,6 +111,15 @@ Agent 使用浏览器的典型流程:
}
```
## 浏览器内核
浏览器内核会自动选择,无需配置:
1. 若检测到本机已安装 **Google Chrome / Edge**,直接驱动系统浏览器,**无需下载 Chromium**,并使用真实浏览器指纹;
2. 否则使用 `install-browser` 下载到 `~/.cow` 的 Chromium 内核作为兜底。
两种方式都使用下面的登录态持久化,行为一致。
## 登录态持久化
**只需登录一次目标网站Agent 后续可直接使用**。提供两种方式: