Skip to main content本页面解释了 LangChain 和 LangGraph 的发布政策。点击下方标签查看各自的发布政策：
LangChain
LangGraph
Deep Agents
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：当前活跃开发，包括 bug 修复、安全补丁和新功能
- MAINTENANCE：接收所有安全补丁和关键 bug 修复，但无新功能
当前 LTS 发布
LangChain 1.0 被指定为 LTS 发布：
- 状态：ACTIVE 直到 2.0 发布
- 支持周期：2.0 发布后，1.0 将进入 MAINTENANCE 模式至少 1 年
- 语义化版本合规：用户可以在次要版本之间（例如，1.0 到 1.1）升级而不会引起破坏性更改
旧版本支持
LangChain 0.3：
- 状态：MAINTENANCE 模式
- 支持周期：直到 2026 年 12 月
- 支持包括：安全补丁和关键 bug 修复
特殊注意事项
langchain-community 0.4：由于社区贡献和第三方集成的性质，langchain-community 可能在次要版本中引入重大更改。它已发布为 0.4 版本以反映这种不同的稳定性政策。 LangGraph 遵循结构化发布政策，以确保用户在构建生产应用时的稳定性和可预测性。发布节奏
我们预计 主要 发布之间至少间隔 6-12 个月，以提供生产应用的稳定性。次要 发布通常每 1-2 个月发布，包含新功能和改进。补丁 发布按需发布，通常每周发布，以解决 bug 和安全问题。API 稳定性
稳定 API
所有无特殊前缀的 API 被认为是稳定且就绪用于生产使用。我们在主要版本内维护稳定功能的向后兼容性。Beta 特性
文档中标记为 beta 的特性：
- 特性完整且已测试
- 安全用于生产使用，理解它们可能会改变
- 受用户反馈的微小 API 调整
实验性特性
标记为 experimental 或 alpha 的特性：
- 正在积极开发
- 可能会显著改变或被移除
- 应谨慎用于生产
内部 API
前缀为下划线 (_) 或明确标记为内部的 API：弃用政策
当弃用特性时：
- 弃用通知：特性被标记为弃用，带有明确的迁移指南
- 宽限期：弃用特性在至少一个次要版本中保持功能
- 移除：特性仅在主要版本发布中移除
- 迁移支持：我们提供迁移指南，以及可能的自动化工具
平台兼容性
Python 支持
- 我们支持 Python 版本，这些版本由 Python 软件基金会积极维护
- Python 版本要求可能仅在主要版本中改变
- 目前需要 Python 3.10 或更高版本
破坏性更改
破坏性更改仅在主要版本中引入，包括：
- 移除弃用的 API
- 必需参数的更改
- 默认行为的更改，影响现有应用
- 最小 Python/Node.js 版本更新
迁移支持
对于主要版本升级，我们提供：
- 综合迁移指南
- 可行时的自动化迁移脚本
- 前一个主要版本的扩展支持周期
- 所有破坏性更改的清晰文档
长期支持 (LTS)
LangGraph 遵循长期支持 (LTS) 策略，为生产应用提供稳定性：发布状态定义
包被标记为以下状态之一：
- ACTIVE：当前活跃开发，包括 bug 修复、安全补丁和新功能
- MAINTENANCE：接收所有安全补丁和关键 bug 修复，但无新功能
当前 LTS 发布
LangGraph 1.0 被指定为 LTS 发布：
- 状态：ACTIVE 直到 2.0 发布
- 支持周期：2.0 发布后，1.0 将进入 MAINTENANCE 模式至少 1 年
- 语义化版本合规：用户可以在次要版本之间（例如，1.0 到 1.1）升级而不会引起破坏性更改
旧版本支持
LangGraph 0.4：
- 状态：MAINTENANCE 模式
- 支持周期：直到 2026 年 12 月
- 支持包括：所有安全补丁和关键 bug 修复
See also
Deep Agents (deepagents) 是一个快速发展的包，用于构建高级代理架构。Pre-1.0 状态
Deep Agents 目前处于 pre-1.0 开发阶段。虽然我们尽量减少破坏性更改，但 API 可能会随着社区反馈和对代理应用快速变化的景观的适应而演变。发布节奏
次要 发布（例如，0.1.0 到 0.2.0）可能包含新功能和潜在的破坏性更改，随着包的成熟。补丁 发布（例如，0.1.0 到 0.1.1）包含错误修复和小改进，不会引起破坏性更改。API 稳定性
作为 pre-1.0 包：
- APIs 可能在次要版本之间改变
- 我们旨在通过提供清晰的迁移指南来最小化干扰
- 标记为
experimental 或 alpha 的特性会受到更显著的更改
弃用政策
当在 Deep Agents 中弃用特性时：
- 我们在可能的情况下提供弃用警告
- 迁移指南包含在发布笔记中
- 弃用特性在后续的次要版本中被移除
路径到 1.0
Deep Agents 将在以下条件达到 1.0：
- 核心 API 基于社区反馈已稳定
- 包已在生产环境中经过测试
- 不再预期有重大更改
1.0 之后，Deep Agents 将遵循与 LangChain 和 LangGraph 相同的语义化版本和 LTS 策略。See also
