# 🚀 CodeBuddy Code v2.97.5 发布

## 📦 版本信息

| 组件 | 版本 |
|------|------|
| CodeBuddy Code CLI | v2.97.5 |
| Agent SDK JS | v0.3.155 |
| Agent SDK Python | v0.3.154 |

## 🐛 问题修复

- **专家团多类卡死/无产物/异常结束**：集中修复了多个用户在使用专家团（"腾讯自选股"、"一人公司"、"专业文档生成"、"深度研究"等）时反馈的异常问题，包括任务异常结束无产物、子成员已完成但主会话卡在"思考中"、专家团运行中途自行结束导致制品丢失等场景
- **Team 成员已完成时 shutdown 无回应**：成员任务已完成后 team-lead 发起 shutdown_request，过去会因绕过 `ShutdownCoordinator` 导致 lead 永远等不到回执；现已统一短路处理，确保 lead 端及时解锁
- **并发 spawn 时消息丢失**：主 lead 短时间内并发拉起多个成员时，旧逻辑会因找不到对端报错丢消息；现采用 "writeToMailbox first, resolve later" 策略，并附带降级刷新与 notice 提示
- **成员被错误识别为 team-lead**：修复 respawn 边界下成员消息 `from` 字段串号导致协作错乱的问题，强制 materialise session.meta 并校验 lead 身份
- **同毫秒并发 shutdown ID 冲突**：lead 并发 shutdown 多成员时 ID 撞车导致回执被覆盖，现使用 `recipient + 时间戳 + 随机数` 形式
- **进程退出兜底清理**：补齐 session-team 的退出清理，避免长期累积 20+ 个孤儿目录
- **Fork subagent 递归爆炸**：新增环境变量 `CODEBUDDY_DISABLE_FORK_SUBAGENT`，启用后从工具描述层和运行时层一致禁用 fork subagent，并对历史调用降级为 `general-purpose`，避免请求量爆炸与报错
- **HTTP User-Agent 头部修复**：修复缺少 `productName` 时 User-Agent 回退为 `WorkBuddy/unknown` 污染下游统计的问题，现仅在产品名存在时才拼入对应段
