Mucaktr/challenge-aware-webbridge

Challenge Aware WebBridge

Aperçu

Utilisez cette compétence pour maintenir l'exécution d'une tâche de navigateur lorsqu'une page de vérification interrompt l'automatisation normale. Détectez les pages de défi, transférez le contrôle à l'utilisateur proprement, attendez que le défi soit résolu, puis reprenez la tâche d'origine dans la même session Kimi WebBridge.

Workflow

1. Réutilisez un nom de session stable pour toute la tâche utilisateur. Ne divisez pas une seule tâche de navigation entre plusieurs noms de session.
2. Après une navigation, exécutez scripts/detect_verification_page.py si le titre de la page, l'URL ou le texte visible semble suspect.
3. Si aucun défi n'est détecté, continuez la navigation normale.
4. Si un défi est détecté :
   • Indiquez clairement à l'utilisateur que le site attend une vérification manuelle.
   • Maintenez l'onglet et la session actuels actifs.
   • Amenez la page en vue si nécessaire pour que l'utilisateur puisse interagir avec elle.
   • Si l'utilisateur demande explicitement une préparation, n'effectuez que des actions non-soumettantes telles que l'ouverture de la page, l'attente de la mise en page, ou la focalisation sur une zone neutre en dehors du défi.
   • N'affirmez pas que la compétence peut contourner, résoudre ou déjouer le défi automatiquement.
5. Exécutez scripts/wait_for_clearance.py pour interroger jusqu'à ce que l'interstitiel disparaisse ou que le délai expire.
6. Lorsque la page est libre, prenez un nouveau snapshot et reprenez la tâche d'origine.

Valeurs par défaut sûres

• Préférez des sondes snapshot et evaluate compactes plutôt que des vidages de page volumineux.
• Traitez les indices de titre ou d'URL tels que checkLoading, turnstile, captcha, verify, ou checking your browser comme des signaux forts.
• Gardez tout langage destiné à l'utilisateur calme et concret. Expliquez ce qui bloque la tâche et ce que l'utilisateur doit faire ensuite.
• Ne stockez jamais de secrets, cookies ou données personnelles dans les scripts d'aide ou les fichiers du dépôt.
• Ne présentez jamais cette compétence comme un outil d'évasion anti-bot.

Outils

• Utilisez scripts/webbridge_request.py pour les appels au démon, en particulier sur Windows où les corps de requête doivent être postés depuis un fichier temporaire en UTF-8.
• Utilisez scripts/detect_verification_page.py pour classer la page actuelle comme libre ou avec défi.
• Utilisez scripts/wait_for_clearance.py après le transfert à l'utilisateur pour détecter quand le site est de nouveau prêt.

Références

• Lisez references/challenge-patterns.md pour les indices de détection et les schémas de reprise.
• Lisez references/user-messaging.md pour le langage court de transfert à l'utilisateur.