本页由英文自动翻译。

阅读英文版
Proxy Mail QA

自定义字段

注册表单的每个字段,都能填好。

只需告诉 Proxy Mail QA 一次你表单中自己的字段该填什么,例如公司规模或“你是从哪里了解到我们的?”。你的编程智能体每次运行都从 form_values 获得与你的团队从 Proxy Mail QA for Chrome 获得的相同答案,没人教过的内容会被猜测并标记待检查。

免费套餐 · 每个项目 50 个自定义字段 · 现成的电话、身份证号和税号字段 · 在 MCP server、REST、npm 和 Python 上提供 form_values · Proxy Mail QA for Chrome

工作原理

只需教一次。

  1. 问问你的智能体

    “为我们的注册表单设置自定义字段。”它会把每个屏幕的字段发送给 form_values,列出会被猜测或留空的字段,并保存你同意的自定义字段。

  2. 在页面上教它

    Proxy Mail QA for Chrome 填好表单后,在它猜测或留空的字段旁选择“教它”,选择该填的内容,然后选择“保存并填写”。

  3. 或在项目设置中添加

    给它命名,说明如何识别该字段(测试 ID、字段名,或标签中的文字,覆盖你站点的每种语言),以及该填什么。可以限定在所有语言下的某个页面、某个站点,或在所有地方使用。

  4. 每次填写都会用到

    项目中的每个智能体、测试和队友都会为该字段得到相同的答案,同一个账号每次也得到相同的答案。

面向编程智能体

你的智能体得到相同的答案。

form_values 会回答页面描述的每个字段。由自定义字段决定的字段返回类型 custom,没人教过的字段返回类型 guess 以及猜测的来源,让智能体在提交前检查。

询问每个字段该填什么

在 MCP server 上使用 form_values,或 POST /v1/form-values。每个屏幕都发送 site 和 page,这样限定于该站点或页面的自定义字段才会生效。

form_values
{
  "site": "staging.acme.dev",
  "page": "/signup",
  "fields": [
    { "id": "size", "type": "select", "label": "Company size",
      "test_id": "company-size", "options": [ … ] },
    { "id": "web", "type": "url", "label": "Website" }
  ]
}

输入返回的值

这些值来自同一个测试地址,因此同一个账号下次会得到相同的答案。

答案
{ "values": [
  { "id": "size", "kind": "custom", "value": "11-50",
    "rule": { "id": "…", "name": "Company size" } },
  { "id": "web", "kind": "guess", "from": "type",
    "value": "https://www.example.com",
    "note": "Guessed from its type. Check it suits your test, …" }
] }

当某个字段阻塞表单时保存一个

智能体只在你要求时,或某个必填字段否则会阻塞表单且你同意时,才保存自定义字段。

save_custom_field
{
  "name": "Company size",
  "match": { "on": "test_id", "text": "company-size" },
  "value": { "kind": "option", "option": "11–50" },
  "tag_answer": true
}

或在你的测试中

npm 包和 Python 辅助工具提供相同的调用,对于分多个屏幕的注册,每个屏幕调用一次。

signup.spec.ts
const first = await qa.formValues({ fields, site: 'staging.acme.dev', page: '/signup' });
// …fill it, press Continue, then on the next screen:
const next = await qa.formValues({ fields: teamFields, address: first.address, site: 'staging.acme.dev', page: '/signup/team' });
await qa.saveCustomField({ name: 'Team size', match: { on: 'name', text: 'team_size' }, value: { kind: 'option', option: '2–10' } });

MCP 文档中的 form_values通过 REST 使用自定义字段

预设字段

电话和身份证号,安全地填写。

有些字段不应该填入编造的值。电话号码可能会联系到某人,证件号字段中的随机数字可能属于真实的人。添加预设字段后,Proxy Mail QA 会为每个智能体和测试填入不会出现这些问题的值。没有这类值时,字段留空并附说明。

电话号码

每个项目都自带一个。它会填入英国、澳大利亚、美国和加拿大专门留作虚构用途的号码,以及你为其他每个添加的国家设置的应用测试号码,因此没有人会收到测试发出的短信。

