nex_docus/docs/sdd/releases/v0.9.6.md

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。