# Rozšíření prohlížeče (https://docs.vitrinka.ai/cs/qa/extension) ## Instalace [#install] CLI rozbalí vydané rozšíření a zaregistruje native-messaging hosta, díky kterému se rozšíření samo aktualizuje: ```bash vitrinka setup extension setup # rozbalí vydání z marketplace, zaregistruje aktualizačního hosta vitrinka setup extension update # prohodí složku za nejnovější vydání; rozšíření se samo znovu načte vitrinka doctor # ohlásí každý článek aktualizačního řetězce ``` `vitrinka setup` nabízí stejný krok; `--extension` ho přijme bez ptaní a `--no-extension` ho přeskočí. Načtení složky rozšíření jako rozbalené v `chrome://extensions` je vývojářská cesta. ## Nasměrujte ho na svůj server [#options] Otevřete **Options** rozšíření (pravý klik na ikonu). S nainstalovaným CLI je vyplní native host. * **Base URL** — adresa serveru, kam se ukládají nahrávky. * **Link this browser** — vitrinka ukáže krátký kód; schvalte ho v přihlášené záložce (nebo naskenujte QR telefonem) a vyberte workspace. Rozšíření dostane token rekordéru, který v něm umí jen zakládat sezení a přidávat do těch, která sám založil; vyprší 30 dní po posledním použití a odvoláte ho v **Nastavení → Tokens**. * **Advanced — workspace and token by hand** — osobní token `vkp_`, který jedná v každém workspace, kde jste členem: vyplňte **Workspace**, nebo pole nechte prázdné a každá nahrávka si workspace odvodí z hostitele záložky. **Save & test** ověří spojení; **Fill from the vitrinka CLI** znovu načte server a token z CLI, když uložené zastaraly. Tokeny se ukládají ve vlastním úložišti rozšíření, nikdy ve stránce. ## Která záložka patří ke kterému projektu [#domains] Nahrávání se spouští z popupu na každé záložce, jejíž hostitel odpovídá doménovému pravidlu projektu, a ostatní záložky na doménách téhož projektu se k session připojí automaticky. Pravidla žijí u projektu: ```json {"domains": [{"pattern": "*.acme.internal", "environment": "staging"}]} ``` Nastavte je v **Nastavení → Projekty → Routing** — vzor a prostředí pro každé pravidlo ([projekty](/cs/pm/projects#routing)) — nebo na `PUT /api/v1/projects/{project}/settings`; popup ukazuje, na který projekt a prostředí se aktuální záložka rozloží. Záložka, která neodpovídá žádnému pravidlu, session spustit nemůže. Přepínač `"inAppRecorder"` u produkčního pravidla se týká jen [rekordéru ve stránce](/cs/qa/recorder/web#link); rozšíření nahrává produkční záložky tak jako tak. ## Co zachycuje [#captures] Rozšíření zaznamenává snímky, interakce, síťové požadavky a odpovědi přes ladicí protokol, chyby konzole, proud DOM událostí rrweb a vaše poznámky. Podrobnosti a omezení popisují [Maskování citlivých údajů](/cs/security/redaction) a [Co rekordéry zaznamenávají](/cs/qa/recorder/protocol). Nahrávání spouštíte a zastavujete sami, z popupu; během aktivní session může zahrnout i další záložky téhož projektu. ## Během nahrávání [#hud] Na stránce je stejná kapsle jako u [rekordéru v aplikaci](/cs/qa/recorder/web) — tečka a časovač, jejichž nástroje se rozbalí, když na ni najedete nebo ji zaměříte. Přetáhněte ji na jedno z osmi míst (rohy, střed každé strany, střed nahoře a dole), nebo ji vytlačte za okraj a schovejte do záložky; totéž udělají šipky a **Move to** a kapsle si místo pamatuje pro každý web. * `Alt+Shift+A` udělá snap: vyberte prvek nebo táhněte oblast a napište poznámku. Před odesláním zvolte **board** (anotace na snímku), nebo **task** (založí i draft v [příjmu](/cs/pm/intake)). * `Alt+Shift+N` přidá rychlou poznámku k aktuální obrazovce; `Alt+Shift+P` nahrávání pozastaví a znovu spustí; `Alt+Shift+S` ho zastaví. * Štítek synchronizace ukazuje stav — `synced`, jakmile má server všechno, `sending N`, dokud se fronta odesílá, a `offline · N`, dokud je vitrinka mimo dosah. * **■** zastaví nahrávání přímo ze stránky: nejdřív se zeptá, pak ukáže **Saving…** a **Saved · in Recents**, dokud vitrinka nástěnku sestavuje (obvykle do minuty), a potom **Saved · Open board** s odkazem na nástěnku. * **⋯** ukáže, s jakým účtem je prohlížeč propojený, vypíše jeho posledních pět nahrávek na aktuálním serveru a v aktuálním workspace s nástěnkami a nastaví velikost kapsle a zobrazení technických podrobností. * Když server rekordér během nahrávání odmítne — `401` nebo `403`, protože token byl odvolán nebo byl prohlížeč během sezení propojen znovu —, sezení se označí jako mrtvé a všechno, co rozšíření ještě drží, zůstane ve frontě; vymaže ji jen odpověď serveru, že sezení neexistuje, je dokončené nebo smazané. **Stop** v popupu sestaví nástěnku sezení. S osobním tokenem popup také ukáže nedávná sezení projektu a umí na jedno z nich navázat na stejné nástěnce; token rekordéru žádná sezení nevypíše, takže s ním vždy založíte nové. ## Aktualizace [#updates] Rozbalené rozšíření se nikdy neaktualizuje samo. Popup se přes native hosta zeptá CLI, jestli marketplace drží novější vydání; **Update** ho stáhne, ověří kontrolní součet, prohodí složku a rozšíření znovu načte. Bez CLI na stroji popup spadne na banner ke stažení. ## Kdy nahrává [#when] Jen když session výslovně spustíte, a jen proti serveru, který si nastavíte v jeho volbách. Na pozadí nenahrává nic. * **Výslovné session** — nahrávání začíná a končí, když řeknete. * **Jediný cíl** — výhradně adresa vitrinka serveru, kterou nastavíte — žádná cizí telemetrie. * **Čitelný zdroj** — rozšíření je publikované v repozitáři vitrinka-kit, takže si můžete ověřit, co vám na stroji běží.