feat: harden Telegram mail notifications

docs/GUIDE.md

@@ -64,13 +64,16 @@ DNS 生效通常需要几分钟到数小时。系统只能检测记录，不能
 管理员可以把每封新收邮件的概要发送到自己的 Telegram 私聊：
 
 1. 使用 `@BotFather` 创建一个邮件通知机器人并取得 Bot Token。
-2. 在 Telegram 中打开机器人，发送 `/start`。
-3. 进入“管理后台 -> 系统设置 -> 通知”。
-4. 填写 Bot Token，点击“自动获取”取得私聊 Chat ID。
-5. 选择正文显示方式并点击“测试通知”。
-6. 测试成功后开启“私聊新邮件通知”，保存设置。
+2. 进入“管理后台 -> 系统设置 -> 通知”，填写 Bot Token。
+3. 点击“安全绑定”生成一次性绑定码，再点击“打开机器人”。
+4. 在机器人会话中发送页面生成的绑定码，然后点击“完成绑定”。
+5. 勾选需要通知的邮箱；需要接收未注册地址邮件时，另行勾选“未知收件”。
+6. 选择正文显示方式并点击“测试通知”。
+7. 测试成功后开启“私聊新邮件通知”，保存设置。
 
-通知会显示发件人、收件邮箱、主题、收件时间、正文和附件名称。Telegram 连接失败不会影响邮局收件，系统会保留通知任务并自动重试。Bot Token 不会在设置页面重新显示；以后修改其他设置时，Token 输入框留空即可保留原值。
+一次性绑定码有效期为 10 分钟，只会匹配发送了该绑定码的私聊账号。通知会显示主题、发件人、收件邮箱、服务器收件时间、正文和附件摘要；识别到唯一高可信验证码时，会高亮显示并提供“复制验证码”按钮。外部 IMAP 第一次同步导入的历史邮件不会发送通知，后续新邮件才会通知。
+
+Telegram 连接失败不会影响邮局收件。系统会保留通知任务并自动重试；关闭通知、更换机器人、更换私聊账号或修改通知邮箱范围时，尚未发送的旧任务会被清除。Telegram Bot API 不提供客户端幂等键，因此网络超时发生在 Telegram 已收到请求但服务器未收到响应时，极少数通知可能重复发送。Bot Token 不会在设置页面重新显示；以后修改其他设置时，Token 输入框留空即可保留原值。
 
 邮件通知机器人只负责部署实例的私聊提醒。项目版本频道通知由 GitHub Release 工作流统一发送，不需要在每台服务器重复配置。