97 lines
2.6 KiB
Markdown
97 lines
2.6 KiB
Markdown
# 更新日志
|
||
|
||
所有重要更改都会记录在此文件中。
|
||
|
||
格式基于 [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
|
||
|