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

Release v0.9.9（历史记录）

本文为历史发布记录：v0.9.9 线已由 v1.0.0 接替，文中「当前基线」「HEAD」等措辞为撰写当时（4ef3c92）的状态，保留原文以供追溯。

基于 git log 版本标记对应的最新发布提交（416ef48 v0.9.9）与当时的 HEAD（4ef3c92 优化了显示）。仓库未打 git tag，此记录以提交信息中的版本标记为准；v0.9.9 线后续还有 f92fff6 v0.9.9 基线版本 与 d6ebd62/eea3b96 v0.9.9-SP1。

元数据

• 版本：v0.9.9（当前基线）
• 对应提交：v0.9.9 标记提交 416ef48；当前 HEAD 4ef3c92
• 适用代码：backend + frontend + docker-compose（main 分支）
• 代码内版本字段：意外标注为 1.0.0，与 git 标记 v0.9.9 不符，见「已知差异」

主要能力

覆盖阶段一~三：认证/DV-0001、项目管理与文件系统/DV-0002、文档编辑/DV-0003、RBAC 与系统管理/DV-0004、全文检索/DV-0005、ZVec 向量化/DV-0006、RAG 对话/DV-0007、模型配置/DV-0008、分享预览/DV-0009、通知日志 Git 导出/DV-0010、MCP/DV-0011。

产物

• 后端镜像（docker-compose backend build）
• 前端镜像（frontend build，nginx 托管静态资源）
• 部署编排：docker-compose.yml + deploy.sh

验证边界

• 自动化测试：backend/tests/test_chat_citations.py、test_model_and_vector_configuration.py、test_search_service.py。
• 运行验证：/health 返回 healthy；Swagger /docs 可用。
• 部署验证：Compose v2 docker compose up -d --build；./scripts/deploy.sh upgrade（脚本自 v1.0.0 起位于 scripts/）。
• 已知限制：单机部署；无实时协同编辑；测试覆盖待增强（OI-3）。

已知问题

编号	内容	处置
OI-1	敏感日志脱敏	待整改
OI-2	Compose v2 官方化	待整改
OI-4	版本字段 1.0.0 与 git 标记不符，需统一	已关闭（v1.0.0 立项并显式建 tag，见 v1.0.0.md）

版本对齐说明

• git 发布线：v0.9.1 → v0.9.2 → v0.9.6 → v0.9.7 → v0.9.8 → v0.9.9（416ef48，含 -SP1）。
• 撰写本文时尚无 v1.0.0 的 git 版本，代码 APP_VERSION=1.0.0、package.json version=1.0.0 与文档中的 v1.0.0/v1.0.1 均为遗留占位。
• 后续处置（已完成）：v1.0.0 已作为首个正式版本立项，代码字段保留 1.0.0 并通过显式建 tag 对齐，见 v1.0.0.md。OI-4 在本发布关闭。