# 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`。