openinterpreter/qa-testing

QA 測試 - 透過實際驅動來驗證

在您建置或修改應用程式或網站之後，不要假設它可以正常運作。請實際驅動它並進行檢查。

1. 需要網路 - 請先檢查

安裝這些工具和載入頁面需要對外網路連線，而沙箱可能會封鎖。請先執行任何其他操作之前進行檢查：

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

如果顯示 network blocked，請停止並告訴使用者：

我需要網路存取權限才能安裝和執行測試工具。請執行 /permissions 並選擇允許網路的存取層級，然後再問我一次。

2. 網頁應用程式和網站 - 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。
• 擷取快照、動作，然後再次擷取快照，以確認每個步驟已成功執行。
• 在執行具影響力的動作（例如購買、傳送訊息、提交表單或刪除）之前請先確認。