@tencent-ai/agent-sdk 0.3.99 → 0.3.100

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

@@ -0,0 +1,5 @@
+# 🚀 CodeBuddy Code v2.37.10 发布
+
+## 🔧 改进优化
+
+- **登录方式优化**：简化登录选项为"Chinese Site"、"International Site"和"Enterprise Domain"，国内站点登录会自动根据网络环境选择最佳认证方式，提升登录体验

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

@@ -0,0 +1,8 @@
+# 🚀 CodeBuddy Code v2.37.11 发布
+
+## 📦 维护性更新
+
+本次为维护性版本发布，主要包含：
+
+- SDK 版本同步更新
+- 内部依赖优化

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

@@ -0,0 +1,14 @@
+# 🚀 CodeBuddy Code v2.37.12 发布
+
+## 🎨 界面优化
+
+- **应用图标更新**：更新 Work 应用图标，提升视觉一致性
+
+## 🔧 改进优化
+
+- **活动栏增强**：新增活动栏组件，支持更丰富的导航和交互功能
+- **设置服务优化**：重构设置服务，提供更灵活的配置管理能力
+- **历史记录缓存**：新增历史缓存服务，改善会话历史的加载和管理体验
+- **进程池管理**：引入 ACP 进程池，提升多会话场景下的资源利用效率
+- **Mermaid 图表**：增强 Mermaid 图表渲染，支持更多图表类型和交互
+- **国际化完善**：补充中英文界面文案

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

@@ -0,0 +1,11 @@
+# 🚀 CodeBuddy Code v2.37.13 发布
+
+## 🔧 改进优化
+
+### 企业版认证优化
+
+优化企业 ID 获取时序，确保企业模型列表在用户登录后能够正确加载，改善企业用户的使用体验。
+
+### 自定义认证修复
+
+修复在自定义认证环境下，认证状态变化时导致 token 丢失的问题，确保认证流程的稳定性和可靠性。

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

@@ -0,0 +1,24 @@
+# 🚀 CodeBuddy Code v2.37.14 发布
+
+## ✨ 新功能
+
+### SDK 动态配置 API
+
+新增 `getAvailableModes()` 和 `getAvailableModels()` 方法，让开发者可以动态获取当前可用的权限模式和模型列表。同时，`setModel()` 和 `setPermissionMode()` 现在仅影响当前会话，不再持久化到配置文件，让多会话场景下的配置管理更加灵活。
+
+### 模型切换快捷键
+
+支持 Option/Alt + P 快速切换模型，无需进入设置即可快速切换到合适的模型。
+
+## 🔧 改进优化
+
+- **用户提示增强**：添加更多内置提示，帮助用户了解快捷键和操作技巧
+- **输出限制统一**：将各类工具的 token 限制统一为 20000，图片内容不受此限制；Read 工具支持 `CODEBUDDY_CODE_FILE_READ_MAX_OUTPUT_TOKENS` 环境变量自定义
+- **启动性能优化**：优化认证和服务配置初始化流程，提升 CLI 冷启动速度
+- **插件市场安装**：优化市场和插件安装流程，显著减少首次安装和自动更新的等待时间
+- **异步文件操作**：将自定义命令、Agent 和 Skill 的加载改为异步并行处理
+- **Git 信息收集**：优化仓库扫描逻辑，采用异步并行处理提升性能
+
+## 🐛 问题修复
+
+- **Diff 渲染稳定性**：修复了工具调用参数解析时因空字符串或不完整 JSON 导致的渲染崩溃问题

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

@@ -0,0 +1,11 @@
+# 🚀 CodeBuddy Code v2.37.15 发布
+
+## 🐛 问题修复
+
+### 退出登录流程优化
+
+修复了退出登录后 token 未正确清理的问题,确保认证拦截器正确处理登出状态,避免后续请求使用过期凭证。
+
+### HTTP 拦截器增强
+
+改进认证 HTTP 拦截器的错误处理和状态同步机制,提升认证流程的稳定性和可靠性。

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

