openinterpreter/qa-testing

QA 测试 - 通过实际操作进行验证

在您构建或更改应用或网站后，不要假定其工作正常。请实际操作并检查。

1. 需要网络 - 首先检查

安装这些工具和加载页面需要出站网络，沙箱可能会阻止。先做如下检查：

curl -fsI https://github.com >/dev/null 2>&1 && echo "network ok" || echo "network blocked"

如果输出 network blocked，请停止并告知用户：

我需要网络访问权限来安装和运行测试工具。请运行 /permissions 并选择一个允许网络访问的级别，然后再次询问我。

2. Web 应用和网站 - agent-browser

在 macOS/Linux 上，优先直接使用预构建的二进制文件：

if ! command -v agent-browser >/dev/null; then
  os=$(uname -s | tr '[:upper:]' '[:lower:]'); m=$(uname -m)
  case "$os/$m" in
    darwin/arm64)              asset=agent-browser-darwin-arm64 ;;
    darwin/x86_64)             asset=agent-browser-darwin-x64 ;;
    linux/aarch64|linux/arm64) asset=agent-browser-linux-arm64 ;;
    linux/x86_64)              asset=agent-browser-linux-x64 ;;
  esac
  mkdir -p ~/.local/bin
  curl -fL "https://github.com/vercel-labs/agent-browser/releases/latest/download/$asset" -o ~/.local/bin/agent-browser
  chmod +x ~/.local/bin/agent-browser
fi
agent-browser install
agent-browser skills get core

在 Windows 上，使用包安装程序，因为它会下载匹配的本机二进制文件：

if (-not (Get-Command agent-browser -ErrorAction SilentlyContinue)) {
  npm install -g agent-browser
  $env:Path = "$env:APPDATA\npm;$env:Path"
}
agent-browser install
agent-browser skills get core

然后使用该工具的维护指南：agent-browser open <url>，获取快照，对元素引用进行操作，并再次获取快照。

3. 本地桌面应用 - cua-driver

macOS/Linux：

command -v cua-driver >/dev/null || /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.sh)"
cua-driver list-tools

Windows PowerShell：

if (-not (Get-Command cua-driver -ErrorAction SilentlyContinue)) {
  irm https://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.ps1 | iex
  $env:Path = [Environment]::GetEnvironmentVariable('Path', 'User') + ';' + [Environment]::GetEnvironmentVariable('Path', 'Machine')
}
cua-driver list-tools

对于本地应用，在操作后验证真实的状态变化。仅仅报告成功的点击命令是不够的。捕捉初始状态、执行操作、然后捕捉操作后的状态，并比较可见文本、计数器、状态标签、选中状态、输入值或屏幕截图证据。

Windows PowerShell 命令规范

许多 Windows 主机仍运行 Windows PowerShell 5.1，其中 && 不是有效的语句分隔符。请使用单独的命令、分号或显式的 if ($LASTEXITCODE -eq 0) { ... } 检查。对以 @ 开头的工具参数，尤其是 agent-browser 引用，请使用引号包裹。

原则

• 首先检查网络。
• 安装前使用 command -v。
• 在 macOS/Linux 上，优先使用直接的二进制文件（如果可用）。
• 参考每个工具自身的文档：agent-browser skills get core 和 cua-driver list-tools。
• 快照、操作、再快照，以确认每个步骤都执行成功。
• 在执行购买、发送消息、提交表单或删除等重大操作前，请先确认。