refactor: 对齐 simapi-net 的 20 项差异

- SimApiLoginItem._types 默认 [user]
- 新增 SimApiIdOnlyRequest
- errorWhenNone 改名 errorWhenNull
- SimApiAuth.update 保留 TTL（Redis ttl/expire）
- SimApiCache: set 接受 Any + 新增 get<T>/getString
- SimApiHttpClient 签名字段移出 Options
- SimApiUtil: md5/sha1 支持 mode + 新增 paginate
- @SimApiAuth 支持逗号分隔多类型
- Logger: 4 位毫秒 + IsEnabled 恒 true
- 删除 /versions 端点；exceptionHandler 改为抛错
- UseSimApi 中间件顺序对齐 .NET
- README 同步更新

src/helpers/SimApiUtil.cj

@@ -61,10 +61,10 @@ public class SimApiUtil {
      * @param source 源字符串。
      * @return 32 位十六进制小写。
      */
-    public static func md5(source: String): String {
+    public static func md5(source: String, mode!: String = "x2"): String {
         let md = MD5()
         md.write(source.toArray())
-        toHexString(md.finish())
+        formatHex(md.finish(), mode)
     }
 
     /**
@@ -72,10 +72,10 @@ public class SimApiUtil {
      * @param source 源字符串。
      * @return 40 位十六进制小写。
      */
-    public static func sha1(source: String): String {
+    public static func sha1(source: String, mode!: String = "x2"): String {
         let sha = SHA1()
         sha.write(source.toArray())
-        toHexString(sha.finish())
+        formatHex(sha.finish(), mode)
     }
 
     /**
@@ -89,6 +89,28 @@ public class SimApiUtil {
         toHexString(sha.finish())
     }
 
+    /// 按 .NET Md5/Sha1 的 mode 格式化：x2/x3/x4 → 每个字节 2/3/4 位十六进制
+    private static func formatHex(bytes: Array<Byte>, mode: String): String {
+        if (mode == "x2") {
+            return toHexString(bytes)
+        }
+        let two = toHexString(bytes)
+        var sb = StringBuilder()
+        for (i in 0..bytes.size) {
+            let pair = two[i * 2..i * 2 + 2]
+            if (mode == "x3") {
+                sb.append("0")
+                sb.append(pair)
+            } else if (mode == "x4") {
+                sb.append("00")
+                sb.append(pair)
+            } else {
+                sb.append(pair)
+            }
+        }
+        sb.toString()
+    }
+
     /**
      * 字符串 Base64 编码。
      */
@@ -112,7 +134,8 @@ public class SimApiUtil {
     }
 
     /**
-     * 判断是否是 Email 地址（简化校验）。
+     * 判断是否是 Email 地址。
+     * 说明：.NET 使用 System.Net.Mail.MailAddress 校验，仓颉无等价 API，此处用正则近似。
      */
     public static func checkEmail(email: String): Bool {
         Regex("^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}$").matches(email)
@@ -189,4 +212,21 @@ public class SimApiUtil {
     public static func base64DecodeTo<T>(base64Str: String): T where T <: ISerialization<T> {
         fromJson<T>(base64Decode(base64Str))
     }
+
+    /**
+     * 分页（对齐 C# Paginate 扩展；仓颉无 IQueryable，改为对 Array<T> 切片）。
+     */
+    public static func paginate<T>(list: Array<T>, page: Int64, count: Int64): Array<T> {
+        let p = if (page < 1) { 1 } else { page }
+        let c = if (count <= 0) { 10 } else { count }
+        let skip = (p - 1) * c
+        let total = list.size
+        if (skip >= total) {
+            return Array<T>()
+        }
+        let end = if (skip + c > total) { total } else { skip + c }
+        list[skip..end]
+    }
+
+    // 说明：C# 的 XmlDeserialize<T> 依赖 System.Xml.Serialization，仓颉生态无 XML 序列化库，未移植。
 }