规范并补充日志内容

SHH.CameraService/Core/ParentProcessSentinel.cs

@@ -1,44 +1,52 @@
-using System.Diagnostics;
+using Ayay.SerilogLogs;
 using Microsoft.Extensions.Hosting;
-using Microsoft.Extensions.Logging;
+using Serilog;
 using SHH.CameraSdk;
+using System.Diagnostics;
 
 namespace SHH.CameraService;
 
+/// <summary>
+/// 父进程守护服务 (BackgroundService)
+/// <para>核心逻辑：定期检查启动本服务的父进程是否存活，若父进程退出（如 UI 崩溃），则触发本服务自动退出，避免孤儿进程占用相机硬件资源。</para>
+/// </summary>
 public class ParentProcessSentinel : BackgroundService
 {
     private readonly ServiceConfig _config;
     private readonly IHostApplicationLifetime _lifetime;
-    private readonly ILogger<ParentProcessSentinel> _logger;
+    private static ILogger _sysLog = Log.ForContext("SourceContext", LogModules.Core);
 
+    /// <summary>
+    /// 使用统一的结构化日志记录器，SourceContext 设置为 Core 模块
+    /// </summary>
     public ParentProcessSentinel(
         ServiceConfig config,
-        IHostApplicationLifetime lifetime,
-        ILogger<ParentProcessSentinel> logger)
+        IHostApplicationLifetime lifetime)
     {
         _config = config;
         _lifetime = lifetime;
-        _logger = logger;
     }
 
+    /// <summary>
+    /// 执行后台守护逻辑
+    /// </summary>
     protected override async Task ExecuteAsync(CancellationToken stoppingToken)
     {
         int pid = _config.ParentPid;
-
-        // 如果 PID 为 0 或负数，说明不需要守护（可能是手动启动调试）
+        // 1. 验证 PID 合法性。如果 PID 为 0 或负数，可能是手动启动调试模式，不执行守护逻辑
         if (pid <= 0)
         {
-            _logger.LogInformation("未指定有效的父进程 PID，守护模式已禁用。");
+            _sysLog.Warning("[Sentinel] 未指定有效的父进程 PID ({ParentPid})，守护模式已禁用，服务将持续运行.", pid);
             return;
         }
 
-        _logger.LogInformation($"父进程守护已启动，正在监控 PID: {pid}");
+        _sysLog.Information("[Sentinel] 父进程守护已启动，正在监控目标 PID: {ParentPid}", pid);
 
         while (!stoppingToken.IsCancellationRequested)
         {
             if (!IsParentRunning(pid))
             {
-                _logger.LogWarning($"[ALERT] 检测到父进程 (PID:{pid}) 已退出！正在终止当前服务...");
+                _sysLog.Warning("[Sentinel] ### ALERT ### 检测到父进程 (PID:{ParentPid}) 已退出！正在下发系统终止信号...", pid);
 
                 // 触发程序优雅退出
                 _lifetime.StopApplication();
@@ -52,6 +60,11 @@ public class ParentProcessSentinel : BackgroundService
         }
     }
 
+    /// <summary>
+    /// 核心状态判定：通过 PID 获取进程快照并检查存活状态
+    /// </summary>
+    /// <param name="pid">父进程 ID</param>
+    /// <returns>存活返回 True，已消亡返回 False</returns>
     private bool IsParentRunning(int pid)
     {
         try
@@ -72,7 +85,7 @@ public class ParentProcessSentinel : BackgroundService
         }
         catch (Exception ex)
         {
-            _logger.LogError(ex, "检查父进程状态时发生未知错误，默认为存活");
+            _sysLog.Debug("[Sentinel] 无法定位 PID 为 {ParentPid} 的进程，判定为已退出.", pid);
             return true; // 发生未知错误时，保守起见认为它还活着
         }
     }