注册扫描器

扫描一个或多个电子邮件账户中与注册相关的邮件，并返回一份去重后、按日期排序的列表，涵盖用户曾经注册过的所有服务。

支持的邮件服务商

完整服务商详情及 IMAP 配置指南 → {baseDir}/references/providers.md

步骤 1 – 确认待扫描账户

在执行任何操作前，请先向用户确认需要扫描哪些邮箱账户：

“您希望我扫描哪些邮箱账户？（例如：Gmail、iCloud、Outlook、Yahoo、AOL、GMX、Web.de、T-Online、Fastmail、Proton —— 或全部？）”

请等待用户回复。未获确认前不得继续下一步。

步骤 2 – 收集凭证信息

Gmail

若已配置，优先使用 Gmail 工具或 Gmail MCP 连接器。
若尚未配置，请告知用户：

“请先通过 openclaw configure 命令连接您的 Gmail 账户，或启用 Gmail MCP 连接器。”

IMAP 类服务商（iCloud、Outlook、Yahoo、AOL、GMX、Web.de、T-Online、Fastmail）

向用户说明：

“对于 [provider]，我需要您的邮箱地址以及一个应用专用密码（非您的常规登录密码）。您可在账户的安全设置中生成该密码。我仅在本次会话中使用该密码，且绝不会以明文形式存储。”

有关各服务商生成应用密码的具体操作指引，请参阅 → {baseDir}/references/providers.md

Proton Mail

Proton Mail 需要本地运行 Proton Mail Bridge 才能接入。

“使用 Proton Mail 前，请确保 Proton Mail Bridge 已启动。我将通过本地地址 127.0.0.1:1143 与其建立连接。”

步骤 3 – 执行扫描

Gmail

使用 Gmail 工具，按顺序执行以下搜索查询，并收集所有匹配邮件的 Message ID。

全语言支持的搜索查询列表 → {baseDir}/references/search-queries.md

IMAP 账户

使用位于 {baseDir}/scripts/imap_scan.py 的 Python 脚本完成连接与搜索：

python3 "{baseDir}/scripts/imap_scan.py" 
  --host "imap.mail.me.com" 
  --port 993 
  --user "user@icloud.com" 
  --password "app-specific-password" 
  --output "/tmp/registration_scan_results.json"

该脚本将自动执行全部搜索查询批次，并返回一个包含匹配结果的 JSON 列表。

请为每个 IMAP 账户单独运行一次该脚本，并将结果分别保存至不同的临时文件中。

步骤 4 – 解析并去重结果

对每一封匹配到的邮件执行以下处理：

1. 提取字段：From、Date、Subject
2. 根据发件人域名或邮件主题推导出服务名称
   示例：noreply@spotify.com → Spotify，hello@notion.so → Notion
3. 按服务名称去重：每个服务仅保留最早的一条记录（即原始注册时间）
4. 跳过以下类型邮件：事务类邮件（如密码重置、订单收据）、纯资讯类简报（无注册上下文）、内部或个人发件人

步骤 5 – 输出结果

最终列表按最新注册时间优先排序，格式如下：

📋 REGISTERED SERVICES – [Account Name]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Found: XX services  |  Range: YYYY – YYYY

YYYY-MM-DD   Service Name
             From: sender@domain.com

YYYY-MM-DD   Service Name
             From: sender@domain.com
...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

若扫描了多个账户，请将所有结果合并为一份统一列表，并按注册日期排序。

展示完列表后，请询问用户：

“是否需要将此结果保存为文件？或按特定服务名称、日期范围进行筛选？”

错误处理

• IMAP 认证失败：请用户重新核对应用专用密码；相关配置步骤详见 {baseDir}/references/providers.md。
• IMAP 未启用：iCloud、Yahoo、Outlook 等服务商可能需在账户设置中手动开启 IMAP；具体指引请参考 {baseDir}/references/providers.md。
• Proton Bridge 未运行：请用户先启动 Proton Mail Bridge 应用程序。
• 遭遇限频（Rate Limiting）：在各批搜索之间添加 1–2 秒延迟，避免被服务商限流。
• 邮箱数据量过大：及时向用户反馈进度；超大收件箱（含 10 万封以上邮件）可能需耗时数分钟。

隐私与安全规范

• 严禁在输出内容或日志中显示密码、应用密钥或其他凭证信息。
• 尽可能使用 OpenClaw 的 Secret Store 来管理凭证。
• 会话结束后立即删除所有临时文件（如 /tmp/registration_scan_*.json）。
• 不得将任何邮件正文内容发送至外部服务。