在 LangGraph 框架中，构建 AI Agent 的本质是通过节点（Node）、** 边（Edge）和状态（State）** 的有机组合形成图（Graph）。其中，State 是核心载体，负责在节点间传递信息，支撑工具使用、记忆能力、人机交互等复杂功能。其底层基于消息传递机制，确保图的持续运行状态。一. State 的定义模式：共享数据结构的流转 LangGraph 中的 State 是共享的字典型数据结构，每个节点具备访问、读取和写入状态的权限。当节点修改状态时，会广播更新到所有节点，实现数据在图中的流动。class ProjectState(TypedDict): pdf_path: List[str] requirements: Optional[str] pdf_content: Optional[str] architecture: Optional[str] code: Optional[str] plan: Optional[str] dev_status :Optional[str] test_status: Optional[str] test_result :Optional[str] test_logs : Annotated[List[AnyMessage], add_messages] # 多智能体对话消息（可选，用于调试 / LangSmith 观察） messages: Annotated[