A shot-scraper 1.10 kiadásával megjelent egy új parancs, shot-scraper video, amely egy storyboard.yml fájlt fogad bemenetként, és a benne leírt műveletsort lefuttatva Playwright segítségével videofelvételt készít a böngészőben végzett lépésekről. A fejlesztő korábban érvelt amellett, hogy a kódoló ügynököknek (coding agents) képesnek kell lenniük demonstrációk előállítására; ez az új parancs ennek az igénynek a kielégítésére tett lépés.
Gyakorlati példa: Datasette demo
A cikk szerzője bemutatott egy példavideót, amely egy még fejlesztés alatt álló funkciót mutat be: CSV, TSV vagy JSON adat beillesztéséből új táblák létrehozása a Datasette-ben. A videót a következő parancs futtatásával hozták létre:
shot-scraper video datasette-bulk-insert-storyboard.yml --auth datasette-demo-auth.json --mp4
A --auth JSON fájl egy sütit (cookie) tartalmaz a dokumentáció szerint, amely a hitelesítéshez szükséges. A konkrét storyboard YAML fájl részletes műveletsort definiál: megnyitja a helyi fejlesztői szervert, kattintásokat és űrlapkitöltéseket hajt végre, várakozásokat és előnézeti lépéseket tartalmaz, majd ellenőrzi, hogy a várt sorok illetve új tábla megjelentek-e.
A storyboard létrehozása: GPT és Pydantic
A bemutató YAML storyboardot teljes egészében egy GPT-5.5 xhigh modell készítette Codex Desktop környezetben. A fejlesztő a modell által előállított YAML formátumot Pydantic segítségével definiálta és validálta, hogy könnyebb legyen a formátum tervezésének és ellenőrzésének áttekintése.
A szerző megjegyzi, hogy a parancs --help kimenete elegendő részletet szolgáltat ahhoz, hogy egy kódoló ügynök használni tudja a parancsot — ez a minta hasonlít arra a megközelítésre, mintha magába a eszközbe egy SKILL.md fájlt csomagolnának. Ugyanezt a mintát alkalmazta korábban a showboat és rodney projekteknél.
Műszaki kihívások és Playwright verziók
A shot-scraper Playwrightra épül, és az egyik kulcskérdés az volt, hogy a Playwright képes legyen olyan minőségben és vezérléssel videót rögzíteni, amely alkalmas termékdemók készítésére. Korábban a Playwright által előállított videók tartalmaztak fejlesztéshez hasznos, de bemutatóhoz nem kívánatos „chrome”-elemeket, illetve a felvétel a böngésző első URL betöltése előtt indult, ami néhány fehér képkockát eredményezett a videó elején.
A Playwright 1.59-es kiadása egy új screencast mechanizmust hozott, amely finomabb vezérlést ad a videórögzítés fölött, de az ebből származó felvételek kezdetben 800px szélességre voltak rögzítve. A problémát egy PR javította, amely a forráshoz bekerült, de még nem volt kiadva. A szerző szerint ezt a javítást a napokban elérhetővé tették a playwright-python 1.61.0 kiadásban, és ez tette lehetővé a feature befejezését.
A fejlesztési folyamat: modell, iteráció, dokumentáció
A tényleges kódot a szerző szerint szintén a GPT-5.5 xhigh írta Codex Desktopban. A modell dokumentációt is generált a parancshoz, ami hasznos keretet biztosított a tervezés áttekintéséhez: a legtöbb iteráció a dokumentáció átnézése és a tervezési hiányosságok, következetlenségek javítása alapján történt.
A szerző elismeri, hogy ez egy olyan funkció, amelyet valószínűleg nehezebben vállalt volna be modell-támogatás nélkül: az eredeti issue-t február 2024-ben nyitotta meg, és sokáig nem talált rá időt más projekteken kívül.
Összegzés
A shot-scraper 1.10 video parancsa lehetővé teszi, hogy storyboard YAML alapján automatikusan rögzítsünk böngészőműveleteket és készítsünk demonstrációs videókat. A megoldás megalkotásában fontos szerepet játszottak a Playwright fejlesztései, a generatív modell (GPT-5.5 xhigh) és a Pydantic alapú formátumellenőrzés. A bemutató példák — köztük a Datasette demo — illusztrálják, hogyan lehet ezt a parancsot fejlesztői szerver ellen futtatva használni.
Tags: projects, python, yaml, ai, datasette, playwright, shot-scraper, generative-ai, llms, pydantic, coding-agents, agentic-engineering
