Mucaktr/challenge-aware-webbridge

Challenge Aware WebBridge

Descripción general

Usa esta habilidad para mantener una tarea de navegación en movimiento cuando una página de verificación interrumpe la automatización normal. Detecta páginas de desafío, entrega el control al usuario de forma limpia, espera a que el desafío se resuelva y luego reanuda la tarea original desde la misma sesión de Kimi WebBridge.

Flujo de trabajo

1. Reutiliza un mismo nombre de session estable para toda la tarea del usuario. No dividas una única tarea de navegación en varios nombres de sesión.
2. Después de la navegación, ejecuta scripts/detect_verification_page.py si el título de la página, la URL o el texto visible parecen sospechosos.
3. Si no se detecta ningún desafío, continúa con la navegación normal.
4. Si se detecta un desafío:
   • Indica al usuario claramente que el sitio está esperando verificación manual.
   • Mantén la pestaña y sesión actuales activas.
   • Trae la página a la vista si es necesario para que el usuario pueda interactuar con ella.
   • Si el usuario pide explícitamente preparación, solo realiza acciones que no impliquen envío, como abrir la página, esperar el diseño o enfocar un área neutral fuera del desafío.
   • No afirmes que la habilidad puede evitar, resolver o derrotar el desafío automáticamente.
5. Ejecuta scripts/wait_for_clearance.py para sondear hasta que la pantalla intermedia desaparezca o el tiempo de espera expire.
6. Cuando la página se despeje, toma una snapshot nueva y reanuda la tarea original.

Valores predeterminados seguros

• Prefiere sondas compactas con snapshot y evaluate en lugar de volcados de página extensos.
• Trata las pistas en el título o la URL como checkLoading, turnstile, captcha, verify o checking your browser como señales fuertes.
• Mantén todo el lenguaje dirigido al usuario calmado y concreto. Explica qué está bloqueando la tarea y qué debe hacer el usuario a continuación.
• Nunca almacenes secretos, cookies o datos personales en scripts auxiliares o archivos del repositorio.
• Nunca presentes esta habilidad como una herramienta de evasión anti-bot.

Herramientas

• Usa scripts/webbridge_request.py para llamadas al demonio, especialmente en Windows donde los cuerpos de las solicitudes deben enviarse desde un archivo temporal UTF-8.
• Usa scripts/detect_verification_page.py para clasificar la página actual como despejada o con desafío.
• Usa scripts/wait_for_clearance.py después de la entrega al usuario para detectar cuándo el sitio está listo nuevamente.

Referencias

• Lee references/challenge-patterns.md para obtener pistas de detección y patrones de recuperación.
• Lee references/user-messaging.md para obtener lenguaje breve de entrega al usuario.