惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

T
Threat Research - Cisco Blogs
博客园 - 聂微东
小众软件
小众软件
P
Proofpoint News Feed
Security Archives - TechRepublic
Security Archives - TechRepublic
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
TaoSecurity Blog
TaoSecurity Blog
博客园 - 司徒正美
罗磊的独立博客
N
News and Events Feed by Topic
cs.AI updates on arXiv.org
cs.AI updates on arXiv.org
S
Security Affairs
S
Security @ Cisco Blogs
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
The GitHub Blog
The GitHub Blog
月光博客
月光博客
S
Secure Thoughts
P
Proofpoint News Feed
cs.CV updates on arXiv.org
cs.CV updates on arXiv.org
Forbes - Security
Forbes - Security
H
Heimdal Security Blog
W
WeLiveSecurity
K
KPMG report finds enterprise disconnect between AI and its ROI | CIO
L
LangChain Blog
T
The Blog of Author Tim Ferriss
NISL@THU
NISL@THU
Google DeepMind News
Google DeepMind News
Cloudbric
Cloudbric
H
Hacker News: Front Page
The Last Watchdog
The Last Watchdog
Hacker News - Newest:
Hacker News - Newest: "LLM"
C
Cisco Blogs
博客园 - 三生石上(FineUI控件)
博客园_首页
Exploit-DB.com RSS Feed
Exploit-DB.com RSS Feed
S
Schneier on Security
Project Zero
Project Zero
SecWiki News
SecWiki News
爱范儿
爱范儿
The Register - Security
The Register - Security
AI
AI
H
Hackread – Cybersecurity News, Data Breaches, AI and More
Y
Y Combinator Blog
L
Lohrmann on Cybersecurity
Application and Cybersecurity Blog
Application and Cybersecurity Blog
P
Privacy International News Feed
J
Java Code Geeks
S
Securelist
C
Cyber Attacks, Cyber Crime and Cyber Security
V
Visual Studio Blog

博客园_首页

