> ## Documentation Index
> Fetch the complete documentation index at: https://langchain-zh.cn/llms.txt
> Use this file to discover all available pages before exploring further.
# 发布策略
本页介绍了 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 年
* **Semver 合规性**：用户可以在次要版本之间升级（例如，1.0 到 1.1）而无需破坏性变更
### 旧版本支持
**LangChain 0.3**：
* **状态**：MAINTENANCE 模式
* **支持周期**：直至 2026 年 12 月
* **支持内容**：安全补丁和关键错误修复
### 特殊说明
**@langchain/community 1.0**：由于社区贡献和第三方集成的性质，`@langchain/community` 可能在次要版本中包含破坏性变更。
LangGraph 遵循结构化的发布策略，以确保构建生产应用程序的用户获得稳定性和可预测性。
## 发布频率
我们预计将**主要**版本的发布间隔至少设为 6-12 个月，以为生产应用程序提供稳定性。
**次要**版本通常每 1-2 个月发布一次，包含新功能和改进。
**补丁**版本根据需要发布，通常每周一次，以解决错误和安全问题。
## API 稳定性
### 稳定 API
所有没有特殊前缀的 API 都被视为稳定且可用于生产环境。我们在主要版本内保持稳定功能的向后兼容性。
### Beta 功能
文档中标记为 `beta` 的功能：
* 功能完整且经过测试
* 可用于生产环境，但需了解它们可能会发生变化
* 根据用户反馈可能进行次要 API 调整
### 实验性功能
标记为 `experimental` 或 `alpha` 的功能：
* 处于活跃开发中
* 可能会发生重大变化或被移除
* 在生产环境中使用时需谨慎
### 内部 API
以下划线 (`_`) 为前缀或明确标记为内部的 API：
* 不属于公共 API
* 可能会在不通知的情况下更改
* 不应直接使用
## 弃用策略
弃用功能时：
1. **弃用通知**：功能被标记为弃用并提供清晰的迁移指南
2. **宽限期**：弃用功能至少在下一个次要版本中保持功能正常
3. **移除**：功能仅在主要版本发布时被移除
4. **迁移支持**：我们提供迁移指南，并在可行时提供自动化工具
## 平台兼容性
### JavaScript/TypeScript 支持
* 我们支持 Node.js LTS 版本
* 所有公共 API 均提供 TypeScript 定义
* 客户端组件的浏览器兼容性已记录
## 破坏性变更
破坏性变更仅在主要版本中引入，包括：
* 移除已弃用的 API
* 必需参数的更改
* 影响现有应用程序的默认行为更改
* Python/Node.js 最低版本更新
## 迁移支持
对于主要版本升级，我们提供：
* 全面的迁移指南
* 在可行时提供自动化迁移脚本
* 对上一个主要版本的延长支持期
* 所有破坏性变更的清晰文档
## 长期支持 (LTS)
LangGraph 遵循长期支持 (LTS) 政策，为生产应用程序提供稳定性：
### 发布状态定义
包标记为以下状态之一：
* **ACTIVE**：当前活跃开发，包括错误修复、安全补丁和新功能
* **MAINTENANCE**：接收所有安全补丁和关键错误修复，但不包含新功能
### 当前 LTS 版本
**LangGraph 1.0** 被指定为 LTS 版本：
* **状态**：在 2.0 发布之前为 ACTIVE
* **支持周期**：2.0 发布后，1.0 将进入 MAINTENANCE 模式至少 1 年
* **Semver 合规性**：用户可以在次要版本之间升级（例如，1.0 到 1.1）而无需破坏性变更
### 旧版本支持
**LangGraph 0.4**：
* **状态**：MAINTENANCE 模式
* **支持周期**：直至 2026 年 12 月
* **支持内容**：所有安全补丁和关键错误修复
## 参见
* [版本控制](/oss/javascript/versioning) - 版本号和支持详情
* [发布记录](/oss/javascript/releases) - 特定版本的发布说明和迁移指南
***
[Edit this page on GitHub](https://github.com/langchain-ai/docs/edit/main/src/i18n\zh-CN\oss\release-policy.mdx) or [file an issue](https://github.com/langchain-ai/docs/issues/new/choose).
[Connect these docs](/use-these-docs) to Claude, VSCode, and more via MCP for real-time answers.