身份证号、税号和护照号

符合格式且绝不会与真实的人匹配的身份证号、个人税号和护照号(Proxy Mail QA 有安全值时),或用于测试模式检查的 KYC 供应商沙盒值。只有项目负责人可以添加。个人税号只来自 KYC 供应商。

增值税号和企业税号

企业号码同理。Proxy Mail QA 没有安全的增值税号,英国的增值税校验会拒绝所有假号码,因此增值税号字段留空并附说明,除非 KYC 供应商的沙盒值中有可用的号码。

常见选择

性别、语言、职位、团队规模、业务类型和从哪里了解到你,会从字段自身的选项中选一个,同一账号始终选同一个。

条款勾选框

勾选,或不勾选,以测试未接受条款时你的表单会显示什么。

使用你网站的语言

每个字段都按它询问的内容找到对应输入框,支持英语、德语、法语、西班牙语、意大利语、葡萄牙语、荷兰语、中文和日语。你为该字段设置的自定义字段仍然优先。

文档中的现成字段安全地测试电话和证件字段

猜测

填写其余字段,并显示哪些是猜的。

没有自定义字段的字段会根据其提示得到一个值,并标记为猜测。同一个账号每次得到相同的猜测。

占位符中的示例

“Acme Ltd”或“e.g. Hiring manager”会原样填入。“Enter your company size”这类指令则永远不会。

其中一个选项

每个账号选一个不同的真实选项,因此一批测试账号能覆盖整个下拉框。会跳过“Choose…”这类占位选项。

字段的类型、格式或标签

https://www.example.com 用于网站,数字填字段范围内的值,职位填 QA Engineer,邮编填该角色所在国家的邮编。

默认填写每个字段

除非项目另有设置,每个没有自定义字段的字段都会得到一个猜测值,新项目和现有项目都一样。

或只填必填字段

只有表单标记为必填的字段会得到猜测值,适用于在可选字段中拒绝奇怪值的应用。可选字段留给你填。

或关闭

只填写内置值和自定义字段,和以前一样。在项目设置中更改,或在单次调用中通过 form_values 中的 guess 更改。

它从不填写的内容

有些字段留给你。

无论设置如何,这些字段都不会被猜测,返回时为空并附上原因。

  • 支付字段

    卡号、CVC、有效期、IBAN 和账单信息。测试卡应在你的支付服务商的测试模式中使用,因此它们也不能设置自定义字段。

  • 证件号和税号

    护照号、国民保险号、增值税号和税号绝不猜测。预设字段会填入一个绝不会与真实的人匹配的假值(Proxy Mail QA 有安全值时),自定义字段则填入你的团队公布的固定测试值,但个人证件号绝不会使用随机数字。

  • 密码和密钥

    只填写账号自己的密码。PIN、密钥、令牌和安全问题永远不会填,看起来像卡号、私钥,或属于 所列格式 之一的 API 密钥 或令牌的值会被拒绝。

  • 来自别处的代码

    一次性验证码、促销码、优惠券码和推荐码来自邮件或你本人。编造的代码会导致表单失败。

  • CAPTCHA 和上传

    从不填写,颜色选择器以及隐藏、禁用和只读字段也一样。

  • 同意复选框

    不勾选也是有效的答案,而勾选意味着同意某些内容。对于你的团队总是勾选的复选框,教它选“已勾选”。

多屏注册

每个屏幕都用同一个账号。

