更新 a2s_agent_arch.md

a2s_agent_arch.md

@@ -21,6 +21,110 @@
 
 ## 目录结构
 
+### 主目录
+
 ```text
-ja
+mis-modules\mis-agent\src\main\
+├── java                               # Java源文件
+└── resources
+    └── mapper                         # Mybatis Mapper XML
+    └── application.yml                # 配置文件
+```
+
+### 智能体
+
+```text
+com\lcfc\agent\agents\
+├── a2a                                 # a2a agent
+├── config                              # Spring配置类
+├── constants                           # 常量类
+├── context                             # 自定义的上下文载体类
+├── controller                          # SpringWeb控制器
+├── dubbo                               # Dubbo接口实现类
+├── enums                               # 枚举类
+├── events                              # Spring事件消息载体, 定义ApplicationEventPublisher.publishEvent的Payload
+├── mapper                              # Mybatis Mapper 接口
+├── multiagent                          # 多智能体,采用agentscope-java的Agent AS Tool架构
+├── saa                                 # 单智能体,采用spring-ai-alibaba的方案
+├── service                             # CRUD业务逻辑接口
+│   └── impl                            # CRUD业务逻辑接口实现类
+├── util                                # 工具类
+├── validator                           # 封装复杂的/可复用的验证工具
+├── domain                              # 数据库实体类
+    ├── DTO                             # DTO
+    └── VO                              # VO
+```
+
+### 事件发布订阅
+
+目的是摆脱对`ApplicationEventPublisher`的依赖，在非`springbean`对象中简单的使用发布订阅模式。
+
+```text
+com\lcfc\agent\eventhub\
+├── MisAgentEventHub.java               # 通过init方法注册监听器,使用broadcast推送事件
+└── MisAgentEventListener.java          # 所有监听器都必须实现该接口
+```
+
+### 智能体记忆
+
+管理智能体的长期记忆。
+
+```text
+com\lcfc\agent\memory\
+├── UserLongTermChannel.java            # 长期记忆组件的通道枚举,例如hindsight
+├── UserLongTermMemoryClient.java       # 用户级别长期记忆的客户端接口
+├── UserLongTermMemoryConfig.java       # 用户级别长期记忆的配置
+└── UserLongTermMemoryCtl.java          # 用户级别长期记忆的控制类
+```
+
+### 智能体监控
+
+收集智能体运行时调用了哪些tool、使用了哪些Skill、触发了哪些工作流、查询了哪些知识库、消耗了多少token等数据。
+
+```text
+com\lcfc\agent\monitor\
+├── AgentChatMetricsCtx.java                  # 智能体监控数据的上下文对象
+├── AgentChatMetricsFinishEvent.java          # 智能体监控数据收集完成事件消息载体
+├── AgentChatMetricsFinishListener.java       # 智能体监控数据收集完成事件监听器
+├── IAgentChatMetricsConsumer.java            # 消费智能体监控数据上下文对象的接口
+├── MisAgentChatMetricsCtl.java               # 管理多智能体和单智能体监控上下文对象的控制类
+└── MisMcpToolMetadataCtl.java                # 管理多智能体和单智能体MCP工具元数据的控制类
+```
+
+### 对于agentscope-java的封装
+
+提炼使用agentscope-java构建智能体可复用的能力。
+
+```text
+com\lcfc\agent\scope\
+├── AgentScopeAgentCtl.java                   # 构建ReActAgent.Builder和A2aAgent.Builder对象的控制类
+├── AgentScopeChatUsageUtils.java             # 计算Token消耗的工具类
+├── AgentScopeMemoryCtl.java                  # 管理官方提供的AutoContextMemory自动压缩上下文控制类
+├── AgentScopeModelCtl.java                   # 控制agentscope-java默认使用的聊天模型
+├── AgentScopeMsgCtl.java                     # 管理智能体输入或输出消息,例如查询知识库或者保存用户输入或者智能体输出的消息,或者创建一个会话窗口ID
+├── AgentScopeMsgUtils.java                   # 格式化Msg的工具类
+├── AgentScopeSkillCtl.java                   # 管理Skill的控制类
+├── AgentScopeToolCtl.java                    # 管理Tool以及MCPTool的控制类
+├── KbReferenceCtl.java                       # 引用的知识库控制类
+└── KbSearchCtl.java                          # 知识库搜索控制类
+```
+
+### 项目数据统计相关
+
+```text
+com\lcfc\agent\stats\
+├── api                                 # Controller
+├── service                             # Service
+├── conf                                # 配置类
+├── domain
+│   ├── dto                             # DTO
+│   ├── vo                              # VO
+│   ├── enums                           # Enum
+│   ├── entity                          # Entity
+│   └── mapper                          # Mapper Java源文件
+├── mq
+│   ├── event                           # 消息载体
+│   └── consumer                        # 监听器
+└── resources
+    └── mapper                          # Mapper XML文件 (位于src/main/resources/mapper)
 ```