新增1.0和2.0两种协议车型车型

2026-07-17 13:36:01 +08:00
parent a0dc1e6cd0
commit a28bc68e23
62 changed files with 12638 additions and 203 deletions
@@ -0,0 +1,149 @@
+using SimpleCore.PropType;
+using StandardScene.Magnetic.Protocol;
+using System;
+using System.Collections.Generic;
+
+namespace StandardScene.Magnetic.Tasking
+{
+    public enum Fass2TaskPhase
+    {
+        Idle,
+        Planning,
+        Dispatching,
+        Moving,
+        AtStation,
+        SegmentDone,
+        Complete,
+        Fault,
+        Cancelled
+    }
+
+    /// <summary>
+    /// 一次 FASS 2.0 任务执行上下文，供状态机推进与重启恢复使用。
+    /// </summary>
+    public sealed class Fass2TaskContext
+    {
+        public Fass2TaskPhase Phase { get; set; } = Fass2TaskPhase.Idle;
+        public int StartSiteId { get; set; }
+        public int GoalSiteId { get; set; }
+        public int CurrentIndex { get; set; }
+        public ulong TaskId { get; set; }
+        public Fass2TaskPlan Plan { get; set; }
+        public string FieldsSignature { get; set; } = string.Empty;
+        public double DefaultSpeed { get; set; } = -1;
+        public string FaultReason { get; set; }
+        public DateTime StartedAt { get; set; }
+        public DateTime LastDispatchAt { get; set; } = DateTime.MinValue;
+        public ulong LastActionId { get; set; }
+        public DateTime LastActionSentAt { get; set; } = DateTime.MinValue;
+    }
+
+    public static class Fass2TaskPersistence
+    {
+        public const string TagPhase = "Fass2Task_Phase";
+        public const string TagStartSite = "Fass2Task_StartSite";
+        public const string TagGoalSite = "Fass2Task_GoalSite";
+        public const string TagCurrentIndex = "Fass2Task_CurrentIndex";
+        public const string TagTaskId = "Fass2Task_TaskId";
+        public const string TagFieldsSignature = "Fass2Task_FieldsSig";
+        public const string TagDefaultSpeed = "Fass2Task_DefaultSpeed";
+
+        public static void Save(TagSet tags, Fass2TaskContext context)
+        {
+            if (tags == null || context == null)
+            {
+                return;
+            }
+
+            SetTag(tags, TagPhase, context.Phase.ToString());
+            SetTag(tags, TagStartSite, context.StartSiteId.ToString());
+            SetTag(tags, TagGoalSite, context.GoalSiteId.ToString());
+            SetTag(tags, TagCurrentIndex, context.CurrentIndex.ToString());
+            SetTag(tags, TagTaskId, context.TaskId.ToString());
+            SetTag(tags, TagFieldsSignature, context.FieldsSignature ?? string.Empty);
+            SetTag(tags, TagDefaultSpeed, context.DefaultSpeed.ToString(System.Globalization.CultureInfo.InvariantCulture));
+        }
+
+        public static bool TryLoad(TagSet tags, out Fass2TaskContext context)
+        {
+            context = null;
+            if (tags == null || !tags.TryGetValue(TagPhase, out var phaseText) ||
+                !Enum.TryParse(phaseText, out Fass2TaskPhase phase))
+            {
+                return false;
+            }
+
+            if (phase is Fass2TaskPhase.Idle or Fass2TaskPhase.Complete or Fass2TaskPhase.Cancelled)
+            {
+                return false;
+            }
+
+            if (!TryReadInt(tags, TagStartSite, out var startSite) ||
+                !TryReadInt(tags, TagGoalSite, out var goalSite) ||
+                !TryReadInt(tags, TagCurrentIndex, out var currentIndex))
+            {
+                return false;
+            }
+
+            tags.TryGetValue(TagFieldsSignature, out var fieldsSignature);
+            ulong.TryParse(tags.TryGetValue(TagTaskId, out var taskIdText) ? taskIdText : "0", out var taskId);
+            double.TryParse(
+                tags.TryGetValue(TagDefaultSpeed, out var speedText) ? speedText : "-1",
+                System.Globalization.NumberStyles.Float,
+                System.Globalization.CultureInfo.InvariantCulture,
+                out var defaultSpeed);
+
+            context = new Fass2TaskContext
+            {
+                Phase = phase,
+                StartSiteId = startSite,
+                GoalSiteId = goalSite,
+                CurrentIndex = currentIndex,
+                TaskId = taskId,
+                FieldsSignature = fieldsSignature ?? string.Empty,
+                DefaultSpeed = defaultSpeed
+            };
+            return true;
+        }
+
+        public static void Clear(TagSet tags)
+        {
+            if (tags == null)
+            {
+                return;
+            }
+
+            RemoveTag(tags, TagPhase);
+            RemoveTag(tags, TagStartSite);
+            RemoveTag(tags, TagGoalSite);
+            RemoveTag(tags, TagCurrentIndex);
+            RemoveTag(tags, TagTaskId);
+            RemoveTag(tags, TagFieldsSignature);
+            RemoveTag(tags, TagDefaultSpeed);
+        }
+
+        private static void SetTag(TagSet tags, string key, string value)
+        {
+            if (tags.Contains(key))
+            {
+                tags.Remove(key);
+            }
+
+            tags.Add(key, value);
+        }
+
+        private static void RemoveTag(TagSet tags, string key)
+        {
+            if (tags.Contains(key))
+            {
+                tags.Remove(key);
+            }
+        }
+
+        private static bool TryReadInt(TagSet tags, string key, out int value)
+        {
+            value = 0;
+            return tags.TryGetValue(key, out var text) && int.TryParse(text, out value);
+        }
+    }
+}