跳到主要内容

文档索引

在以下地址获取完整的文档索引：https://docs.langchain.org.cn/llms.txt

在进一步探索之前，请使用此文件发现所有可用页面。

我们的开源版本号遵循 MAJOR.MINOR.PATCH 格式，即 语义化版本控制 (Semantic Versioning) 定义的标准。
  • 主版本号 (Major)：需要修改代码的破坏性 API 更新。
  • 次版本号 (Minor)：保持向后兼容的新功能和改进。
  • 修订号 (Patch)：错误修复和细微改进。
例如：
  • 1.0.0：具备生产级 API 的首个稳定版本
  • 1.1.0：以向后兼容方式添加的新功能
  • 1.0.1：向后兼容的错误修复

​
API 稳定性

我们通过以下方式传达 API 的稳定性：

​
稳定的 API

所有没有特殊前缀的 API 均被视为稳定版本，可用于生产环境。我们保持稳定功能的向后兼容性，且仅在主版本中引入破坏性变更。

​
测试版 (Beta) API

标记为 beta 的 API 已实现完整功能，但可能会根据用户反馈进行小幅调整。它们可以安全地用于生产环境，但在未来版本中可能需要进行小幅调整。

​
内测版 (Alpha) API

标记为 alpha 的 API 为实验性质，可能会发生重大变更。在生产环境中使用时请务必谨慎。

​
已弃用的 API

标记为 deprecated（已弃用）的 API 将在未来的主版本中移除。我们会在可能的情况下说明预计移除的版本。处理弃用时请：
  1. 切换到推荐的替代 API
  2. 遵循迁移指南（随主版本一同发布）
  3. 在可用时使用自动化迁移工具

​
内部 API

某些 API 会通过以下两种方式被明确标记为“内部 (internal)”：
  • 某些文档引用了内部实现并将其明确说明。如果文档指出某内容为内部 API，则该内容可能会发生变化。
  • 以单下划线 (_) 开头的函数、方法和其他对象。这是 Python 指示某物为私有的标准约定；如果任何方法以单个 _ 开头，则它是内部 API。
    • 例外：某些方法带有 _ 前缀，但不包含具体实现。这些方法旨在由提供具体实现的子类重写。此类方法通常属于 LangChain 的 公共 API。

​
发布周期

主版本发布（例如 1.0.0 → 2.0.0）可能包含：
  • 破坏性的 API 变更
  • 移除已弃用的功能
  • 重大的架构改进
我们提供：
  • 详细的迁移指南
  • 在可能的情况下提供自动化迁移工具
  • 为以前的主版本提供扩展的支持期
次版本发布（例如 1.0.0 → 1.1.0）包含：
  • 新功能和特性
  • 性能改进
  • 新的可选参数
  • 向后兼容的增强功能
修订版发布（例如 1.0.0 → 1.0.1）包含：
  • 错误修复
  • 安全更新
  • 文档改进
  • 无需修改 API 的性能优化

​
版本支持策略

  • 最新主版本：提供全面支持并处于活跃开发状态 (ACTIVE 状态)
  • 前一个主版本：在下一个主版本发布后，继续提供 12 个月的安全更新和关键错误修复 (MAINTENANCE 状态)
  • 较旧版本：仅由社区支持

​
长期支持 (LTS) 版本

LangChain 和 LangGraph 的 1.0 版本均被指定为 LTS（长期支持）版本
  • 1.0 版本将保持 ACTIVE 状态，直到 2.0 版本发布
  • 2.0 版本发布后，1.0 版本将进入 MAINTENANCE 模式至少 1 年
  • LTS 版本遵循语义化版本控制 (semver)，允许在次版本之间安全升级
  • 旧版本（LangChain 0.3 和 LangGraph 0.4）将处于 MAINTENANCE 模式直至 2026 年 12 月

​
1.0 之前的包

有关发布状态和支持时间表的详细信息，请参阅 发布策略。

​
检查您的版本

检查已安装版本的方法 
import { version } from "langchain/package.json";
console.log(version);

​
升级

# Upgrade to the latest version
npm update langchain @langchain/core

# Install a specific version
npm install langchain@1.0.0 @langchain/core@1.0.0

​
预发布版本

我们偶尔会发布 alpha 和 beta 版本供早期测试
  • Alpha（例如 1.0.0a1）：早期预览，预期会有重大变更
  • Beta（例如 1.0.0b1）：功能完整，可能会有小幅变更
  • 发布候选版 (Release Candidate)（例如 1.0.0rc1）：稳定发布前的最终测试

​
另请参见

将这些文档连接到 Claude、VSCode 等，以获得实时答案。
在 GitHub 上编辑此页面 或 提交问题。
© . This site is unofficial and not affiliated with LangChain, Inc.