【nanabot项目源码解读】events.py 逐行详细注释解析

events.py 逐行详细注释解析配套第4篇《消息总线 Bus：异步通信的核心枢纽》本文档对nanobot/bus/events.py进行逐行深度解析文件概述events.py定义了 nanobot 消息总线的核心数据结构——消息事件类型。这是整个系统消息通信的"契约"，所有模块通过这两个数据类进行消息交换。文件定位：nanobot/bus/ ├── __init__.py # 模块导出 ├── events.py # 消息事件定义（本文件）⭐ └── queue.py # 队列实现核心价值：类型安全：通过 Python 类型注解和 dataclass 确保消息格式一致性结构清晰：明确区分入站消息（用户→Agent）和出站消息（Agent→用户）可扩展性：预留 metadata 字段支持各渠道特有功能不可变性：dataclass 默认支持值语义，便于消息传递和缓存