@@ -0,0 +1,9 @@
+# 🚀 CodeBuddy Code v2.37.16 发布
+
+## 🔧 改进优化
+
+- **配置更新**：将机器人配置文件纳入构建流程，确保配置同步更新
+
+## 🐛 问题修复
+
+- **企业版登录兼容性**：修复用户切换企业版 URL 登录时模型列表不一致的问题，确保 endpoint 变更后配置正确加载

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

@@ -0,0 +1,5 @@
+# 🚀 CodeBuddy Code v2.37.17 发布
+
+## 🔧 改进优化
+
+- **SDK 版本同步更新**：SDK-JS 更新至 0.3.12，SDK-Python 更新至 0.3.10，确保与 CLI 版本保持同步

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

@@ -0,0 +1,9 @@
+# 🚀 CodeBuddy Code v2.37.18 发布
+
+## 🐛 问题修复
+
+- **登录流程优化**：修复登录方式映射配置问题,提升登录界面的交互体验和可用性
+
+## 🔧 改进优化
+
+- **SDK 版本更新**：同步更新 SDK-JS 至 0.3.13,SDK-Python 至 0.3.11,保持与最新 SDK 的兼容性

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

@@ -0,0 +1,5 @@
+# 🚀 CodeBuddy Code v2.37.19 发布
+
+## 🔧 改进优化
+
+- **SDK 版本同步**：更新 JavaScript/TypeScript SDK 至 0.3.14，Python SDK 至 0.3.12，保持 SDK 与 CLI 版本同步，确保最佳兼容性

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

@@ -0,0 +1,28 @@
+# 🚀 CodeBuddy Code v2.37.2 发布
+
+## 🔧 改进优化
+
+### ACP 认证增强
+
+- 在 authenticate 响应中返回用户信息，客户端可获取当前登录用户的 ID、用户名和昵称
+- 修复已登录用户再次调用认证接口时无法弹出登录页面的问题
+
+### 异步上下文压缩
+
+引入异步上下文压缩机制，当对话历史达到临界阈值时自动触发后台压缩，提升长对话场景下的响应性能。
+
+### SDK 连接性能优化
+
+- 优化连接池机制，支持并发查询场景下的预热连接复用，显著降低首次消息延迟
+- 增加 `prewarmInitialize` 选项，将 CLI 启动时间提前到预热阶段
+- 增加会话锁机制，避免同一会话 ID 被并发恢复导致的数据混乱
+
+### 其他改进
+
+- **ACP 会话模型隔离**：修复切换模型时影响全局配置的问题，现在模型切换仅影响当前会话
+- **插件卸载清理**：修复卸载插件后 MCP 配置仍然残留的问题，卸载时会自动清理相关配置
+- **网络错误处理**：优化 print 模式下网络错误自动重试逻辑，避免异常退出
+- **SDK 性能优化**：优化了会话恢复和用户交互流程，提升了 SDK 响应速度和稳定性
+- **会话存储**：支持跨项目目录搜索会话，新增 meta 文件分离存储
+- **认证流程**：优化认证机制，新增用户信息查询接口
+- **服务模式**：增强服务器模式策略功能

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

@@ -0,0 +1,8 @@
+# 🚀 CodeBuddy Code v2.37.20 发布
+
+## 🔧 改进优化
+
+- **模型临时切换**：在模型选择面板按 `t` 键可仅对当前会话生效，不修改用户配置，方便临时测试不同模型
+- **--model 参数优化**：命令行 `--model` 参数现在正确覆盖项目级配置，当前会话立即生效
+- **上下文压缩优化**：压缩时过滤规则和记忆内容，避免将配置指令压缩进摘要，压缩后自动重新注入完整规则，保持 AI 行为一致性
+- **配置面板精简**：隐藏开发者选项，需通过 `/config --dev` 访问，让配置界面更简洁

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

