NewLife.Core 版本更新记录

v11.12.2026.0301 (2026-03-01)

序列化增强

  • SpanSerializer：新增高性能 Span 二进制序列化器，支持零分配读写，性能全面优于传统方式
  • SpanReader/SpanWriter：新增对 byte[] 的直接构造支持
  • 字符串读取优化：优化字符串读取时的内存分配策略，减少堆分配

IPacket 重构与性能优化

  • OwnerPacket：重构为 sealed 类，优化内存管理与生命周期
  • 切片性能：优化 IPacket 切片逻辑，减少装箱，完善测试
  • PacketHelper.AsPacket：新增快捷转换方法，简化 Packet 操作
  • 释放机制：完善 IPacket 与 IMessage 的释放文档与测试

网络层性能优化

  • SendMessageAsync：重构为非异步路径，降低 Task 分配开销
  • PooledValueTaskSource：增强池化 ValueTask 源，提升并发吞吐
  • 编解码器池化：对编解码器与事件参数进行池化，Echo 场景性能大幅提升
  • NetServer 实测：压测跑出 23.4 Gbps 带宽、1.4 亿 pkt/s 吞吐

配置系统热加载重构

  • 事件驱动：FileConfigProvider 从低效轮询改为 FileSystemWatcher 事件驱动热更新
  • 双重保险：Watcher 可用时定时器周期延长为 60 秒作为兜底，保持 Period 属性向后兼容

IO 工具增强

  • IOHelper：新增异步精确读取（ReadExactlyAsync）与最少读取（ReadAtLeastAsync）方法及测试
  • MaxSafeArraySize：新增安全最大数组尺寸常量

其他优化

  • DeferredQueue：支持运行时动态修改处理周期
  • MemoryCache：Remove 单键路径实现零分配优化
  • 文件操作：增强异常处理与哈希校验链路追踪

性能基准测试

  • 新增 Benchmark 基准测试项目（net10.0），覆盖 IPacket、MemoryCache、TCP Echo、NetServer 等核心场景
  • 发布 IPacket、NetServer、MemoryCache 等性能测试报告

文档与 Copilot 指令

  • 新增 NewLife.Net 开发规范文档与 Copilot 协作指令
  • 新增 AI 开发流程指令及自治批处理规范
  • 优化 Copilot 指令文档结构与基准测试规范

v11.11.2026.0201 (2026-02-01)

核心功能

ApiHttpClient 增强

  • 多服务竞速与负载均衡：支持多地址竞速下载，自动选择最快节点
  • 哈希校验：支持文件下载时的哈希校验功能
  • 负载均衡器重构：新增 RaceLoadBalancer、PeerEndpointSelector 等负载均衡组件
  • 节点管理：自动屏蔽失败节点，支持可配置的启动延迟步长
  • 性能追踪：为竞速调度和下载过程增加 Tracer 埋点

依赖注入（DI）增强

  • ObjectContainer 优化：增强文档与核心功能，支持延迟 DI 集成
  • Token 模型扩展：引入 IToken 接口，提升令牌模型的扩展性
  • TokenModel 扩展：新增 Scope 属性支持，改为 partial 类提高扩展容错

网络层优化

  • NetClient 重构：完善文档与注释，补充单元测试
  • 会话/服务器增强：增强 Net 会话与服务器注释及单元测试
  • 消息处理统一：统一 IMessage 处理逻辑，简化消息提取代码，支持原始内容追踪
  • UdpServer 修复：修正监听 0 端口后没有自动回填到 NetServer 的问题
  • 并发性能优化：优化消息队列并发性能，完善编码器注释

工具类新增与增强

  • UriInfo 增强：新增 ToUri 方法，增强对 IPv6 及多格式 URL 的解析支持
  • Span 扩展：新增 Span<byte> Trim 扩展方法及单元测试
  • 配置支持：Config<T> 支持泛型字典（修复 #172）
  • 序列化优化：如果属性定义了 DataObjectFieldAttribute，让它们排在前面

文档与协作

  • 使用手册：为主要功能模块编写使用手册（ApiHttpClient、网络库等）
  • Copilot 指令优化：
    • 新增 Markdown 文档规范
    • 完善主动优化原则及细化规范
    • 新增防御性注释与日志规范
    • 新增集合表达式与 Null 条件运算符指引
    • 优化 XCode/Cube 指令读取与 XML 检测策略
    • 自动分发 Copilot 指令文件及 MSBuild 支持

测试与质量

  • 单元测试大幅增强：为网络库核心功能、UriInfo、PeerEndpointSelector、ApiHttpClient 等新增大量单元测试
  • 测试健壮性提升：优化测试用例健壮性与时区兼容性，提升 CI 兼容性

其他优化

  • 日志优化：简化线程池和长任务在日志里的名字，让应用启动时的日志更整齐
  • AddServer 改进：添加服务地址时返回服务节点

历史版本

v11.10.2026.0101 (2026-01-01)

  • 重构 IEventBus，支持 EventHub
  • ApiHttpClient 支持文件下载

说明：

  • 正式版发布周期：每月月初
  • 测试版发布周期：提交代码到 GitHub 时自动发布
  • 版本号格式：正式版 {主版本}.{子版本}.{年}.{月日}，测试版 {主版本}.{子版本}.{年}.{月日}-beta{时分}