@tencent-ai/codebuddy-code 2.99.1 → 2.100.1

package/dist/web-ui/docs/cn/cli/env-vars.md

@@ -63,6 +63,7 @@ CodeBuddy Code 支持通过环境变量来控制其行为。这些变量可以
 | `CODEBUDDY_IMAGE_GEN_ENABLED` | 设置为 `false` 或 `0` 禁用图片生成功能 |
 | `CODEBUDDY_IMAGE_EDIT_ENABLED` | 设置为 `false` 或 `0` 禁用图片编辑功能 |
 | `CODEBUDDY_COMPUTER_USE_ENABLED` | **实验功能**：设置为 `true` 或 `1` 启用 macOS 桌面控制工具（截图、鼠标、键盘）。仅 macOS 可用，默认关闭。首次调用键盘/鼠标动作需在系统设置 → 隐私与安全 → 辅助功能、屏幕录制中为终端授权 |
+| `CODEBUDDY_WAIT_FOR_MCP_SERVERS_ENABLED` | 设置为 `0` 或 `false` 禁用 WaitForMcpServers 工具。默认开启。交互模式下不阻塞等待 MCP 连接，当 LLM 需要尚未就绪的 MCP 工具时可主动调用此工具按需等待。WorkBuddy 场景设置为 `0` 禁用 |
 | `CODEBUDDY_DEFER_TOOL_LOADING` | 设置为 `false` 或 `0` 禁用 MCP 工具延迟加载 |
 | `CODEBUDDY_SHOW_ALL_DEFERRED_TOOLS` | 设置为 `true` 或 `1` 显示所有延迟工具的完整描述 |
 | `CODEBUDDY_DISABLE_CRON` | 设置为 `1` 禁用计划任务 |

package/dist/web-ui/docs/cn/cli/release-notes/README.md

@@ -17,6 +17,7 @@ Release Notes 记录了每个版本的用户可见变更，包括：
 
 <!-- 新版本自动添加到此处 -->
 
+- [v2.99.1](./v2.99.1.md) - 2026-05-28
 - [v2.99.0](./v2.99.0.md) - 2026-05-27
 - [v2.98.1](./v2.98.1.md) - 2026-05-25
 - [v2.98.0](./v2.98.0.md) - 2026-05-24

package/dist/web-ui/docs/cn/cli/release-notes/v2.99.1.md

@@ -0,0 +1,46 @@
+# 🚀 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`

package/dist/web-ui/docs/en/cli/env-vars.md

@@ -63,6 +63,7 @@ CodeBuddy Code supports environment variables to control its behavior. These var
 | `CODEBUDDY_IMAGE_GEN_ENABLED` | Set to `false` or `0` to disable image generation |
 | `CODEBUDDY_IMAGE_EDIT_ENABLED` | Set to `false` or `0` to disable image editing |
 | `CODEBUDDY_COMPUTER_USE_ENABLED` | **Experimental**: Set to `true` or `1` to enable the macOS desktop control tool (screenshot, mouse, keyboard). Available only on macOS, disabled by default. The first invocation of keyboard/mouse actions requires authorizing the terminal in System Settings → Privacy & Security → Accessibility and Screen Recording |
+| `CODEBUDDY_WAIT_FOR_MCP_SERVERS_ENABLED` | Set to `0` or `false` to disable the WaitForMcpServers tool. Enabled by default. In interactive mode, MCP connections are not awaited blockingly; when the LLM needs an MCP tool that is not yet ready, it can proactively call this tool to wait on demand. Set to `0` to disable in WorkBuddy scenarios |
 | `CODEBUDDY_DEFER_TOOL_LOADING` | Set to `false` or `0` to disable MCP tool deferred loading |
 | `CODEBUDDY_SHOW_ALL_DEFERRED_TOOLS` | Set to `true` or `1` to show full descriptions for all deferred tools |
 | `CODEBUDDY_DISABLE_CRON` | Set to `1` to disable scheduled tasks |

package/dist/web-ui/docs/en/cli/release-notes/README.md

@@ -17,6 +17,7 @@ Difference from CHANGELOG.md:
 
 <!-- New versions are automatically added here -->
 
+- [v2.99.1](./v2.99.1.md) - 2026-05-28
 - [v2.99.0](./v2.99.0.md) - 2026-05-27
 - [v2.98.1](./v2.98.1.md) - 2026-05-25
 - [v2.98.0](./v2.98.0.md) - 2026-05-24

package/dist/web-ui/docs/en/cli/release-notes/v2.99.1.md

@@ -0,0 +1,46 @@
+# 🚀 CodeBuddy Code v2.99.1 Release
+
+## 📦 Version Information
+
+| Component | Version |
+|-----------|---------|
+| CodeBuddy Code CLI | v2.99.1 |
+| Agent SDK JS | v0.3.159 |
+| Agent SDK Python | v0.3.158 |
+
+## 🔧 Improvements
+
+### Enhanced OTel Observability
+
+- **Single Source of Truth for Span Schema**: Added `otel-span-schema.ts` to centrally manage span names, attribute keys, and event names, ensuring implementation stays consistent with documentation
+- **Fine-grained Privacy Switches**: Support for environment variables such as `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS`, and `OTEL_LOG_TOOL_CONTENT`, providing tiered opt-in control over sensitive data logging
+- **Tool Span Enhancements**: Records tool input parameters and output content based on switches, with 60KB truncation protection
+- **Trace Visualization**: Web UI TracesView adds new metrics including LLM call statistics, cache hit rate, and multi-model display
+
+### Galileo Monitoring System Upgrade
+
+- Split tool tracking logic into independent GalileoToolPreHook / GalileoToolPostHook with more focused responsibilities
+- Completed model dimension coverage for all Agent SLA metrics (ttfb / streaming / task_total / prompt_build / tool / request / cache)
+- Added agent_name, agent_purpose, and conversation_request_id dimensions to support multi-angle aggregation analysis
+- patchName is globally injected, with all three platforms uniformly controlled by the galileo.enable switch
+
+### ACP Session Stability
+
+- Refined boundary handling for ACP team bridging, session replay, and message ID utilities to avoid rendering jitter
+- Removed redundant state transitions in the session run state machine for more stable state progression
+
+### Skill and Tool Optimizations
+
+- Skill list changed from XML format to Markdown list, reducing token usage
+- Single skill description truncation threshold lowered from 250 to 150 characters
+- Removed meaningless tag injection from tool return content
+- Optimized deferred tool list size, reducing context occupation by large MCP tool collections
+- Removed promotional links from the help panel
+
+## 🐛 Bug Fixes
+
+- **Deferred Tool Loading**: Fixed the issue where bare-name MCP tools loaded via tool search could not be invoked correctly
+- **Custom Model Pass-through**: Avoid passing internal reporting fields to customer gateways; merge providerData only for non-custom models
+- **Permission Error Messages**: Preserve more specific error details when modifying permission-restricted files fails, reducing troubleshooting cost
+- **Session Compaction**: Fixed the issue where compaction after `/clear` could still carry over old session content
+- **Galileo Field Casing**: Unified to lowercase `galileo` in product.json