docs: 完善参数注释与StyleCop配置

src/Core/TakeoutSaaS.Shared.Abstractions/Results/ApiResponse.cs

@@ -47,36 +47,53 @@ public sealed record ApiResponse<T>
     /// <summary>
     /// 成功返回。
     /// </summary>
+    /// <param name="data">业务数据。</param>
+    /// <param name="message">提示信息。</param>
+    /// <returns>封装后的成功响应。</returns>
     public static ApiResponse<T> Ok(T data, string? message = "操作成功")
         => Create(true, 200, message, data);
 
     /// <summary>
     /// 无数据的成功返回。
     /// </summary>
+    /// <param name="message">提示信息。</param>
+    /// <returns>封装后的成功响应。</returns>
     public static ApiResponse<T> Ok(string? message = "操作成功")
         => Create(true, 200, message, default);
 
     /// <summary>
     /// 兼容旧名称：成功结果。
     /// </summary>
+    /// <param name="data">业务数据。</param>
+    /// <param name="message">提示信息。</param>
+    /// <returns>封装后的成功响应。</returns>
     public static ApiResponse<T> SuccessResult(T data, string? message = "操作成功")
         => Ok(data, message);
 
     /// <summary>
     /// 错误返回。
     /// </summary>
+    /// <param name="code">错误码。</param>
+    /// <param name="message">错误提示。</param>
+    /// <param name="errors">错误详情。</param>
+    /// <returns>封装后的失败响应。</returns>
     public static ApiResponse<T> Error(int code, string message, object? errors = null)
         => Create(false, code, message, default, errors);
 
     /// <summary>
     /// 兼容旧名称：失败结果。
     /// </summary>
+    /// <param name="code">错误码。</param>
+    /// <param name="message">错误提示。</param>
+    /// <returns>封装后的失败响应。</returns>
     public static ApiResponse<T> Failure(int code, string message)
         => Error(code, message);
 
     /// <summary>
     /// 附加错误详情。
     /// </summary>
+    /// <param name="errors">错误详情。</param>
+    /// <returns>包含错误详情的新响应。</returns>
     public ApiResponse<T> WithErrors(object? errors)
         => this with { Errors = errors };
 
@@ -95,6 +112,7 @@ public sealed record ApiResponse<T>
     /// <summary>
     /// 解析当前 TraceId。
     /// </summary>
+    /// <returns>当前有效的 TraceId。</returns>
     private static string ResolveTraceId()
     {
         if (!string.IsNullOrWhiteSpace(TraceContext.TraceId))
@@ -142,6 +160,7 @@ internal sealed class IdFallbackGenerator
     /// <summary>
     /// 生成雪花风格的本地备用 ID。
     /// </summary>
+    /// <returns>本地生成的雪花 ID。</returns>
     public long NextId()
     {
         lock (_sync)
@@ -168,6 +187,8 @@ internal sealed class IdFallbackGenerator
     /// <summary>
     /// 等待到下一个毫秒以避免序列冲突。
     /// </summary>
+    /// <param name="lastTimestamp">上一毫秒的时间戳。</param>
+    /// <returns>下一个时间戳（毫秒）。</returns>
     private static long WaitNextMillis(long lastTimestamp)
     {
         var timestamp = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds();