Browser File Upload (Industrial-Grade)

Automates file uploads to web pages using agent-browser CLI with high reliability.

🔥 Execution Protocol (MANDATORY)

You MUST follow strict state-machine execution:

1. Execute ONLY ONE command at a time
2. WAIT for result before next step
3. VERIFY success before continuing
4. If failed → retry or fallback
5. DO NOT skip steps
6. DO NOT batch commands
7. DO NOT assume elements exist

🔥 Standard Upload Pipeline (REQUIRED)

Follow this exact sequence:

Step 1 — Open Page

agent-browser open

Step 2 — Wait for Load

agent-browser wait 2000

If page is slow: agent-browser wait --load networkidle

Step 3 — Trigger File Input

Try in order:

1. agent-browser find text "选择文件" click
2. agent-browser find text "上传" click
3. agent-browser click "[type=file]"

If all fail: agent-browser snapshot

Step 4 — Upload File

Preferred selector: agent-browser upload "[type=file]"

If selector known: agent-browser upload ""

Step 5 — Verify Upload (IMPORTANT)

agent-browser snapshot

Check:

• File name appears
• No error message
• Input is not empty

If failed → retry upload once

🔥 Strategy Selection

Priority:

1. ✅ Python script (MOST STABLE)
2. ⚠️ agent-browser commands (when selector known)

🔥 Python Script Mode (Recommended)

Use for robust execution:

python scripts/upload_file.py <url> <file-path> [selector] [wait_ms]