@@ -0,0 +1,22 @@
+# 🚀 CodeBuddy Code v2.37.3 发布
+
+## 🔧 改进优化
+
+### Electron 桌面应用体验优化
+
+- **单实例锁**：防止应用多开，第二个实例会自动聚焦现有窗口
+- **macOS 窗口行为**：关闭窗口时隐藏而非退出，符合 macOS 应用规范
+- **Dock 图标清理**：修复子进程在 macOS Dock 中显示多余图标的问题
+
+### SDK API 增强
+
+- **权限模式动态切换**：Session API 新增 `setPermissionMode` 和 `getPermissionMode` 方法，支持在会话中动态切换权限模式
+- **Plan 模式优化**：切换到 plan 模式时返回 plan 文件路径，便于 SDK 获取和展示
+- **历史消息处理**：优化 Query API 中 resume + prompt 场景下的历史消息处理流程
+
+### 消息列表交互优化
+
+- **时间线排序**：优化消息与工具调用的时间线排序，支持工具调用分组显示
+- **反馈功能**：新增消息点赞和点踩按钮，支持用户反馈
+- **图片预览**：用户消息图片支持点击放大预览，带有平滑动画效果
+- **复制功能**：改进助手消息复制逻辑，支持复制完整回复组；用户消息支持双击复制

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

@@ -0,0 +1,19 @@
+# 🚀 CodeBuddy Code v2.37.4 发布
+
+## ✨ 新功能
+
+### 自定义 Session ID
+
+SDK 现在支持在创建会话时指定自定义 session ID，便于外部系统追踪和管理会话。这对于需要将 CodeBuddy 会话与业务系统集成的场景非常有用。
+
+## 🐛 问题修复
+
+- **会话历史加载**：修复会话重连后历史消息无法正确显示的问题，改用 ACP session/load 机制加载历史
+- **模型选择同步**：修复模型 ID 映射问题，正确处理 SDK 返回的 modelId 字段
+- **模型持久化**：优化模型选择的持久化逻辑，确保用户选择在会话重连后保持一致
+- **会话订阅栈溢出**：防止 session 被重复订阅时导致的递归栈溢出问题
+- **Stop Hook 序列化**：移除未使用的 result 字段，避免序列化循环引用导致的错误
+
+## 🔧 改进优化
+
+- **工具步骤展示**：优化工具调用列表的布局和动画效果，提升视觉体验

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

@@ -0,0 +1,5 @@
+# 🚀 CodeBuddy Code v2.37.5 发布
+
+## 🐛 问题修复
+
+- **ACP 会话模型设置**：修复通过 SDK 切换模型后，后续对话仍使用旧模型的问题，现在模型切换会立即生效

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

@@ -0,0 +1,5 @@
+# 🚀 CodeBuddy Code v2.37.6 发布
+
+## 🔧 改进优化
+
+- **会话恢复增强**：支持显示通过 `/compact` 命令生成的会话，用户不再丢失压缩后的会话历史

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

@@ -0,0 +1,5 @@
+# 🚀 CodeBuddy Code v2.37.7 发布
+
+## ✨ 新功能
+
+- **红包封面推广**：帮助面板新增「码到成功」红包封面领取入口，根据国内/国际版自动显示对应链接，助您在新年期间领取专属红包封面

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

@@ -0,0 +1,5 @@
+# 🚀 CodeBuddy Code v2.37.8 发布
+
+## 🔧 改进优化
+
+- **会话状态管理优化**：优化 lastMessageId 在异步压缩时的更新机制，确保长对话场景下消息 ID 关联正确，提升会话恢复的可靠性

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

@@ -0,0 +1,8 @@
+# 🚀 CodeBuddy Code v2.37.9 发布
+
+## 🔧 改进优化
+
+- **侧边栏交互优化**：支持拖拽调整宽度，新增会话管理操作按钮，让界面操作更加灵活便捷
+- **User-Agent 标识**：ACP 进程启动时自动设置包含版本信息的 User-Agent 请求头，便于服务端识别客户端版本
+- **配置同步优化**：为产品配置同步添加节流+防抖机制，减少高频调用造成的性能开销
+- **日志增强**：增加流式消息处理和配置缓存过期的调试日志，便于问题排查

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

