> ## Documentation Index
> Fetch the complete documentation index at: https://nvd-54.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 发布政策

本页面说明 LangChain 和 LangGraph 的发布政策。点击下方标签查看各自的发布政策：

<Tabs>
  <Tab title="LangChain">
    LangChain 生态系统由不同的组件包组成（例如 `langchain-core`、`langchain`、`langchain-community`、合作伙伴包等）。

    ## 发布节奏

    随着 LangChain 1.0 的发布，`langchain` 和 `langchain-core` 的**次版本**发布（例如从 `1.0.x` 到 `1.1.0`）遵循语义化版本控制，可能会频繁发布。次版本包含新功能和改进，但不包含破坏性变更。

    补丁版本频繁发布，每周最多数次，包含 Bug 修复和小幅改进。

    ## 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`）包含 Bug 修复和小幅改进

    我们通常会尽量避免不必要的变更，并为即将移除的功能提供弃用政策。

    ### 其他包的稳定性

    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 年
    * **Semver 合规**：用户可以在次版本之间升级（例如 1.0 到 1.1）而不会遇到破坏性变更

    ### 旧版本支持

    **LangChain 0.3**：

    * **状态**：MAINTENANCE 模式
    * **支持期**：至 2026 年 12 月
    * **支持包括**：安全补丁和关键 Bug 修复

    ### 特殊注意事项

    **langchain-community 0.4**：由于社区贡献和第三方集成的性质，`langchain-community` 可能在次版本中包含破坏性变更。它以 0.4 版本发布以反映这种不同的稳定性政策。
  </Tab>

  <Tab title="LangGraph">
    LangGraph 遵循结构化的发布政策，为构建生产应用程序的用户提供稳定性和可预测性。

    ## 发布节奏

    我们预计**主版本**发布之间至少间隔 6-12 个月，以为生产应用程序提供稳定性。

    **次版本**通常每 1-2 个月发布一次，包含新功能和改进。

    **补丁**版本根据需要发布，通常每周一次，以解决 Bug 和安全问题。

    ## API 稳定性

    ### 稳定 API

    所有没有特殊前缀的 API 都被视为稳定且可用于生产环境。我们在主版本内保持稳定功能的向后兼容性。

    ### Beta 功能

    文档中标记为 `beta` 的功能：

    * 功能完整且已测试
    * 可安全用于生产环境，但需了解它们可能会变更
    * 可能会根据用户反馈进行小幅 API 调整

    ### 实验性功能

    标记为 `experimental` 或 `alpha` 的功能：

    * 正在积极开发中
    * 可能会发生重大变更或被移除
    * 应谨慎用于生产环境

    ### 内部 API

    以下划线（`_`）为前缀或明确标记为内部的 API：

    * 不属于公共 API
    * 可能在不通知的情况下变更
    * 不应直接使用

    ## 弃用政策

    弃用功能时：

    1. **弃用通知**：功能标记为已弃用并附带明确的迁移指南
    2. **过渡期**：已弃用功能至少在一个次版本中保持可用
    3. **移除**：功能仅在主版本发布时移除
    4. **迁移支持**：我们提供迁移指南，并在可能时提供自动化工具

    ## 平台兼容性

    ### 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 年
    * **Semver 合规**：用户可以在次版本之间升级（例如 1.0 到 1.1）而不会遇到破坏性变更

    ### 旧版本支持

    **LangGraph 0.4**：

    * **状态**：MAINTENANCE 模式
    * **支持期**：至 2026 年 12 月
    * **支持包括**：所有安全补丁和关键 Bug 修复

    ## 另请参阅

    * [版本管理](/oss/python/versioning) - 版本编号和支持详情
    * [发布](/oss/python/releases) - 特定版本的发布说明和迁移指南
  </Tab>

  <Tab title="深度智能体">
    深度智能体（`deepagents`）是一个用于构建高级智能体架构的快速迭代包。

    ## 1.0 之前状态

    深度智能体目前处于 1.0 之前的开发阶段。虽然我们会尽量减少破坏性变更，但随着我们吸收社区的经验并适应快速变化的智能体应用格局，API 可能会演进。

    ## 发布节奏

    **次版本**发布（例如 `0.1.0` 到 `0.2.0`）可能包含新功能和潜在的破坏性变更，因为包仍在成熟中。

    **补丁**版本发布（例如 `0.1.0` 到 `0.1.1`）包含 Bug 修复和小幅改进，不包含破坏性变更。

    ## API 稳定性

    作为 1.0 之前的包：

    * API 可能在次版本之间变更
    * 我们致力于在变更发生时提供清晰的迁移指南，以最大限度地减少影响
    * 标记为 `experimental` 或 `alpha` 的功能可能会有更大的变更

    ## 弃用政策

    在深度智能体中弃用功能时：

    * 在可能的情况下提前提供弃用警告
    * 在发布说明中包含迁移指南
    * 在后续次版本中移除已弃用的功能

    ## 通往 1.0 之路

    深度智能体将在以下条件满足时达到 1.0：

    * 核心 API 已根据社区反馈稳定
    * 包已在生产环境中经过实战检验
    * 核心功能不再预期有破坏性变更

    达到 1.0 后，深度智能体将遵循与 LangChain 和 LangGraph 相同的语义化版本和 LTS 政策。

    ## 另请参阅

    * [版本管理](/oss/python/versioning) - 版本编号和支持详情
  </Tab>
</Tabs>

***

<div className="source-links">
  <Callout icon="terminal-2">
    [连接这些文档](/use-these-docs)到 Claude、VSCode 等工具，通过 MCP 获取实时答案。
  </Callout>

  <Callout icon="edit">
    [在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/oss/release-policy.mdx)或[提交 issue](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>