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:

bash

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