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.
• 각 단계가 반영되었는지 확인하기 위해 스냅샷, 작업, 재스냅샷을 수행하십시오.
• 구매, 메시지 전송, 양식 제출, 삭제 등 중요한 작업 전에 확인하십시오.