Elle kaydedilen Chrome uzantısı senaryoları

Elle kayıt, Admin yakalama işi olarak çalışır: Desktop → Web Extension. Dahili ortamı WebExtension; yakalama meta verileri ve herkese açık MCP web-extension kullanır. Aracı seçili Chrome Web Store uzantısını indirir; onunla ve Reconstruct yakalama uzantısıyla geçici bir Chromium profili açar. Gezinmeyi operatör yapar; Reconstruct ekranları ve gözlemlenen geçişleri reconstruct.scene.v1 olarak kaydeder.

İş oluşturma ve çalıştırma

1. Admin → Jobs → Create içinde Desktop → Web Extension seçin. Yalnızca uzantıyı istiyorsanız Web seçimini kaldırın. Mobil ortamlar Web, iOS ve Android olarak kalır.
2. Environment Settings → Web Extension içinde seçili Chrome Web Store bağlantısını yapıştırın. Yerel uzantı dizinleri ve kişisel tarayıcı profilleri girdi olarak kullanılmaz.
3. İşi kuyruğa alın. Desktop / Web Extension atanmış etkin Capture Agent işi sahiplenir. Web ve Web Extension çalışanları birbirlerinin işlerini sahiplenemez.
4. Aracı Google'ın güncelleme hizmetinden imzalı CRX3 indirir; özel iş dizinine çıkarmadan önce seçili uzantı kimliğini ve yayıncı imzasını doğrular. Paket, açılmış olarak yüklendiğinde mağaza kimliğini korur. Yakalama sürümünün meta verisi, doğrulanmış kimlik, yerelleştirilmiş ad, paket sürümü ve SHA-256 ile browserExtension içerir; katalog görünen adı bu paketten gelir. Arşiv yolları, dosya sayıları ve açılmış boyut kullanımdan önce kontrol edilir.
5. Chromium uzantının kendi başlangıç sekmesini açar. Yoksa bildirilen seçenekler sayfası veya eylem açılır penceresi kullanılır. UI giriş noktası olmayan uzantı başarısız olur.
6. Tarayıcının uzantılar menüsünden Reconstruct Agent Browser Bridge açın. Açılır penceresi etkin iş kimliğini ve kaydedilen ekran sayısını gösterir. Her ekrandan sonra Capture screen kullanın. Pause, Resume ve Finish recording kontrollerini oradan kullanın.

Başlatılacak bağımsız kaydedici CLI veya ek kayıt MCP'si yoktur. Kontroller etkin işe ve gizli yerel oturum belirtecine bağlıdır. Alan değerleri, keyfî etiketler veya kaynak URL'leri kabul etmezler. Yöneticiler Admin → Jobs → job → Live browser üzerinden iş tarayıcısını izleyip kontrol edebilir; oradaki girdi yalnızca iş operatörü beklerken kabul edilir. Başka uzantı veya başka iş reddedilir. Uzantı başka sekme açarsa yakalamadan önce etkinleştirin; hedef değiştirmeden önce kimliği kontrol edilir. Parolalar, cüzdan oluşturma, sözleşmeler ve kayıt elle yapılan işlemler olarak kalır.

Giriş işleri ve otomatik keşif

Başlangıç kurulumu gerektiren uzantılar (örneğin MetaMask cüzdan oluşturma) yarı otomatik kaydedilebilir. Environment Settings → Web Extension içinde Sign-in değerini Operator registers (veya Operator signs in) yapın.

1. İş operatörü bekler. Başlangıç kurulumunu Admin → Jobs → job → Live browser içinde veya iş tarayıcısının kendisinde tamamlayın. Ekranları Capture screen ile kaydedin; parola ve kurtarma ifadesi ekranları asla kaydedilmez.
2. Finish sign-in (konsol), Continue (Admin) veya Finish sign-in and explore (Reconstruct açılır penceresi) seçin.
3. Reconstruct daha sonra uzantının açılır pencere, seçenek ve yan panel sayfalarını, gezinme kontrollerinin yönlendirdiği rotaları ziyaret ederek rota başına bir ekran kaydeder. Gönderme, imzalama, onaylama, gösterme, dışa aktarma, kilitleme, silme veya herhangi bir şey oluşturma ihtimali olan kontrollere asla tıklamaz.
4. Uzantı kendini kilitlerse operatör kilidi açıp tekrar Finish sign-in seçeneğini seçene kadar iş Signed out durumunda bekler. Rota kalmadığında veya sayfa sınırına ulaşıldığında kayıt biter ve inceleme için yüklenir.

Web işlerinde de aynı Sign-in ayarı bulunur: giriş ekranları aşama olarak kaydedilir, tarama çıkış bağlantılarını atlar ve oturum sona ererse duraklar. CAPTCHA, SMS kodları ve koşul kabulü her zaman operatöre aittir. Ayrıntılar için backend/docs/operator-sign-in.md dosyasına bakın.

Aracı kurulumu

backend/agent-browser-extensions içinde yarn nx run chrome:build ile eşleşen tarayıcı bağdaştırıcısını derleyin. Ana makine Node.js 24+, Python 3 ve uzantı destekli Chromium sürümü gerektirir. Mevcut Capture Agent'ı sürüm kontrolüne dahil edilmeyen yerel ayarlar veya ortam değişkenleriyle yapılandırın:

{
  "Agent": {
    "Id": "extension-worker",
    "ApiUrl": "https://internal-admin-api.example",
    "ChromiumPath": "/Applications/Chromium.app/Contents/MacOS/Chromium",
    "ExtensionDir": "/checkout/backend/agent-browser-extensions/chrome"
  },
  "WebExtension": {
    "RecorderDirectory": "/checkout/backend/tools/manual-recorder",
    "NodePath": "node",
    "PythonPath": "python3"
  }
}