Linux实操--组管理、权限管理和定时任务 Java + EasyExcel 实现单个接口导出多个Excel Mem0 源码解析系列(二):提示词工程的深度剖析 Openclaw TaskFlow究竟是什么?和普通Skill技能有什么区别 博文阅读密码验证 - 博客园 嘉立创开源:应该是全网MicroPython教程最多的开发板 Hermes Agent 集成实践:从协议到生产 2026年AI编程工具横评:Cursor、Codex、Claude Code、Zed、Windsurf Java程序员必看的RAG入门教程 2026 AI效率神器:Superpowers + Claude Code 保姆级教程 本地大模型部署全攻略:从 0 到 1 玩转 Ollama 【从0到1构建一个ClaudeAgent】内存管理-上下文压缩 .NET 高级开发 | 设计、实现一个事件总线框架 电子小白入门之NE555 3. WorkBuddy:隐藏玩法,一键召唤专家,让 AI 以"专家身份"给你干活 和AI一起搞事情#3:Claude Teammate 游戏开发翻车实录 【OpenClaw】通过 Nanobot 源码学习架构---(7)Memory C# .NET 周刊|2026年3月3期 我在 Debian 11 上把 K8s 单机搭起来了,过程没你想的那么顺(/opt 目录版) 深度学习进阶(七)Data-efficient Image Transformer CLI+Skill搭建浏览器AI自动化框架,告别一切重复枯燥任务 告别Token账单无底洞:OpenClaw本地部署,重塑企业数据主权的唯一解 FastAPI+Vue:文件分片上传+秒传+断点续传,这坑我帮你踩平了! SBTI 爆火后,我做了个程序员版的 CBTI。。已开源 + 附开发过程 多模态检索开始进入工程期:用 Sentence Transformers 搭建可落地的 Multimodal RAG 100多行代码实现一个最简单的Agent(用ReAct) Claude Code 通关手册(八):推荐 5 个 Hooks,代码质量提升 3 倍 老板:“有人截图了!”。安全部门:“收到,马上查暗水印!” - why技术 技术之外,皆是人间 C#/.NET/.NET Core技术前沿周刊 | 第 69 期(2026年4.01-4.12) Snack JSONPath 项目架构分析 Claude Code Buddy 小析:一个非核心功能,如何体现产品的细节完成度 AI新时代下的图床管理方案-Cloudflare图床+MCP+Skills方案指南 化繁为简:顺丰速运App如何通过 HarmonyOS SDK实现专业级空间测量 从零实现富文本编辑器#13-React非编辑节点的内容渲染 AI开发-python-langchain框架(3-23-OpenAI Functions风格Tool Calling智能助手) .NET + AI 进阶实战:基于类的技能开发 - 打造可治理的 Agent 能力模块 【从0到1构建一个ClaudeAgent】规划与协调-技能 上周热点回顾(4.6-4.12) 电子小白的工具三件套:面包板、杜邦线、万能板 单表五亿数据的查询优化 | Mysql、StarRocks 2. WorkBuddy:从“我是谁”到“帮我干活” C# 如何减少代码运行时间:7 个实战技巧 基于HelixToolkit.SharpDX 渲染3D模型 - 笺上知微 从零开始的双臂具身VLA起源及现阶段发展综述 - SkyXZ 记对 xonsh shell 的使用, 脚本编写, 迁移及调优 - pluvium27 受够了Vibe Coding的失控?换个起点,让AI事半功倍 从开始配置漏洞环境到漏洞复现流程 - 難しい 关于10年工作经验的程序员对OpenClaw的实战经验分享以及看法 - 虚无境 Any metadata 的内存布局 C# .NET 周刊|2026年3月2期 - InCerry 我帮你测过了,测试圈排名第二的 Skill 依然很牛逼 Skill Discovery | 无监督技能发现的经典工作总结 - MoonOut PbootCMS 网站内容数量多导致访问慢?这些实用优化方案帮你提速! - 家兴网络技术工作室 上下文工程是什么?过时了么?一文讲明白! - 一枫说码 网站漏洞怎么发现并修复?一篇实用指南(附完整流程) - 家兴网络技术工作室 开了 TUN 模式还是直连?90% 的人都踩过这个坑 Github日报|2026年04月12日 - AI一族 AScript扩展多种脚本语言 - rockey627 AI 学习笔记:Agent 的记忆机制 你能被装进一个文件里吗?——7 万人把同事"蒸馏"成了 AI - 我没有三颗心脏 Claude Code 通关手册(七):给 AI 装上技能包——Skills 完全指南 - 暮色之狐 在浏览器中快速编辑代码:VSCode Web 集成实践 - Newbe36524 蒸馏自己 skill?基于 Deepseek 的蒸馏器,丐版蒸馏方式,简单便捷 - To_Carpe_Diem Spring AI Aliababa和AgentScope,哪个更好? - 苏三说技术 Etsy 把 1000 个 MySQL 分片迁进 Vitess:425TB 数据背后的真正问题不是性能,而是运维规模 MicroPython LVGL基础知识和概念:底层渲染与性能优化 - FreakStudio 数据库草图算法 Python 潮流周刊#146:CPython 引入 Rust 的进展 - 豌豆花下猫 最小生成树 - mofei1116 红日靶场七:从外网入口、容器逃逸到 AD 接管的完整利用链复盘 - YouDiscovered1t 分享四款开源且实用的 Kafka 管理工具 - 追逐时光者 vLLM 权重加载机制全解析:从挑战到理想架构 LCT 学习笔记 - ACehomoxue Avalonia UI 12.0.0 正式发布:架构演进和性能飞跃 - 张善友 当 AI Agent 把调用链拉长,延迟开始成为一门生意 conhost.exe 无法显示 U+2717 - 145a 太秀了,我把自己蒸馏成了 Skill!已开源 - 程序员鱼皮 ASP.NET Core 内存缓存实战:一篇搞懂该怎么配、怎么避坑 基于 Ghostty 带有分割标签页和为 Claude 编程设计的通知终端 - BugShare AI 焊死入口:教育的“操作系统级”重塑 - 郝hai 初级Java开发工程师使用sql脚本编写代码的过程是简单而且不糊涂 - CoderOilStation Claude Code通关手册(六):MCP协议完全指南 - 暮色之狐 边框灯光环绕动画特效实现指南 - Newbe36524 开源:子木蒸馏版的 SEO 审计工具 seo-audit-skill v1.0 我所理解的Python元模型 【从0到1构建一个ClaudeAgent】规划与协调-TodoWrite - 程序员Seven Claude 和 Codex 在审计 Skill 上性能差异探究 - ACai_sec AScript如何实现中文脚本引擎 - rockey627 【渗透测试】HTB Season10 Garfield 全过程wp - dynasty_chenzi Android 开发者为什么必须掌握 AI 能力?端侧视角下的技术变革 树状数组正确性证明 - AC-wyr 你的 AI 焦虑,可能比 AI 本身更危险——ATM 机没有消灭银行柜员,但恐慌消灭了你的判断力 - 我没有三颗心脏 一个拉胯的分库分表方案有多绝望?整个部门都在救火! - 冰河团队 动态规划入门必学之走方格问题 - Ofnoname PostgREST 与 PostgreSQL 角色权限配置全解析(生产级实践) - SheepDog1998 使用 UEFI 图形输出协议 GOP 在屏幕上显示图像的方法 - 阿源- Claude Code通关手册(五):组建你的AI专家团队,子代理系统 - 暮色之狐 一个程序员到架构师的催婚路之感悟(整整10年后的催婚相亲感悟) - MisterLip 用 Agent Skill 自动生成工作周报 - 赵康
AI开发-python-LangGraph框架(3-30-LangGraph 「追加式消息状态」的原理与实践)
万笑佛 · 2026-04-22 · via 博客园_首页

