chore: save current workspace progress

ClumsyPilot/ParkrobTrajplanner/PathSmoothing/Contracts/PathSmoothingDiagnostics.cs

@@ -2,79 +2,35 @@ using System;
 
 namespace MultiWheelC.TrajectoryPlanning.PathSmoothing;
 
-/// <summary>一次平滑尝试的不可变诊断信息。</summary>
+/// <summary>一次 Local G2 平滑尝试的不可变诊断快照，适用于成功、取消和失败结果。</summary>
 public sealed class PathSmoothingDiagnostics
 {
-    /// <summary>创建不含路径指标的默认诊断信息。</summary>
+    /// <summary>创建不可行、零耗时且没有终止原因的默认诊断快照。</summary>
     public PathSmoothingDiagnostics()
-        : this(new PathQualityMetrics(), TimeSpan.Zero, 0, 0d, string.Empty)
+        : this(new PathQualityMetrics(), TimeSpan.Zero, string.Empty)
     {
     }
 
-    /// <summary>创建完整的平滑诊断快照。</summary>
+    /// <summary>创建平滑诊断快照。</summary>
+    /// <param name="metrics">路径可行性、曲率、净空和相对变化的质量指标。</param>
+    /// <param name="elapsed">从服务入口到终止的累计耗时。</param>
+    /// <param name="terminationReason">可供调用方记录的成功、取消或失败原因；为 <see langword="null"/> 时为空字符串。</param>
     public PathSmoothingDiagnostics(
         PathQualityMetrics metrics,
         TimeSpan elapsed,
-        int retryCount,
-        double acceptedStrength,
         string terminationReason = null)
     {
         Metrics = metrics ?? new PathQualityMetrics();
         Elapsed = elapsed;
-        RetryCount = retryCount;
-        AcceptedStrength = acceptedStrength;
         TerminationReason = terminationReason ?? string.Empty;
     }
 
-    /// <summary>使用所有测量量创建平滑诊断快照。</summary>
-    public PathSmoothingDiagnostics(
-        bool isFeasible,
-        double pathLengthMeters,
-        double maximumAbsoluteVehicleCurvaturePerMeter,
-        double rootMeanSquareVehicleCurvaturePerMeter,
-        double totalAbsoluteCurvatureVariationPerMeter,
-        double curvatureVariationEnergy,
-        double minimumBodyClearanceMeters,
-        double lengthChangePercent,
-        double peakCurvatureChangePercent,
-        double curvatureVariationChangePercent,
-        double minimumClearanceChangeMeters,
-        TimeSpan elapsed,
-        int retryCount,
-        double acceptedStrength,
-        string terminationReason = null)
-        : this(
-            new PathQualityMetrics(
-                isFeasible,
-                pathLengthMeters,
-                maximumAbsoluteVehicleCurvaturePerMeter,
-                rootMeanSquareVehicleCurvaturePerMeter,
-                totalAbsoluteCurvatureVariationPerMeter,
-                curvatureVariationEnergy,
-                minimumBodyClearanceMeters,
-                lengthChangePercent,
-                peakCurvatureChangePercent,
-                curvatureVariationChangePercent,
-                minimumClearanceChangeMeters),
-            elapsed,
-            retryCount,
-            acceptedStrength,
-            terminationReason)
-    {
-    }
-
-    /// <summary>路径质量指标；始终非空。</summary>
+    /// <summary>本次尝试的质量指标；未提供时为全零且不可行的默认指标。</summary>
     public PathQualityMetrics Metrics { get; }
 
-    /// <summary>从算法入口到返回诊断的耗时。</summary>
+    /// <summary>本次尝试的累计耗时，类型为 <see cref="TimeSpan"/>。</summary>
     public TimeSpan Elapsed { get; }
 
-    /// <summary>已执行的安全强度重试次数。</summary>
-    public int RetryCount { get; }
-
-    /// <summary>通过复核的平滑强度；未接受候选时为零。</summary>
-    public double AcceptedStrength { get; }
-
-    /// <summary>面向调用方的稳定终止说明。</summary>
+    /// <summary>终止原因文本；不承载可消费的部分路径。</summary>
     public string TerminationReason { get; }
 }