Mevcut ApiTokens:Agent kimlik bilgisini gizli yapılandırmayla sağlayın. Mevcut Kestrel Web dinleyicisi yerel döngüde olmalıdır. Capture Agent ikilisini extension serve ile başlatın, ardından Admin'de aracı kaydını Desktop / Web Extension olarak atayın. Her ana makine modu kendi dinleyicisini ve iş kilidini yönetir; tek uç noktada iki çalışan başlatmayın. Uzak çalışanlar, yönetilen yalıtılmış tarayıcı ana makinesi ve açık WebExtension:ManagedBrowserIsolated bildirimi gerektirir; uzantılar kendi ağ ve arka plan kodlarını çalıştırır. Bu bayrak yalıtım oluşturmaz. Mevcut açık Agent:AllowHttpApi ayarı yerel döngüdeki geliştirme API'si için geçerlidir.

Çalışan sahiplenme, kalp atışı, iptal ve yeniden yükleme denemelerini yönetir. Dahili Node alt işlemi gizli işlem boruları kullanır, hata ayıklama TCP portu kullanmaz. Bitirme o işin tarayıcısını kapatıp geçici profilini siler. Boş test cüzdanı kullanın: senaryo kimlik bilgilerini veya kullanılabilir cüzdanı korumaz.

Gizli bilgiler ve görüntü incelemesi

Parola, kurtarma ifadesi, anahtar veya kod girmeden önce duraklatın. Hassas ekrandan ayrıldıktan sonra devam edin. Korumalı metin ekranlarında işlem kapalı kalır ve gözlem boşluğu oluşur. Düzenlenebilir kontroller ve alt öğeleri ekran görüntüsünden önce maskelenir; alan değerleri Scene içine okunmaz. Ön/son kontroller, yakalama sırasında korumalı durum, maskeleme, gezinme veya belge içeriği değiştiğinde yakalamayı reddeder.

Canvas ve diğer opak pikseller özel inceleme medyasında görünür kalır. DOM kontrolleri bunlarda gizli bilgi bulunmadığını kanıtlayamaz. İnceleme ve maskeleme tek bir yalıtılmış dünya değerlendirmesinde eşzamanlı çalışır; yerel canvas içeriğinin işlenebilmesi için ekran görüntüsü sırasında JavaScript etkin kalır.

Finish recording, sonucu otomatik paketleyip yayımlanmamış yakalama olarak yükler. Her kontrol noktası bir sayfaya, Scene'e ve ekran görüntüsüne sahiptir. Senaryo dizini, metinlerini kopyalamadan sayfalara başvurur. Admin'de her ekran görüntüsünü Hide personal data içinde inceleyin, hassas bölgeleri bulanıklaştırın veya güvensiz medyayı silin ve incelemeden sonra yayımlayın. Karartma, kapsanan Scene metnini, erişilebilir adları, tekrarlanan değerleri ve medya başvurularını da temizler. Ayrı saklanan özgün medya ayrıca incelenmelidir. Kayıt kontrolleri yayımlayamaz veya ham görüntü döndüremez.

MCP üzerinden yeniden oluşturma

İnceleme ve yayımdan sonra aracılar sürümü normal Capture MCP kataloğundan keşfeder. Admin karartmaları dahil güncel sayfa sahipli verilerden birleştirilen kareleri, profilleri ve geçişleri yüklemek için get_scenario_scene kullanın. Onaylı görüntüler için normal yayımlanmış sayfa araçlarını kullanın. Yeniden oluşturmayı gerekli tüm yakalanmış ekranlara ve profillere göre doğrulayın; yalnızca başarılı araçlar görsel doğruluğu kanıtlamaz.

Kanıtlar ve sınırlar

Kontrol noktaları durağan gözlemlerdir. Gezinmeden, menü, modal ve diğer içerik açılmalarından sonra ve gerekli her görünüm alanında yakalayın. Komşu gözlemler değişmiş/değişmemiş sonuçları ölçer; otomatik tıklama yapıldığını kanıtlamaz. Duraklatılmış ve engellenmiş aralıklar açık boşluklar oluşturur. Bu mod gizlice her tıklamayı yakalamaz, kaydı yeniden oynatmaz, yerel işletim sistemi izin iletişim kutularını yakalamaz veya durağan görüntülerden animasyon çıkarmaz. Gizli adımlar elle yapılır ve yayımlanmış senaryoda bulunmaz. İşin sayfa sınırı kontrol noktalarını sınırlar (otomatik seçim varsayılanı 200); Scene düğüm bütçesi iş başına 100.000'dir. İşin zaman ve öğe sınırları da geçerlidir.

İstek kullanılabilirliği

Admin → Requests → Job defaults → Request submissions içinde izin verilen ürün türü/ortam çiftlerini yapılandırın. Varsayılanlar Desktop/Web, Desktop/Web Extension ve Mobile/Web şeklindedir. Allow new requests tüm yeni gönderimleri kapatır veya açar; kapalıyken kaydetmek seçili çiftleri korur. Mevcut istekler ve yayımlanmış yakalamalar erişilebilir kalır. Aynı kalıcı politika, eski form seçenekli istemciler dahil platform API ve kimliği doğrulanmış MCP için geçerlidir. Gönderimler kapalıyken request-options uç noktası platform döndürmez. Katalog ürün türü/ortam seçicileri yalnızca o ürün için yakalanmış ortamları gösterir; istek kullanılabilirliği yayımlanmış katalog kanıtlarını gizlemez.