Chrome 浏览器中继
Chrome 浏览器中继让 AI 能够控制你真实的 Chrome 浏览器——保留你已有的登录状态、Cookies 和会话。与内置浏览器工具（会打开一个干净的 Electron 窗口）不同，Chrome Relay 操作的是你日常使用的 Chrome。
工作原理
AI 对话 → ChromeRelay 工具 → Alma 服务器 → WebSocket → Chrome 扩展 → chrome.debugger → 你的标签页Alma 附带一个 Chrome 扩展，通过 Chrome DevTools Protocol (CDP) 将你的浏览器桥接到 AI。扩展通过本地 WebSocket 连接 Alma，AI 通过该通道发送导航、点击、输入和截图等命令。
设置
方式一：一键启动（推荐）
- 打开 Alma → 设置 → Chrome Relay
- 复制页面上显示的 Auth Token
- 点击 Launch Chrome with Extension
- 等待连接状态变为绿色
WARNING
点击前请先关闭所有 Chrome 窗口。--load-extension 参数在 Chrome 未运行时效果最好。
方式二：手动安装
如果一键启动不生效（比如 Chrome 已在运行）：
- 打开 Alma 设置 → Chrome Relay
- 展开 Manual Install 部分，复制 Extension Path
- 打开 Chrome，地址栏输入
chrome://extensions - 开启右上角的开发者模式
- 点击加载已解压的扩展程序，粘贴复制的路径
- 点击 Chrome 工具栏上的扩展图标打开弹窗
- 如未自动连接，点弹窗底部的 Settings
- 输入 Port（默认
23001）和从 Alma 复制的 Auth Token - 点击 Save，扩展会自动重连
验证连接
- 扩展图标显示绿色 ON 徽章
- Alma 设置 → Chrome Relay 显示绿色 Connected 状态
- 已 Attach 的标签页会在扩展弹窗和 Alma 设置中列出
可用工具
| 工具 | 描述 |
|---|---|
| ChromeRelayListTabs | 列出所有打开的 Chrome 标签页（ID、URL、标题、是否活跃） |
| ChromeRelayNavigate | 导航到 URL，或新建标签页 |
| ChromeRelayClick | 通过 CSS 选择器点击元素（自动滚动到可视区域） |
| ChromeRelayType | 在输入框中输入文字，可选按 Enter |
| ChromeRelayScreenshot | 截取标签页截图用于视觉分析 |
| ChromeRelayRead | 将页面内容读取为 Markdown（使用 Readability） |
| ChromeRelayReadDom | 列出所有可交互元素（按钮、链接、输入框）及选择器提示 |
| ChromeRelayEval | 在页面上下文中执行 JavaScript |
| ChromeRelayScroll | 上下滚动页面 |
| ChromeRelayBack | 浏览器后退 |
| ChromeRelayForward | 浏览器前进 |
使用示例
利用已有的登录状态浏览
"帮我看看 GitHub 上有没有新的通知"
"打开我的 Gmail，帮我总结最新的邮件"
"去我的 Jira 看板，列出未关闭的工单"AI 使用你现有的 Chrome 会话，无需重新登录。
与页面交互
"在 Google 搜索 'TypeScript 最佳实践'"
"点击第一条搜索结果"
"帮我填写这个联系表单"读取和提取内容
"读取当前标签页的文章并总结"
"列出这个页面上所有的链接"
"对当前页面截个图"Chrome Relay vs 内置浏览器
| Chrome Relay | 内置浏览器 | |
|---|---|---|
| 浏览器 | 你真实的 Chrome | Electron 窗口 |
| 会话/Cookies | 保留已有登录 | 干净会话 |
| 需要扩展 | 是 | 否 |
| 适用场景 | 需要已登录账户的操作 | 通用浏览 |
TIP
如果你需要操作已登录的网站（Gmail、GitHub、Jira 等），使用 Chrome Relay。对于不需要认证的通用浏览或搜索，内置浏览器工具即可。
设置项
所有 Chrome Relay 设置位于 设置 → Chrome Relay：
| 设置项 | 描述 |
|---|---|
| Connection Status | 显示扩展是否已连接 |
| Auth Token | 用于认证扩展的令牌（可复制、重新生成） |
| Launch Chrome | 一键启动带扩展的 Chrome |
| Manual Install | 手动安装的分步说明 |
| Attached Tabs | 已建立调试器会话的标签页列表 |
常见问题
扩展显示 OFF（红色徽章）
- 确认 Alma 正在运行且端口 23001 可用
- 检查 Alma 设置和扩展 Options 中的 Auth Token 是否一致
- 点击扩展弹窗中的 Reconnect
点击 "Launch Chrome with Extension" 没反应
- 先完全关闭 Chrome（包括后台进程）
- macOS 上可在活动监视器中检查是否有残留的 Chrome 进程
- 改用手动安装方式
AI 没有使用 ChromeRelay 工具
- 在提示中明确说"用我的 Chrome 浏览器"或"在我真实的浏览器里操作"
- AI 会根据上下文区分 ChromeRelay（真实 Chrome）和 Browser（Electron 窗口）
扩展频繁断开
- Chrome 可能会挂起 Service Worker；扩展使用 keep-alive 定时器来防止这种情况
- 如问题持续，检查防火墙对 localhost 连接的设置
- 尝试在 Alma 设置中重新生成 Auth Token
重新生成 Token 后扩展断开
这是正常行为。重新生成后：
- 打开扩展弹窗 → Settings
- 输入新的 Token
- 点击 Save