版本更新日志 - 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)的适用场景
- 更新中英文 API 文档,新增
更改
-
模组常量重构
- 新增内部静态类
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