petwash/CHANGELOG.md

更新日志

[1.0.1] - 2026-02-25

修复

• 修复 MQTTnet 4.3.7 版本 API 兼容性问题
  • ConnectAsync() 添加 CancellationToken 参数
  • SubscribeAsync() 使用 MqttClientSubscribeOptionsBuilder
  • PublishAsync() 添加 CancellationToken 参数
  • ApplicationMessage.PayloadSegment 使用 .ToArray() 转换为字节数组
  • 修复 CS0234、CS0246、CS0119 编译错误
• 修复 LogService.cs 缺少 using System.IO; 导致的 CS0103 错误
• 降级 MQTTnet 从 5.1.0 到 4.3.7 以保持 API 兼容性
• 统一 Microsoft.Extensions.Hosting 版本到 8.0.1

文档更新

• README.md 添加版本兼容性说明
• README.md 添加常见问题修复章节
• QUICK_START.md 添加 MQTTnet 编译错误解决方案
• PROJECT_STRUCTURE.md 添加 MQTTnet 4.3.7 API 变更说明
• 新增 CHANGELOG.md 版本更新日志

改进

• 所有异步 MQTT 操作添加 CancellationToken 支持
• 增强错误处理和空值检查
• 统一代码风格和注释

[1.0.0] - 2026-02-25

新增

• 完整的后端 API 服务（ASP.NET Core 8）

  • 套餐管理 API
  • 订单管理 API
  • 内置 MQTT Broker
  • SQLite 数据库
  • Swagger 文档

• WPF 客户端应用

  • MVVM 架构
  • 套餐选择界面
  • 订单创建和支付
  • MQTT 实时通信
  • 设备状态监控

• 完整的项目结构

  • Converters: 值转换器
  • Models: 数据模型
  • Services: 业务服务层
  • ViewModels: 视图模型
  • Views: XAML 界面
  • Resources: 样式资源

• 核心服务

  • ApiService: HTTP API 通信
  • MqttClientService: MQTT 客户端
  • ConfigurationService: 配置管理
  • LogService: 日志记录

• 文档

  • README.md: 项目说明
  • QUICK_START.md: 快速启动指南
  • PROJECT_STRUCTURE.md: 项目结构说明
  • install-packages.ps1: NuGet 包安装脚本

技术栈

• .NET 8
• ASP.NET Core 8
• WPF
• Entity Framework Core
• SQLite
• MQTTnet 4.3.7
• CommunityToolkit.Mvvm 8.4.0

---

版本说明

版本号格式：主版本号.次版本号.修订号

• 主版本号：重大架构变更或不兼容的 API 修改
• 次版本号：新增功能，向下兼容
• 修订号：问题修复和小改进