GITHUB ↗ NPM ↗
PLATFORMS · 平台支持现状

Windows 能用了，Linux 还没验

Windows 插件模式已经支持——注册表 + 命名管道 + .bat 启动器都做完了， 装法和 macOS 完全一样。还没做的是 Windows 上的 CLI / headless 模式； Linux 的代码路径写了，但没有在真机上验过。这一页逐条讲清楚每个平台现在到哪一步。

macOS 完整实测 · Windows 插件模式可用 · Linux 未验证

三个平台，各到哪一步

按「装上之后能不能真的用起来」说，不按代码写没写说。

  • macOS ✅ 完整实测——插件模式和 CLI / headless 模式都跑通， 日常开发和全部端到端测试都在这上面。
  • Windows ✅ 插件模式可用——native host 清单写注册表、 进程间通信换成命名管道、启动器是 .bat， 桥接的第一道防线由目录权限换成了令牌。 CLI / headless 模式（AGENT_IN_CHROME_LAUNCH=1）在 Windows 上还没支持。
  • Linux ⚠️ 代码路径已写、未验证——按 XDG 目录放 native host 清单， 理论上和 macOS 同一条路，但没有在真机上跑过完整流程。撞上问题请开 issue， 带上 check 的输出。
扩展本身在哪个系统上都一样——它是纯 JavaScript，平台差异全在本机那一端。 代码全部开源，欢迎直接来一个 PR。

装法：和 macOS 一模一样

需要 Node.js 18+ 和 Chrome 125+。两步，第二步必须手动。

npx @liang-hz/agent-in-chrome@latest install
npx @liang-hz/agent-in-chrome check

然后打开 chrome://extensions → 开启开发者模式 → 「加载已解压的扩展程序」→ 选安装器最后打印的那个目录 （%USERPROFILE%\.agent-in-chrome\extension）。 扩展还没上架应用商店，所以这一步省不掉。

看完整快速开始 → 装不上就开 issue ↗

Windows 上当初难在哪

留一份记录：这三件事在 Windows 上是另一套机制，是重做而不是改路径。现在都做完了。

  • 启动脚本：macOS / Linux 是 .sh，Windows 换成了 .bat，MCP 那侧用 cmd /c 拉起。
  • 浏览器怎么找到本机程序：macOS / Linux 是往目录里放一个 json 清单文件； Windows 必须写注册表（HKCU\Software\Google\Chrome\NativeMessagingHosts）。
  • 进程间通信：Unix domain socket 在 Windows 上不存在，换成了命名管道； 目录权限那道防线也随之换成令牌校验。

怎么第一时间知道有新版

Windows 的 CLI 模式、Linux 的实测结论，都会跟着版本一起发。