发布流程
该项目遵循稍作修改的语义化版本(semantic versioning),采用 0.Y.Z
的形式。前导的 0
表示 SDK 仍在快速演进。版本号的递增规则如下:
次版本号(Y
)
Section titled “次版本号(Y)”对于未标记为 beta 的任何公共接口发生的破坏性变更,我们会增加次版本号 Y
。例如,从 0.0.x
升至 0.1.x
可能包含破坏性变更。
如果您不希望引入破坏性变更,建议在项目中将版本固定到 0.0.x
。
修订号(Z
)
Section titled “修订号(Z)”对于非破坏性变更,我们会增加修订号 Z
:
- 缺陷修复
- 新增功能
- 对私有接口的更改
- 对 beta 特性的更新
子包的版本管理
Section titled “子包的版本管理”主包 @openai/agents
由多个可独立使用的子包组成。目前这些包的版本是绑定的,这意味着只要其中一个包版本提升,其他包也会随之提升。随着我们迈向 1.0.0
,这一策略可能会发生变化。
我们会为每个子包生成变更日志,帮助理解变更内容。由于变更可能发生在某个子包中,您可能需要查看对应子包的变更日志以获取详细信息。