quantum_log 0.3.2

# QuantumLog 版本发布说明

## 版本 0.3.2 - 安全加固与性能优化 🔒⚡

**发布日期**: 2025年8月19日

### 🎯 重大更新
\
**📊 InfluxDB 时序数据库支持**\
- 新增完整的 InfluxDB Sink 实现，支持高性能时序数据写入\
- 兼容 InfluxDB 1.x 和 2.x 版本，支持多种认证方式\
- 批量写入和异步处理架构，优化大规模数据场景性能\
- 为 HPC 和监控场景提供专业的时序日志存储解决方案\
\
**🏗️ 项目架构重构**\
- 创建独立的 `examples` crate，提供完整的测试和示例环境\
- 合并和优化 `test/` 和 `examples/` 目录结构\
- 每个 sink 类型都有专门的测试样例和完整文档\
- 提升代码组织性和可维护性

这是 QuantumLog 的一个重要安全和性能优化版本，专注于生产环境的稳定性和安全性提升。

### 🔒 安全加固

- **数据库连接字符串脱敏**: 防止敏感信息泄露到日志中
- **文件权限安全检查**: 确保日志文件访问权限正确设置
- **缓冲区溢出保护**: 增强内存安全性，防止潜在的安全漏洞
- **TLS网络传输加密**: 全面支持TLS/SSL加密传输，保障数据安全
  - 支持TLS证书验证（服务器证书和主机名验证）
  - 支持自定义CA证书文件
  - 支持客户端证书认证
  - 可配置的TLS验证策略
- **网络连接安全增强**: 改进网络连接的安全性和可靠性
- **资源清理机制**: 防止资源泄露，提高系统稳定性
- **配置验证增强**: 提高配置文件的安全性验证

### ⚡ 性能优化

- **减少字符串分配**: 优化字符串操作，减少不必要的内存分配
- **HashMap转换优化**: 提升数据结构转换效率
- **数据库操作优化**: 改进数据库连接和查询性能
- **文件路径处理优化**: 提升文件操作的执行效率
- **内存分配优化**: 减少运行时内存开销

### 🛠️ 代码质量改进

- **网络模块TLS安全增强**: 完整实现TLS加密传输功能
  - 新增TLS配置字段：`tls_verify_certificates`、`tls_verify_hostname`、`tls_ca_file`、`tls_cert_file`、`tls_key_file`
  - 实现自定义TLS验证器，支持灵活的证书验证策略
  - 优化网络重连机制：`max_reconnect_attempts`、`reconnect_delay_ms`
- **修复QuantumLoggerConfig字段缺失**: 完善配置结构体定义
- **修复PipelineBuilder导入问题**: 解决模块导入冲突
- **移除未使用代码**: 清理未使用的导入和变量
- **通过cargo audit安全检查**: 确保依赖库安全性
- **所有测试用例通过**: 保证代码质量和功能完整性

### 📚 文档更新

- **统一版本号引用**: 确保所有文档中版本号的一致性
- **更新示例代码**: 提供最新的使用示例
- **完善安全使用指南**: 增加安全最佳实践说明

### 🔄 迁移指南

#### 从 0.3.0 迁移

1. **无需修改现有代码** - 所有现有 API 保持兼容
2. **配置文件检查** - 建议检查配置文件的安全性设置
3. **依赖更新** - 运行 `cargo update` 更新到最新版本

> **迁移提示（MPI 动态加载）**: 自 0.3.2 起，运行时代码不再读取自定义 `MPI_LIB_PATH` 变量；请使用平台标准环境变量（`LD_LIBRARY_PATH`/`PATH`/`DYLD_LIBRARY_PATH`）覆盖或指定库路径。`MPI_LIB_PATH` 仅作为构建阶段的提示性输出，运行时不依赖该变量。

### 🧪 测试覆盖

- 为所有安全修复添加了专门的测试用例
- 性能优化的基准测试验证
- 单元测试覆盖率保持 > 90%
- 集成测试确保系统稳定性
- 安全漏洞扫描通过

### 📦 依赖更新

- 更新所有依赖到最新安全版本
- 通过 `cargo audit` 安全审计
- 移除不必要的依赖项

### 🚀 使用示例

#### TLS网络传输配置示例

```rust
use quantum_log::config::{QuantumLoggerConfig, NetworkConfig};
use quantum_log::sinks::NetworkSink;

// 启用TLS的网络配置
let network_config = NetworkConfig {
    address: "secure-log-server.example.com:8443".to_string(),
    protocol: "tcp".to_string(),
    timeout_ms: 5000,
    max_reconnect_attempts: 3,
    reconnect_delay_ms: 1000,
    // TLS安全配置
    tls_verify_certificates: true,
    tls_verify_hostname: true,
    tls_ca_file: Some("/path/to/ca-cert.pem".to_string()),
    tls_cert_file: Some("/path/to/client-cert.pem".to_string()),
    tls_key_file: Some("/path/to/client-key.pem".to_string()),
};

// 创建启用TLS的网络Sink
let network_sink = NetworkSink::new(network_config).await?;
```

