Skip to content

v1.2.0

Latest

Choose a tag to compare

@SunYanbox SunYanbox released this 15 Mar 17:31
· 14 commits to master since this release

版本更新日志 - v1.2.0

新增

  • 哈希工具类 (HashUtil)

    • 新增静态工具类 HashUtil,提供 Hash(string text, HashAlgo hashAlgo) 和 Hash(byte[] data, HashAlgo hashAlgo) 两个重载方法
    • 支持多种哈希算法:SHA1、SHA256、MD5、SHA384、SHA512,默认算法为 SHA256
    • 利用 .NET 5+ 的 HashAlgorithm.HashData 静态方法优化性能,避免手动管理 IDisposable 资源
    • 新增 HashAlgo 枚举类型,明确定义支持的算法集,并包含详细的安全建议文档
  • 单元测试覆盖

    • 新增 HashUtilTest 测试类,遍历所有 HashAlgo 枚举值对固定字符串进行哈希计算并输出结果,确保各算法实现正确
  • 文档完善

    • 更新中英文 API 文档,新增 HashUtil 章节详细说明方法签名、参数说明及异常行为
    • 更新中英文 README 功能列表,新增 HashUtil 条目
    • 在 HashAlgo 枚举中通过 XML 文档明确区分推荐算法(SHA-2 系列)与遗留算法(SHA1、MD5)的适用场景

更改

  • 模组常量重构

    • 新增内部静态类 SuntionCoreMod,将 ModName 常量和 Logger 实例从 SuntionCoreLoad 迁移至此
    • 在 SuntionCoreMod 中初始化 public static readonly ModLogger Logger,统一日志获取逻辑
  • 版本升级

    • 模组版本号从 1.1.0 提升至 1.2.0
    • 同步更新项目文件中的 <Version> 标签为 1.2.0

移除

  • 从 README.md 中移除原有的 "ModMailService" 详细功能描述段落(该功能已合并到 SPT 扩展中)

修复

  • 元数据引用修复

    • 修复 SuntionCoreMetadata.Name 属性引用错误,由过时的 SuntionCoreLoad.ModName 更正为 SuntionCoreMod.ModName
  • 日志引用修复

    • 更新 SuntionCoreLoad.OnLoad 方法中的日志检查逻辑,使用 SuntionCoreMod.ModName 进行判断
    • 更新日志输出调用,直接使用 SuntionCoreMod.Logger.Info 替代原有的实例获取方式
  • 异常处理增强

    • 在 HashUtil 方法中添加参数 null 检查 (ArgumentNullException.ThrowIfNull)
    • 添加不支持算法的异常处理 (NotSupportedException)

影响范围

  • 无破坏性变更:此次变更为常规版本迭代,主要反映新增的 HashUtil 功能及文档完善,未涉及现有 API 的重命名或删除

病毒检测报告:
SuntionCore-1.2.0.7z