@tencent-ai/agent-sdk 0.3.99 → 0.3.100

package/cli/CHANGELOG.md

@@ -7,6 +7,32 @@ CodeBuddy Code 的所有重要更新都会记录在这里。
 
 ## [未发布]
 
+## [2.68.0] - 2026-03-30
+
+### ✨ 新功能
+
+- **Web UI 文档查看器**：在 Web UI 中新增文档浏览功能，支持全文搜索、中英文切换、目录导航和 TOC
+- **API 文档入口**：文档页面提供 API Reference 快捷链接，可直接跳转到 Swagger UI
+- **CLI 文档打包**：构建时自动处理 CLI 文档并随 Web UI 一起分发，支持离线查看
+
+### 🔧 功能改进
+
+- **HTTP API 标准化**：所有公开端点统一到 `/api/v1/` 前缀，支持版本控制；内部端点迁移到 `/internal/`
+- **API 文档**：新增 Swagger UI（`/api/docs`）和 OpenAPI 规范（`/api/openapi.json`），Beta 阶段
+- **统一响应格式**：公开端点使用标准 `{ data }` / `{ error: { code, message } }` 信封格式
+- **统一认证**：提取公共认证函数，消除各 Controller 中的重复实现
+- **ACP 端点迁移**：ACP 协议端点从 `/acp` 迁移到 `/api/v1/acp`，与 REST API 统一路由前缀
+- **文档独立窗口**：Web UI 文档视图支持在新标签页中独立全屏打开
+- **版本号显示**：文档视图和侧边栏优化版本号展示逻辑
+- **API 响应兼容**：Web UI 适配统一信封格式（`{ data }` 包装），确保 REST 端点响应正确解析
+- **凭证存储统一**：WeChat 和 WeCom 凭证从多文件存储迁移到单文件 `instances.json` 格式，支持自动迁移旧格式
+- **E2E 测试**：新增 HTTP API 端到端测试覆盖（40 个测试用例）
+
+### 🐛 问题修复
+
+- **确认框显示修复**：修复 AskUserQuestion 确认框偶发不显示的问题，解决路由导航中的竞态条件
+- **文档链接格式**：修正 Channels 文档中 localhost 链接的格式
+
 ## [2.67.0] - 2026-03-28
 
 ### ✨ 新功能