# 更新日志 ☕

本页面记录了白虎面板的主要版本更新历史。

## ⚠️ 重大升级与迁移说明 (v3 数据结构)

本次更新包含底层数据结构的重大突破，将所有数据的 ID 类型从数字编号平滑迁移为 20 位的字符式全局唯一标识符（`xid`）。系统在启动时会**自动进行数据的清洗、映射、拷贝与外键修补**，以确保旧数据被妥善对接。

- **备份位置**：执行迁移前，即使有程序自动转换逻辑（data\migration_v3_backup_backup_xxx.zip），为了数据安全，仍然建议您**提前手动进行备份**。
- **降级机制**：如果遇到未预期的迁移失败或数据显示丢失，**请使用原本备份的数据库** 并 **降级至 `v1.0.10` 及以下旧版本** 进行恢复与使用。

---

## 最近更新概览

### 2026.03.05 - API 文档重构
- **OpenAPI 认证体系**：支持站点级 Token 配置与 Basic Auth 保护。
- **自定义 UI**：新增设计感十足的全局 **404 页面**。

### 2026.03.04 - 消息推送系统重构
- **原生内置**：全新原生支持企业微信、钉钉、飞书、Telegram、Bark、邮件等十余种主流渠道。
- **事件捕获**：接入系统级事件通知自动捕获，告别原有必配外部推送服务的繁琐历史。

### 2026.02.13 - 任务执行引擎重构
- **深度集成 Mise**：支持 Python, Node.js, Go, Rust, PHP 等几乎所有主流语言的动态安装与多版本切换。
- **依赖管理**：同步上线跨语言统一依赖管理系统。

### 2026.02.11 - 安全性增强
- **随机密码策略**：首次启动使用随机密码并打印在日志中。
- **暴力破解防护**：登录接口增加防暴力破解。
- **路径遍历防护**：文件系统操作增加路径穿越锁定。

### 2026.02.10 - 任务调度重构
- **调度性能**：重写了并发控制逻辑，完善了任务队列。
- **体验优化**：优化文件树交互体验，支持任务执行实时日志流。

### 2026.02.06 - 镜像扩展
- **Debian 13 支持**：增加对 Debian 13 (Trixie) 镜像支持，整理 Docker 目录结构。