From cd1c1f76f4822b60b8f2b6bb81412ebcaff0da96 Mon Sep 17 00:00:00 2001 From: cfdaily Date: Sun, 7 Jun 2026 08:34:07 +0800 Subject: [PATCH] auto-sync: 2026-06-07 08:34:07 --- docs/design/mail-failure-notification.md | 28 +++++++++++++++++------- 1 file changed, 20 insertions(+), 8 deletions(-) diff --git a/docs/design/mail-failure-notification.md b/docs/design/mail-failure-notification.md index 3686818..938684d 100644 --- a/docs/design/mail-failure-notification.md +++ b/docs/design/mail-failure-notification.md @@ -1,6 +1,6 @@ # Mail 失败通知设计 -> 版本：v1.2-draft | 日期：2026-06-07 | 作者：庞统 | 状态：待二次确认 +> 版本：v1.3 | 日期：2026-06-07 | 作者：庞统 | 状态：待确认 ## 1. 背景 @@ -82,14 +82,26 @@ def notify_mail_failed(db_path: Path, original_mail_id: str, reason: str, detail | must_haves.system_notify | `true`（防递归标记） | | must_haves.in_reply_to | 原邮件 task_id | -通知正文按 reason 区分： +通知正文使用**统一模板**，把所有可能的失败原因和建议放在一封邮件里： -| reason | 正文模板 | 处理建议 | -|--------|---------|---------| -| `no_reply_found` | "你发送的 request 邮件「{title}」未被回复" | "建议重发邮件，或通过黑板任务方式联系" | -| `auth_failed` | "邮件「{title}」投递时认证失败" | "需检查 Agent 配置，联系姜维排查" | -| `crash_limit` | "邮件「{title}」投递时多次崩溃" | "系统异常，建议稍后重试" | -| `task_timeout` | "邮件「{title}」处理超时" | "建议重发或通过其他方式联系" | +``` +你的邮件投递失败了。 + +📧 原始邮件：「{title}」 +👤 收件人：{to_agent} +❌ 失败原因：{reason} + +常见失败原因及处理建议： +• no_reply_found：收件人未回复。建议重发邮件，或通过黑板任务方式联系 +• auth_failed：收件人认证失败。需检查 Agent 配置，联系姜维(jiangwei-infra)排查 +• crash_limit：收件人处理时多次崩溃。系统异常，建议稍后重试 +• task_timeout：处理超时。建议重发或通过其他方式联系 +• 其他原因：建议联系副军师(pangtong-fujunshi)排查 + +——系统自动通知 +``` + +实现时 `{reason}` 替换为实际 reason 字符串，其余排查指引固定不变。 | 其他 | "邮件「{title}」投递失败（原因：{reason}）" | "建议联系副军师(pangtong-fujunshi)排查" | ### 2.7 防递归