新增信号交互进程插件

StandardScene.Signal/Plc/PlcStationWorker.cs

@@ -9,6 +9,15 @@ namespace StandardScene.Signal.Plc
     /// 单机构 200ms 循环：心跳、读允许进出、回读写值、按需写入、自动离站。
     /// 对齐反编译 <c>PLCManager.ExcuteThreadMethod</c>。
     /// </summary>
+    /// <remarks>
+    /// 一拍顺序固定，失败则本拍标断线并 return，避免用脏数据推进状态机：
+    /// 1. 翻转内存心跳标志；若配置了 HeartDb，读当前位再写反码（PLC 侧看翻转判断调度活着）。
+    /// 2. 读 ReadDb → <see cref="PlcStationRuntime.ReadSignal"/>。
+    /// 3. 回读 WriteDb → ReadWriteSignal；与目标 WriteSignal 一致则 WriteSuccess=true。
+    /// 4. 目标与回读不一致且尚未成功时写入目标字节。
+    /// 5. <see cref="PlcStationLogic.AutoLeave"/>。
+    /// 读写均在 <see cref="PlcStationRuntime.Sync"/> 内，与扫车 Handler 互斥。
+    /// </remarks>
     public sealed class PlcStationWorker : IDisposable
     {
         private readonly SiemensPlcSession _session;
@@ -16,6 +25,8 @@ namespace StandardScene.Signal.Plc
         private readonly Action _onTick;
         private CancellationTokenSource _cts;
         private Thread _thread;
+
+        /// <summary>断线日志节流起点，避免 200ms 打满诊断。</summary>
         private DateTime _lastFailLog = DateTime.MinValue;
 
         public PlcStationWorker(PlcStationRuntime runtime, SiemensPlcSession session, int pollMs, Action onTick = null)
@@ -26,8 +37,10 @@ namespace StandardScene.Signal.Plc
             _onTick = onTick;
         }
 
+        /// <summary>本机构运行态，扫车线程按 JgName 查找后加 Sync 读写。</summary>
         public PlcStationRuntime Runtime { get; }
 
+        /// <summary>启动后台线程。重复 Start 若仍存活则忽略。</summary>
         public void Start()
         {
             if (_thread != null && _thread.IsAlive) return;
@@ -41,6 +54,7 @@ namespace StandardScene.Signal.Plc
             Diagnosis.Log($"{Runtime.Config.JgName} Worker 已启动 → {Runtime.Config.Ip}:{Runtime.Config.Port}", "PLC", true);
         }
 
+        /// <summary>取消循环、最多等 2s、关闭 S7 连接并标断线。</summary>
         public void Stop()
         {
             try { _cts?.Cancel(); }
@@ -80,6 +94,7 @@ namespace StandardScene.Signal.Plc
             }
         }
 
+        /// <summary>单拍 PLC 交互。心跳地址为空则跳过心跳；读写地址为空则跳过对应步骤。</summary>
         internal void Tick()
         {
             var cfg = Runtime.Config;
@@ -145,6 +160,7 @@ namespace StandardScene.Signal.Plc
             LogFail($"{Runtime.Config.JgName} {reason}");
         }
 
+        /// <summary>同一机构失败日志最少间隔 5 秒。</summary>
         private void LogFail(string msg)
         {
             if ((DateTime.Now - _lastFailLog).TotalSeconds < 5) return;