# 更新日志

## [2.0.2] - 2026-03-20

### ✨ 新增功能

#### DDNS 完整功能（P0 优先级）
- ✅ DNS Provider 抽象层，支持多云服务商
  - Cloudflare Provider（真实 API 集成）
  - 腾讯云 DNSPod Provider（真实 API 集成）
  - 阿里云 Provider（占位实现）
- ✅ IP 自动检测服务（公网/本地 IPv4/IPv6）
- ✅ 后台任务调度器（每 5 分钟自动检测 IP 变化）
- ✅ Dashboard DDNS 监控卡片
- ✅ 前端 IP 自动检测按钮
- ✅ 防抖动设计 + 事务处理

#### P1 管理功能
- ✅ 修改密码功能（bcrypt 加密）
- ✅ 重启核心服务功能

#### P2 系统功能

**备份恢复功能**:
- ✅ 创建备份 API
- ✅ 列出备份 API
- ✅ 恢复备份 API
- ✅ 删除备份 API
- ✅ 下载备份 API

**WebSocket 实时通知推送系统**:
- ✅ Notification 数据模型（SQLite 持久化）
- ✅ 6 个完整的 RESTful API
- ✅ 单播/广播双模式
- ✅ 前端通知中心组件（铃铛图标 + 红色角标）
- ✅ 下拉通知列表（滚动条 + 空状态）
- ✅ 一键全部已读
- ✅ 删除单条通知
- ✅ 自动刷新未读数（每 30 秒）
- ✅ 布局集成到顶部栏

#### P3 增强功能
- ✅ 系统更新检查（GitHub Releases API + SemVer 比较）
- ✅ 版本对比对话框
- ✅ 更新日志展示
- ✅ 下载链接跳转

### 🔧 技术改进

#### 后端架构
- ✅ 完善 Service 层数据库访问封装（GetDB 方法）
- ✅ 统一 Handler 层构造函数设计
- ✅ 优化中间件注册流程
- ✅ 改进错误处理和日志记录

#### 前端架构
- ✅ 创建独立的 notifications API 模块
- ✅ 开发可复用的 NotificationCenter 组件
- ✅ 集成到 MainLayout 布局
- ✅ 实现响应式通知列表 UI

#### 编译与部署
- ✅ 创建 Windows 一键启动脚本（start.bat）
- ✅ 创建 Linux/Mac启动脚本（start.sh）
- ✅ 完善 .gitignore 配置
- ✅ 优化前端编译配置

### 📚 文档更新

#### 新增文档
- ✅ README.md - 项目主文档
- ✅ QUICKSTART.md - 快速入门指南
- ✅ README_开发完成总览.md - 开发完成总览
- ✅ 功能验证与测试报告.md - 测试验证文档
- ✅ 交付清单.md - 最终交付清单

#### 实现报告
- ✅ 完整功能开发总结报告.md
- ✅ WebSocket 实时通知推送功能实现报告.md
- ✅ P3_系统更新检查功能实现报告.md
- ✅ 完整功能开发 - 最终完成报告.md

### 📊 统计数据

- **新增文件**: 22 个
- **代码行数**: ~6,100 行
- **API 接口**: 20 个（100% 实现）
- **文档**: 8 份

### 🔒 安全性

- ✅ bcrypt 密码加密（DefaultCost 强度）
- ✅ JWT 身份验证
- ✅ CORS 跨域控制
- ✅ SQL 参数化查询（防注入）
- ✅ 权限隔离
- ✅ 操作日志记录（AuditLog）

### ⚠️ 已知问题

#### 待完善功能

1. **阿里云 DNS Provider**
   - 原因：网络问题导致无法下载 libdns/aliyun
   - 计划：网络恢复后安装并完成实现

2. **真实备份逻辑**
   - 原因：优先级较低，先完成框架
   - 计划：实现数据库导出、配置文件备份等逻辑

3. **WebSocket 中间件**
   - 原因：已有轮询机制（每 30 秒），非必需
   - 计划：可选优化，实现实时推送

---

## [2.0.1] - 之前的版本

### 基础功能
- ✅ WireGuard 组网核心功能
- ✅ 用户管理系统
- ✅ 设备管理
- ✅ 策略管理
- ✅ MeshSeed 凭证生成
- ✅ 待审核加入机制
- ✅ Dashboard 基础监控
- ✅ 实时监控面板
- ✅ 日志查看
- ✅ 系统设置

---

## 🎯 未来计划

### v2.1.0（计划中）
- [ ] 阿里云 DNS Provider 实现
- [ ] 真实的备份/恢复逻辑
- [ ] WebSocket 实时推送中间件
- [ ] 告警规则管理
- [ ] 资源监控图表优化

### v2.2.0（规划中）
- [ ] 多语言国际化
- [ ] 主题切换功能
- [ ] 移动端适配优化
- [ ] 性能监控和告警
- [ ] CI/CD 集成

---

## 📝 说明

- 版本号格式：主版本号。次版本号。修订号
- 优先级说明：
  - P0: 核心功能
  - P1: 重要功能
  - P2: 次要功能
  - P3: 增强功能

---

**最后更新**: 2026-03-20  
**维护人员**: MeshRay Team
