langchain-core
LangChain 框架的核心基础模块,提供 Runnable 接口、消息抽象、回调系统等关键能力,是整个 LangChain 生态的基础依赖,几乎所有上层组件都依赖于它
核心事实
时间轴 (近 90 天)
LangChain 核心库近期采用小步快跑的发布节奏,每个版本聚焦少数几个修复。
1.6.12 的修复确保 extras 在事件构造时被正确传播。
在 1.6.12 之前,content-block-start 事件被触发时,附着在内容块上的 extras 信息没有被正确传递到事件对象中。
langchain-core 1.6.12 的变更日志只包含两个条目:版本号发布提交(#41277)和修复内容块起始事件 extras 传播问题(#41272)。
对于生产环境,如果当前版本运行稳定且未遇到 extras 传播问题,不必急于升级;如果正在使用流式 content block 相关功能特别是需要读取 extras 的场景,1.6.12 值得纳入升级计划。
使用 requirements.txt 或 poetry.lock 锁定确切版本的项目需要主动更新才能获得修复;使用 ~=1.6.0 或 ^1.6.0 等允许修订号浮动的约束则会自动纳入这类小修复。
langchain-core 采用主版本.次版本.修订号的语义化版本形式,1.6.12 属于修订号递增,按约定表示向后兼容的缺陷修复。
langchain-core 1.6.12 的 Release 由 github-actions 机器人发布,提交经过了 GPG 签名验证。
langchain-core 发布了 1.6.11 版本,该版本由 github-actions 机器人于 15 日自动发布。
如果当前追踪配置完全依赖默认环境变量且运行稳定,升级到 1.6.11 的紧迫性不高。
还有 40 条时间轴事件
全部知识事实 (20)
可通过 pip install -U langchain-core==1.6.6 命令完成升级
90%已验证补丁级别更新通常不引入破坏性变更,一般可以直接升级而无需修改现有代码
90%已验证langchain-core 1.6.6 是补丁级更新,没有引入破坏性变更
80%已验证LangChain 团队发布了 langchain-core 1.6.6 版本更新
80%待验证langchain-core 是整个 LangChain 框架的基础依赖,承载了 Runnable 接口、消息抽象、回调系统等关键能力
70%待验证LangChain 的 Claude 集成通过 langchain-anthropic 子包实现,但模型兼容性的基础抽象定义在 langchain-core 中
70%待验证使用 requirements.txt 或 poetry.lock 锁定确切版本的项目需要主动更新才能获得修复;使用 ~=1.6.0 或 ^1.6.0 等允许修订号浮动的约束则会自动纳入这类小修复。
50%待验证LangChain 核心库近期采用小步快跑的发布节奏,每个版本聚焦少数几个修复。
50%待验证langchain-core 采用主版本.次版本.修订号的语义化版本形式,1.6.12 属于修订号递增,按约定表示向后兼容的缺陷修复。
50%待验证LangChainTracer 在 1.6.11 中支持在初始化时接受 address 参数,其对应 PR 为 #41006。
50%待验证LangChain 生态由多个独立发版的包组成:langchain-core 是最底层抽象层,定义 Runnable、消息类型、工具接口及追踪等基础协议;langchain 提供链与 Agent 的高层封装;langgraph 专注于基于图的状态机式工作流。三者版本号各自独立,并不强制对齐。
50%待验证底层 langchain-core 新增的 API 若不显式暴露,上层 langchain 或 langgraph 未必能直接使用,其透传取决于各上层包的维护节奏。
50%待验证如果当前追踪配置完全依赖默认环境变量且运行稳定,升级到 1.6.11 的紧迫性不高。
50%待验证langchain-core 1.6.11 自 1.6.10 以来包含两个提交:版本发布提交 release(core): 1.6.11 (#41260) 和功能增强 feat(core): accept address inside LangChainTracer (#41006)。
50%待验证如果项目同时安装 langchain-core、langchain-openai、langchain-anthropic 等包,建议一并升级到相互兼容的版本,避免能力声明与实际实现不一致。
50%待验证如果只升级 langchain-openai 而未同步升级 core,可能出现上层读取 profile 的逻辑不认识新字段,或声明被忽略但不报错的情况。
50%待验证langchain-core 1.6.8 相较 1.6.7 的核心改动是通过 PR #41151 加固了作用域(scoped)与兼容性(compatible)IPv6 地址的 SSRF 检查
50%待验证将 SSRF 校验下沉到 langchain-core 核心层,所有依赖该核心库的上层应用都能自动获得防护,无需各自重复实现
50%待验证在核心层统一实现 SSRF 防护体现纵深防御(Defense in Depth)原则,比边界安全思维在安全覆盖面和一致性上更有保障
50%待验证1.6.9 是一个 patch/minor 级别的功能增强更新,向后兼容风险较低
50%