发布流程/变更日志

本项目遵循略微修改的语义化版本规范，版本格式为0.Y.Z。开头的0 表示 SDK 仍在快速演进。各部分的递增规则如下：

次版本（Y）

对于任何未标记为 beta 的公共接口上的破坏性变更，我们会递增次版本号Y。例如，从0.0.x 升级到0.1.x 可能包含破坏性变更。

如果你不希望出现破坏性变更，我们建议在项目中将版本固定到0.0.x。

修订版本（Z）

对于非破坏性变更，我们会递增Z：

• Bug 修复
• 新功能
• 私有接口变更
• beta 功能更新

破坏性变更日志

0.8.0

在此版本中，有两项运行时行为变更可能需要迁移工作：

• 包装同步 Python 可调用对象的工具调用现在通过asyncio.to_thread(...) 在工作线程上执行，而不是在事件循环线程上运行。如果你的工具逻辑依赖线程本地状态或线程亲和资源，请迁移到异步工具实现，或在你的工具代码中显式声明线程亲和性。
• 本地 MCP 工具的失败处理现在可配置，且默认行为可能返回模型可见的错误输出，而不是让整个运行失败。如果你依赖快速失败（fail-fast）语义，请设置mcp_config={"failure_error_function": None}。服务级别的failure_error_function 值会覆盖智能体级别设置，因此请在每个带有显式处理器的本地 MCP 服务上设置failure_error_function=None。

0.7.0

在此版本中，有一些行为变更可能影响现有应用：

• 嵌套任务转移历史现在为可选启用（默认禁用）。如果你依赖 v0.6.x 默认的嵌套行为，请显式设置RunConfig(nest_handoff_history=True)。
• gpt-5.1 /gpt-5.2 的默认reasoning.effort 变更为"none"（从之前由 SDK 默认配置的"low" 变更而来）。如果你的提示词或质量/成本配置依赖"low"，请在model_settings 中显式设置。

0.6.0

在此版本中，默认的任务转移历史现在会打包为一条 assistant 消息，而不是暴露原始的 user/assistant 轮次，从而为下游智能体提供简洁、可预测的回顾- 现有的单消息任务转移转录现在默认会在<CONVERSATION HISTORY> 块之前以 "For context, here is the conversation so far between the user and the previous agent:" 开头，从而让下游智能体获得清晰标注的回顾

0.5.0

此版本未引入任何可见的破坏性变更，但包含新功能，并在底层进行了若干重要更新：