Chrome Actuator

非官方伴侣：从智能体驱动你已经打开的 Chrome 窗口 （已在 Grok Build 上测试）。新工作会落在当前会话中一个粉色的 Actuator 标签组里，而不是新的 Chrome 窗口。

tabs_create → snapshot → press @e12 / fill @e5 "text" → settle

v1 是一个执行器，而不是侧面板聊天机器人。智能体留在终端中。扩展程序能看到页面，分配 @eN 引用，并执行点击/输入。你的 Cookie 和登录状态保留在 Chrome 中。

与 xAI 无关联、未经其认可或赞助。 “Grok”和“Grok Build”是 xAI 的商标，此处仅用于描述兼容性。参见 NOTICE。

状态

阶段 0–3 已完成。pnpm gauntlet 涵盖单元测试、内容脚本执行器以及通过原生消息传递驱动的实时 Chromium 标签页。

Related MCP server: login-mcp

加载扩展

cd /path/to/chrome-actuator
pnpm install
pnpm --filter @chrome-actuator/extension build

1. 打开 chrome://extensions

2. 启用开发者模式

3. 加载已解压的扩展程序 → packages/extension/dist

4. 固定扩展程序并点击它（或按 Cmd+Shift+G）

然后注册原生主机（仅一次）并完全退出 Chrome：

node packages/host/dist/install.js

插件安装时的 --trust 允许智能体操作此 Chrome 配置文件。仅在你信任该智能体时才这样做。

grok plugin install ./packages/plugin --trust

一旦 MCP 主机运行，侧面板应显示 connected。

pnpm gauntlet   # unit + L3 + live native-messaging L4

稳定的已解压 ID（来自已提交的 manifest key）：lgkcgenkjaalkfnpmglgpfclkaokblfj

我们不会重新讨论的决定

• 大脑在智能体，身体在 Chrome。v1 中没有扩展内 LLM 循环。

• 使用原生消息传递，而非 WebSocket、Playwright 或 agent-device-the-binary。

• agent-device 契约仅限于 snapshot / press / fill。

• v1 中不使用 chrome.debugger（无黄色信息栏）。

• 独立实现。不要将其他供应商的品牌、商标或逆向工程内部代码复制到此仓库中。

布局

packages/shared      protocol, snapshot grammar, target parser
packages/extension   MV3 side panel + service worker
packages/host        MCP + native host
packages/plugin      Grok Build plugin (compatibility layer)

测试

pnpm --filter @chrome-actuator/shared test

许可证

MIT。参见 LICENSE 和 NOTICE。