#### 安全配置示例

```rust
use quantum_log::config::QuantumLoggerConfig;

let config = QuantumLoggerConfig {
    // 启用TLS特性
    enable_tls: true,
    // 其他安全配置
    mask_sensitive_data: true,
    validate_file_permissions: true,
    ..Default::default()
};
```

### 🐛 已修复问题

- 修复了数据库连接字符串可能泄露的安全问题
- 解决了文件权限设置不当的问题
- 修复了潜在的缓冲区溢出风险
- 解决了网络传输中的安全隐患
- 修复了资源清理不完整的问题
- 解决了配置验证不充分的问题

---

## 版本 0.2.0 - 统一 Sink Trait 系统 🚀

**发布日期**: 2025年07月18日

### 🎯 重大更新
\
**📊 InfluxDB 时序数据库支持**\
- 新增完整的 InfluxDB Sink 实现，支持高性能时序数据写入\
- 兼容 InfluxDB 1.x 和 2.x 版本，支持多种认证方式\
- 批量写入和异步处理架构，优化大规模数据场景性能\
- 为 HPC 和监控场景提供专业的时序日志存储解决方案\
\
**🏗️ 项目架构重构**\
- 创建独立的 `examples` crate，提供完整的测试和示例环境\
- 合并和优化 `test/` 和 `examples/` 目录结构\
- 每个 sink 类型都有专门的测试样例和完整文档\
- 提升代码组织性和可维护性

这是 QuantumLog 的一个重要里程碑版本，引入了全新的统一 Sink Trait 系统，为日志处理提供了更强大、更灵活的架构。

### 🎯 核心特性

#### 统一 Sink Trait 系统

- **QuantumSink 核心 Trait**: 定义了所有 Sink 的基础接口
- **可叠加型 vs 独占型**: 智能区分不同类型的 Sink
- **Pipeline 管理**: 统一的 Sink 管理和协调系统
- **健康检查**: 实时监控 Sink 状态
- **统计信息**: 详细的性能和状态统计

#### Pipeline 管理系统

- **并行处理**: 支持多 Sink 并行执行
- **错误策略**: 可配置的错误处理策略
- **背压控制**: 智能缓冲区管理
- **优雅关闭**: 确保数据完整性的关闭机制
- **建造者模式**: 灵活的配置接口

### 📋 详细技术说明

#### QuantumSink Trait 设计

```rust
use quantum_log::sinks::{QuantumSink, SinkError, SinkMetadata};
use quantum_log::core::event::QuantumLogEvent;
use async_trait::async_trait;

#[async_trait]
pub trait QuantumSink: Send + Sync + std::fmt::Debug {
    type Config: Send + Sync;
    type Error: std::error::Error + Send + Sync + 'static;
    
    // 核心功能
    async fn send_event(&self, event: QuantumLogEvent) -> Result<(), Self::Error>;
    async fn shutdown(&self) -> Result<(), Self::Error>;
    async fn is_healthy(&self) -> bool;
    
    // 元数据和诊断
    fn name(&self) -> &'static str;
    fn stats(&self) -> String;
    fn metadata(&self) -> SinkMetadata;
}
```

#### Sink 类型区分

```rust
// 可叠加型 Sink - 可与其他 Sink 组合使用
pub trait StackableSink: QuantumSink {}

// 独占型 Sink - 独立运行
pub trait ExclusiveSink: QuantumSink {}
```

### 🔧 现有 Sink 增强

所有现有 Sink 都已升级支持新的 trait 系统：

- **ConsoleSink**: 实现 StackableSink
- **StdoutSink**: 实现 StackableSink  
- **FileSink**: 实现 ExclusiveSink
- **NetworkSink**: 实现 StackableSink
- **RollingFileSink**: 实现 ExclusiveSink
- **LevelFileSink**: 实现 ExclusiveSink

### 🛡️ 向后兼容性

- ✅ 完全向后兼容现有 API
- ✅ 现有代码无需修改即可运行
- ✅ 渐进式迁移支持
- ✅ 详细的迁移指南

---

**完整更新日志**: 查看 Git 提交历史获取详细变更信息

**下载**: 通过 Cargo 更新到最新版本

```bash
cargo update quantum_log
```

**验证安装**:

```bash
cargo test --all-features
```

---

*QuantumLog 0.3.1 - 让日志处理更加安全和高效！* 🔒⚡