发布策略

自托管 LangSmith 的发布渠道、节奏和版本支持。

自托管 LangSmith 通过两个发布渠道提供：客户在生产环境中运行的稳定渠道，以及跟踪下一个主版本的预览渠道。

发布渠道

稳定版

当前正式可用的主版本。LangSmith 建议将此渠道用于生产。稳定版每周发布补丁版本，仅包含关键 bug 修复和安全补丁。主版本之间不会在稳定版上引入新功能、数据迁移或基础设施变更。

在本页中，N 指当前稳定的主版本。预览版跟踪下一个主版本 N+1。

预览

下一个主版本的开发构建。预览版包含合并到 LangSmith SaaS 的新功能和修复，因此你可以在下一个主版本变为稳定版之前进行评估。预览版构建可能包含数据迁移，但绝不会添加或移除服务，也不会引入破坏性变更。

预览版旨在用于测试和暂存环境中的评估。LangSmith 不建议在生产环境中运行预览版。

发布节奏

渠道	节奏
预览版	按照 LangSmith SaaS 的发布节奏发布镜像
稳定版：新主版本（v0.X.0）	大约每 6 周（每季度两次）
稳定版：补丁（v0.X.Y）	每周（通常为周五），如果没有更改则跳过。针对关键客户问题发布临时版本。

各渠道包含的内容

	预览版	稳定版补丁	下一个主版本
新功能	是	否	是
Bug 修复	是	仅关键修复	是
安全补丁	是	是	是
数据迁移和回填	是	否	是
新增或移除服务	否	否	是
破坏性变更	否	否	是

服务新增、服务移除和破坏性变更只会出现在新的主版本中，因此请据此规划升级到新主版本。

版本编号

每个自托管版本都有两个版本号：

• chart 版本是你安装并固定的 Helm chart 版本。发布版本以它命名，无论是在自托管变更日志中，还是作为 Helm 仓库的发布标签，例如 langsmith-0.15.17。
• LangSmith 版本是 chart 部署的应用程序版本，在 chart 中记录为 appVersion。

	Chart 版本	LangSmith 版本
稳定版	0.15.17	0.15.24
预览版（发布候选）	0.16.0-rc.15	0.16.19rc1

• 稳定版 chart 版本为 0.X.Y，其中 X 是主版本，Y 随每个补丁版本递增。
• 预览版 chart 版本为 0.X.0-rc.N，其中 N 随每个发布候选递增。
• 两个版本号独立递增。chart 补丁号和 LangSmith 补丁号不要求一致。

用于发布序列的 vX 简写（v15、v16）指主版本，因此 v15 表示 chart 版本 0.15.Y。

版本支持

LangSmith 支持当前稳定主版本（N）和上一个稳定主版本（N-1）：

• N 获得积极支持：关键 bug 修复、安全补丁和每周补丁版本。
• N-1 仅获得关键支持：关键 bug 修复和安全补丁，按需发布而不是每周发布。
• 早于 N-1 的版本已终止生命周期，不再获得新的补丁版本、bug 修复或安全更新。

由于大约每 6 周发布一个新主版本，一个版本在被取代为稳定版后约 6 周就会终止生命周期。版本终止生命周期后，修复不会向后移植；请升级到受支持的主版本以获取这些修复。

除了两个受支持的稳定版本之外，下一个主版本还会以一系列发布候选的形式在预览渠道提供，例如 0.16.0-rc.15。预览版构建会持续发布，并且始终包含最新修复，但它们旨在用于测试和暂存环境中的评估，而不是生产环境。在非生产环境中运行预览版是验证下一个主版本在变为稳定版之前表现的推荐方式。

建议

• 在生产环境运行稳定版。 预览版仅用于评估，可能包含仍在验证中的未发布功能。
• 在测试或暂存环境使用预览版。 在非生产环境运行预览版是尽早发现问题并为下一次主版本升级做准备的最佳方式。
• 规划主版本升级。 数据迁移、服务新增或移除以及破坏性变更只会出现在新的主版本中。升级前请查看自托管变更日志，并规划任何所需的数据或基础设施变更。
• 保持在受支持的版本上。 LangSmith 建议在每个新主版本发布后尽快升级，以按推荐节奏获得架构改进。

当前版本

要查看当前稳定版和预览版，请参阅自托管变更日志。

另请参阅

• 发布阶段：了解功能如何从 alpha 进入 GA
• API 和 SDK 弃用策略：了解已弃用的端点和方法如何移除

---