@@ -0,0 +1,22 @@
+# 🚀 CodeBuddy Code v2.38.0 发布
+
+## ✨ 新功能
+
+### 子 Agent 模型变体
+
+Agent 工具新增 `model` 参数，支持指定 `lite`、`reasoning` 等模型变体。您可以根据任务复杂度选择合适的模型：
+
+- `lite`：适用于简单搜索、快速文件操作等轻量任务
+- `reasoning`：适用于复杂分析、架构决策和多步骤问题求解
+
+## 🔧 改进优化
+
+- **Checkpoint Hook 统计优化**：优化文件变更统计计算，通过对比备份文件与当前文件提供准确的增删行数
+- **Shell 编码处理**：优化终端输出的字符编码解码逻辑，改善 Windows 环境下中文等非 ASCII 字符的显示效果
+- **SDK 版本更新**：同步更新 SDK-JS 至 0.3.16，SDK-Python 至 0.3.14
+
+## 📝 文档更新
+
+- **环境要求**：明确 Node.js 最低版本为 18.20+
+- **开发文档**：完善 CODEBUDDY.md，补充开发命令、目录结构说明和构建流程细节
+- **文档同步**：同步 CLI 文档到 IDE docs 目录，新增费用说明文档等

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

@@ -0,0 +1,6 @@
+# 🚀 CodeBuddy Code v2.38.1 发布
+
+## 🔧 改进优化
+
+- **命令安全检查简化**：移除未使用的命令黑名单功能，精简代码结构，提升代码可维护性
+- **SDK 版本同步**：同步更新 SDK-JS 至 0.3.17，SDK-Python 至 0.3.15

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

@@ -0,0 +1,9 @@
+# 🚀 CodeBuddy Code v2.38.2 发布
+
+## 🔧 改进优化
+
+- **路径解析优化**：使用 PathUtils 统一 WASM 文件和证书文件的路径解析逻辑，支持从 EMBED_FS 加载嵌入资源，提升不同部署环境下的兼容性
+
+## 🐛 问题修复
+
+- **控制台输出**：修复特定场景下控制台输出模式解析异常的问题

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

@@ -0,0 +1,18 @@
+# 🚀 CodeBuddy Code v2.39.0 发布
+
+## ✨ 新功能
+
+### 图片生成工具
+
+新增 `ImageGen` 工具，让 AI 助手可以直接根据文本描述生成图片。支持自定义尺寸、风格、质量等多种参数，为创意工作流提供更多可能性。
+
+- **文生图模型切换**：通过 `/model:text-to-image` 命令查看和切换可用的文生图模型
+- **CLI 参数支持**：启动时使用 `--text-to-image-model` 参数指定默认模型
+- **配置持久化**：在用户配置中设置 `textToImageModel` 作为默认文生图模型
+
+## 🔧 改进优化
+
+- **配置面板优化**：将 Env-Route 选项移至开发者模式，通过 `/config --dev` 或 `/config -d` 激活，简化常规配置界面
+- **输入提交修复**：修复在输入斜杠命令时无法按回车提交的问题，现在可以正常提交命令或将无效命令作为普通消息发送
+- **工具描述优化**：改进工具描述中的引号格式，提升可读性
+- **SDK 版本更新**：同步更新 SDK-JS 至 0.3.19，SDK-Python 至 0.3.17

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

@@ -0,0 +1,19 @@
+# 🚀 CodeBuddy Code v2.4.0 发布
+
+## ✨ 新功能
+
+- 任务执行轮次控制：新增 `--max-turns` 命令行参数，让您可以精确控制 AI 助手的执行轮次，避免无限循环，提升任务执行的可控性
+
+## 🔧 改进优化
+
+- 执行能力提升：默认最大执行轮次从 100 提升至 500，为复杂任务提供更充足的处理空间，减少因轮次限制导致的任务中断
+- 外部编辑器集成：新增 Ctrl+G 快捷键支持，可快速调用 VSCode、Sublime Text 等外部编辑器编辑长文本，提升输入体验
+- 日志保存优化：改进日志落盘机制，确保进程退出时所有日志信息完整保存，方便问题排查
+- 会话管理优化：改进历史会话列表展示，自动过滤内部子代理会话，让会话列表更清晰
+
+## 🐛 问题修复
+
+- Native 版本命令兼容性：修复 `/release-notes` 命令在 Native 环境中无法正常运行的问题
+- 遥测数据准确性：修复工具调用遥测数据中标识信息缺失问题，确保数据完整上报
+- 自动更新稳定性：增强多进程场景下的自动更新锁机制，避免更新冲突
+- 子代理中断问题：修复使用子代理时无法响应中断指令的问题，提升交互体验

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

