# 更新日志

本文档记录 Sharp-Basic Framework 的所有重要更改。

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

## [未发布]

### 计划中
- Cache 模块完整实现
- EventBus 模块完整实现
- 性能监控和诊断工具

## [1.0.1] - 2025-01-XX

### 新增
- 完整的项目元数据和版权信息
- AUTHORS 文件列出贡献者
- CONTRIBUTING.md 贡献指南
- NOTICE 文件包含第三方依赖声明
- CHANGELOG.md 版本变更记录
- Directory.Build.props 统一管理项目元信息

### 变更
- 更新许可证为 AGPL-3.0-or-later
- 完善 README.md，添加项目徽章和详细信息
- 统一版权声明为 Copyright © 2024-2025 duyl328

### 文档
- 更新 CLAUDE.md 项目指南
- 添加快速开始指南

## [1.0.0] - 2024-XX-XX

### 新增
- ✨ 初始版本发布
- 核心模块实现:
  - **Sharp.Common**: 基础工具库（Result<T>、Global DI 容器、扩展方法）
  - **Sharp.Config**: 多格式配置管理（JSON/XML/INI/TOML）
  - **Sharp.Data**: EF Core 数据访问层（仓储模式、审计、软删除）
  - **Sharp.Log**: Serilog 日志集成
  - **Sharp.Wpf**: WPF MVVM 基础库
  - **Sharp.Wpf.HandyControl**: HandyControl UI 库集成
  - **Sharp.Wpf.DevTools**: 开发者工具（DevTools 窗口、日志查看器）
  - **Sharp.NetClient**: HTTP 客户端（Polly 重试）
  - **Sharp.NetServer**: 轻量级 Web 服务器
  - **Sharp.Ports**: 串口通信库
  - **Sharp.Plc**: PLC 通信抽象层
  - **Sharp.Plc.Siemens**: 西门子 S7 PLC 驱动
  - **Sharp.Process**: 进程执行管理
  - **Sharp.Python**: Python 脚本执行
- 📦 完整的单元测试覆盖
- 📚 各模块 README 文档
- 🎯 Sharp.Demo 综合示例应用

### 架构
- 模块化设计，引入即用
- 约定优于配置的理念
- 固执己见的技术栈（EF Core, Serilog, HandyControl）
- Result<T> 函数式错误处理
- 混合 DI 方式（标准 DI + Global 容器）

---

## 版本说明

### 版本号格式: MAJOR.MINOR.PATCH

- **MAJOR**: 不兼容的 API 变更
- **MINOR**: 向后兼容的功能新增
- **PATCH**: 向后兼容的问题修正

### 变更类型

- `新增`: 新功能
- `变更`: 现有功能的变更
- `弃用`: 即将移除的功能
- `移除`: 已移除的功能
- `修复`: Bug 修复
- `安全`: 安全相关的修复
- `文档`: 文档相关变更
- `性能`: 性能改进

---

[未发布]: https://gitea.duyl328.org/jimmy/sharp-basic/compare/v1.0.1...HEAD
[1.0.1]: https://gitea.duyl328.org/jimmy/sharp-basic/compare/v1.0.0...v1.0.1
[1.0.0]: https://gitea.duyl328.org/jimmy/sharp-basic/releases/tag/v1.0.0