表格自动填写助手 / Auto Form Filler

通过前台（headed）浏览器自动填写网页表单，分析表单结构后批量点击选项，支持答案核对，个人信息字段留给用户手动输入。

触发条件 / Trigger Criteria

• 用户提供网页链接要求"填写"、"填表"、"答题"、"做问卷"
• 用户说"帮我填下这个表单"、"自动填写这个链接"
• 涉及 jsj.top、问卷星、金数据等在线表单平台
• 用户指定仅自动填写选项部分，个人信息手动填写

约束条件 / Constraints

1. 必须前台操作（headed mode）： 使用 browser-use --headed，不后台填写
2. 个人信息手动填写： 姓名、手机号、部门、地址等个人识别字段一律留空，由用户手动输入
3. 答案可核对： 如果用户提供参考文档（docx），必须逐题核对答案，修正不一致项
4. 操作前先截图： 每完成一批填写后截图确认，确保状态正确
5. 每题间隔 150-300ms： 连续点击之间加短暂延迟，避免页面响应不及时

Workflow

Phase 1 — 环境检查 / Environment Check

browser-use doctor 2>&1 | head -20
browser-use close --all 2>&1

确认 browser-use 已安装且无残留 session。

Phase 2 — 打开表单 / Open Form

browser-use --headed --session form open <FORM_URL>

• 始终使用 --headed 参数（前台模式）
• Session 名称固定为 form，便于后续操作
• 打开后等待页面完全加载（约 2-3 秒）

Phase 3 — 分析表单结构 / Analyze Form Structure

browser-use --session form state 2>&1

从 state 输出中提取：

记录一个答题映射表：

Q1 (单选): A=index1, B=index2, C=index3, D=index4
Q2 (单选): A=index5, B=index6, ...
...

Phase 4 — 答案准备 / Prepare Answers

情况 A：无参考文档（直接答题）

根据题目内容自行判断答案。如果题目涉及专业知识不确定，优先搜索确认后再选。

情况 B：有参考文档 docx（核对模式）

使用捆绑脚本提取答案：

python3 <skill_dir>/scripts/extract_docx_answers.py "<DOCX_PATH>"

将提取出的答案与表单题目逐一对照，建立 题号 → 答案 映射表。

核对步骤：

1. 提取 docx 中每道题的正确答案
2. 与表单中已选答案对比
3. 不一致的题目取消勾选错误选项，重新选择正确选项
4. 输出核对结果表格（题号、题型、我的答案、标准答案、结果）

Phase 5 — 逐题填写 / Fill Answers

使用 browser-use --session form click 逐题点击选项。

要点：

• 单选/判断题： 直接点击对应选项的 index
• 多选题： 逐个点击每个正确选项的 index，之间加 150ms 延迟
• 滚动翻页： 题目超出屏幕时，使用 browser-use --session form scroll down --amount 滚动
• 批量操作： 相邻题目可用 && 串联点击命令，减少调用次数

示例命令：

# Q1 单选 A (index=421)
browser-use --session form click 421

# Q6 多选 ABC (index=780,793,806)
browser-use --session form click 780 && sleep 0.15 && browser-use --session form click 793 && sleep 0.15 && browser-use --session form click 806

# Q11 判断 B错 (index=1155)
browser-use --session form click 1155

答案修正（取消已选项）： 对于多选题目，如果选错了选项，点击该选项的 index 即可取消：

# Q7 多选取消多选的 C 选项
browser-use --session form click 880

Phase 6 — 结果验证 / Verify Results

# 截图保存最终结果
browser-use --session form screenshot <workspace>/form_result.png --full 2>&1

# 获取最终 state 核对
browser-use --session form state 2>&1 | grep -E "(单选题|多选题|判断题|提交|完成)"

输出核对汇总表，确认所有题目已正确填写。

Phase 7 — 提示用户手动填写 / Prompt Manual Input

在全部选项填写完毕后：

1. 用表格汇总所有已填答案，逐题标注 ✅
2. 明确列出需要用户手动填写的个人信息字段（姓名、手机号、部门、地址等）
3. 提醒浏览器窗口仍保持打开状态，用户可直接操作
4. 告知用户填写完个人信息后点击"提交"按钮

常见表单平台特征 / Common Platform Patterns

关键要点 / Key Pitfalls

Bundle Contents / 捆绑文件

• scripts/extract_docx_answers.py — 从 .docx 参考文件中提取纯文本答案（仅用 stdlib，无需安装依赖）