@@ -0,0 +1,20 @@
+# 🚀 CodeBuddy Code v2.40.0 发布
+
+## ✨ 新功能
+
+### SDK 延迟控制请求同步
+
+SDK 新增延迟控制请求同步功能，让您可以在发送消息前灵活设置权限模式和模型选项。这一改进为 SDK 用户提供了更灵活的 API 调用方式，方便在消息发送前进行配置调整。
+
+**使用示例**：
+
+```typescript
+// 在发送消息前设置权限模式
+session.setPermissionMode('auto');
+session.setModel('claude-sonnet-4-20250514');
+await session.send('你的消息');
+```
+
+## 🔧 改进优化
+
+- **SDK 版本同步**：SDK-JS 更新至 0.3.20，SDK-Python 更新至 0.3.18，同步支持新的延迟控制请求功能

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

@@ -0,0 +1,6 @@
+# 🚀 CodeBuddy Code v2.40.1 发布
+
+## 🐛 问题修复
+
+- **图片生成工具**：修复 Windows 系统下输出目录路径解析错误的问题，现在可以正确生成图片到指定目录
+- **输入建议**：修复从建议菜单选择后消息重复发送的问题，提升交互体验

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

@@ -0,0 +1,15 @@
+# 🚀 CodeBuddy Code v2.41.0 发布
+
+## ✨ 新功能
+
+### 配置热更新
+
+现在修改 Skills、记忆文件（CODEBUDDY.md）、配置文件等后，无需重启 CLI 即可自动生效。告别频繁的重启操作，让工作流更加顺畅。
+
+## 🔧 改进优化
+
+- **工具白名单**：新增 `--tools` 选项，支持限制 CodeBuddy 可使用的内置工具集。可设置为空字符串禁用所有内置工具，或指定逗号分隔的工具列表，让工具使用更可控
+
+## 📝 文档更新
+
+- **环境配置说明**：为 SDK、ACP 和 IAM 文档添加 `CODEBUDDY_INTERNET_ENVIRONMENT` 环境变量配置指引，帮助不同版本用户正确配置认证环境

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

@@ -0,0 +1,6 @@
+# 🚀 CodeBuddy Code v2.41.1 发布
+
+## 🔧 改进优化
+
+- **会话管理优化**：SDK 重构 sessionId 参数，改为自动生成，简化 API 调用流程，开发者无需手动管理 sessionId
+- **SDK 版本更新**：同步更新 SDK-JS 至 0.3.23，SDK-Python 至 0.3.21

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

@@ -0,0 +1,5 @@
+# 🚀 CodeBuddy Code v2.41.2 发布
+
+## 🔧 改进优化
+
+- **SDK 版本更新**：同步更新 SDK-JS 至 0.3.24，SDK-Python 至 0.3.22

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

@@ -0,0 +1,8 @@
+# 🚀 CodeBuddy Code v2.41.3 发布
+
+## 🔧 改进优化
+
+- **新增 Kimi-K2.5 模型**：支持 Kimi-K2.5 模型，具备工具调用、图像理解和推理能力，为用户提供更多模型选择
+- **参数校验优化**：改进工具参数校验错误提示，提供更清晰的错误信息，帮助快速定位问题
+- **类型自动转换**：支持字符串形式的数字参数自动转换，提升与不同模型的兼容性
+- **热更新通知优化**：用户级 settings.json 热更新时不再显示通知，减少不必要的干扰

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

@@ -0,0 +1,5 @@
+# 🚀 CodeBuddy Code v2.41.4 发布
+
+## 🔧 改进优化
+
+- **SDK 版本同步**：更新 SDK-JS 至 0.3.26，SDK-Python 至 0.3.24，保持 SDK 与 CLI 版本同步

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

