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

# 发布策略

> 本页面解释了 LangChain 和 LangGraph 的发布政策。点击下方标签查看各组件的发布政策：

本页面解释了 LangChain 和 LangGraph 的发布政策。点击下方标签查看各组件的发布政策：

> [tab] LangChain
>
> :::python
> LangChain 生态系统由不同组件包组成（例如 `langchain-core`、`langchain`、合作伙伴包等）
> :::
> :::js
> LangChain 生态系统由不同组件包组成（例如 `@langchain/core`、`langchain`、合作伙伴包等）
> :::
>
> ## 发布节奏
>
> :::python
> 自 LangChain 1.0 发布后，`langchain` 和 `langchain-core` 的 **次要** 版本（例如从 `1.0.x` 到 `1.1.0`）遵循语义版本规范，可能频繁发布。次要版本包含新功能和改进，但不包含破坏性变更。
> :::
> :::js
> 自 LangChain 1.0 发布后，`langchain` 和 `@langchain/core` 的 **次要** 版本（例如从 `1.0.x` 到 `1.1.0`）遵循语义版本规范，可能频繁发布。次要版本包含新功能和改进，但不包含破坏性变更。
> :::
>
> 补丁版本会频繁发布（每周最多几次），包含漏洞修复和小改进。
>
> ## API 稳定性
>
> :::python
> LLM 应用开发是快速演进的领域，我们持续从用户和社区中学习。因此，我们预期 `langchain` 和 `langchain-core` 的 API 将持续演进以更好地满足用户需求。
> :::
> :::js
> 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版本后保持稳定。其他合作伙伴包可能采用不同的稳定性和版本管理策略，用户应参考对应包的文档获取更多信息。
>
> ## 弃用政策
>
> 我们通常会避免在引入更好替代方案前弃用功能。
>
> :::python
> 在LangChain 1.0的语义化版本管理机制下，弃用功能将在整个1.x版本系列中持续可用。破坏性变更（包括弃用功能的移除）仅在主版本发布（例如2.0）时生效。
>
> 当功能在 `langchain` 或 `langchain-core` 中被标记为弃用时，我们将：
>
> * 在代码和文档中明确标注弃用状态
> * 提供向推荐替代方案的迁移指引
> * 通过所有1.x小版本持续为弃用功能提供安全更新
>   :::
>   :::js
>   在LangChain 1.0的语义化版本管理机制下，弃用功能将在整个1.x版本系列中持续可用。破坏性变更（包括弃用功能的移除）仅在主版本发布（例如2.0）时生效。
>
> 当功能在 `langchain` 或 `@langchain/core` 中被标记为弃用时，我们将：
>
> * 在代码和文档中明确标注弃用状态
> * 提供向推荐替代方案的迁移指引
> * 通过所有1.x小版本持续为弃用功能提供安全更新
>   :::
>
> 在特定情况下（例如未引发维护问题），我们可能允许弃用功能在代码库中保留更长时间以进一步降低用户负担。
>
> ## 长期支持（LTS）
>
> LangChain采用长期支持（LTS）政策为生产应用提供稳定性：
>
> ### 版本状态定义
>
> 包将标记为以下状态之一：
>
> * **ACTIVE**：当前持续开发中，包含漏洞修复、安全补丁和新功能
> * **MAINTENANCE**：仅接收安全补丁和关键漏洞修复，不新增功能
>
> ### 当前LTS版本
>
> **LangChain 1.0** 已被标记为长期支持（LTS）版本：
>
> * **状态**: 直至2.0版本发布前为活跃状态
> * **支持周期**: 2.0版本发布后，1.0将进入维护模式至少一年
> * **语义版本兼容性**: 用户可安全升级至次要版本（如1.0→1.1）且无破坏性变更
>
> ### 遗留版本支持
>
> **LangChain 0.3**：
>
> * **状态**: 维护模式
> * **支持周期**: 直至2026年12月
> * **支持内容**: 安全补丁和关键缺陷修复

