QAwalk

Všichni průvodci › Podle použití

Podle použití

Desktopové aplikace: Electron a macOS aplikace na stejné plachtě

QAwalk otevře Electron aplikace přes Playwright se všemi webovými kontrolami, zachytí okna macOS aplikací i se stromem přístupnosti a importuje obrazovky z jakéhokoli jiného nástroje, takže desktopová flow projdou stejným review jako web a mobil.

Desktopovou aplikaci před releasem často nikdo neprojde: webová verze dostane review, Electron obal jen smoke test. QAwalk bere okno desktopové aplikace jako každou jinou obrazovku.

Problém

Desktopové releasy se kontrolují tak, že někdo aplikaci otevře a proklikne. Nic se nezaznamená, nic se neporovná s minulým releasem a lokalizovaná menu či dialogy jako první vidí zákazníci.

Co se s QAwalkem změní

platform: electron otevře aplikaci přes Playwright. Její okno je pro QAwalk webová stránka, takže selektory, kontroly přístupnosti, chyby v konzoli i sémantické otázky fungují beze změny. platform: desktop zachytí okno macOS aplikace se stromem přístupnosti (nebo s textem, který na něm je). Každá obrazovka má na plachtě rámeček okna, vedle webových a mobilních běhů stejné funkce.

Jak to funguje

  1. Pojmenujte aplikaci

    app.electron.main: dist/main.js (nebo zabalený spustitelný soubor), případně app.desktop.name: Notes pro macOS aplikaci.

  2. Naskriptujte kroky

    kroky v Electronu dostanou Playwright page, takže funguje app.tap('#new') i jakýkoli Playwright kód. Kroky v macOS ovládá váš nástroj, AppleScript nebo člověk a QAwalk zachytí okno.

  3. Zkontrolujte

    packy a11y a console platí pro Electron stejně jako na webu. Pack app hlídá v oknech macOS popisky, velikosti a useknuté texty.

  4. Review a porovnání

    plachta ukáže každý krok v rámečku okna. Běh dalšího releasu se porovná obrazovku po obrazovce s přijatým referenčním během.

Skilly a prompty

Projdi naši Electron aplikaci v en a cs: prázdný stav, vytvoření poznámky a dialog nastavení. Použij pack a11y a běh nasdílej na review.
Po každé změně v tomhle PR zachyť okno předvoleb naší macOS aplikace a řekni mi, které popisky se v češtině usekly.

Očekávaný výsledek: obrazovky v rámečcích oken pro každý jazyk s kontrolami, chyby v konzoli z rendereru a porovnání s předchozím releasem.

Co získáte

FAQ

Aplikace pro Windows a Linux?

Vestavěné zachycení okna funguje jen na macOS. Na Windows a Linuxu aplikaci ovládejte přes WinAppDriver, Appium nebo vlastní nástroj a screenshot (případně s UI dumpem) importujte přes qawalk capture --image.

Jaká oprávnění macOS potřebuje?

Nahrávání obrazovky pro snímky oken a Zpřístupnění pro UI strom, udělená terminálu nebo aplikaci agenta. Bez Zpřístupnění QAwalk použije rozpoznání textu.

Další průvodci

Akceptace tasku s AI agentem přímo v pull requestuRegrese před releasem: porovnání běhu s přijatým referenčním běhemSEO a kontrola landing pages na produkci, jen pro čtení, každý denE‑mailové flow: zachyťte zprávu vedle obrazovky, která ji poslala

Instalace ve třech krocích

QAwalk běží tam, kde je váš kód a váš agent. Služba výsledky ukládá a verzuje, zobrazuje plachtu a sbírá schválení.

  1. Přidejte CLI do projektu
    npm install --save-dev @qawalk/cli

    Potřebuje Node 20 nebo novější. Aktualizace později přes npm update @qawalk/cli.

  2. Vytvořte konfiguraci a nainstalujte skill
    npx qawalk init --agent claude --org <your-org>
    npx qawalk doctor

    Skill se zkopíruje do .claude/skills/qawalk.

  3. Založte organizaci a vytvořte token

    Založte organizaci, stanete se jejím adminem. Úvodní stránka nabídne token s rolí tester jedním kliknutím, později ho najdete v Nastavení → API tokeny. Uložte ho do .env projektu:

    QAWALK_TOKEN=qwk_…
    TYPESAFE_API_KEY=…   # optional: semantic evaluator
  4. Spusťte a nasdílejte
    npx qawalk start --scenario docs/tasks/TASK-123/qa/scenario.yml --env local
    npx qawalk walk        # playwright steps; agent/manual steps: qawalk capture
    npx qawalk evaluate
    npx qawalk share --pr

    Nebo požádejte agenta: “Projdi akceptační plán TASK-123 s QAwalk na localu a nasdílej výsledek.”