浏览器
蓝莓办公通过内置浏览器技能 lanmate-browser-use 操作网页,有三种后端:
| 模式 | 用在哪 |
|---|---|
| 内置浏览器(默认) | 右侧面板「浏览器」Tab,你和蓝莓办公看同一个页面 |
| 外部 Chrome(扩展桥接) | 需要复用你真实 Chrome 的登录态、扩展与指纹 |
| Playwright 独立 Chromium | 需要干净环境、网络拦截或独立窗口时;本机通常没有预装,不保证可用 |
内置浏览器
右侧面板「浏览器」Tab 打开。每个标签页独立运行,与主窗口共享 lanmate-browser 登录态。蓝莓办公打开页面时会自动锁定浏览器,你能实时看到它的操作;点底部的「解锁控制」可以随时接管。
它怎么“看”页面
不是一上来就截图,而是按成本从低到高:
- 语义快照:返回页面结构树与可交互元素,每个元素带
@eN引用(如@e7) - 正文 / 链接 / 图片:只需要内容时直接取
- 控制台日志:页面报错、白屏、接口失败时先看日志
- 截图:只有布局、图片、Canvas 这类必须看画面时才截
操作元素优先用 @eN 引用,不猜 CSS 选择器。页面导航或 DOM 变化后,旧引用会失效,需要重新快照。
需要你接手的时候
遇到验证码、登录、短信验证码、支付确认这类只有人能做的步骤,蓝莓办公会调用 request_help:浏览器自动解锁并弹出提示条,你完成后它继续。你也可以设置完成条件(例如登录后 URL 包含 /dashboard),它会在条件满足后自动接着做。
外部 Chrome 扩展
设置 → 扩展 → 浏览器,打开「允许控制外部浏览器」,再安装并连接配套 Chrome 扩展:
- 打开扩展管理页
- 加载本地插件文件夹
- 扩展与本机蓝莓办公建立连接
连接成功后,内置模式的请求会自动路由到你的真实 Chrome,复用登录态。扩展 0.3.0 起,点击、悬停、按键走真实 CDP 输入;首次使用 Chrome 会显示「正在被调试」提示条。
「已连接」和「允许路由」是两件事:扩展装好并连上,但设置开关没开时,状态会显示已连接、未允许。
安全设置
| 设置项 | 默认值 | 说明 |
|---|---|---|
| 允许执行 JavaScript | 关 | 开启后才允许注入 JS;严格 CSP 站点会回退到 CDP |
| 站点审批 | 开 | 首次访问需要批准,1.0.1 起按站点(host)记住 |
| 任务默认浏览器 | 内置 | 可切换为外部 Chrome |
| 限制渠道工具文件访问 | 开 | 渠道工具只能访问当前工作目录内的文件 |
安全红线:
- 不在银行、SSO 登录、密码管理器页面执行脚本读取 Cookie、Token 或密码
- 快照里的密码框值会自动打码为
[redacted],不要尝试绕过 - 不把登录态 Cookie / Storage 写进对话或文件
下载的文件去哪了
内置浏览器的下载会自动存入当前会话的工作区,产物面板可直接预览;无法解析安全目录的会话保留系统保存框。
使用示例
打开公司 OA 系统,帮我把这个月的考勤记录导出来
蓝莓办公会打开内置浏览器 → 导航到 OA → 需要登录时把控制权交给你 → 找到考勤页面 → 点击导出。