> [tab] LangGraph
>
> LangGraph 遵循结构化发布策略，确保用户构建生产级应用时的稳定性和可预测性。
>
> ## 发布节奏
>
> 我们预计**主要版本**间隔至少6-12个月，以保障生产应用稳定性。
>
> **次要版本**通常每1-2个月发布新功能与改进。
>
> **补丁版本**按需发布（通常每周一次），用于修复缺陷和漏洞。
>
> ## API 稳定性
>
> ### 稳定 API
>
> 无特殊前缀的API均视为稳定，适用于生产环境。我们会在主版本内保持稳定功能向后兼容。
>
> ### Beta 功能
>
> 文档中标记为 `beta` 的功能特性：
>
> * 功能完整且经过测试
> * 在理解可能变更的前提下可用于生产
> * 根据用户反馈可能进行次要API调整
>
> ### 实验性功能
>
> 标记为 `experimental` 或 `alpha` 的功能：
>
> * 处于活跃开发中
> * 可能发生重大变更或移除
> * 建议谨慎用于生产环境
>
> ### 内部 API
>
> 以下两种情况视为内部API：
>
> * 前缀为下划线（`_`）
> * 文档明确标记为内部
> * API特性：
>   * 不属于公共API
>   * 可能无通知变更
>   * 不应直接调用
>
> ## 弃用政策
>
> 弃用功能时遵循以下流程：
>
> 1. **弃用通知**: 明确标记为弃用并提供迁移指引
> 2. **缓冲期**: 弃用功能在至少一个次要版本中保持可用
> 3. **移除**: 仅在主版本发布时移除
> 4. **迁移支持**: 提供迁移指南，必要时提供自动化工具
>
> ## 平台兼容性
>
> :::python
>
> ### Python支持
>
> * 我们支持 Python Software Foundation 维护的活跃版本
> * Python 版本要求仅在重大版本中更新
> * 当前需要 Python 3.10 或更高版本
>   :::
>
> :::js
>
> ### JavaScript/TypeScript 支持
>
> * 我们支持 Node.js 长期支持（LTS）版本
> * 所有公共 API 都提供 TypeScript 类型定义
> * 客户端组件的浏览器兼容性在文档中均有说明
>   :::
>
> ## 重大版本变更
>
> 重大版本中才会引入破坏性变更，包括：
>
> * 移除已弃用 API
> * 修改必需参数
> * 影响现有应用行为的默认行为变更
> * Python/Node.js 最小版本更新
>
> ## 迁移支持
>
> 进行重大版本升级时，我们提供：
>
> * 完整的迁移指南
> * 可行时提供的自动化迁移脚本
> * 前一重大版本延长支持期
> * 所有破坏性变更的清晰文档
>
> ## 长期支持（LTS）
>
> LangGraph 遵循长期支持政策为生产应用提供稳定性：
>
> ### 发布状态定义
>
> 软件包会标记以下状态之一：
>
> * **ACTIVE**：当前活跃开发，包含漏洞修复、安全补丁和新功能
> * **MAINTENANCE**：仅接收安全补丁和关键漏洞修复，不再新增功能
>
> ### 当前 LTS 发布版本
>
> **LangGraph 1.0** 被指定为 LTS 版本：
>
> * **状态**：ACTIVE 直至 2.0 发布
> * **支持周期**：2.0 发布后，1.0 将进入 MAINTENANCE 模式至少一年
> * **语义版本合规**：用户可安全升级到小版本（如 1.0→1.1）而不会遇到破坏性变更
>
> ### 遗留版本支持
>
> **LangGraph 0.4**：
>
> * **状态**：MAINTENANCE 模式
> * **支持周期**：至 2026 年 12 月
> * **支持内容**：所有安全补丁和关键漏洞修复
>
> ## 参考信息
>
> * [版本规范](https://langchain-docs-zh.mintlify.site/langchain/oss/versioning.md) - 版本编号与支持详情
> * [发布记录](https://docs.langchain.com/oss/releases) - 版本特定发布说明与迁移指南

> [tab] Deep Agents
>
> :::python
> 深度智能体（`deepagents`）是一个快速演进的包，用于构建高级智能体架构。
>
> ## 1.0 之前版本状态
>
> Deep Agents 目前处于预1.0版本开发阶段。在可能的情况下我们将尽量减少破坏性变更，但随着社区反馈的融入和智能应用生态的快速演变，API 可能会持续演进。
>
> ## 发布节奏
>
> **次要版本发布**（例如 `0.1.0` 到 `0.2.0`）可能包含新功能，随着包体成熟度提升，可能引入破坏性变更。
>
> **补丁版本发布**（例如 `0.1.0` 到 `0.1.1`）仅包含缺陷修复和微小优化，不会引入破坏性变更。
>
> ## API 稳定性
>
> 作为预1.0版本：
>
> * APIs 可能会在次要版本间发生变更
> * 当发生变更时会提供清晰的迁移指引
> * 标记为 `experimental` 或 `alpha` 的功能可能经历重大变更
>
> ## 弃用政策
>
> 在 Deep Agents 中弃用功能时：
>
> * 在可能的情况下会提前发布弃用警告
> * 迁移指引会包含在版本更新说明中
> * 弃用功能将在后续次要版本中移除
>
> ## 1.0 版本路径
>
> Deep Agents 达到1.0版本需满足：
>
> * 基础 API 已根据社区反馈完成稳定
> * 包体已在生产环境中通过实战验证
> * 核心功能不再预期存在破坏性变更
>
> 1.0版本后，Deep Agents 将遵循 LangChain 和 LangGraph 相同的语义版本管理和长期支持政策。
>
> ## 参考信息
>
> * [版本规范](https://langchain-docs-zh.mintlify.site/langchain/oss/versioning.md) - 版本编号规则与支持详情
>   :::

***

> 官方原文：[src/oss/release-policy.mdx](https://github.com/langchain-ai/docs/blob/main/src/oss/release-policy.mdx) · 非官方翻译，译文由 AI 生成，以英文原文为准。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.