在基于 LangGraph 构建对话类应用(聊天机器人、智能助手)时,状态管理是核心痛点之一。传统的状态更新往往是「覆盖式」的,每次更新都会清空原有数据,这对于需要保留完整对话历史的场景完全不适用。

今天就给大家分享 LangGraph 中极具实用性的追加式状态管理模式,专门解决对话历史保留问题,无需手动拼接消息,让状态自动追加、流畅迭代。

对话系统的本质是多轮交互、历史留存,用户的每一次提问、AI 的每一次回复,都需要完整保留在状态中,不能丢失任何一条消息。

如果用普通状态管理,每次更新都会覆盖之前的消息,对话会直接「断片」;而追加式状态的核心价值就是:新数据不会覆盖旧数据,而是自动拼接在原有数据之后,完美适配聊天机器人、对话交互等场景。

这种模式的优势非常直观:

  1. 自动保留完整对话历史,无需手动维护消息列表
  2. 状态更新极简,节点只需返回新数据,无需处理历史拼接
  3. 状态流转清晰,符合对话系统的交互逻辑
  4. 扩展性强,多轮对话、长文本交互都能轻松支持

实现追加式状态的关键,是 LangGraph 结合 Python 类型注解的精准设计,核心依赖两个要素:Annotated 类型注解 + 运算符合并规则。

在定义状态结构时,我们不再使用普通的列表类型,而是通过 Annotated 为状态字段绑定追加行为。这是告诉 LangGraph:这个字段的更新方式不是覆盖,而是追加。

搭配 operator.add 运算符,让 LangGraph 知道如何处理新旧状态的合并 —— 对于列表类型,add 运算符等价于列表拼接,新消息会自动追加到原有消息列表的末尾,全程无需手动编写拼接逻辑。

这就是追加式状态的底层逻辑:通过注解声明行为,通过运算符定义规则,让框架自动完成状态追加

基于这个核心原理,我们可以搭建一套完整的对话状态管理体系,整体分为三部分:

对话状态包含两类字段,各司其职:

  • 消息历史字段:使用追加规则,自动保留所有用户与 AI 的消息,是对话的核心数据
  • 辅助状态字段:使用普通覆盖规则,用于存储当前对话主题、状态标识等临时数据,每次更新直接覆盖

这种设计既保证了历史不丢失,又让辅助状态灵活更新,兼顾实用性与简洁性。

LangGraph 的节点函数是状态更新的入口,在追加式模式下,节点的逻辑极度简化:

  • 每个节点只需要生成当前需要新增的一条 / 一组数据
  • 直接返回新数据即可,框架会自动将其追加到原有状态中
  • 无需读取历史消息、无需拼接列表,代码更简洁、可读性更强

比如用户输入节点只需要生成用户的新消息,AI 回复节点只需要生成 AI 的新回复,剩下的追加工作完全交给框架处理。

按照对话的自然流程构建图结构:起始节点 → 用户输入节点 → AI 回复节点 → 总结节点 → 结束节点。

每一步节点执行后,状态都会自动追加新消息,最终在总结节点可以拿到完整的对话历史,实现从交互到总结的全流程闭环。

对比传统的手动维护状态,LangGraph 追加式状态的优势无可替代:

  1. 极简代码:告别手动列表拼接、状态合并,减少冗余代码
  2. 自动管理:框架自动处理消息追加,开发者专注业务逻辑
  3. 稳定可靠:避免因手动合并导致的消息丢失、顺序错乱问题
  4. 场景适配:完美匹配聊天机器人、对话系统、多轮交互等核心场景
  5. 易于扩展:新增节点、新增交互步骤,无需修改状态合并逻辑

这种追加式状态管理模式,不仅仅适用于简单的天气查询机器人,几乎所有需要保留历史交互记录的场景都能使用:

  • 智能客服机器人
  • 多轮对话式助手
  • 长文本交互应用
  • 带记忆功能的 AI 应用

它是 LangGraph 状态管理中最实用、最常用的模式之一,掌握这种设计思路,能让你基于 LangGraph 开发对话类应用时,效率翻倍、稳定性拉满。

