# Changelog

所有值得注意的更改都将记录在此文件中。

格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。

## [Unreleased]

### Added
- 混合检索（BM25 + 向量联合），HybridRetriever + SearchConfig 可配置
- 增量入库（SHA256 文件变更追踪），CLI `--incremental` / `--force` 选项
- Cross-Encoder 结果重排序（BAAI/bge-reranker-base）
- Web 管理界面（Vue 3 SPA，`/admin`）
- .docx 文档支持（markitdown）
- 数据导出功能（JSON/CSV），CLI `export` 命令
- Docker 部署方案 + docker-compose（含 GPU profile）
- API 审计日志、请求体大小限制、健康检查免限速
- GitHub Actions CI 流水线 + PyPI 发布
- Pre-commit 钩子配置（ruff + mypy）
- 性能基准测试（嵌入 + 检索）

### Changed
- Searcher 支持 hybrid/vector 检索模式切换
- Embedder Protocol 修复为标准写法
- PDF/EPUB Splitter 参数名统一为 `source`

### Fixed
- CORS `allow_credentials` 配置修复
- chromadb 不同版本异常类型兼容（NotFoundError）

## [0.1.0] - 2026-07-05

### Added
- Markdown 文档解析与语义检索
- 多 Provider 嵌入支持（local/OpenAI/DashScope）
- 多格式文档（.md/.txt/.pdf/.html/.epub）
- GPU 自动检测加速
- FastAPI HTTP API + Typer CLI
- API Key 认证和速率限制
- 路径遍历安全防护