LangChain 发布策略

LangChain 生态系统由不同的组件包组成（例如，langchain-core、langchain、langchain-community、langgraph、langserve、合作伙伴包等）

版本控制

langchain、langchain-core 和集成包

langchain、langchain-core、langchain-text-splitters 和集成包 (langchain-openai、langchain-anthropic 等) 遵循 语义版本控制，格式为 0.Y.Z。这些包正在快速开发中，因此目前的版本主要版本号为 0。

次要版本增加将发生在以下情况：

• 对任何未标记为 beta 的公共接口进行重大更改。

补丁版本增加将发生在以下情况：

• 错误修复、
• 新功能、
• 对私有接口的任何更改、
• 对 beta 功能的任何更改。

在次要版本之间升级时，用户应查看重大更改和弃用列表。

我们有时会将包版本化为发布候选版本。这些版本旨在作为稳定版本发布，但我们希望在发布之前获得社区的反馈。发布候选版本将版本化为 0.Y.ZrcN。例如，0.2.0rc1。如果未发现问题，则发布候选版本将作为具有相同版本号的稳定版本发布。如果发现问题，我们将发布一个新的发布候选版本，并将 N 值递增（例如，0.2.0rc2）。

langchain-community

langchain-community 目前的版本为 0.2.x。

次要版本增加将发生在以下情况：

• 更新所需的 langchain-x 依赖项的主要/次要版本。例如，当将所需的 langchain-core 版本从 ^0.2.x 更新到 0.3.0 时。

补丁版本增加将发生在以下情况：

• 错误修复、
• 新功能、
• 对私有接口的任何更改、
• 对 beta 功能的任何更改、
• 对集成的重大更改，以反映第三方服务的重大更改。

在可能的情况下，我们将避免在补丁版本中进行重大更改。但是，如果外部 API 进行了重大更改，则相应的 langchain-community 集成的重大更改可能会在补丁版本中发生。

langchain-experimental

langchain-experimental 目前的版本为 0.0.x。所有更改都将伴随补丁版本增加。

发布节奏

我们预计 langchain 和 langchain-core 的次要版本发布（例如，从 0.2.x 到 0.3.0）之间至少间隔 2-3 个月，因为此类版本可能包含重大更改。

补丁版本发布频繁，每周最多几次，因为它们包含错误修复和新功能。

API 稳定性

LLM 应用程序的开发是一个快速发展的领域，我们不断从用户和社区中学习。因此，我们预计 langchain 和 langchain-core 中的 API 将继续发展，以更好地满足用户的需求。

即使 langchain 和 langchain-core 目前都处于 pre-1.0 状态，我们仍致力于维护这些包中的 API 稳定性。

• 对公共 API 的重大更改将导致次要版本号（第二位数字）的提升
• 任何错误修复或新功能都将导致补丁版本号（第三位数字）的提升

我们通常会尽量避免进行不必要的更改，并将为要删除的功能提供弃用策略。

其他包的稳定性

LangChain 生态系统中其他包的稳定性可能会有所不同

• langchain-community 是一个由社区维护的包，其中包含第三方集成。虽然我们尽最大努力审查和测试 langchain-community 中的更改，但由于它包含许多社区贡献，因此预计 langchain-community 会比 langchain 和 langchain-core 经历更多的重大更改。
• 合作伙伴包可能遵循不同的稳定性和版本控制策略，用户应参考这些包的文档以获取更多信息；但是，一般来说，这些包预计是稳定的。

什么是“API 稳定性”？

API 稳定性意味着

• 所有公共 API（本文档中的所有内容）都不会在不提供向后兼容别名的情况下被移动或重命名。
• 如果这些 API 添加了新功能（这是很有可能的），它们不会破坏或更改现有方法的含义。换句话说，“稳定”并不（一定）意味着“完整”。
• 如果由于某种原因，必须删除或替换声明为稳定的 API，则会声明其为已弃用，但至少在两个次要版本中仍会保留在 API 中。当调用已弃用的方法时，将发出警告。

标记为内部的 API

某些 API 在几种方面被明确标记为“内部”

• 一些文档提到了内部结构，并将其称为内部结构。如果文档说某些内容是内部的，则可能会更改。
• 函数、方法和其他对象以一个前导下划线 (_) 开头。这是指示某些内容是私有的标准 Python 约定；如果任何方法以单个 _ 开头，则它是内部 API。
  • 例外： 某些方法以 _ 为前缀，但不包含实现。这些方法旨在由提供实现的子类覆盖。此类方法通常是 LangChain 的 公共 API 的一部分。

弃用策略

在更好的替代方案可用之前，我们通常会避免弃用功能。

当某个功能被弃用时，它将在当前和下一个次要版本的 langchain 和 langchain-core 中继续工作。之后，该功能将被删除。

由于我们预计次要版本发布之间至少间隔 2-3 个月，这意味着某个功能可能会在弃用后的 2-6 个月内被删除。

在某些情况下，如果该功能在包中没有引起问题，我们可能会允许该功能在代码库中保留更长时间，以减轻用户的负担。