# 🚀 CodeBuddy Code v2.103.1 发布

## 📦 版本信息

| 组件 | 版本 |
|------|------|
| CodeBuddy Code CLI | v2.103.1 |
| Agent SDK JS | v0.3.166 |
| Agent SDK Python | v0.3.165 |

## 🔧 改进优化

- **模型计费系数更新**：按最新计费策略调整 cli-saas 各部署形态下的默认模型、推理模型、图像模型及多个第三方模型的计费系数
- **WorkBuddy 助理对话标识**：当环境变量 `PERSONAL_AGENT_ROLE` 存在时，对话请求自动标记为 WorkBuddy 助理来源，便于服务端识别 orchestrator/specialist 场景
- **遥测 flush 配置可调**：新增 `galileo.aggregatorFlushIntervalSec` 配置项（默认 60 秒，范围 [5, 600]），短对话占比高的场景可调低到 10-20 秒以更及时上报数据
- **故障排查文档补充**：新增"更新不到最新版"章节，说明在 npm 镜像缓存延迟场景下，可通过 `--registry=https://registry.npmjs.org/` 指定官方源重试

## 🐛 问题修复

- **进程退出前丢失监控数据**：短对话（< 60s 退出）的子进程会随进程退出丢弃 aggregator 当前窗口和上报缓冲区中的监控数据，导致监控后台数据量级远低于预期。新增统一 flush helper 在所有进程退出关键点提前 flush metrics + trace + log 三类数据，并将 flush 提到清理队列最前面以确保 2s 预算内完成
- **遥测环境标识修正**：修复 Desktop sidecar 进程上报遥测时环境标识始终为 Production 的问题，避免开发期数据混入正式监控库
- **历史压缩边界误识别**：修复对话中包含 HTML 折叠块（`<details><summary>...</summary>...</details>`）时，消息被错误判定为历史压缩边界、进而被排除出真实用户输入的问题
- **后台任务通知日志清理**：移除后台命令完成通知中遗留的临时排查日志，降低日志噪音并避免敏感字段泄漏
- **IOA 端点漂移防御**：修复并发刷新场景下 IOA 用户的模型请求可能短暂落到公共云域名的问题，内部改为事务化更新避免中间态被读取，并新增二道防线检测异常路由
- **sub-agent hook 会话 ID 修正**：在 sub-agent 内触发的 hook，其 `session_id` 现指向**主 agent** 的 session id，sub-agent 自身 id 通过 `agent_id` 字段单独暴露，便于下游审计/统计跨主 session 聚合
- **MCP 禁用持久化**：修复 IDE 插件提供的 MCP 服务通过 `/mcp` 禁用后，重启再次出现的问题，禁用状态现已持久化到本地配置
- **snappy 原生模块打包**：修复打包时 snappy 原生模块未被正确排除的问题

## 📝 文档更新

- **CLI 文档归档**：补全 v2.100.0 ~ v2.103.0 共 6 个版本发布说明的英文翻译，更新中英文导航栏；同步更新 env-vars、http-api、troubleshooting 等文档的中英文版本