LangGraph 的追加式状态管理,通过 Annotated + 运算符的优雅设计,解决了对话系统中历史状态保留的核心难题。它把复杂的状态合并逻辑交给框架,让开发者专注于业务流程与节点逻辑,是构建高质量对话应用的必备技巧。

后续我会继续分享 LangGraph 状态管理的其他进阶模式,帮助大家彻底掌握 LangGraph 核心能力,轻松开发企业级 AI 应用。

实现代码:

"""
📌 模式2: 消息历史追加
核心机制: Annotated[List, add] 实现自动追加(非覆盖)
适用场景: 聊天机器人、对话系统、需要保留完整历史的场景
"""
import asyncio
from typing import TypedDict, List, Annotated
from operator import add  # 关键:列表追加操作符
from langgraph.graph import StateGraph, START, END
from langchain_core.messages import HumanMessage, AIMessage


# ===== 1. 状态定义(关键:Annotated + add)=====
class ChatState(TypedDict):
    """
    聊天状态设计:
    - messages: 使用 Annotated[List, add] → 自动追加新消息
    - current_topic: 当前对话主题(普通字段,覆盖更新)
    """
    messages: Annotated[List[HumanMessage | AIMessage], add]  # ⚠️ 核心:add 操作符
    current_topic: str


# ===== 2. 节点函数 =====
def user_input_node(state: ChatState) -> dict:
    """
    用户输入节点: 追加用户消息
    返回 {"messages": [新消息]} → 自动追加到历史
    """
    print(f"\n[用户输入] 当前消息数: {len(state['messages'])}")
    new_msg = HumanMessage(content="用户: 今天天气怎么样?")
    return {
        "messages": [new_msg],  # 返回单元素列表
        "current_topic": "天气查询"
    }


def ai_response_node(state: ChatState) -> dict:
    """
    AI回复节点: 追加AI消息
    ⚠️ 注意: 返回的 messages 会追加,不会覆盖历史!
    """
    print(f"[AI回复] 当前消息数: {len(state['messages'])}")
    new_msg = AIMessage(content="AI: 今天北京晴,25°C,适合外出")
    return {
        "messages": [new_msg],  # 再次返回单元素列表
        "current_topic": "天气详情"
    }


def summary_node(state: ChatState) -> dict:
    """
    总结节点: 展示完整对话历史
    """
    print(f"\n[对话总结] 总消息数: {len(state['messages'])}")
    for i, msg in enumerate(state['messages'], 1):
        role = "👤" if isinstance(msg, HumanMessage) else "🤖"
        print(f"  {role} 消息{i}: {msg.content[:30]}...")
    return {"current_topic": "对话结束"}


# ===== 3. 构建图 =====
def build_chat_graph():
    builder = StateGraph(ChatState)
    builder.add_node("user_input", user_input_node)
    builder.add_node("ai_response", ai_response_node)
    builder.add_node("summary", summary_node)

    builder.add_edge(START, "user_input")
    builder.add_edge("user_input", "ai_response")
    builder.add_edge("ai_response", "summary")
    builder.add_edge("summary", END)

    return builder.compile()


# ===== 4. 执行演示 =====
async def main():
    print("=" * 60)
    print("🧠 模式2: 消息历史追加(Annotated + add)")
    print("=" * 60)

    graph = build_chat_graph()
    # 画图
    print(graph.get_graph().draw_ascii())

    # 初始状态(必须初始化 messages 为空列表!)
    initial_state = {
        "messages": [],  # ⚠️ 关键:必须初始化,否则合并失败
        "current_topic": "初始"
    }

    print("\n【初始状态】messages 长度: 0")

    # 执行图
    final_state = await graph.ainvoke(initial_state)

    print("\n【最终状态】")
    print(f"  messages 长度: {len(final_state['messages'])}")
    print(f"  current_topic: {final_state['current_topic']}")




if __name__ == "__main__":
    asyncio.run(main())

结果输出:

============================================================
🧠 模式2: 消息历史追加(Annotated + add)
============================================================
 +-----------+   
 | __start__ |   
 +-----------+   
        *        
        *        
        *        
+------------+   
| user_input |   
+------------+   
        *        
        *        
        *        
+-------------+  
| ai_response |  
+-------------+  
        *        
        *        
        *        
  +---------+    
  | summary |    
  +---------+    
        *        
        *        
        *        
  +---------+    
  | __end__ |    
  +---------+

【初始状态】messages 长度: 0

[用户输入] 当前消息数: 0
[AI回复] 当前消息数: 1

[对话总结] 总消息数: 2
  👤 消息1: 用户: 今天天气怎么样?...
  🤖 消息2: AI: 今天北京晴,25°C,适合外出...

【最终状态】
  messages 长度: 2
  current_topic: 对话结束

更多学习资料尽在 老虎网盘资源