Windows 上 agent-browser daemon 无法启动怎么排查？

Windows 上 agent-browser daemon 无法启动怎么排查【免费下载链接】ArchonThe first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.项目地址: https://gitcode.com/GitHub_Trending/archon3/Archon在 Windows 上给 Archon 跑 E2E 测试时agent-browser open报出 daemon 无法启动Daemon failed to start 一类现象是最常见的卡点。原因在文档中已明确agent-browser 在 Windows 上存在已知的上游 bugdaemon 因 Unix domain socket 不兼容而无法启动。本文给出的排查与解决路径是先区分症状确认环境然后把 agent-browser 跑进 WSL、让开发服务器留在 Windows 上最后验证 WSL 能访问到 Windows 主机上的服务并正常驱动浏览器。先区分症状命令找不到还是 daemon 启动失败Archon 的 troubleshooting 参考文档 把两种情况分开处理排查前先看错误属于哪一种agent-browser: command not found说明根本没装agent-browser 是 Archon 的可选外部依赖核心功能不依赖它。安装方式# Install globally npm install -g agent-browser # Download browser engine (Chrome for Testing) agent-browser install命令存在但 daemon 启动失败在 macOS/Linux 上可以直接杀掉残留 daemon 重试pkill -f daemon.js但在 Windows 上这是已知 bug杀进程解决不了需要走 WSL 绕行方案即本文后续步骤。以下路径以 Windows WSL2 为前提。准备条件WSL2 里装好 agent-browser按 E2E Testing on WSL 的前置要求已安装 WSL2 且里面有 Ubuntu用下面命令确认wsl --list --verbose后续命令里的wsl -d Ubuntu --都假设发行版名为Ubuntu如果你的发行版名不同需要相应替换。在 WSL 里安装 agent-browsernpm install -g agent-browser安装 Playwright chromiumagent-browser install --with-deps注意--with-deps需要 sudo会安装系统依赖请确认你有权限再执行。找到 WSL 能访问的 Windows 主机 IPWSL2 里localhost指向的是 WSL 自身而不是 Windows 主机所以必须拿到 Windows 主机 IP后续所有地址都用它。文档给了两种查法ipconfig | findstr IPv4 | findstr WSL # 文档示例输出: IPv4 Address. . . . . . . . . . . : 172.18.64.1或者从 WSL 内部读 DNS 配置wsl -d Ubuntu -- bash -c cat /etc/resolv.conf | grep nameserver172.18.64.1是文档中的示例值不是固定预期。你机器上的 IP 以实际命令输出为准下文命令中出现的172.18.64.1都替换成你查到的 IP。在 Windows 上启动开发服务器并确认 WSL 能连通开发服务器跑在 Windows 上但必须绑定到所有网卡0.0.0.0否则 WSL 访问不到# Backend (Hono on port 3090) - already binds to 0.0.0.0 by default bun run dev:server # Frontend (Vite on port 5173) - needs --host flag cd packages/web bun x vite --host 0.0.0.0 后端 3090 端口默认就绑 0.0.0.0不需要额外参数Vite 默认只绑localhost必须加--host 0.0.0.0这是 WSL 场景下最常见的连通性陷阱。然后从 WSL 侧验证两个服务都能访问把172.18.64.1换成你的主机 IPwsl -d Ubuntu -- curl -s http://172.18.64.1:3090/api/health wsl -d Ubuntu -- curl -s -o /dev/null -w %{http_code} http://172.18.64.1:5173健康检查能返回内容、5173 返回 HTTP 状态码说明 WSL 到 Windows 的网络链路通了可以继续下一步。通过 WSL 前缀运行 agent-browser 命令所有 agent-browser 命令都在 Windows 终端里执行统一加wsl -d Ubuntu --前缀把命令送进 WSL 执行# Open a page wsl -d Ubuntu -- agent-browser open http://172.18.64.1:5173 # Take interactive snapshot (get element refs like e1, e2) wsl -d Ubuntu -- agent-browser snapshot -i # Click, fill, press wsl -d Ubuntu -- agent-browser click e1 wsl -d Ubuntu -- agent-browser fill e2 some text wsl -d Ubuntu -- agent-browser press Enter # Wait for content to load wsl -d Ubuntu -- agent-browser wait 3000 # Reload page (hard refresh) wsl -d Ubuntu -- agent-browser reload # Close browser wsl -d Ubuntu -- agent-browser closee1、e2是snapshot -i给出的元素引用按快照输出替换。如果agent-browser open在 WSL 里仍然报 Daemon failed to start残留 daemonwsl -d Ubuntu -- pkill -f daemon.js副作用说明pkill -f daemon.js会在该 WSL 发行版内杀掉所有匹配daemon.js的进程即旧的 agent-browser daemon然后重新执行open命令重试即可。验证结果版本与冒烟测试来自 E2E Testing Guideagent-browser --version # Expected: prints version number (e.g., 0.x.x) # Quick smoke test — opens a page and closes agent-browser open https://example.com agent-browser close在 Windows 上执行时同样加wsl -d Ubuntu --前缀。页面上的 SSE 状态指示器只有web平台的会话显示ConnectedTelegram/Slack 会话显示Disconnected是预期行为不要据此误判连通性失败。截图路径与其余已知坑截图不能直接存到/mnt/c/。文档建议先存到 WSL 原生路径再拷贝出去因为 agent-browser 的 Node.js 进程在某些环境下会把/mnt/c/路径改写坏例如前置拼上C:/Program Files/Git/。下面的命令中/home/user/screenshot.png是 WSL 里的临时路径/path/to/archon/e2e-screenshots/my-test.png需要替换成你 WSL 内 Archon 项目的实际路径# Save to WSL home, then copy to project wsl -d Ubuntu -- bash -c agent-browser screenshot /home/user/screenshot.png 21 cp /home/user/screenshot.png /path/to/archon/e2e-screenshots/my-test.png Git Bash 路径展开通过 Git Bash 传参时/status这类以/开头的参数会被 shell 展开成C:/Program Files/Git/status。这不是 agent-browser 的问题是 Git Bash 的路径展开行为换终端或给参数加引号即可。agent-browser 缺席时的行为未安装 agent-browser 时E2E workflow 节点会在调用agent-browser时失败。AI agent 通过 prompt 被要求在 2 次连接失败后停止并只产出 code-review 报告但这只是 prompt 级指令不是自动化逻辑实际表现取决于模型对指令的遵循程度。所有非 E2E workflow 不安装 agent-browser 也能安全运行。更多 Windows 平台的一般性设置WSL2 安装、文件路径选择等可参考 Windows Setup 文档E2E 测试的完整背景见 E2E Testing。【免费下载链接】ArchonThe first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.项目地址: https://gitcode.com/GitHub_Trending/archon3/Archon创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考