@@ -0,0 +1,10 @@
+# 🚀 CodeBuddy Code v2.41.5 发布
+
+## 🐛 问题修复
+
+- **热更新稳定性提升**：修复 plugins 目录热更新时可能触发 `.git` 等系统目录变更事件的问题，确保热更新功能更加稳定可靠
+
+## 🔧 改进优化
+
+- **会话锁机制优化**：将 session lock 的获取延迟到实际使用时，减少锁泄漏风险，同时支持 fork 操作无需获取锁，提升会话管理的灵活性
+- **SDK 同步更新**：SDK-JS 更新至 0.3.27，SDK-Python 更新至 0.3.25

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

@@ -0,0 +1,9 @@
+# 🚀 CodeBuddy Code v2.41.6 发布
+
+## 🔧 改进优化
+
+- **输入提交优化**：修复在输入斜杠命令时无法按回车提交的问题，现在可以正常提交命令或将无效命令作为普通消息发送
+- **热更新优化**：修复 plugins 目录热更新时可能触发 `.git` 等系统目录变更事件的问题，提升稳定性
+- **上下文压缩**：优化历史记录处理逻辑，过滤分支历史确保压缩准确性
+- **工具描述模板**：优化工具描述中的引号格式，提升可读性
+- **SDK 版本更新**：同步更新 SDK-JS 至 0.3.28，SDK-Python 至 0.3.26

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

@@ -0,0 +1,14 @@
+# 🚀 CodeBuddy Code v2.41.7 发布
+
+## 🔧 改进优化
+
+- **Checkpoint 性能优化**：将 checkpoint 文件读取改为异步并行处理，避免阻塞事件循环，提升响应性能
+- **会话恢复优化**：改进 session/load 流程，确保历史消息和 artifact 恢复在响应发送后执行，修复多连接场景下的重复发送问题
+- **SDK 工具参数传递**：修复 allowedTools/disallowedTools 参数格式，确保正确传递多个工具名称
+- **Python SDK 流缓冲区**：增加 100MB 缓冲区限制，防止 MCP 服务返回大 JSON 响应时出错
+- **SDK 版本追踪**：SDK 在与 CLI 通信时会自动注入 User-Agent 请求头，包含 SDK 版本和运行时信息，便于后端服务追踪和诊断
+- **SDK 版本更新**：同步更新 SDK-JS 至 0.3.29，SDK-Python 至 0.3.27
+
+## 📝 文档更新
+
+- **SDK Custom Tools 文档**：修复 Python SDK 示例中 tool 装饰器的错误用法，改为从包直接导入并使用正确的装饰器语法

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

@@ -0,0 +1,18 @@
+# 🚀 CodeBuddy Code v2.41.8 发布
+
+## 🔧 改进优化
+
+- **Print 模式输出优化**：在 print 模式下静默通知类消息，避免污染 agent 输出流，让脚本集成更加干净
+- **配置结构简化**：移除冗余的 deploymentType 配置字段，简化产品配置结构
+
+## 🐛 问题修复
+
+- **自定义请求头解析**：修复换行符判断逻辑，确保多行 header 配置能够被正确解析
+- **SDK 系统提示词传递**：修复 v2 Session API 中 `systemPrompt` 参数未正确传递的问题
+- **SDK 会话加载竞态条件**：修复多窗口场景下并发调用 `loadSession` 和 `prompt` 时的竞态条件问题，防止会话数据不一致
+
+## 📝 文档更新
+
+- **环境变量文档**：新增 `CODEBUDDY_IMAGE_GEN_ENABLED` 功能开关说明，用于控制图片生成功能
+- **发版说明**：新增 v2.40.0 至 v2.41.7 版本的中英文发版说明
+- **SDK 文档**：完善 hooks、permissions、TypeScript SDK 等文档内容

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

