跳到主要内容

文档索引

在以下地址获取完整的文档索引:https://docs.langchain.org.cn/llms.txt

在进一步探索之前,请使用此文件发现所有可用页面。

本页面说明了 LangChain 和 LangGraph 的发布策略。点击下方的选项卡可查看各项发布策略。
LangChain 生态系统由不同的组件包组成(例如 @langchain/corelangchain@langchain/community、合作伙伴包等)。

发布节奏

随着 LangChain 1.0 的发布,langchain@langchain/core次要版本(例如从 1.0.x1.1.0)遵循语义化版本控制,并可能频繁发布。次要版本包含新功能和改进,但不包含破坏性变更。补丁版本发布频繁,每周最多几次,因为它们包含错误修复和细微改进。

API 稳定性

LLM 应用程序的开发是一个快速发展的领域,我们不断向用户和社区学习。因此,我们预计 langchain@langchain/core 中的 API 将继续演进,以更好地满足用户的需求。随着 LangChain 1.0 采用语义化版本控制:
  • 对公共 API 的破坏性变更仅会出现在主要版本发布中(例如 2.0.0
  • 次要版本升级(例如 1.0.01.1.0)会添加新功能,且不会产生破坏性变更
  • 补丁版本升级(例如 1.0.01.0.1)包含错误修复和细微改进
我们通常会尽量避免进行不必要的变更,并会针对正在移除的功能提供弃用策略。

其他包的稳定性

LangChain 生态系统中其他包的稳定性可能会有所不同
  • 由 LangChain 维护的合作伙伴包(如 langchain-openailangchain-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 版本
  • 状态:ACTIVE(在 2.0 发布前)
  • 支持周期:2.0 发布后,1.0 将进入 MAINTENANCE 模式,至少维持 1 年
  • Semver 合规性:用户可以在次要版本之间升级(例如 1.0 到 1.1),且不会产生破坏性变更

旧版本支持

LangChain 0.3:
  • 状态:MAINTENANCE 模式
  • 支持周期:至 2026 年 12 月
  • 支持内容:安全补丁和关键错误修复

特殊考量

@langchain/community 1.0:由于社区贡献和第三方集成的性质,@langchain/community 在次要版本中可能会有破坏性变更。

© . This site is unofficial and not affiliated with LangChain, Inc.