37 lines
1.8 KiB
Markdown
37 lines
1.8 KiB
Markdown
# Release v0.9.6（历史升级记录）
|
||
|
||
> **文档性质**：历史发布记录。整合自原 `docs/UPGRADE_v0.9.6.md`（已并入）。内容多为当时的新增能力，绝大部分已被后续版本吸收为基线；此处仅作发布历史留存。
|
||
|
||
## 元数据
|
||
- **版本**：v0.9.6
|
||
- **更新时间**：2026-03-11
|
||
|
||
## 主要变更
|
||
1. 新增后端内集成的 MCP Server 能力（原生 `streamableHttp`，入口 `/mcp`，兼容 `/mcp/`）。
|
||
2. 新增用户级 MCP 凭证管理（`X-Bot-Id` / `X-Bot-Secret` 认证模型）。
|
||
3. 打通通过 Nginx 统一入口访问 MCP。
|
||
4. 调整部署运行环境到 Python 3.12（MCP SDK 要求 3.10+）。
|
||
5. 将 MySQL、Redis 数据目录改为项目根目录 `storage/` 持久化（`storage/mysql`、`storage/redis`、`storage/projects`、`storage/temp`）。
|
||
6. 个人中心与文档页交互优化（左右布局、浏览/编辑切换、认证异常 Toast 抑制）。
|
||
|
||
## MCP 能力（当时新增）
|
||
- 工具：`list_created_projects`、`get_project_tree`、`get_file`、`create_file`、`update_file`、`delete_file`。
|
||
- 接口：`GET /api/v1/auth/mcp-credentials`、`POST /api/v1/auth/mcp-credentials/rotate-secret`。
|
||
|
||
## 部署变更
|
||
- backend 基础镜像切换为 `python:3.12-slim`；pip 构建工具升级；国内源失败回退官方源。
|
||
- Nginx 补 `/mcp`、`/mcp/` 兼容反代。
|
||
- MySQL/Redis 数据目录挂载到 `storage/`。
|
||
|
||
## 升级迁移注意事项
|
||
- MCP 调用地址：经前端 Nginx 统一入口改为 `http(s)://<host>/mcp`；调用头保持 `X-Bot-Id`/`X-Bot-Secret`。
|
||
|
||
## 验证边界（当时建议）
|
||
1. backend `/health` 正常；
|
||
2. 统一入口 `/api/`、`/mcp`、`/mcp/` 可访问；
|
||
3. MCP client 能完成 `initialize`；
|
||
4. 个人中心 MCP 凭证展示与轮换正常。
|
||
|
||
## 关联
|
||
- 现规格映射：FR-18 / DV-0011；集成细节见 `integrations/mcp.md`。
|