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 探測，而非大範圍的頁面傾印。
• 將標題或 URL 中的線索，例如 checkLoading、turnstile、captcha、verify 或 checking your browser，視為強烈訊號。
• 所有面向使用者的語言應保持冷靜且具體。解釋是什麼阻礙了任務，以及使用者下一步應該做什麼。
• 切勿在輔助腳本或儲存庫檔案中儲存機密、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 以取得簡短的使用者交接用語。