Windows 上 agent-browser 使用问题排查与解决

news/2026/1/22 23:38:30/文章来源:https://www.cnblogs.com/kissazi2/p/19519316

背景

agent-browser 是 Vercel 推出的一个 AI 浏览器自动化工具，它允许通过自然语言控制浏览器进行自动化操作。在 macOS 和 Linux 上安装使用都很顺利，但在 Windows 上遇到了一些坑。本文记录了完整的排查与解决过程。

环境信息

操作系统: Windows 11
Node.js: 已安装
安装方式: npm install -g agent-browser
Git for Windows: 已安装（Git Bash 位于 C:\Program Files\Git\）

问题一：安装 Chromium 浏览器失败

现象

> agent-browser install

报错：

&: C:\Users\<YourUsername>\AppData\Roaming\npm\agent-browser.ps1:24
Line |24 |      & "/bin/sh$exe"  "$basedir/node_modules/agent-browser/bin/agent-b …|        ~~~~~~~~~~~~~| The term '/bin/sh.exe' is not recognized as a name of a cmdlet, function, script file, or executable

排查过程

首先查看 npm 生成的 PowerShell 脚本：

# 文件位置: C:\Users\<YourUsername>\AppData\Roaming\npm\agent-browser.ps1

脚本内容（npm 自动生成）：

#!/usr/bin/env pwsh
$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent$exe=""
if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {$exe=".exe"
}
$ret=0
if (Test-Path "$basedir//bin/sh$exe") {if ($MyInvocation.ExpectingInput) {$input | & "$basedir//bin/sh$exe"  "$basedir/node_modules/agent-browser/bin/agent-browser" $args} else {& "$basedir//bin/sh$exe"  "$basedir/node_modules/agent-browser/bin/agent-browser" $args}$ret=$LASTEXITCODE
} else {# 问题出在这里！if ($MyInvocation.ExpectingInput) {$input | & "/bin/sh$exe"  "$basedir/node_modules/agent-browser/bin/agent-browser" $args} else {& "/bin/sh$exe"  "$basedir/node_modules/agent-browser/bin/agent-browser" $args}$ret=$LASTEXITCODE
}
exit $ret

问题分析：脚本硬编码了 Unix 风格的 /bin/sh 路径，Windows 上不存在该路径。
确认 Git Bash 的 sh.exe 位置：

> where sh.exe
C:\Program Files\Git\usr\bin\sh.exe

解决方案

将脚本中的 /bin/sh$exe 替换为 Git Bash 的完整路径。

修改前（第 22-24 行）：

  if ($MyInvocation.ExpectingInput) {$input | & "/bin/sh$exe"  "$basedir/node_modules/agent-browser/bin/agent-browser" $args} else {& "/bin/sh$exe"  "$basedir/node_modules/agent-browser/bin/agent-browser" $args}

修改后：

  if ($MyInvocation.ExpectingInput) {$input | & "C:\Program Files\Git\usr\bin\sh.exe"  "$basedir/node_modules/agent-browser/bin/agent-browser" $args} else {& "C:\Program Files\Git\usr\bin\sh.exe"  "$basedir/node_modules/agent-browser/bin/agent-browser" $args}

验证

> agent-browser install
Installing Chromium browser...
✓ Chromium installed successfully

问题二：运行命令时报错 Unix 命令未找到

现象

> agent-browser open www.baidu.com

报错：

C:\Users\<YourUsername>\AppData\Roaming\npm/node_modules/agent-browser/bin/agent-browser: line 11: dirname: command not found
C:\Users\<YourUsername>\AppData\Roaming\npm/node_modules/agent-browser/bin/agent-browser: line 13: uname: command not found
C:\Users\<YourUsername>\AppData\Roaming\npm/node_modules/agent-browser/bin/agent-browser: line 13: tr: command not found
Error: No binary found for -
Run 'npm run build:native' to build for your platform

排查过程

查看 shell 包装脚本的内容：

# 文件位置: C:\Users\<YourUsername>\AppData\Roaming\npm\node_modules\agent-browser\bin\agent-browser

