新增信号交互进程插件

StandardScene.Signal/Site/SignalSiteFields.cs

@@ -1,12 +1,19 @@
 namespace StandardScene.Signal.Site
 {
     /// <summary>
-    /// 站点 fields 键名，替代老地图 <c>SignalStop</c>。
-    /// 地图编辑器若未挂字段袋，仍可手工写入这两个键；未写则回退 handshake-points.json。
+    /// 站点 fields 键名，替代老地图 <c>SignalStop</c> 对象。
     /// </summary>
+    /// <remarks>
+    /// 地图编辑器若未挂字段袋，仍可手工在站点 fields 写入这两个键。
+    /// 扫车解析顺序：站点有非空 SignalType → 用地图点；否则回退 <c>handshake-points.json</c>。
+    /// 键名必须与迷毂/地图侧约定完全一致，改这里要同步改地图字段袋。
+    /// </remarks>
     public static class SignalSiteFields
     {
+        /// <summary>握手类型，取值同 <see cref="StandardScene.Signal.Model.HandshakePointModel.SignalType"/>。</summary>
         public const string SignalType = "SignalType";
+
+        /// <summary>握手参数，取值同 <see cref="StandardScene.Signal.Model.HandshakePointModel.SignalParams"/>。</summary>
         public const string SignalParams = "SignalParams";
     }
 }