From bfdc9b00e51b808493b1672b6cc7e178cfd2c7fb Mon Sep 17 00:00:00 2001
From: slhafzjw <slhafzjw@slhaf.work>
Date: Mon, 17 Nov 2025 15:11:02 +0800
Subject: [PATCH] =?UTF-8?q?ActionPlanner=20=E6=B5=81=E7=A8=8B=E5=9B=BE?=
 =?UTF-8?q?=E5=88=B6=E4=BD=9C=E5=AE=8C=E6=AF=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 doc/architechture/action.md | 68 ++++++++++++++++++++++++++++++++++++-
 1 file changed, 67 insertions(+), 1 deletion(-)

diff --git a/doc/architechture/action.md b/doc/architechture/action.md
index b01cd76b..633cdd30 100644
--- a/doc/architechture/action.md
+++ b/doc/architechture/action.md
@@ -1 +1,67 @@
-# 流程参考: 行动模块
\ No newline at end of file
+# 流程参考: 行动模块
+> 行动模块当前仍在推进中，当前展示的为设想中或者当前阶段的流程图，可能与最终实现存在差异
+
+## 前置模块
+### 行动规划模块: [ActionPlanner](../../Partner-Main/src/main/java/work/slhaf/partner/module/modules/action/planner/ActionPlanner.java)
+
+```mermaid
+---
+config:
+  layout: elk
+  elk:
+    nodePlacementStrategy: LINEAR_SEGMENTS
+---
+flowchart TD
+
+    direction TB
+
+    Context --> Input[输入]
+    ActionCore --> ActionTendencyCache[行动意图缓存]
+
+    subgraph AC [行动缓存匹配]
+        Input[输入] --> ActionTendencyCache
+        ActionTendencyCache --> Hit{是否命中}
+    end
+    Hit --> |否| AR
+
+    subgraph AR [行动意图识别]
+        ActionExtractor[行动意图提取]
+
+        Input[输入] --> ActionExtractor
+        Messages --> ActionExtractor
+
+        ActionExtractor --> ExtractorResult{是否存在行动意图}
+    end
+
+    ExtractorResult --> |否| ResultEmpty
+
+    subgraph AE [行动意图评估]
+        ActionTendencies[行动意图列表] 
+        EvaluatorResult[意图评估结果]
+        DATA[数据<br/>---<br/>记忆切片 可选行动单元 近期对话记录 用户信息]
+
+        Hit --> |是| ActionTendencies
+        ExtractorResult --> |是| ActionTendencies
+
+        DATA --> EvaluatorThread1
+        DATA --> EvaluatorThread2
+        DATA --> EvaluatorThread3
+
+        ActionTendencies --> Tendency1[行动意图1] --> EvaluatorThread1[评估线程1] --> EvaluatorResult
+        ActionTendencies --> Tendency2[行动意图2] --> EvaluatorThread2[评估线程2] --> EvaluatorResult
+        ActionTendencies --> Tendency3[行动意图3] --> EvaluatorThread3[评估线程3] --> EvaluatorResult
+    end
+
+    EvaluatorResult --> |放入行动池| ActionCore
+    EvaluatorResult --> |异步更新行动意图缓存| ActionCore
+    EvaluatorResult --> ResultNormal --> |回写| Context
+
+    ResultEmpty@{shape: braces, label: "[结束]<br/>---<br/>行动模块前置流程结束"}
+    ResultNormal@{shape: braces, label: "[结束]<br/>---<br/>聚合为特定格式的 Prompt"}
+
+    ActionCore[行动核心] --> DATA
+    MemoryCore[记忆核心] --> DATA
+    CognationCore[认知核心] --> DATA
+    PerceiveCore[感知核心] --> DATA
+    Context[流程上下文]
+```
\ No newline at end of file