Mucaktr/challenge-aware-webbridge

Challenge Aware WebBridge

Übersicht

Nutzen Sie diese Fertigkeit, um eine Browser-Aufgabe fortzusetzen, wenn eine Verifizierungsseite die normale Automatisierung unterbricht. Erkennen Sie Hürdenseiten, übergeben Sie die Kontrolle sauber an den Benutzer, warten Sie, bis die Hürde verschwunden ist, und setzen Sie die ursprüngliche Aufgabe in derselben Kimi WebBridge-Sitzung fort.

Workflow

1. Verwenden Sie für die gesamte Benutzeraufgabe einen stabilen session-Namen. Teilen Sie eine einzelne Browser-Aufgabe nicht auf mehrere Sitzungsnamen auf.
2. Führen Sie nach der Navigation scripts/detect_verification_page.py aus, wenn Seitentitel, URL oder sichtbarer Text verdächtig erscheinen.
3. Wenn keine Hürde erkannt wird, setzen Sie das normale Browsen fort.
4. Wenn eine Hürde erkannt wird:
   • Teilen Sie dem Benutzer klar mit, dass die Website auf eine manuelle Verifizierung wartet.
   • Halten Sie den aktuellen Tab und die Sitzung aktiv.
   • Bringen Sie die Seite bei Bedarf in den Vordergrund, damit der Benutzer mit ihr interagieren kann.
   • Wenn der Benutzer ausdrücklich um Vorbereitung bittet, führen Sie nur nicht-ausführende Aktionen aus, wie das Öffnen der Seite, das Warten auf das Layout oder das Fokussieren eines neutralen Bereichs außerhalb der Hürde.
   • Behaupten Sie nicht, dass die Fertigkeit die Hürde umgehen, lösen oder besiegen kann.
5. Führen Sie scripts/wait_for_clearance.py aus, um in einer Schleife zu prüfen, bis die Zwischenseite verschwunden ist oder das Zeitlimit abläuft.
6. Wenn die Seite wieder frei ist, machen Sie einen aktuellen snapshot und setzen Sie die ursprüngliche Aufgabe fort.

Sichere Standardeinstellungen

• Bevorzugen Sie kompakte snapshot- und evaluate-Abfragen gegenüber umfassenden Seiten-Dumps.
• Behandeln Sie Titel- oder URL-Hinweise wie checkLoading, turnstile, captcha, verify oder checking your browser als starke Signale.
• Halten Sie die Sprache gegenüber dem Benutzer ruhig und konkret. Erklären Sie, was die Aufgabe blockiert und was der Benutzer als Nächstes tun sollte.
• Speichern Sie niemals Geheimnisse, Cookies oder personenbezogene Daten in Hilfsskripten oder Repo-Dateien.
• Präsentieren Sie diese Fertigkeit niemals als Anti-Bot-Umgehungswerkzeug.

Werkzeuge

• Verwenden Sie scripts/webbridge_request.py für Daemon-Aufrufe, insbesondere unter Windows, wo Anforderungstexte aus einer UTF-8-Temp-Datei gepostet werden sollten.
• Verwenden Sie scripts/detect_verification_page.py, um die aktuelle Seite als frei oder blockiert zu klassifizieren.
• Verwenden Sie scripts/wait_for_clearance.py nach der Benutzerübergabe, um zu erkennen, wann die Website wieder bereit ist.

Referenzen

• Lesen Sie references/challenge-patterns.md für Erkennungshinweise und Wiederherstellungsmuster.
• Lesen Sie references/user-messaging.md für kurze, an den Benutzer gerichtete Übergabetexte.