@@ -0,0 +1,39 @@
+# 🚀 CodeBuddy Code v2.42.0 发布
+
+## ✨ 新功能
+
+### MCP 配置支持 JSONC 格式
+
+MCP 配置文件现在支持 JSONC (JSON with Comments) 格式，让配置文件更易于维护：
+
+- 支持单行注释 (`//`)
+- 支持多行注释 (`/* */`)
+- 支持尾随逗号
+
+```jsonc
+{
+  // MCP Server Configuration
+  "mcpServers": {
+    /* Filesystem server */
+    "filesystem": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem"],
+    },
+  },
+}
+```
+
+## 🔧 改进优化
+
+- **Python 3.10 支持**：Agent SDK 扩展了兼容的 Python 版本范围，现已支持 Python 3.10
+- **ACP 会话控制**：修复了通过 SDK 设置模型和权限模式的功能
+- **工具调用稳定性**：当模型返回不完整的工具调用参数时，自动检测并请求模型重新生成，提升对话稳定性
+- **会话 Fork 增强**：支持更多参数组合方式，可通过 `--resume` 或 `--session-id` 指定源会话
+- **命令消息格式**：统一斜杠命令和技能的消息标签格式，新增 `command-args` 标签支持参数提取
+- **数据追踪准确性**：修复 prompt suggestion 与主对话数据混淆的问题
+
+## 🐛 问题修复
+
+- **Hook 输出显示**：修复 hook 执行后显示多余 JSON 原始数据的问题
+- **软链接支持**：修复 rules 目录下软链接文件无法正确加载的问题，并增加循环引用防护

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

@@ -0,0 +1,8 @@
+# 🚀 CodeBuddy Code v2.42.1 发布
+
+## 🔧 改进优化
+
+- **启动性能监控**：新增启动时间分析器，可在 `/doctor` 面板查看各阶段耗时，帮助诊断启动缓慢问题
+- **WSL 环境支持**：自动检测 WSL 环境并提示模型使用正确的 Linux 路径格式，提升 WSL 用户体验
+- **路径兼容性**：修复模型在非 Windows 平台发送 Windows 风格路径时的解析问题，避免路径错误
+- **SDK 版本更新**：同步更新 SDK-JS 至 0.3.32，SDK-Python 至 0.3.30

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

@@ -0,0 +1,18 @@
+# 🚀 CodeBuddy Code v2.42.3 发布
+
+## 🔧 改进优化
+
+### 会话摘要与主题持久化
+
+- **AI 摘要生成**：自动为会话生成 AI 摘要，在 `/resume` 列表中展示更友好的描述，帮助您快速识别和恢复历史会话
+- **主题持久化**：终端标题现在会保存到会话历史，方便后续查看和管理
+- **非交互模式支持**：新增 `--enable-session-tracking` 参数，支持在非交互模式下启用会话追踪功能
+
+### 会话追踪配置细粒度控制
+
+将会话追踪功能拆分为两个独立的环境变量，支持更灵活的配置：
+
+- `CODEBUDDY_INCLUDE_SUMMARY_MESSAGE`：控制是否生成会话摘要
+- `CODEBUDDY_INCLUDE_TOPIC_MESSAGE`：控制是否保存会话主题
+
+这允许您根据实际需求单独启用或禁用特定功能。

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

@@ -0,0 +1,27 @@
+# 🚀 CodeBuddy Code v2.43.0 发布
+
+## ✨ 新功能
+
+### 任务管理工具重构
+
+将原有的单一任务管理工具拆分为 5 个独立工具，提供更精细的任务控制能力：
+
+- **TaskCreate**：创建新任务
+- **TaskGet**：获取任务详情
+- **TaskUpdate**：更新任务状态
+- **TaskList**：列出所有任务
+- **TaskStop**：停止任务执行
+
+### Skill 工具增强
+
+Skill 工具现在支持直接执行斜杠命令，新增 `args` 参数用于传递命令参数，让技能调用更加灵活。
+
+## 🔧 改进优化
+
+- **计划模式增强**：新增 `/plan` 命令用于预览当前计划文件内容，优化计划模式下的权限控制
+- **Shell 环境快照**：执行命令时自动捕获用户 shell 配置（函数、别名、选项），确保命令在用户熟悉的环境中运行
+- **Shell 环境文件支持**：新增 `CODEBUDDY_ENV_FILE` 环境变量，支持在命令执行前自动加载指定的环境文件
+- **提示词优化**：优化 Agent 提示词模板，提升回复简洁性
+- **文件搜索优化**：精简硬编码忽略规则，优先依赖项目 .gitignore 配置
+- **Grep 工具**：新增 `context` 参数别名，提升使用便捷性
+- **子代理配置**：新增 `max_turns` 参数，支持控制代理执行轮次

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

