b7718100c5
feat: add regex fallback for verification code extraction without Workers AI When AI email extraction is enabled but no Workers AI binding is available, fall back to a built-in, zero-dependency regex extractor so self-hosted deployments without Workers AI still surface verification codes in Telegram notifications and webhooks. - Add worker/src/email/extract_code.ts: rule-based multilingual (English / Chinese / Japanese / Korean) verification-code extractor with year and YYYYMMDD date rejection to avoid false positives. - ai_extract.ts: share the allowlist check and content parsing across both paths, extract a saveExtractMetadata helper, and use the regex fallback when env.AI is absent. - Reuse the existing aiExtractResult pipeline (auth_code type), so Telegram and webhook output need no changes. - Update bilingual CHANGELOG and AI-extract feature docs.
4.5 KiB
AI 邮件识别
Note
此功能从 v1.1.0 版本开始支持
本功能参考自 Alle 项目
功能说明
AI 邮件识别功能使用 Cloudflare Workers AI 自动分析收到的邮件内容，智能提取重要信息，包括：
- 验证码 (auth_code) - OTP、安全码、确认码等
- 认证链接 (auth_link) - 登录、验证、激活、重置密码链接
- 服务链接 (service_link) - GitHub、GitLab、部署通知等服务相关链接
- 订阅管理链接 (subscription_link) - 退订、管理订阅等链接
- 其他链接 (other_link) - 其他有价值的链接
提取结果会自动保存到数据库的 metadata 字段中，前端可以直接展示提取的验证码或链接。
配置变量
| 变量名 | 类型 | 说明 | 示例 |
|---|---|---|---|
ENABLE_AI_EMAIL_EXTRACT |
文本/JSON | 是否启用 AI 邮件识别功能 | true |
AI_EXTRACT_MODEL |
文本 | AI 模型名称，从支持 JSON 模式的模型中选择 | @cf/meta/llama-3.1-8b-instruct-fast |
推荐使用 @cf/meta/llama-3.1-8b-instruct-fast 作为默认模型，它支持当前实现依赖的 JSON Mode，且 Cloudflare 说明 -fast 变体会保持可用。价格更低的 @cf/meta/llama-3.1-8b-instruct-fp8-fast 目前不在 JSON Mode 支持列表中，不建议用于本功能。Cloudflare 推荐的新模型 @cf/zai-org/glm-4.7-flash 适合多语言场景，但用于本功能前请先确认它在你的账号/区域支持结构化 JSON 输出。旧默认模型 @cf/meta/llama-3.1-8b-instruct 将于 2026-05-30 被 Cloudflare 弃用，不建议继续使用。
内容长度限制
为避免 AI 模型 token 限制，邮件内容最大处理长度为 4000 字符。超过此长度的邮件内容将被截断后再进行 AI 分析。
Workers AI 绑定
需要在 wrangler.toml 中配置 Workers AI 绑定：
[ai]
binding = "AI"
或在 Cloudflare Dashboard 的 Worker 设置中添加：
- Variable name:
AI - Type: Workers AI
无 Workers AI 绑定时的正则兜底
如果启用了 ENABLE_AI_EMAIL_EXTRACT 但没有配置 Workers AI 绑定（例如自部署时未开通 Workers AI），系统会自动回退到内置的正则验证码提取：
- 仅提取验证码（
auth_code），不提取链接（链接提取依赖 AI） - 零依赖、零成本，在 Worker 内本地完成
- 支持中文、英文、日文、韩文常见验证码格式
- 自动排除年份（如
2026）与YYYYMMDD日期，降低误判 - 提取结果同样写入
metadata，并复用 Telegram 推送与 Webhook 占位符（此时aiExtractType为auth_code）
当配置了 Workers AI 绑定时，仍优先使用 AI 提取（可识别验证码与各类链接），不受此回退影响。
地址白名单（可选）
为了控制成本和资源使用，可以在 Admin 控制台的 AI 提取设置 页面配置地址白名单：
配置说明
- 未启用白名单：所有邮箱地址都可使用 AI 提取功能
- 启用白名单：仅白名单中的邮箱地址会进行 AI 提取
白名单格式
每行一个地址，支持通配符 * 匹配任意字符：
- 精确匹配：
user@example.com- 仅匹配该邮箱 - 域名通配符：
*@example.com- 匹配 example.com 域名下的所有邮箱 - 用户通配符：
admin*@example.com- 匹配 admin 开头的邮箱 - 任意位置通配符：
*test*@example.com- 匹配包含 test 的邮箱 - 多个通配符：
admin*@*.com- 匹配所有 .com 域名下 admin 开头的邮箱
配置示例
user@example.com
*@mydomain.com
admin*@company.com
此配置将只对以下邮箱进行 AI 提取：
user@example.com（精确匹配）- 所有
@mydomain.com的邮箱（如test@mydomain.com、admin@mydomain.com） - 所有
admin开头的@company.com邮箱（如admin@company.com、admin123@company.com）