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

38 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# Release v0.9.9(历史记录)
> **本文为历史发布记录**:v0.9.9 线已由 [v1.0.0](v1.0.0.md) 接替,文中「当前基线」「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](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](v1.0.0.md)。OI-4 在本发布关闭。