#!/bin/sh
# agent-browser CLI wrapper
# Detects OS/arch and runs the appropriate native binarySCRIPT="$0"
while [ -L "$SCRIPT" ]; doSCRIPT_DIR="$(cd "$(dirname "$SCRIPT")" && pwd)"SCRIPT="$(readlink "$SCRIPT")"case "$SCRIPT" in /*) ;; *) SCRIPT="$SCRIPT_DIR/$SCRIPT" ;; esac
done
SCRIPT_DIR="$(cd "$(dirname "$SCRIPT")" && pwd)"# 需要这些 Unix 命令
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
ARCH=$(uname -m)
case "$OS" in darwin) OS="darwin" ;; linux) OS="linux" ;; mingw*|msys*|cygwin*) OS="win32" ;; esac
case "$ARCH" in x86_64|amd64) ARCH="x64" ;; aarch64|arm64) ARCH="arm64" ;; esacBINARY="$SCRIPT_DIR/agent-browser-${OS}-${ARCH}"if [ -f "$BINARY" ] && [ -x "$BINARY" ]; thenexec "$BINARY" "$@"
fiecho "Error: No binary found for ${OS}-${ARCH}" >&2
echo "Run 'npm run build:native' to build for your platform" >&2
exit 1

问题分析：脚本需要 dirname、uname、tr 等 Unix 命令来检测操作系统和架构。虽然 Git Bash 提供了这些命令，但脚本在检测 Windows 环境时可能失败。
检查实际存在的二进制文件：

> ls C:\Users\<YourUsername>\AppData\Roaming\npm\node_modules\agent-browser\bin\
agent-browser-darwin-arm64
agent-browser-darwin-x64
agent-browser-linux-arm64
agent-browser-linux-x64
agent-browser-win32-x64.exe    # ← Windows 的二进制文件是存在的！

解决方案

既然 Windows 的二进制文件已经存在，我们可以让 PowerShell 脚本直接调用 Windows 二进制文件，完全绕过 shell 脚本的 OS 检测逻辑。

完整的修改后脚本

用以下内容完整替换 C:\Users\<YourUsername>\AppData\Roaming\npm\agent-browser.ps1：

#!/usr/bin/env pwsh
$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent# Windows binary path
$binary="$basedir/node_modules/agent-browser/bin/agent-browser-win32-x64.exe"$ret=0
if (Test-Path $binary) {# Support pipeline inputif ($MyInvocation.ExpectingInput) {$input | & $binary @args} else {& $binary @args}$ret=$LASTEXITCODE
} else {Write-Error "Error: agent-browser Windows binary not found at $binary"$ret=1
}
exit $ret

脚本修改说明

原脚本逻辑	新脚本逻辑
通过 sh.exe 调用 shell 脚本	直接调用 .exe 二进制文件
shell 脚本检测 OS/架构	硬编码 Windows 路径
可能因命令缺失失败	无需外部命令，更可靠

验证

> agent-browser open www.baidu.com
✓ 百度一下，你就知道https://www.baidu.com/

成功！

完整对比

原始脚本（npm 生成）

#!/usr/bin/env pwsh
$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent$exe=""
if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {$exe=".exe"
}
$ret=0
if (Test-Path "$basedir//bin/sh$exe") {if ($MyInvocation.ExpectingInput) {$input | & "$basedir//bin/sh$exe"  "$basedir/node_modules/agent-browser/bin/agent-browser" $args} else {& "$basedir//bin/sh$exe"  "$basedir/node_modules/agent-browser/bin/agent-browser" $args}$ret=$LASTEXITCODE
} else {if ($MyInvocation.ExpectingInput) {$input | & "/bin/sh$exe"  "$basedir/node_modules/agent-browser/bin/agent-browser" $args} else {& "/bin/sh$exe"  "$basedir/node_modules/agent-browser/bin/agent-browser" $args}$ret=$LASTEXITCODE
}
exit $ret

修改后脚本

#!/usr/bin/env pwsh
$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent# Windows binary path
$binary="$basedir/node_modules/agent-browser/bin/agent-browser-win32-x64.exe"$ret=0
if (Test-Path $binary) {# Support pipeline inputif ($MyInvocation.ExpectingInput) {$input | & $binary @args} else {& $binary @args}$ret=$LASTEXITCODE
} else {Write-Error "Error: agent-browser Windows binary not found at $binary"$ret=1
}
exit $ret