邮件提醒

通过 IMAP / POP3 协议定时连接收件邮箱，拉取最近若干封邮件并与上次快照比对。当满足触发规则时，通过微信、钉钉、飞书等渠道推送通知。

适用场景

• 重要邮件到达即时提醒（不必一直开着邮箱客户端）
• 指定发件人或关键词邮件过滤推送
• 工作邮箱、备用邮箱的新邮件监控
• 将邮件事件接入钉钉 / 飞书 / 微信等 IM 通知

执行流程

每次调度或「立即执行」时，运行客户端在本地连接邮箱服务器：

1. 按配置的协议（IMAP / POP3）、服务器、端口与凭据登录
2. 拉取最近 N 封邮件（IMAP 可选「仅未读」），解析标题、发件人、正文摘要
3. 与上次快照比对，识别 新邮件 列表
4. 按 触发规则 决定是否发送通知

首次执行仅建立基线

第一次执行（尚无历史快照）只会拉取并保存当前邮件列表作为基线，不会推送通知，避免历史邮件一次性触发大量告警。从第二次执行起，才会对新收到的邮件按规则评估并通知。

创建步骤

向导共 4 步：类型 → 邮箱配置 → 触发规则 → 频率与通知。

1. 选择邮件提醒类型

   在客户端点击「新建任务」，选择「邮件提醒」。

   

2. 邮箱配置

   填写收件邮箱的 IMAP/POP3 连接信息与抓取参数。

   

   任务名称

   • 必填，用于任务列表与通知展示
   • 建议写清监控目的，如「QQ 邮箱重要邮件」「工作邮箱-老板来信」

   运行客户端

   控制从哪台客户端连接邮箱。三种方案与会员限制见 运行客户端。邮箱凭据保存在运行节点本地。

   常见服务商

   • 可选 QQ 邮箱、163 邮箱、Gmail、Outlook 等预设，自动填充服务器地址与端口
   • 国内邮箱通常需在邮箱设置中 单独开启 IMAP/POP3，并使用 授权码（非登录密码）

   收件协议

   协议	默认端口	说明
   IMAP	993（SSL）	推荐；支持指定收件箱文件夹、仅检查未读邮件
   POP3	995（SSL）	兼容旧邮箱；每次拉取最近若干封邮件

   服务器与凭据

   字段	说明
   服务器地址	如 imap.qq.com、pop.163.com
   端口	1～65535；勾选「使用 SSL/TLS」
   用户名	完整邮箱地址
   密码 / 授权码	邮箱授权码或应用专用密码，非 Web 登录密码

   配置完成后可点击 测试连接，确认凭据与网络可达。

   抓取参数

   字段	说明
   收件箱文件夹	仅 IMAP；默认 INBOX，可填其他文件夹名
   每次抓取数量	1～100，默认 20；数值越大覆盖越全，耗时略增
   仅检查未读邮件	仅 IMAP；开启后只拉取未读邮件

3. 配置触发规则

   定义 何时发送通知。可添加多条规则，或使用 规则组 嵌套 AND/OR 逻辑。

   

   单条规则参数

   参数	适用规则	说明
   类型	全部	见下文「触发规则」表格
   关键词	标题 / 发件人 / 正文匹配	支持 全局变量
   匹配方式	标题 / 发件人 / 正文匹配	包含关键词 或 正则匹配
   超时阈值（秒）	收取超时	1～300；连接或收取超时时触发

   推荐规则

   若希望 任意新邮件 都通知，添加一条「收到新邮件」规则即可。若只关心特定来源或主题，使用「发件人匹配」或「邮件标题匹配」。

4. 频率与通知

   设置 Cron 调度、随机延迟与通知渠道，保存任务。

   

   检测规则 (Cron)

   • 通过分、时、日、月、周字段或 常用预设 配置检查频率
   • 邮件收取频率不宜过高，建议根据邮箱服务商限制合理设置（如每 5～15 分钟）

   启用通知

   • 关闭时：即使规则满足也不发送任务级通知（执行记录仍会保存）
   • 开启时须选择至少一个 通知渠道

   通知模板

   • 留空时按任务类型与主规则 自动匹配 内置默认模板
   • 模板中可使用 newEmailCount、emailSubject、emailFrom 等变量，详见 通知模板

触发规则

邮件提醒支持以下规则类型（可添加多条，支持规则组与 AND/OR 组合）：

规则类型	说明	典型场景
收到新邮件	本次执行检测到新邮件	任意新邮件即时提醒
邮件标题匹配	新邮件标题包含关键词或匹配正则	含「发票」「合同」的邮件
发件人匹配	新邮件发件人包含关键词或匹配正则	指定客户、上级邮箱来信
邮件正文匹配	新邮件正文包含关键词或匹配正则	正文含验证码、订单号
邮件列表变化	邮件列表与上次快照不同	通用变化检测
收取超时	连接或拉取邮件超时	邮箱服务异常、网络问题

未添加规则时不通知

与其它任务类型相同：未添加任何触发规则时，即使收到新邮件也不会发送任务级通知。请至少添加一条规则（如「收到新邮件」）。

通知模板变量

邮件提醒任务可在 通知模板 中使用以下变量：

变量	说明
newEmailCount	本次检测到的新邮件数量
emailSubject	首封新邮件的标题
emailFrom	首封新邮件的发件人
diff	新邮件差异详情（按渠道渲染）
diffUrl	完整差异详情链接

常见邮箱配置提示

邮箱	IMAP 服务器	说明
QQ / Foxmail	imap.qq.com	设置 → 账户 → 开启 IMAP，生成授权码
163 / 126 / Yeah.net	imap.163.com 等	设置 → POP3/IMAP/SMTP → 开启并获取授权码
Gmail	imap.gmail.com	需开启两步验证并使用应用专用密码
Outlook	outlook.office365.com	部分账号需应用密码

安全提示

邮箱密码 / 授权码保存在 运行客户端本地，不会上传至服务端。请妥善保管凭据，并优先使用邮箱服务商提供的 授权码 而非主密码。