公司信息、团队规模或引导问题通常在点击“下一步”之后出现。Proxy Mail QA for Chrome 会用它在第一个屏幕上创建的账号填写。它从不点击“下一步”或提交。

  1. 填写这一步

    在之后的屏幕上,第一个空字段中的按钮会用同一个测试账号及其自定义字段和猜测值填写该屏幕。卡片会计数屏幕,例如“已填写第 2 步,共 3 步”。

  2. 或使用快捷键

    Alt+Shift+F 的作用相同,弹出窗口中的“填写此页面”也能在那里使用,适用于在页面或弹出窗口中开始的注册。在 chrome://extensions/shortcuts 更改快捷键。

  3. 下一步之后的提问

    在你点击“下一步”或“继续”后(按钮文字支持九种语言识别),它会询问新屏幕是否属于注册流程。选择“保留此屏幕”后,此后它会自动填写该站点之后的每个屏幕;如果项目只允许负责人更改站点,则会先询问负责人。

  4. 或自动填写每个屏幕

    对于注册流程总会继续下去的站点,选择“保留此屏幕”,或开启 Project settings → Sites → Sign-up goes over several screens。你点击“下一步”后的每个新屏幕都会被填写,卡片会显示填入的内容。

智能体和测试在每个屏幕调用一次 form_values,使用同一个地址,以及每个屏幕的 site 和 page(原生应用屏幕则以名称作为 screen)。每个站点的注册屏幕都列在 Project settings → Sites → Sign-up screens 中。

你的团队保持掌控

负责人决定,成员申请。

仅允许负责人更改

Project settings → General 中的一个开关可以只让项目负责人更改项目的站点和自定义字段。在负责人开启之前,它处于关闭状态。

成员改为提出申请

成员可以在扩展的 Teach 中、在应用中或通过自己的智能体,附上说明向负责人申请。负责人在项目设置中批准或拒绝,每小时最多收到一封邮件。

一切都在活动日志里

每个自定义字段的保存或删除,每次猜测设置的更改,每个申请和答复,以及是谁、从哪里操作,包括“来自 Claude Code”。

FAQ

常见问题

Proxy Mail QA 会检查我的表单是否正常工作吗?

不会。它为每个字段提供值,由你的应用来检查。表单是否接受这些值、接下来做什么,由你的测试或智能体来检查。

智能体和扩展得到的值相同吗?

可以,适用于你团队自己的自定义字段。它们属于项目,其列表、随机数字和猜测都由测试地址决定,所以同一个账号从 form_values 和 Proxy Mail QA for Chrome 得到的答案相同。不过 Proxy Mail QA for Chrome 0.9.0 不会填写现成字段,并会用自己的方式猜测电话号码、街道、城市、地区或邮编。

遇到它不认识的字段会怎样?

它会根据占位符、选项、模式、标签或类型给出一个猜测值,并标记为猜测及其来源,除非项目设为只猜测必填字段或完全不猜测。付款字段、证件号码、密钥、验证码、CAPTCHA、同意勾选框和上传字段永远不会猜测。

它能用于多语言网站吗?

能。像 /signup 这样的页面也涵盖 /de/signup 和 /fr/signup。通过标签识别字段的自定义字段可以保存每种语言的标签,例如 Referral code、Empfehlungscode 和 Code de parrainage。测试 ID 或名称通常在各语言中相同,所以只需要一个。

它能填写付款字段吗?

不能。银行卡和银行字段永远不会填写,也不能设置自定义字段。请使用付款服务商的测试模式和测试卡。

电话或证件号码字段里会填什么?

在 form_values 中,只填入项目预设字段给出的值。每个项目都有电话号码字段,会填入为虚构用途预留的号码,或你的应用针对账号所在国家的测试号码。证件号和税号字段会一直留空,直到负责人添加对应的预设字段,这些字段给出符合格式且绝不会与真实的人匹配的值。没有安全值的电话号码、证件号或税号字段会留空并附说明。

我能停止猜测吗?

能。在 Project settings → Custom fields 中,“填写不认识的字段”有三个选项:所有字段、仅必填字段和关闭。智能体也可以在单次调用中向 form_values 传入 guess off。

一个项目可以有多少个自定义字段?

50 个,Free 和 Team 相同,每个最多查找 10 个短语。每个字段可以限定于一个网站,或该网站在所有语言下的某个页面,也可以用于所有网站。

更多功能

你的整个注册表单,每次都以相同方式填写。

创建免费账号,连接你的智能体,告诉它你的表单专有字段该填什么。

对本页有疑问?

可以用任何语言提问。文档可以立即回答,你也可以把问题发给 Proxy Mail QA 团队,他们会用英文回复。