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

36 lines
2.1 KiB
Markdown
Raw Normal View History

2026-08-19 10:05:22 +00:00
# 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-composemain 分支)
- **代码内版本字段**:意外标注为 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 buildnginx 托管静态资源)
- 部署编排:`docker-compose.yml` + `deploy.sh`
## 验证边界
- 自动化测试:`backend/tests/test_chat_citations.py`、`test_model_and_vector_configuration.py`、`test_search_service.py`。
- 运行验证:`/health` 返回 healthySwagger `/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 并同步代码字段。