表单审计与填充测试数据

WTFAA 的开发者角色有两个表单动作：表单审计检查当前页面上表单的结构；填充测试数据为可见字段生成虚构的值，并且只在你确认后才写入页面。

本指南说明这两个动作会从页面读取什么、返回什么，以及填写步骤不会做什么。如果还没有安装和配置 WTFAA，请先看快速上手。三个角色的概览见阅读者、设计师和开发者角色。

WTFAA 会读取表单的哪些信息

两个动作都在本地从当前标签页读取表单结构：

• 只收集至少包含两个控件的 <form> 元素。通过内联样式隐藏的表单会被跳过；不在 <form> 元素里的字段不会被收集。
• 每个表单：标题或 legend、表单内的文字、表单的 action 地址和提交方法。
• 每个字段：标签名、类型、name、id、label、placeholder、是否必填，以及当前值。
• type="hidden" 的输入框和通过内联 display: none 隐藏的字段完全不会被收集。
• 页面 URL、页面标题，以及页面上检测到的前端技术线索摘要。

Chrome 不允许扩展在 chrome:// 页面、Chrome 应用店等受限页面上运行，所以这两个动作在这些页面上不可用。

第 1 步：检查发送预览

点击任一动作后，会先打开发送前检查。表单请求会显示页面 URL 和标题、表单数、字段数、模型和模式。

本地脱敏一栏列出本地过滤发现的内容。密码字段一定会出现在这里：字段类型为 password，或者 name、id、label 中包含 "password"、"passcode" 或 "pin"，都按密码字段处理。开启使用本地过滤后的上下文时，这些字段的值会在发送前替换为 [REDACTED_PASSWORD]。只要过滤发现了内容，这个选项就会自动开启；如果你手动关闭，发送的就是未过滤的值。

点击发送给 AI 继续，或点击取消停止。预览中各选项的说明见发送给 AI 的内容。

第 2 步：运行表单审计

1. 打开包含表单的页面。
2. 打开 WTFAA 侧边栏，切换到开发者角色。
3. 点击表单审计。
4. 检查预览，点击发送给 AI。

报告分为三部分：

• 字段汇总：列出每个字段的类型、标签、是否必填和校验规则的表格。
• 依赖关系：字段之间的条件逻辑。
• 潜在问题：可用性、标签、必填状态和客户端校验方面的可见问题。

审计只根据可见的 HTML 属性、客户端提示、页面上显示的错误状态和字段之间的关系判断校验规则，不推断服务端校验；无法确定的后端规则会标为未知。

第 3 步：用填充测试数据生成测试值

1. 在同一页面点击填充测试数据。
2. 检查预览，点击发送给 AI。
3. 模型返回一段简短说明和一个结构化 JSON 动作，其中为每个字段列出 CSS 选择器和值。请求要求模型使用逼真但虚构的数据，优先使用基于字段 id 或 name 的选择器，并且只包含表单上下文中的可见字段。
4. 回复完成后，WTFAA 显示 💡 建议操作卡片，说明将填写几个字段，并在执行前请检查字段和值下逐行列出选择器和值。

第 4 步：检查字段并确认

逐行检查卡片内容。点击一键执行之前，页面不会被写入任何内容。

点击后，WTFAA 在当前窗口的活动标签页中填写字段，并短暂高亮每个已填写的字段。点击时请保持表单所在的标签页处于活动状态。页面上找不到的选择器会被跳过。

卡片不支持修改或删除单行。如果某一行不应填写，就不要执行：可以在对话中让 AI 重新生成，或自己手动填写这些字段。

值是怎样写入的

• 文本输入框和多行文本框：WTFAA 通过浏览器原生的 value setter 设置值，更新 React 内部的值跟踪器，然后触发 focus、input、change 和 blur 事件，让 React 受控输入框识别新值。
• 下拉选择框：先按选项的 value 匹配，再按选项文字匹配，最后当作选项序号使用。
• 复选框和单选框：值为 true、1、checked 或 on 时勾选，其他值取消勾选。从 1.3.4 版本起，这些变化也会正确更新 React 受控表单的状态。

从 1.3.2 版本起，WTFAA 不再执行 AI 生成的 JavaScript。填写动作只是 JSON 数据，执行它的代码内置在扩展中。

填写步骤不会做什么

• 不提交表单，也不点击提交按钮或其他任何按钮。填写代码只设置字段值并触发输入事件。是否提交由你决定。
• 隐藏输入框不会发送给模型，因此不会出现在生成的数据里。
• 请求要求模型不要包含隐藏字段、密码字段、支付字段、条款复选框、提交按钮或破坏性控件，也不要触发支付或接受条款。这是给模型的指令，不是技术上的拦截。卡片中的字段列表就是你的检查点：如果其中出现条款复选框、支付字段或密码字段，请不要执行。

提示

• 请在测试或预发布环境中使用填充测试数据。这些值是虚构的，不用于真实提交。
• 如果预览显示表单数为 0，页面很可能没有使用 <form> 元素来构建表单，WTFAA 不会收集这类字段。
• 想处理页面上的其他内容，可以看网页翻译或截图分析。