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

Release v0.9.9（当前基线）

基于 git log 版本标记对应的最新发布提交（416ef48 v0.9.9）与当前 HEAD（4ef3c92 优化了显示，位于 v0.9.9 之后）。仓库未打 git tag，此记录以提交信息中的版本标记为准。

元数据

• 版本：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；./deploy.sh upgrade。
• 已知限制：单机部署；无实时协同编辑；测试覆盖待增强（OI-3）。

已知问题

编号	内容	处置
OI-1	敏感日志脱敏	待整改
OI-2	Compose v2 官方化	待整改
OI-4	版本字段 1.0.0 与 git 标记不符，需统一	待整改（见本文档「版本对齐」说明）

版本对齐说明

• git 发布线：v0.9.1 → v0.9.2 → v0.9.6 → v0.9.7 → v0.9.8 → v0.9.9（416ef48）。
• 无 v1.0.0 的 git 版本；代码 APP_VERSION=1.0.0、package.json version=1.0.0 与文档中的 v1.0.0/v1.0.1 均为遗留占位，与 git 不符。
• 建议：下次打 tag 时以 v0.9.9 为基线；若计划升级 v1.0.0 则应显式建 tag 并同步代码字段。