auto-sync: 2026-06-07 08:34:07

2026-06-07 08:34:07 +08:00
parent 7e1bdec0b2
commit cd1c1f76f4
1 changed files with 20 additions and 8 deletions
@@ -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 防递归