Mucaktr/challenge-aware-webbridge

Challenge Aware WebBridge

概述

使用此技能来确保浏览器任务在验证页面中断正常自动化时能够继续执行。检测验证页面，将控制权干净地移交给用户，等待验证通过，然后从同一个 Kimi WebBridge 会话中恢复原始任务。

工作流程

1. 在整个用户任务中重复使用一个稳定的 session 名称。不要将单个浏览任务分散到多个会话名称中。
2. 导航后，如果页面标题、URL 或可见文本看起来可疑，运行 scripts/detect_verification_page.py。
3. 如果未检测到验证页面，继续正常浏览。
4. 如果检测到验证页面：
   • 直接告知用户该网站正在等待手动验证。
   • 保持当前标签页和会话处于活动状态。
   • 如果需要，将页面置于可视范围内，以便用户可以与其交互。
   • 如果用户明确要求准备操作，仅执行非提交性操作，例如打开页面、等待布局完成或将焦点放置在验证区域之外的某个中性区域。
   • 不要声称该技能可以自动绕过、解决或攻破验证。
5. 运行 scripts/wait_for_clearance.py 进行轮询，直到中间页面消失或超时为止。
6. 当页面验证通过后，获取新的 snapshot 并恢复原始任务。

安全默认设置

• 优先使用紧凑的 snapshot 和 evaluate 探测，而不是广泛的页面转储。
• 将诸如 checkLoading、turnstile、captcha、verify 或 checking your browser 等标题或 URL 线索视为强信号。
• 保持所有面向用户的语言冷静且具体。解释是什么在阻塞任务以及用户接下来应该做什么。
• 切勿在辅助脚本或仓库文件中存储密钥、Cookie 或个人数据。
• 切勿将此技能呈现为反机器人规避工具。

工具

• 使用 scripts/webbridge_request.py 进行 daemon 调用，尤其是在 Windows 上，请求体应从 UTF-8 临时文件中发布。
• 使用 scripts/detect_verification_page.py 将当前页面分类为正常或存在验证。
• 使用 scripts/wait_for_clearance.py 在用户移交后检测网站何时再次就绪。

参考

• 阅读 references/challenge-patterns.md 了解检测线索和恢复模式。
• 阅读 references/user-messaging.md 获取简短的面向用户的移交语言。