# 更新日志

所有重要更改都会记录在此文件中。

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

## [Unreleased]

### 计划中
- 支持 PDF 加密与密码保护
- 支持自定义页眉页脚模板
- 支持水印功能
- 多语言管理后台

---

## [2.0.0] - 2024-12-10

### 🎉 正式版发布

这是一个重大版本更新，引入了异步任务处理架构。

### 新增
- ✨ **异步任务队列** - 基于 Redis 的任务队列，支持高并发处理
- ✨ **任务管理** - 完整的任务生命周期管理（创建、查询、取消、重试）
- ✨ **批量任务** - 支持一次提交多个转换任务
- ✨ **管理后台** - Vue 3 构建的可视化管理界面
- ✨ **API Key 认证** - 支持多租户 API Key 管理
- ✨ **请求限流** - IP/用户维度的速率限制
- ✨ **SSRF 防护** - 阻止内网地址访问
- ✨ **幂等性支持** - Idempotency-Key 防止重复提交
- ✨ **Prometheus 监控** - 完整的指标采集
- ✨ **健康检查** - Ready/Live 探针，支持 K8s
- ✨ **云存储支持** - 支持阿里云 OSS 和腾讯云 COS
- ✨ **回调重试** - 带指数退避的回调重试机制
- ✨ **HMAC 签名** - 回调请求签名验证

### 优化
- ⚡ 浏览器池自愈机制（内存阈值重启、健康检查）
- ⚡ 任务状态新增 `Stalled`（卡死）状态
- ⚡ 多队列隔离（fast/normal/slow）
- ⚡ Dry-run 预检 API

### 技术栈升级
- 升级到 .NET 9
- 升级 PuppeteerSharp 到 20.x

### 兼容性
- 保留同步 API 接口，向后兼容 MVP 版本

---

## [1.0.0] - 2024-11-01

### 🚀 MVP 版本发布

首个公开版本，提供基础的 HTML/URL 转 PDF 功能。

### 新增
- ✨ HTML 内容转 PDF
- ✨ URL 转 PDF
- ✨ HTML/URL 转图片（PNG/JPEG/WebP）
- ✨ 浏览器实例池化
- ✨ 并发控制
- ✨ 本地文件存储
- ✨ 回调机制
- ✨ Docker 容器化部署
- ✨ 健康检查接口

### 技术栈
- .NET 8
- PuppeteerSharp 20.2.5
- Chromium (Headless)

---

## 版本对比

| 特性 | MVP (1.0) | 正式版 (2.0) |
|------|-----------|--------------|
| 接口模式 | 同步 | 异步 + 同步 |
| 任务管理 | ❌ | ✅ |
| 认证授权 | ❌ | ✅ |
| 请求限流 | ❌ | ✅ |
| 监控告警 | 基础 | 完整 |
| 云存储 | ❌ | ✅ |
| 管理后台 | ❌ | ✅ |
| 集群部署 | 有限 | 完整 |

---

[Unreleased]: https://github.com/your-username/html-to-pdf/compare/v2.0.0...HEAD
[2.0.0]: https://github.com/your-username/html-to-pdf/compare/v1.0.0...v2.0.0
[1.0.0]: https://github.com/your-username/html-to-pdf/releases/tag/v1.0.0