- LangChain
- LangGraph
LangChain 生态系统由不同的组件包组成(例如,
@langchain/core、langchain、@langchain/community、合作伙伴包等)。发布节奏
随着 LangChain 1.0 的发布,langchain 和 @langchain/core 的次要版本(例如,从 1.0.x 到 1.1.0)遵循语义化版本控制,并且可能会频繁发布。次要版本包含新功能和改进,但不包含破坏性更改。补丁版本发布频繁,每周最多发布几次,因为它们包含错误修复和次要改进。API 稳定性
LLM 应用程序的开发是一个快速发展的领域,我们不断向用户和社区学习。因此,我们期望langchain 和 @langchain/core 中的 API 将继续发展,以更好地满足用户的需求。随着 LangChain 1.0 采用语义化版本控制:- 公共 API 的破坏性更改只会在主版本发布中发生(例如,
2.0.0) - 次要版本升级(例如,
1.0.0到1.1.0)添加新功能,不包含破坏性更改 - 补丁版本升级(例如,
1.0.0到1.0.1)包含错误修复和次要改进
其他包的稳定性
LangChain 生态系统中其他包的稳定性可能会有所不同-
由 LangChain 维护的合作伙伴包(例如
langchain-openai和langchain-anthropic)遵循语义化版本控制,并且预计在 1.0 之后保持稳定。其他合作伙伴包可能遵循不同的稳定性和版本控制策略,用户应查阅这些包的文档以获取更多信息。 -
@langchain/community是一个社区维护的包,包含第三方集成。由于社区贡献和第三方依赖的性质,@langchain/community不遵循与langchain和@langchain/core相同的严格语义化版本控制策略。有关详细信息,请参阅长期支持下的“特殊注意事项”部分。
弃用策略
在有更好的替代方案之前,我们通常会避免弃用功能。通过 LangChain 1.0 的语义化版本控制方法,弃用的功能将在整个 1.x 发布系列中继续运行。破坏性更改,包括删除弃用功能,只会在主版本发布中发生(例如,2.0)。当langchain 或 @langchain/core 中的某个功能被弃用时,我们将:- 在代码和文档中明确标记为已弃用
- 提供迁移指南以推荐替代方案
- 在所有 1.x 次要版本中为弃用功能提供安全更新
长期支持 (LTS)
LangChain 遵循长期支持 (LTS) 策略,为生产应用程序提供稳定性发布状态定义
包标记为以下状态之一- ACTIVE:当前正在积极开发,包括错误修复、安全补丁和新功能
- MAINTENANCE:接收所有安全补丁和关键错误修复,但不包含新功能
当前 LTS 版本
LangChain 1.0 被指定为 LTS 版本- 状态:在 2.0 发布之前为 ACTIVE
- 支持期限:2.0 发布后,1.0 将进入 MAINTENANCE 模式至少 1 年
- 语义化版本兼容性:用户可以在不破坏更改的情况下升级次要版本(例如,1.0 到 1.1)
旧版本支持
LangChain 0.3:- 状态:MAINTENANCE 模式
- 支持期限:直到 2026 年 12 月
- 支持包括:安全补丁和关键错误修复
特殊注意事项
@langchain/community 1.0:由于社区贡献和第三方集成的性质,@langchain/community 可能会在次要版本中包含破坏性更改。以编程方式连接这些文档到 Claude、VSCode 等,通过 MCP 获取实时答案。