用于检查登录表单的邮箱地址

先说我们的建议。 Proxy Mail QA 是我们做的，所以我们并不中立。测试登录表单时，如果你需要邮件可读的测试账号，我们推荐它：每个账号都保存着自己的密码，登录验证码和魔法链接会进入真实收件箱，密码重置邮件也能完整走完流程。它不测试社交登录（Google、Apple、Microsoft）、短信验证码、身份验证器应用或通行密钥，也不会替 AI 智能体或测试填写或提交表单：这些由它们来做。

登录表单测试涵盖什么

1. 正确的邮箱和密码可以登录。
2. 密码错误时给出清晰的提示，且不透露该邮箱是否有账号。没有账号的邮箱得到同样的提示。
3. 用大写输入邮箱，或末尾带空格，也能登录同一个账号。
4. 登录验证码或魔法链接能送达，只能用一次，过期或发送新的之后失效。
5. 忘记密码会发送一封邮件，其中的链接只能用一次。之后旧密码失效，新密码可用。
6. 密码错误次数过多后，账号会被锁定或限速，相关的解锁邮件能送达。
7. 密码管理器能填写表单：字段带有 autocomplete="username"（或 email）和 autocomplete="current-password"。
8. 登录后，用户会回到原本要去的页面，而不是总落在首页。

可以再次登录的测试账号

• 创建一个带已保存密码的账号。在 API 中或通过智能体，创建带密码的地址（password: true）。在应用中，对该地址使用 Generate a test password 并保存。使用 Proxy Mail QA for Chrome 时，照常注册：提交后，它会询问是否把你用过的密码保存到该测试地址。保存的密码已加密，每次读取都会记录日志。
• 手动再次登录。 在登录表单上，扩展的按钮会列出项目中的测试账号，在该网站用过的排在前面，并填入邮箱和对应的已保存密码。
• 通过智能体或测试再次登录。 get_sign_in（MCP）或 signInAccount（npm）一次调用即可返回在该网站使用的账号及其密码。两者都需要一个创建时勾选了 Can read saved passwords 的 API 密钥，每次读取都会记录日志。通过 Qoder Marketplace 连接的智能体用你的浏览器登录 Proxy Mail QA，而不是用密钥，因此无法读取之前保存的密码：它会使用同一会话中自己创建的账号的密码，或者你用这样的密钥来连接它（MCP server 设置）。
• 密码修改后，用 set_password（MCP）或 setPassword（npm）保存新密码，让下一次测试用正确的密码登录。
• 并行运行测试时，从账号池借用账号：check_out_account 会给测试分配一个状态已知的账号（按 verified 等标签，或按年龄、国家、是否有已保存密码筛选），在归还之前其他测试不会拿到它。

import { ProxyMailQA } from 'proxymail-qa';

const qa = new ProxyMailQA(); // a key with "Can read saved passwords", in PROXYMAIL_QA_API_KEY

await qa.withAccount({ tags: ['verified'] }, async (account) => {
  const { secret } = await qa.savedPassword(account.address);
  await signIn(page, account.address, secret); // your own sign-in steps
});

登录验证码和魔法链接

对于通过邮件发送验证码或链接、而不要求密码的表单：

• wait_for_code 最多等待 30 秒并返回验证码；unused: true 会跳过已用过的验证码，所以第二次请求会拿到第二个验证码。
• wait_for_link 返回魔法登录链接。Proxy Mail QA 从不打开它，所以你拿到时它仍未被使用。
• check_email 检查邮件：SPF、DKIM 和 DMARC，链接是否指向你正在测试的网站（expect_host），以及是否说明了验证码何时失效。

服务器的 test_sign_in_code 提示词会借用一个已验证的账号，并用应用发送的验证码或链接登录。更多内容见测试一次性验证码和测试魔法链接。

大写字母和加号标签

get_address_variants 会提供测试地址的多种变体，它们仍然会进入该地址的收件箱。登录时有两种很重要：

• 大写字母（K7F2X9AB12CD@MAILCLUB.DEV）。用它登录应该进入与普通地址相同的账号。如果失败，输入邮箱时带大写字母的用户就无法登录。
• 加号标签（k7f2x9ab12cd+work@mailclub.dev）。对大多数应用来说，这是另一个账号。决定你的应用是否把它视为同一个账号，并测试它是否按你的决定运行。

密码重置

test_password_reset 提示词会借用一个已验证的账号，通过你的应用重置其密码，检查重置邮件，把新密码保存到账号上，然后把账号归还到池中。之后检查旧密码已无法登录。更多内容见测试密码重置。

问问你的智能体

在 Qoder 中连接 Proxy Mail QA 后（Marketplace）：

Test the sign-in form at https://staging.acme.dev/login with Proxy Mail QA. Start a run.
Create a test address with a password (create_address, password: true), sign up with it
at https://staging.acme.dev/signup and finish the verification. Sign out.
Sign in with it. Then try a wrong password, an email with no account, and the address
in capitals, and compare the messages.
Use "Forgot password", finish the reset with the link from the email, save the new
password with set_password, and check the old one fails.
Finish the run and give me the report.

智能体会在会话期间保留 create_address 返回的密码，所以这在 Marketplace 连接下也能用，尽管该连接无法读取之前保存的密码。

它不涵盖什么

• 社交登录。 用 Google、Apple 或 Microsoft 登录使用的是这些服务的账号，Proxy Mail QA 不会创建它们。请使用各服务商的测试账号。
• 短信验证码、身份验证器应用和通行密钥。 它只接收电子邮件。
• 大规模的速率限制和锁定。 你可以检查锁定邮件是否送达，但负载测试需要专门的负载测试工具。
• 你的线上网站。 它用于你开发的或获准测试的应用的预发布环境或本地副本。