01WHAT IT SOLVES
这个项目解决什么问题？
langchain 定位为智能体工程与大语言模型应用开发框架，核心以模块化组件和标准接口组织模型、嵌入、向量库、检索器、工具与集成，便于组合调用和替换模型。在生态分工中，Deep Agents 提供规划、子智能体和文件系统等高层能力，LangGraph 面向可控、复杂的智能体编排，LangSmith 承担评估、可观测与调试。相较只调用单一模型接口的方式，它承担应用编排与集成层角色；若需求偏高级定制，可转向 LangGraph。
02CORE CAPABILITIES
核心能力
标准组件接口
通过统一抽象连接聊天与嵌入模型、向量库、检索器和工具
模型可互换
支持替换和比较不同模型，以适应模型选型与应用需求变化
实时数据增强
可连接模型提供商、工具、向量库及内部外部数据源
模块化应用构建
以组件化架构组合链式调用和智能体流程，支持快速原型与迭代
生产配套集成
可结合 LangSmith 进行监控、评估、调试及智能体部署
03适合谁
- 构建大语言模型应用与智能体的 Python 开发者
- 需要快速验证模型、提示词、工具和检索方案的团队
- 需要在多个模型提供商与外部系统之间切换的工程师
- 需要可观测、评估和部署配套能力的应用团队
04典型使用场景
- 构建能够调用外部工具和数据源的智能体
- 搭建基于检索与模型生成的问答应用
- 比较不同模型与工作流并快速迭代原型
- 将实验方案接入评估、观测和部署流程
05为什么值得关注
- 同时覆盖模型、嵌入、工具、检索器和向量库集成，减少重复连接工作
- 提供从高层抽象到细粒度组件的多层使用方式
- 与 Deep Agents、LangGraph 和 LangSmith 形成从构建到编排运维的生态分工
- 新版本持续调整 Python 支持、决策模型和模型路由中间件
06采用前要注意
- 最新列出的 langchain 1.5.0 已停止支持 Python 3.10，最低版本改为 Python 3.11
- langchain 1.5.0 要求 langchain-core 至少为 1.8.0，升级时需同步检查依赖
- 核心框架之外的高级编排、评估、观测和部署分别涉及 LangGraph 与 LangSmith
07RELEASE INTELLIGENCE
近期版本变化
langchain langchain-typesafe==0.1.0：版本变化解读
该版本停止支持 Python 3.10，最低版本改为 Python 3.11，并要求 langchain-core 至少为 1.8.0；experimental 附加项要求 langchain 1.5.0。Python 3.10 用户将继续解析到 langchain-typesafe 0.0.x。版本还弃用实验性中间件并加入 TypeSafeClassifier 决策模型，升级前需要检查 Python、依赖和中间件使用情况。
- 最低支持版本调整为 Python 3.11
- experimental 附加项要求 langchain 1.5.0
- 新增 TypeSafeClassifier 决策模型
- 弃用实验性中间件
langchain langchain==1.5.0：版本变化解读
该版本移除已停止维护的 Python 3.10 支持，最低 Python 版本调整为 3.11，langchain-core 最低版本调整为 1.8.0；Python 3.10 用户将继续解析到 langchain 1.4.x。同时新增模型路由与自动模式中间件，使用者需重点关注运行时升级及仍处于 beta 阶段的 ModelRouterMiddleware。
- 最低支持版本调整为 Python 3.11
- langchain-core 最低版本调整为 1.8.0
- 新增模型路由与自动模式中间件
langchain langchain-core==1.8.0：版本变化解读
该版本移除已结束生命周期支持的 Python 3.10，最低支持版本改为 Python 3.11；Python 3.10 用户将继续解析到 langchain-core 1.7.x。核心包同时加入决策模型能力，直接依赖 langchain-core 的项目应评估 Python 升级节奏及新增接口的影响。
- 最低支持版本调整为 Python 3.11
- Python 3.10 用户继续使用 langchain-core 1.7.x
- 新增决策模型能力
langchain langchain==1.4.10：版本变化解读
该版本修复中间件内部模型调用被放入 messages 流的问题，避免相关调用出现在预期的消息输出中；同时从 ModelRefusalMiddleware 的追踪信息中省略输入，并更新较新 Python 版本的依赖锁定解析。涉及消息流、拒绝中间件或追踪数据的项目需要关注这些修复。
- 中间件内部模型调用不再进入 messages 流
- ModelRefusalMiddleware 追踪中省略输入
- 更新较新 Python 版本的依赖锁定解析
langchain langchain-core==1.7.7：版本变化解读
该版本为 load() 增加嵌套深度上限，以限制过深的加载结构；同时更新较新 Python 版本的依赖锁定解析。处理复杂序列化对象、深层加载或依赖锁定的项目应检查这一版本，但官方说明未提供更多细节。
- 为 load() 增加嵌套深度上限
- 更新较新 Python 版本的依赖锁定解析
langchain-fireworks langchain-fireworks==1.7.3：按模型配置默认输出上限
Fireworks 集成改为从模型配置中取得默认 max_tokens，并刷新模型配置数据。该变化会影响使用 Fireworks 且未显式设置输出上限的应用，升级后默认行为可能随对应模型配置调整。官方仅列出数据刷新，未逐一说明受影响的模型，官方说明未提供更多细节。
- 默认 max_tokens 改为读取模型配置
- 刷新模型配置数据
- 受刷新影响的具体模型官方说明未提供更多细节
langchain-typesafe langchain-typesafe==0.0.2：实验中间件支持分类器
类型安全组件的实验性中间件开始接受 classifier 参数，为按分类逻辑处理或组织请求提供了新入口，适合正在试验该中间件的开发者关注。官方未说明 classifier 的具体行为、调用时机和适用范围，官方说明未提供更多细节。
- 实验性中间件新增 classifier 参数支持
- 适合类型安全中间机的早期采用者验证
- classifier 的具体语义官方说明未提供更多细节
langchain-core langchain-core==1.7.6：优化流式消息与JSON解析
核心包在累积 Runnable 流时改为一次性合并 AIMessageChunk，并停止让 parse_partial_json 按单字符反复重试。前者面向流式消息处理路径，后者面向部分 JSON 解析场景，能够减少重复处理。使用相关流式接口或部分 JSON 解析能力的开发者需关注此次调整。
- 累积 Runnable 流时一次性合并 AIMessageChunk
- parse_partial_json 不再逐字符重试
- 主要影响流式消息与部分 JSON 解析场景
langchain-fireworks==1.7.2：修正用量统计并转正重排序
langchain-fireworks 1.7.2 修正流式令牌用量重复上报问题，并在响应元数据中记录所服务的模型，同时将重排序功能移出测试阶段。更新影响 Fireworks 集成的流式统计、模型识别和重排序使用方式；官方说明未提供更多细节。
- 流式令牌用量仅上报一次
- 响应元数据新增所服务模型信息
- 重排序功能不再处于测试阶段
- 刷新模型档案并更新多项依赖
langchain langchain==1.4.9：统一模型拒答内容块
此次更新为 langchain 1.4.9，标准化模型拒答内容块，并为拒答处理要求 langchain-core 至少为 1.7.5。使用模型拒答、错误分流或跨模型统一处理的团队需同步检查核心依赖版本，避免升级后出现不兼容。
- 标准化模型拒答内容块
- 要求 langchain-core 版本不低于 1.7.5
- 处理模型拒答内容的用户需检查依赖升级