# 🚀 CodeBuddy Code v2.99.1 发布

## 📦 版本信息

| 组件 | 版本 |
|------|------|
| CodeBuddy Code CLI | v2.99.1 |
| Agent SDK JS | v0.3.159 |
| Agent SDK Python | v0.3.158 |

## 🔧 改进优化

### OTel 可观测性增强

- **Span Schema 单一真相源**：新增 `otel-span-schema.ts` 统一管理 span 名称、属性键和事件名，确保实现与文档一致
- **细粒度隐私开关**：支持 `OTEL_LOG_USER_PROMPTS`、`OTEL_LOG_TOOL_DETAILS`、`OTEL_LOG_TOOL_CONTENT` 等环境变量，逐级 opt-in 控制敏感数据记录
- **Tool Span 增强**：按开关记录工具输入参数和输出内容，带 60KB 截断保护
- **Trace 可视化**：Web UI TracesView 新增 LLM 调用统计、Cache 命中率、多模型展示等指标

### Galileo 监控体系升级

- 将 tool 打点逻辑拆分为独立的 GalileoToolPreHook / GalileoToolPostHook，职责更单一
- Agent SLA 全指标补齐 model 维度（ttfb / streaming / task_total / prompt_build / tool / request / cache）
- 新增 agent_name、agent_purpose、conversation_request_id 维度，支持多角度聚合分析
- patchName 全局注入，三端统一受 galileo.enable 开关控制

### ACP 会话稳定性

- 完善 ACP 团队桥接、会话回放与消息 ID 工具的边界处理，避免渲染抖动
- 会话运行状态机移除冗余状态切换，状态推进更稳定

### Skill 与工具优化

- Skill 列表从 XML 格式改为 Markdown 列表，减少 token 占用
- 单条 skill 描述截断阈值从 250 降至 150 字符
- 移除工具返回内容中无意义的标签注入
- 优化延迟工具列表体积，减少大型 MCP 工具集合对上下文的占用
- 帮助面板移除推广链接

## 🐛 问题修复

- **延迟工具加载**：修复裸名 MCP 工具通过工具搜索加载后无法正确调用的问题
- **自定义模型透传**：避免把内部上报字段透传给客户网关，仅在非自定义模型时合并 providerData
- **权限错误提示**：修改无权限文件失败时保留更具体的错误详情，减少排查成本
- **会话压缩**：修复 `/clear` 后压缩仍可能带入旧会话内容的问题
- **Galileo 字段大小写**：product.json 中统一为小写 `galileo`