@@ -0,0 +1,27 @@
+# 🚀 CodeBuddy Code v2.43.1 发布
+
+## ✨ 新功能
+
+### 任务管理工具重构
+
+将原有的单一任务管理工具拆分为 5 个独立工具，提供更精细的任务控制能力：
+
+- **TaskCreate**：创建新任务
+- **TaskGet**：获取任务详情
+- **TaskUpdate**：更新任务状态
+- **TaskList**：列出所有任务
+- **TaskStop**：停止任务执行
+
+### Skill 工具增强
+
+Skill 工具现在支持直接执行斜杠命令，新增 `args` 参数用于传递命令参数，让技能调用更加灵活。
+
+## 🔧 改进优化
+
+- **计划模式增强**：新增 `/plan` 命令用于预览当前计划文件内容，优化计划模式下的权限控制
+- **Shell 环境快照**：执行命令时自动捕获用户 shell 配置（函数、别名、选项），确保命令在用户熟悉的环境中运行
+- **Shell 环境文件支持**：新增 `CODEBUDDY_ENV_FILE` 环境变量，支持在命令执行前自动加载指定的环境文件
+- **提示词优化**：优化 Agent 提示词模板，提升回复简洁性
+- **文件搜索优化**：精简硬编码忽略规则，优先依赖项目 .gitignore 配置
+- **Grep 工具**：新增 `context` 参数别名，提升使用便捷性
+- **子代理配置**：新增 `max_turns` 参数，支持控制代理执行轮次

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

@@ -0,0 +1,11 @@
+# CodeBuddy Code v2.44.0 发布
+
+## ✨ 新功能
+
+### 会话标题同步
+
+支持将会话主题（Topic）通过 ACP 协议同步给 IDE，便于在标签页或侧边栏显示有意义的会话名称。当 AI 助手识别出会话主题后，IDE 可以自动更新对应的标签页标题，让用户更容易识别和管理多个并行会话。
+
+## 🔧 改进优化
+
+- **SDK 版本更新**：同步更新 SDK-JS 至 0.3.37，SDK-Python 至 0.3.35

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

@@ -0,0 +1,22 @@
+# 🚀 CodeBuddy Code v2.44.1 发布
+
+## 🔧 改进优化
+
+- **Skill/Command 调用控制**：新增 `disableModelInvocation` 配置项，支持将 skill 或 command 设置为仅手动触发模式，避免被模型自动调用，让您对 AI 的行为有更精细的控制
+- **子代理中断处理**：优化 Task 子代理被用户中断时的行为，现在会返回清晰的中断提示和可恢复的 Agent ID，支持通过 `resume` 参数继续任务，中断不再意味着丢失进度
+- **Plan 子代理能力增强**：Plan 子代理现在可以使用 Write、Edit、MultiEdit 工具编辑 plan 文件，让计划模式更加灵活实用
+- **媒体内容错误自动恢复**：当图片过大、格式无效或数量过多导致请求失败时，系统会自动移除问题内容并提供压缩建议，让对话能够继续进行
+- **WebFetch 工具增强**：增强对 SPA 页面的支持，当页面主体内容为空时自动提取 meta 标签信息，更好地理解现代 Web 应用
+- **自定义 Headers 合并优化**：修复 HTTP headers 合并时的大小写敏感问题，现在会正确覆盖同名但大小写不同的 header
+- **allowed-tools 格式支持**：自定义 Skill 和 Command 的 `allowed-tools` 字段现在同时支持逗号分隔字符串和 YAML 数组两种格式，配置更灵活
+- **输入框优化**：修复消息发送时序问题，确保消息完全发送后再清空输入
+
+## 🐛 问题修复
+
+- **自定义请求头解析**：修复换行符判断逻辑，确保多行 header 配置能够被正确解析
+- **文档链接**：修正沙箱文档链接指向正确的文件
+
+## 📝 文档更新
+
+- **SDK 示例文档**：新增 SDK 演示页面，提供 TypeScript SDK 的使用示例和最佳实践
+- **技能与命令文档**：更新技能和斜杠命令的相关文档说明