From b3de854c46695dee1597d18ab664d1e4c2397f81 Mon Sep 17 00:00:00 2001
From: Losita <2810873701@qq.com>
Date: Thu, 12 Mar 2026 22:28:21 +0800
Subject: [PATCH] =?UTF-8?q?Version:=200.5.3.dev.260312=20docs:=20?=
 =?UTF-8?q?=F0=9F=93=9D=20=E6=9B=B4=E6=96=B0=20README=20=E4=B8=AD=E7=9A=84?=
 =?UTF-8?q?=20Mermaid=20=E6=B5=81=E7=A8=8B=E5=9B=BE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 添加并更新了两个关键场景的流程图：

  * 命中“添加日程/随口记”后的完整业务流转图
  * 总分流图（普通聊天 vs 执行任务），清晰展示聊天与任务执行的流程区分
---
 README.md | 47 ++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 46 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index ab31c51..01af54a 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# 1 项目概览
+# 1 项目概览
 
 ## 1.1 总体介绍
 
@@ -352,7 +352,51 @@ $$Gap = \frac{TotalAvailableSlots - (TaskCount \times 2)}{TaskCount + 1}$$
 
 ## 5.4 Agent范式实现细节
 
+### 1) 命中“添加日程/随口记”后的业务流转
 
+```mermaid
+flowchart TD
+    A[用户消息进入 /agent/chat] --> B[规范会话ID + 选模型]
+    B --> C[确保会话存在\nRedis会话状态检查\n必要时回源DB创建]
+    C --> D[quick_note.request.accepted\n推送reasoning状态块]
+    D --> E[意图识别节点\nquick_note.intent.analyzing]
+    E --> F{是否随口记意图}
+    F -- 否 --> X[回落普通聊天链路]
+    F -- 是 --> G[时间抽取与校验\nquick_note.deadline.validating]
+    G --> H{时间是否有效}
+    H -- 否 --> I[返回纠错文案\n不写库\nquick_note.failed]
+    H -- 是 --> J[优先级评估\nquick_note.priority.evaluating]
+    J --> K[调用写库工具\nquick_note.persisting]
+    K --> L{写入是否成功}
+    L -- 否 --> M[按重试策略处理\n最终失败则返回错误文案]
+    L -- 是 --> N[quick_note.persisted]
+    N --> O[quick_note.reply.polishing\nAI生成贴题轻松跟进句]
+    O --> P[拼接最终正文\n一次性content输出]
+    P --> Q[后置持久化\nuser+assistant写Redis\n并写outbox/DB]
+```
+
+### 2) 总分流图（消息识别后的去向）
+
+```mermaid
+flowchart TD
+    A[用户消息进入 AgentChat] --> B{是否命中任务/提醒关键词}
+
+    B -- 否 --> C[尝试随口记graph（静默）]
+    C --> D{是随口记意图?}
+    D -- 是 --> E[执行随口记写库链路\n返回一次性正文]
+    D -- 否 --> F[普通聊天链路\nStreamChat token流式输出]
+
+    B -- 是 --> G[开启reasoning状态推送]
+    G --> H[执行随口记graph（带阶段状态）]
+    H --> I{是随口记意图?}
+    I -- 是 --> J[执行随口记写库链路\n返回一次性正文]
+    I -- 否 --> K[推送fallback状态\n回落普通聊天StreamChat]
+
+    E --> Z[后置持久化\nRedis + outbox/DB]
+    F --> Z
+    J --> Z
+    K --> Z
+```
 
 # 6 前端实现
 
@@ -376,3 +420,4 @@ $$Gap = \frac{TotalAvailableSlots - (TaskCount \times 2)}{TaskCount + 1}$$
 
 # 8 快速开始
 
+