本页解释了 LangChain 和 LangGraph 的发布策略。点击下方标签页查看各自的发布策略：

LangChain

LangGraph

The LangChain ecosystem is composed of different component packages (e.g., langchain-core, langchain, langchain-community, partner packages, etc.)

## 发布节奏

随着 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 发布之前为活跃状态
- **支持期限**：2.0 发布后，1.0 将进入维护模式至少 1 年
- **语义化版本控制合规性**：用户可以在次要版本之间升级（例如，从 1.0 到 1.1）而不会遇到破坏性变更

### 旧版本支持

**LangChain 0.3**：
- **状态**：维护模式
- **支持期限**：直到 2026 年 12 月
- **支持内容**：安全补丁和关键错误修复

### 特殊注意事项

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