diff --git a/.gitignore b/.gitignore
index da2c31b..29dff36 100644
--- a/.gitignore
+++ b/.gitignore
@@ -11,6 +11,8 @@ UserSettings/
 *.asmdef
 *.pdb
 *.mdb
+!Samples~/**/*.cs
+!Samples~/**/*.asmdef
 
 # OS/editor noise
 .DS_Store
diff --git a/Editor/Aisu.SIM1.Face.Editor.dll b/Editor/Aisu.SIM1.Face.Editor.dll
index 2362395..e2ef8c4 100644
Binary files a/Editor/Aisu.SIM1.Face.Editor.dll and b/Editor/Aisu.SIM1.Face.Editor.dll differ
diff --git a/Runtime/Aisu.SIM1.Face.Runtime.dll b/Runtime/Aisu.SIM1.Face.Runtime.dll
index 6374e8c..ff7671c 100644
Binary files a/Runtime/Aisu.SIM1.Face.Runtime.dll and b/Runtime/Aisu.SIM1.Face.Runtime.dll differ
diff --git a/Samples~/Face Detection Demo/Aisu.SIM1.Face.Samples.FaceDetectionDemo.asmdef b/Samples~/Face Detection Demo/Aisu.SIM1.Face.Samples.FaceDetectionDemo.asmdef
new file mode 100644
index 0000000..7786c90
--- /dev/null
+++ b/Samples~/Face Detection Demo/Aisu.SIM1.Face.Samples.FaceDetectionDemo.asmdef	
@@ -0,0 +1,16 @@
+{
+  "name": "Aisu.SIM1.Face.Samples.FaceDetectionDemo",
+  "rootNamespace": "Aisu.SIM1.Face.Samples.FaceDetectionDemo",
+  "references": [
+    "Aisu.SIM1.Face.Runtime"
+  ],
+  "includePlatforms": [],
+  "excludePlatforms": [],
+  "allowUnsafeCode": false,
+  "overrideReferences": false,
+  "precompiledReferences": [],
+  "autoReferenced": true,
+  "defineConstraints": [],
+  "versionDefines": [],
+  "noEngineReferences": false
+}
diff --git a/Samples~/Face Detection Demo/Scripts/FaceDetectionDemoBootstrap.cs b/Samples~/Face Detection Demo/Scripts/FaceDetectionDemoBootstrap.cs
new file mode 100644
index 0000000..af1ee47
--- /dev/null
+++ b/Samples~/Face Detection Demo/Scripts/FaceDetectionDemoBootstrap.cs	
@@ -0,0 +1,382 @@
+using Aisu.SIM1.Face.Core;
+using UnityEngine;
+using UnityEngine.EventSystems;
+using UnityEngine.UI;
+
+namespace Aisu.SIM1.Face.Samples.FaceDetectionDemo
+{
+    /// <summary>
+    /// 人脸检测 Demo 场景 UI 动态构建器。
+    /// </summary>
+    public sealed class FaceDetectionDemoBootstrap : MonoBehaviour
+    {
+        private Font m_font; // UI 字体。
+
+        private void Awake()
+        {
+            Build();
+        }
+
+        /// <summary>
+        /// 构建 MVP 测试页面。
+        /// </summary>
+        public void Build()
+        {
+            m_font = Resources.GetBuiltinResource<Font>("Arial.ttf");
+            EnsureEventSystem();
+
+            var manager = FindObjectOfType<FaceModuleManager>() ?? new GameObject("FaceModuleManager").AddComponent<FaceModuleManager>();
+            var camera = gameObject.AddComponent<FaceDetectionDemoCamera>();
+            var logger = gameObject.AddComponent<FaceDetectionDemoLogger>();
+            var userList = gameObject.AddComponent<FaceDetectionDemoUserList>();
+            var controller = gameObject.AddComponent<FaceDetectionDemoController>();
+
+            var canvasGo = Create("FaceDetectionDemoCanvas", transform);
+            var canvas = canvasGo.AddComponent<Canvas>();
+            canvas.renderMode = RenderMode.ScreenSpaceOverlay;
+            canvasGo.AddComponent<GraphicRaycaster>();
+            var scaler = canvasGo.AddComponent<CanvasScaler>();
+            scaler.uiScaleMode = CanvasScaler.ScaleMode.ScaleWithScreenSize;
+            scaler.referenceResolution = new Vector2(1280, 720);
+
+            var root = Create("Root", canvasGo.transform);
+            Stretch(root.GetComponent<RectTransform>());
+            var rootLayout = root.AddComponent<VerticalLayoutGroup>();
+            rootLayout.padding = new RectOffset(16, 16, 16, 16);
+            rootLayout.spacing = 10;
+            rootLayout.childControlWidth = true;
+            rootLayout.childForceExpandWidth = true;
+
+            var title = Text(root.transform, "SI-M1 Face Detection Demo", 28, TextAnchor.MiddleLeft);
+            title.color = new Color(0.05f, 0.07f, 0.1f);
+
+            var statusText = Text(root.transform, "摄像头未打开 | 模组未连接", 20, TextAnchor.MiddleLeft);
+            statusText.color = new Color(0.12f, 0.18f, 0.24f);
+
+            var body = Create("Body", root.transform);
+            body.AddComponent<LayoutElement>().flexibleHeight = 1f;
+            var bodyLayout = body.AddComponent<HorizontalLayoutGroup>();
+            bodyLayout.spacing = 12;
+            bodyLayout.childControlHeight = true;
+            bodyLayout.childForceExpandHeight = true;
+
+            var left = Panel(body.transform, "LeftPanel", new Color(0.95f, 0.97f, 1f));
+            left.AddComponent<LayoutElement>().flexibleWidth = 1f;
+            var leftLayout = left.AddComponent<VerticalLayoutGroup>();
+            leftLayout.padding = new RectOffset(10, 10, 10, 10);
+            leftLayout.spacing = 8;
+            leftLayout.childControlWidth = true;
+            leftLayout.childForceExpandWidth = true;
+
+            var right = Panel(body.transform, "RightPanel", new Color(0.98f, 0.98f, 0.96f));
+            right.AddComponent<LayoutElement>().preferredWidth = 430;
+            var rightLayout = right.AddComponent<VerticalLayoutGroup>();
+            rightLayout.padding = new RectOffset(10, 10, 10, 10);
+            rightLayout.spacing = 8;
+            rightLayout.childControlWidth = true;
+            rightLayout.childForceExpandWidth = true;
+
+            var cameraDropdown = Dropdown(left.transform, "未发现摄像头");
+            var cameraRow = Row(left.transform);
+            var refreshCameraButton = Button(cameraRow.transform, "刷新摄像头");
+            var openCameraButton = Button(cameraRow.transform, "打开摄像头");
+            var closeCameraButton = Button(cameraRow.transform, "关闭摄像头");
+
+            var previewFrame = Panel(left.transform, "CameraPreview", Color.black);
+            previewFrame.AddComponent<LayoutElement>().flexibleHeight = 1f;
+            var preview = Create("Preview", previewFrame.transform).AddComponent<RawImage>();
+            preview.color = Color.white;
+            var previewRect = preview.GetComponent<RectTransform>();
+            previewRect.anchorMin = Vector2.zero;
+            previewRect.anchorMax = Vector2.one;
+            previewRect.offsetMin = Vector2.zero;
+            previewRect.offsetMax = Vector2.zero;
+            var aspect = preview.gameObject.AddComponent<AspectRatioFitter>();
+            aspect.aspectMode = AspectRatioFitter.AspectMode.FitInParent;
+
+            Text(right.transform, "串口 / 模组", 22, TextAnchor.MiddleLeft);
+            var serialDropdown = Dropdown(right.transform, "手动输入串口");
+            var serialInput = Input(right.transform, "串口名，例如 COM3 或 /dev/ttyUSB0");
+            var baudInput = Input(right.transform, "115200");
+            var serialRow = Row(right.transform);
+            var refreshSerialButton = Button(serialRow.transform, "刷新串口");
+            var connectButton = Button(serialRow.transform, "连接模组");
+            var disconnectButton = Button(serialRow.transform, "断开模组");
+
+            Text(right.transform, "人脸操作", 22, TextAnchor.MiddleLeft);
+            var userNameInput = Input(right.transform, "User");
+            var adminToggle = Toggle(right.transform, "管理员", false);
+            var faceRow = Row(right.transform);
+            var enrollButton = Button(faceRow.transform, "录入人脸");
+            var verifyButton = Button(faceRow.transform, "检测人脸");
+
+            var resultText = Text(right.transform, "结果: -", 20, TextAnchor.UpperLeft);
+            resultText.gameObject.AddComponent<LayoutElement>().preferredHeight = 58;
+
+            Text(right.transform, "人脸数据", 22, TextAnchor.MiddleLeft);
+            var userButtonRow = Row(right.transform);
+            var refreshUsersButton = Button(userButtonRow.transform, "刷新用户列表");
+            var userScroll = ScrollView(right.transform, out var userContent);
+            userScroll.GetComponent<LayoutElement>().preferredHeight = 170;
+
+            Text(root.transform, "操作日志", 22, TextAnchor.MiddleLeft);
+            var logRow = Row(root.transform);
+            var clearLogButton = Button(logRow.transform, "清空日志");
+            var logScroll = ScrollView(root.transform, out var logContent);
+            logScroll.GetComponent<LayoutElement>().preferredHeight = 150;
+            var logText = Text(logContent, string.Empty, 18, TextAnchor.UpperLeft);
+            logText.font = m_font;
+            logText.color = Color.white;
+            logText.horizontalOverflow = HorizontalWrapMode.Wrap;
+            logText.verticalOverflow = VerticalWrapMode.Overflow;
+            logText.gameObject.AddComponent<LayoutElement>().flexibleWidth = 1f;
+            logContent.gameObject.GetComponent<Image>().color = new Color(0.07f, 0.08f, 0.09f);
+
+            camera.Bind(preview, aspect, logger);
+            logger.Bind(logText, logScroll);
+            userList.Bind(userContent, m_font, controller.DeleteUser);
+            controller.Bind(manager, camera, logger, userList, cameraDropdown, serialDropdown, serialInput, baudInput, userNameInput, adminToggle, statusText, resultText);
+
+            refreshCameraButton.onClick.AddListener(controller.RefreshCameras);
+            openCameraButton.onClick.AddListener(controller.OpenCamera);
+            closeCameraButton.onClick.AddListener(controller.CloseCamera);
+            refreshSerialButton.onClick.AddListener(controller.RefreshSerialPorts);
+            connectButton.onClick.AddListener(controller.ConnectModule);
+            disconnectButton.onClick.AddListener(controller.DisconnectModule);
+            enrollButton.onClick.AddListener(controller.EnrollFace);
+            verifyButton.onClick.AddListener(controller.VerifyFace);
+            refreshUsersButton.onClick.AddListener(controller.RefreshUsers);
+            clearLogButton.onClick.AddListener(logger.Clear);
+        }
+
+        private static void EnsureEventSystem()
+        {
+            if (FindObjectOfType<EventSystem>() != null)
+            {
+                return;
+            }
+
+            var eventSystem = new GameObject("EventSystem");
+            eventSystem.AddComponent<EventSystem>();
+            eventSystem.AddComponent<StandaloneInputModule>();
+        }
+
+        private GameObject Panel(Transform parent, string name, Color color)
+        {
+            var go = Create(name, parent);
+            go.AddComponent<Image>().color = color;
+            return go;
+        }
+
+        private GameObject Row(Transform parent)
+        {
+            var row = Create("Row", parent);
+            var layout = row.AddComponent<HorizontalLayoutGroup>();
+            layout.spacing = 8;
+            layout.childControlWidth = true;
+            layout.childForceExpandWidth = true;
+            row.AddComponent<LayoutElement>().preferredHeight = 44;
+            return row;
+        }
+
+        private Button Button(Transform parent, string text)
+        {
+            var go = Create(text, parent);
+            go.AddComponent<Image>().color = new Color(0.78f, 0.86f, 0.95f);
+            var button = go.AddComponent<Button>();
+            go.AddComponent<LayoutElement>().preferredHeight = 42;
+            var label = Text(go.transform, text, 20, TextAnchor.MiddleCenter);
+            Stretch(label.GetComponent<RectTransform>());
+            return button;
+        }
+
+        private InputField Input(Transform parent, string placeholder)
+        {
+            var go = Create("InputField", parent);
+            go.AddComponent<Image>().color = Color.white;
+            go.AddComponent<LayoutElement>().preferredHeight = 42;
+            var input = go.AddComponent<InputField>();
+
+            var text = Text(go.transform, string.Empty, 20, TextAnchor.MiddleLeft);
+            var textRect = text.GetComponent<RectTransform>();
+            Stretch(textRect);
+            textRect.offsetMin = new Vector2(10, 0);
+            textRect.offsetMax = new Vector2(-10, 0);
+            input.textComponent = text;
+
+            var placeholderText = Text(go.transform, placeholder, 20, TextAnchor.MiddleLeft);
+            placeholderText.color = new Color(0.45f, 0.48f, 0.52f);
+            var placeholderRect = placeholderText.GetComponent<RectTransform>();
+            Stretch(placeholderRect);
+            placeholderRect.offsetMin = new Vector2(10, 0);
+            placeholderRect.offsetMax = new Vector2(-10, 0);
+            input.placeholder = placeholderText;
+            return input;
+        }
+
+        private Toggle Toggle(Transform parent, string label, bool value)
+        {
+            var row = Row(parent);
+            row.GetComponent<HorizontalLayoutGroup>().childForceExpandWidth = false;
+            var toggleGo = Create("Toggle", row.transform);
+            toggleGo.AddComponent<LayoutElement>().preferredWidth = 34;
+            var toggle = toggleGo.AddComponent<Toggle>();
+            var background = Create("Background", toggleGo.transform).AddComponent<Image>();
+            background.color = Color.white;
+            Stretch(background.GetComponent<RectTransform>());
+            var checkmark = Create("Checkmark", background.transform).AddComponent<Image>();
+            checkmark.color = new Color(0.18f, 0.45f, 0.85f);
+            var checkRect = checkmark.GetComponent<RectTransform>();
+            checkRect.anchorMin = new Vector2(0.2f, 0.2f);
+            checkRect.anchorMax = new Vector2(0.8f, 0.8f);
+            checkRect.offsetMin = Vector2.zero;
+            checkRect.offsetMax = Vector2.zero;
+            toggle.targetGraphic = background;
+            toggle.graphic = checkmark;
+            toggle.isOn = value;
+            Text(row.transform, label, 20, TextAnchor.MiddleLeft).gameObject.AddComponent<LayoutElement>().flexibleWidth = 1f;
+            return toggle;
+        }
+
+        private Dropdown Dropdown(Transform parent, string initial)
+        {
+            var go = Create("Dropdown", parent);
+            var image = go.AddComponent<Image>();
+            image.color = Color.white;
+            go.AddComponent<LayoutElement>().preferredHeight = 42;
+            var dropdown = go.AddComponent<Dropdown>();
+            dropdown.targetGraphic = image;
+            var label = Text(go.transform, initial, 20, TextAnchor.MiddleLeft);
+            var labelRect = label.GetComponent<RectTransform>();
+            Stretch(labelRect);
+            labelRect.offsetMin = new Vector2(10, 0);
+            labelRect.offsetMax = new Vector2(-30, 0);
+            var arrow = Text(go.transform, "v", 18, TextAnchor.MiddleCenter);
+            var arrowRect = arrow.GetComponent<RectTransform>();
+            arrowRect.anchorMin = new Vector2(1f, 0f);
+            arrowRect.anchorMax = Vector2.one;
+            arrowRect.pivot = new Vector2(1f, 0.5f);
+            arrowRect.sizeDelta = new Vector2(30, 0);
+            arrowRect.anchoredPosition = Vector2.zero;
+            dropdown.template = CreateDropdownTemplate(go.transform, out var itemText);
+            dropdown.captionText = label;
+            dropdown.itemText = itemText;
+            dropdown.options.Add(new Dropdown.OptionData(initial));
+            dropdown.value = 0;
+            return dropdown;
+        }
+
+        private RectTransform CreateDropdownTemplate(Transform parent, out Text itemText)
+        {
+            var template = Panel(parent, "Template", Color.white);
+            template.SetActive(false);
+            var templateRect = template.GetComponent<RectTransform>();
+            templateRect.anchorMin = new Vector2(0f, 0f);
+            templateRect.anchorMax = new Vector2(1f, 0f);
+            templateRect.pivot = new Vector2(0.5f, 1f);
+            templateRect.sizeDelta = new Vector2(0f, 180f);
+            templateRect.anchoredPosition = new Vector2(0f, 2f);
+            var scrollRect = template.AddComponent<ScrollRect>();
+            scrollRect.horizontal = false;
+
+            var viewport = Panel(template.transform, "Viewport", new Color(1f, 1f, 1f, 0.98f));
+            viewport.AddComponent<Mask>().showMaskGraphic = false;
+            Stretch(viewport.GetComponent<RectTransform>());
+
+            var contentGo = Create("Content", viewport.transform);
+            var contentRect = contentGo.GetComponent<RectTransform>();
+            contentRect.anchorMin = new Vector2(0f, 1f);
+            contentRect.anchorMax = Vector2.one;
+            contentRect.pivot = new Vector2(0.5f, 1f);
+            contentRect.offsetMin = Vector2.zero;
+            contentRect.offsetMax = Vector2.zero;
+            contentGo.AddComponent<VerticalLayoutGroup>().childForceExpandWidth = true;
+            contentGo.AddComponent<ContentSizeFitter>().verticalFit = ContentSizeFitter.FitMode.PreferredSize;
+
+            var itemGo = Create("Item", contentGo.transform);
+            var itemToggle = itemGo.AddComponent<Toggle>();
+            itemGo.AddComponent<LayoutElement>().preferredHeight = 36;
+            var itemBackground = itemGo.AddComponent<Image>();
+            itemBackground.color = Color.white;
+            itemToggle.targetGraphic = itemBackground;
+
+            var checkmark = Text(itemGo.transform, "✓", 18, TextAnchor.MiddleCenter);
+            var checkRect = checkmark.GetComponent<RectTransform>();
+            checkRect.anchorMin = new Vector2(0f, 0f);
+            checkRect.anchorMax = new Vector2(0f, 1f);
+            checkRect.pivot = new Vector2(0f, 0.5f);
+            checkRect.sizeDelta = new Vector2(28f, 0f);
+            checkRect.anchoredPosition = Vector2.zero;
+            itemToggle.graphic = checkmark;
+
+            var itemLabel = Text(itemGo.transform, "Option", 18, TextAnchor.MiddleLeft);
+            var itemLabelRect = itemLabel.GetComponent<RectTransform>();
+            Stretch(itemLabelRect);
+            itemLabelRect.offsetMin = new Vector2(32f, 0f);
+            itemLabelRect.offsetMax = new Vector2(-8f, 0f);
+
+            scrollRect.viewport = viewport.GetComponent<RectTransform>();
+            scrollRect.content = contentRect;
+            itemText = itemLabel;
+            return templateRect;
+        }
+
+        private ScrollRect ScrollView(Transform parent, out Transform content)
+        {
+            var root = Panel(parent, "ScrollView", new Color(0.12f, 0.13f, 0.15f));
+            var scrollRect = root.AddComponent<ScrollRect>();
+            scrollRect.horizontal = false;
+            root.AddComponent<LayoutElement>().preferredHeight = 160;
+
+            var viewport = Panel(root.transform, "Viewport", new Color(0.12f, 0.13f, 0.15f));
+            viewport.AddComponent<Mask>().showMaskGraphic = false;
+            Stretch(viewport.GetComponent<RectTransform>());
+
+            var contentGo = Panel(viewport.transform, "Content", new Color(0.12f, 0.13f, 0.15f));
+            content = contentGo.transform;
+            var contentRect = contentGo.GetComponent<RectTransform>();
+            contentRect.anchorMin = new Vector2(0, 1);
+            contentRect.anchorMax = new Vector2(1, 1);
+            contentRect.pivot = new Vector2(0.5f, 1f);
+            contentRect.offsetMin = new Vector2(8, 0);
+            contentRect.offsetMax = new Vector2(-8, 0);
+            contentGo.AddComponent<VerticalLayoutGroup>().spacing = 6;
+            contentGo.AddComponent<ContentSizeFitter>().verticalFit = ContentSizeFitter.FitMode.PreferredSize;
+
+            scrollRect.viewport = viewport.GetComponent<RectTransform>();
+            scrollRect.content = contentRect;
+            return scrollRect;
+        }
+
+        private Text Text(Transform parent, string value, int size, TextAnchor alignment)
+        {
+            var go = Create("Text", parent);
+            var text = go.AddComponent<Text>();
+            text.font = m_font;
+            text.fontSize = size;
+            text.color = Color.black;
+            text.alignment = alignment;
+            text.text = value;
+            text.horizontalOverflow = HorizontalWrapMode.Wrap;
+            text.verticalOverflow = VerticalWrapMode.Overflow;
+            return text;
+        }
+
+        private static GameObject Create(string name, Transform parent)
+        {
+            var go = new GameObject(name, typeof(RectTransform));
+            go.transform.SetParent(parent, false);
+            return go;
+        }
+
+        private static void Stretch(RectTransform rect)
+        {
+            rect.anchorMin = Vector2.zero;
+            rect.anchorMax = Vector2.one;
+            rect.offsetMin = Vector2.zero;
+            rect.offsetMax = Vector2.zero;
+        }
+    }
+}
+
+
diff --git a/Samples~/Face Detection Demo/Scripts/FaceDetectionDemoCamera.cs b/Samples~/Face Detection Demo/Scripts/FaceDetectionDemoCamera.cs
new file mode 100644
index 0000000..90a2042
--- /dev/null
+++ b/Samples~/Face Detection Demo/Scripts/FaceDetectionDemoCamera.cs	
@@ -0,0 +1,200 @@
+using System.Collections;
+using System.Collections.Generic;
+using System;
+using UnityEngine;
+using UnityEngine.UI;
+
+#if UNITY_ANDROID
+using UnityEngine.Android;
+#endif
+
+namespace Aisu.SIM1.Face.Samples.FaceDetectionDemo
+{
+    /// <summary>
+    /// MVP 摄像头预览，使用 WebCamTexture。
+    /// </summary>
+    public sealed class FaceDetectionDemoCamera : MonoBehaviour
+    {
+        [SerializeField] private RawImage m_preview;                 // 预览图。
+        [SerializeField] private AspectRatioFitter m_aspectFitter;   // 宽高比适配。
+
+        private WebCamTexture m_texture;                             // 当前摄像头纹理。
+        private FaceDetectionDemoLogger m_logger;                   // 日志。
+        private WebCamDevice[] m_devices;                            // 当前摄像头设备列表。
+
+        public bool IsOpen => m_texture != null && m_texture.isPlaying;
+
+        /// <summary>
+        /// 绑定 UI 和日志。
+        /// </summary>
+        public void Bind(RawImage preview, AspectRatioFitter aspectFitter, FaceDetectionDemoLogger logger)
+        {
+            m_preview = preview;
+            m_aspectFitter = aspectFitter;
+            m_logger = logger;
+        }
+
+        /// <summary>
+        /// 枚举摄像头名称。
+        /// </summary>
+        public string[] GetDeviceNames()
+        {
+            m_devices = WebCamTexture.devices;
+            var names = new List<string>();
+            for (var i = 0; i < m_devices.Length; i++)
+            {
+                names.Add(i + ": " + m_devices[i].name);
+                m_logger?.Info("摄像头[" + i + "] " + m_devices[i].name + "，前置=" + m_devices[i].isFrontFacing + "，自动对焦=" + m_devices[i].isAutoFocusPointSupported);
+            }
+
+            return names.ToArray();
+        }
+
+        /// <summary>
+        /// 请求权限后枚举摄像头。
+        /// </summary>
+        public void GetDeviceNamesWhenAuthorized(Action<string[]> callback)
+        {
+            StartCoroutine(GetDeviceNamesWhenAuthorizedRoutine(callback));
+        }
+
+        /// <summary>
+        /// 打开摄像头。
+        /// </summary>
+        public void Open(int deviceIndex)
+        {
+            Close();
+            if (m_devices == null || m_devices.Length == 0)
+            {
+                m_logger?.Error("没有可用摄像头");
+                return;
+            }
+
+            if (deviceIndex < 0 || deviceIndex >= m_devices.Length)
+            {
+                m_logger?.Error("摄像头索引无效: " + deviceIndex);
+                return;
+            }
+
+            StartCoroutine(OpenWhenAuthorized(deviceIndex));
+        }
+
+        private IEnumerator OpenWhenAuthorized(int deviceIndex)
+        {
+            yield return EnsureCameraAuthorization();
+            if (!HasCameraAuthorization())
+            {
+                m_logger?.Error("摄像头权限未授权");
+                yield break;
+            }
+
+            var deviceName = m_devices[deviceIndex].name;
+            m_texture = new WebCamTexture(deviceName, 1280, 720, 30);
+            m_texture.Play();
+            if (m_preview != null)
+            {
+                m_preview.texture = m_texture;
+            }
+
+            m_logger?.Info("摄像头已打开: " + deviceName);
+        }
+
+        private IEnumerator GetDeviceNamesWhenAuthorizedRoutine(Action<string[]> callback)
+        {
+            Close();
+            yield return EnsureCameraAuthorization();
+            if (!HasCameraAuthorization())
+            {
+                m_logger?.Error("摄像头权限未授权，无法枚举摄像头");
+                callback?.Invoke(new string[0]);
+                yield break;
+            }
+
+            string[] names = null;
+            for (var i = 0; i < 5; i++)
+            {
+                names = GetDeviceNames();
+                if (names.Length > 0)
+                {
+                    break;
+                }
+
+                yield return new WaitForSeconds(0.3f);
+            }
+
+            callback?.Invoke(names ?? new string[0]);
+        }
+
+        private IEnumerator EnsureCameraAuthorization()
+        {
+#if UNITY_ANDROID && !UNITY_EDITOR
+            if (!Permission.HasUserAuthorizedPermission(Permission.Camera))
+            {
+                m_logger?.Info("正在请求摄像头权限");
+                Permission.RequestUserPermission(Permission.Camera);
+                var timeout = 10f;
+                while (!Permission.HasUserAuthorizedPermission(Permission.Camera) && timeout > 0f)
+                {
+                    timeout -= Time.deltaTime;
+                    yield return null;
+                }
+            }
+#else
+            yield return null;
+#endif
+        }
+
+        private static bool HasCameraAuthorization()
+        {
+#if UNITY_ANDROID && !UNITY_EDITOR
+            return Permission.HasUserAuthorizedPermission(Permission.Camera);
+#else
+            return true;
+#endif
+        }
+
+        /// <summary>
+        /// 关闭摄像头。
+        /// </summary>
+        public void Close()
+        {
+            if (m_texture != null)
+            {
+                if (m_texture.isPlaying)
+                {
+                    m_texture.Stop();
+                }
+
+                Destroy(m_texture);
+                m_texture = null;
+            }
+
+            if (m_preview != null)
+            {
+                m_preview.texture = null;
+            }
+        }
+
+        private void Update()
+        {
+            if (m_texture == null || m_aspectFitter == null || m_texture.width <= 16 || m_texture.height <= 16)
+            {
+                return;
+            }
+
+            m_aspectFitter.aspectRatio = (float)m_texture.width / m_texture.height;
+            if (m_preview != null)
+            {
+                m_preview.rectTransform.localEulerAngles = new Vector3(0f, 0f, -m_texture.videoRotationAngle);
+                m_preview.uvRect = m_texture.videoVerticallyMirrored ? new Rect(0f, 1f, 1f, -1f) : new Rect(0f, 0f, 1f, 1f);
+            }
+        }
+
+        private void OnDestroy()
+        {
+            Close();
+        }
+    }
+}
+
+
diff --git a/Samples~/Face Detection Demo/Scripts/FaceDetectionDemoController.cs b/Samples~/Face Detection Demo/Scripts/FaceDetectionDemoController.cs
new file mode 100644
index 0000000..e021961
--- /dev/null
+++ b/Samples~/Face Detection Demo/Scripts/FaceDetectionDemoController.cs	
@@ -0,0 +1,546 @@
+using System;
+using System.Collections.Generic;
+using System.IO.Ports;
+using System.Threading.Tasks;
+using Aisu.SIM1.Face.Core;
+using Aisu.SIM1.Face.Models;
+using Aisu.SIM1.Face.Protocol;
+using UnityEngine;
+using UnityEngine.UI;
+
+namespace Aisu.SIM1.Face.Samples.FaceDetectionDemo
+{
+    /// <summary>
+    /// 人脸检测 Demo 主流程控制器。
+    /// </summary>
+    public sealed class FaceDetectionDemoController : MonoBehaviour
+    {
+        [SerializeField] private Dropdown m_cameraDropdown;                // 摄像头下拉框。
+        [SerializeField] private Dropdown m_serialDropdown;                // 串口下拉框。
+        [SerializeField] private InputField m_serialInput;                 // 串口输入兜底。
+        [SerializeField] private InputField m_baudRateInput;               // 波特率输入。
+        [SerializeField] private InputField m_userNameInput;               // 用户名输入。
+        [SerializeField] private Toggle m_adminToggle;                     // 管理员开关。
+        [SerializeField] private Text m_statusText;                        // 状态文本。
+        [SerializeField] private Text m_resultText;                        // 结果文本。
+
+        private FaceModuleManager m_manager;                               // SDK Manager。
+        private FaceDetectionDemoCamera m_camera;                           // 摄像头预览。
+        private FaceDetectionDemoLogger m_logger;                           // 日志。
+        private FaceDetectionDemoUserList m_userList;                       // 用户列表。
+
+        /// <summary>
+        /// 绑定 MVP UI。
+        /// </summary>
+        public void Bind(
+            FaceModuleManager manager,
+            FaceDetectionDemoCamera camera,
+            FaceDetectionDemoLogger logger,
+            FaceDetectionDemoUserList userList,
+            Dropdown cameraDropdown,
+            Dropdown serialDropdown,
+            InputField serialInput,
+            InputField baudRateInput,
+            InputField userNameInput,
+            Toggle adminToggle,
+            Text statusText,
+            Text resultText)
+        {
+            m_manager = manager;
+            m_camera = camera;
+            m_logger = logger;
+            m_userList = userList;
+            m_cameraDropdown = cameraDropdown;
+            m_serialDropdown = serialDropdown;
+            m_serialInput = serialInput;
+            m_baudRateInput = baudRateInput;
+            m_userNameInput = userNameInput;
+            m_adminToggle = adminToggle;
+            m_statusText = statusText;
+            m_resultText = resultText;
+
+            if (m_manager != null)
+            {
+                m_manager.OnError += OnManagerError;
+                m_manager.OnReady += OnManagerReady;
+                m_manager.OnFaceStateUpdated += OnFaceStateUpdated;
+            }
+
+            if (m_serialDropdown != null)
+            {
+                m_serialDropdown.onValueChanged.AddListener(OnSerialDropdownChanged);
+            }
+
+            RefreshCameras();
+            RefreshSerialPorts();
+            RefreshStatus();
+        }
+
+        /// <summary>
+        /// 刷新摄像头列表。
+        /// </summary>
+        public void RefreshCameras()
+        {
+            if (m_camera == null)
+            {
+                SetDropdownOptions(m_cameraDropdown, Array.Empty<string>(), "未发现摄像头");
+                LogInfo("摄像头数量: 0");
+                return;
+            }
+
+            LogInfo("正在刷新摄像头");
+            m_camera.GetDeviceNamesWhenAuthorized(names =>
+            {
+                SetDropdownOptions(m_cameraDropdown, names, "未发现摄像头");
+                LogInfo("摄像头数量: " + names.Length);
+                if (names.Length == 0)
+                {
+                    LogInfo("Android 未枚举到摄像头时，请确认 USB 摄像头是否被系统 Camera API 识别；部分 UVC 设备需要原生插件读取");
+                }
+            });
+        }
+
+        /// <summary>
+        /// 打开摄像头。
+        /// </summary>
+        public void OpenCamera()
+        {
+            if (m_cameraDropdown == null || m_cameraDropdown.options == null || m_cameraDropdown.options.Count == 0)
+            {
+                LogError("未发现可打开的摄像头");
+                return;
+            }
+
+            var deviceName = SelectedDropdownText(m_cameraDropdown);
+            if (deviceName == "未发现摄像头")
+            {
+                LogError("未发现可打开的摄像头");
+                return;
+            }
+
+            m_camera?.Open(m_cameraDropdown.value);
+            RefreshStatus();
+        }
+
+        /// <summary>
+        /// 销毁测试页面时释放连接和事件。
+        /// </summary>
+        private void OnDestroy()
+        {
+            if (m_manager != null)
+            {
+                m_manager.OnError -= OnManagerError;
+                m_manager.OnReady -= OnManagerReady;
+                m_manager.OnFaceStateUpdated -= OnFaceStateUpdated;
+                m_manager.Close();
+            }
+
+            if (m_serialDropdown != null)
+            {
+                m_serialDropdown.onValueChanged.RemoveListener(OnSerialDropdownChanged);
+            }
+
+            m_camera?.Close();
+        }
+
+        /// <summary>
+        /// 关闭摄像头。
+        /// </summary>
+        public void CloseCamera()
+        {
+            m_camera?.Close();
+            LogInfo("摄像头已关闭");
+            RefreshStatus();
+        }
+
+        /// <summary>
+        /// 刷新串口列表。
+        /// </summary>
+        public void RefreshSerialPorts()
+        {
+            string[] ports;
+            try
+            {
+                ports = SerialPort.GetPortNames();
+            }
+            catch (Exception ex)
+            {
+                ports = Array.Empty<string>();
+                LogError("串口枚举失败: " + ex.Message);
+            }
+
+            SetDropdownOptions(m_serialDropdown, ports, "手动输入串口");
+            if (ports.Length > 0 && m_serialInput != null)
+            {
+                m_serialInput.text = ports[0];
+            }
+
+            LogInfo("串口数量: " + ports.Length);
+        }
+
+        /// <summary>
+        /// 连接模组。
+        /// </summary>
+        public void ConnectModule()
+        {
+            RunAsync(async () =>
+            {
+                if (m_manager == null)
+                {
+                    LogError("FaceModuleManager 不存在");
+                    return;
+                }
+
+                var portName = ReadPortName();
+                if (string.IsNullOrWhiteSpace(portName))
+                {
+                    LogError("未选择串口");
+                    return;
+                }
+
+                var baudRate = ReadInt(m_baudRateInput, 115200);
+                m_manager.Configure(false, portName, baudRate);
+                m_manager.Config.RawLogEnabled = false;
+                LogInfo("正在连接模组: " + portName + " @ " + baudRate);
+                m_manager.Open();
+                await WaitReadyAndProbeAsync();
+                LogInfo("模组连接成功，状态: " + m_manager.CurrentStatus);
+                RefreshStatus();
+            });
+        }
+
+        /// <summary>
+        /// 断开模组。
+        /// </summary>
+        public void DisconnectModule()
+        {
+            m_manager?.Close();
+            LogInfo("模组连接已关闭");
+            RefreshStatus();
+        }
+
+        /// <summary>
+        /// 录入人脸。
+        /// </summary>
+        public void EnrollFace()
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireReady())
+                {
+                    return;
+                }
+
+                var userName = string.IsNullOrWhiteSpace(m_userNameInput?.text) ? "User" : m_userNameInput.text.Trim();
+                await PrepareFaceOperationAsync("录入人脸");
+                LogInfo("开始录入人脸: " + userName);
+                var result = await EnrollSingleWithFallbackAsync(m_adminToggle != null && m_adminToggle.isOn, userName, 30);
+                if (result.Success)
+                {
+                    SetResult("录入成功，UserID=" + result.UserId);
+                    LogInfo("录入成功，UserID=" + result.UserId);
+                    await RefreshUsersInternal();
+                }
+                else
+                {
+                    var message = FaceProtocolEncoding.ResultMessage(result.ResultCode);
+                    SetResult("录入失败: " + message);
+                    LogError("录入失败: " + message);
+                }
+            });
+        }
+
+        /// <summary>
+        /// 检测人脸。
+        /// </summary>
+        public void VerifyFace()
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireReady())
+                {
+                    return;
+                }
+
+                await PrepareFaceOperationAsync("检测人脸");
+                LogInfo("开始检测人脸");
+                var result = await m_manager.Verify.VerifyAsync(30, 60);
+                if (result.Success)
+                {
+                    var message = $"检测成功，UserID={result.UserId}，姓名={result.UserName}，管理员={result.IsAdmin}";
+                    SetResult(message);
+                    LogInfo(message);
+                }
+                else
+                {
+                    var message = FaceProtocolEncoding.ResultMessage(result.ResultCode);
+                    SetResult("检测失败: " + message);
+                    LogError("检测失败: " + message);
+                }
+            });
+        }
+
+        /// <summary>
+        /// 刷新用户列表。
+        /// </summary>
+        public void RefreshUsers()
+        {
+            RunAsync(RefreshUsersInternal);
+        }
+
+        /// <summary>
+        /// 删除指定用户。
+        /// </summary>
+        public void DeleteUser(int userId)
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireReady())
+                {
+                    return;
+                }
+
+                await m_manager.Users.DeleteUserAsync(userId);
+                LogInfo("已删除用户: " + userId);
+                await RefreshUsersInternal();
+            });
+        }
+
+        private async Task RefreshUsersInternal()
+        {
+            if (!RequireReady())
+            {
+                return;
+            }
+
+            await EnsureModuleStandbyAsync("刷新用户列表");
+            var users = await GetAllUsersWithFallbackAsync();
+            m_userList?.SetUsers(users);
+            LogInfo("用户列表已刷新，数量: " + users.Count);
+        }
+
+        private bool RequireReady()
+        {
+            if (m_manager != null && m_manager.IsOpen && m_manager.IsReady)
+            {
+                return true;
+            }
+
+            LogError("模组未连接或未 READY");
+            RefreshStatus();
+            return false;
+        }
+
+        private void RefreshStatus()
+        {
+            if (m_statusText == null)
+            {
+                return;
+            }
+
+            var cameraStatus = m_camera != null && m_camera.IsOpen ? "摄像头已打开" : "摄像头未打开";
+            var moduleStatus = m_manager == null
+                ? "模组不存在"
+                : (m_manager.IsReady ? "模组 READY" : (m_manager.IsOpen ? "模组已连接，未 READY" : "模组未连接"));
+            m_statusText.text = cameraStatus + " | " + moduleStatus;
+        }
+
+        private void OnFaceStateUpdated(FaceFaceStateNote state)
+        {
+            SetResult("人脸状态: " + FaceProtocolEncoding.FaceStateMessage(state.State));
+        }
+
+        private void OnManagerError(FaceResultCode _, string message)
+        {
+            LogError("SDK 错误: " + message);
+        }
+
+        private void OnManagerReady()
+        {
+            LogInfo("模组 READY");
+        }
+
+        private async Task WaitReadyAndProbeAsync()
+        {
+            try
+            {
+                await m_manager.WaitReadyAsync(1500);
+            }
+            catch (TimeoutException)
+            {
+                LogInfo("未收到 READY，改用主动查询确认模组状态");
+            }
+
+            LogInfo("正在查询模组状态");
+            await m_manager.ProbeReadyByStatusAsync();
+        }
+
+        private async Task PrepareFaceOperationAsync(string operationName)
+        {
+            await EnsureModuleStandbyAsync(operationName);
+            await ResetFaceFlowIfPossibleAsync(operationName);
+        }
+
+        private async Task EnsureModuleStandbyAsync(string operationName)
+        {
+            var status = await m_manager.Basic.GetStatusAsync();
+            if (status == FaceModuleStatus.Busy)
+            {
+                LogInfo(operationName + " 前模组忙碌，正在取消当前人脸流程");
+                await ResetFaceFlowIfPossibleAsync(operationName);
+                await Task.Delay(300);
+                status = await m_manager.Basic.GetStatusAsync();
+            }
+
+            if (status == FaceModuleStatus.Busy)
+            {
+                throw new InvalidOperationException(operationName + " 前模组仍处于忙碌状态");
+            }
+
+            if (status == FaceModuleStatus.Error || status == FaceModuleStatus.Invalid)
+            {
+                throw new InvalidOperationException(operationName + " 前模组状态异常: " + status);
+            }
+        }
+
+        private async Task ResetFaceFlowIfPossibleAsync(string operationName)
+        {
+            try
+            {
+                await m_manager.Basic.FaceResetAsync();
+                LogInfo(operationName + " 前已取消残留人脸流程");
+            }
+            catch (Exception ex)
+            {
+                LogInfo(operationName + " 前取消残留流程未完成: " + ex.Message);
+            }
+        }
+
+        private async Task<FaceEnrollResult> EnrollSingleWithFallbackAsync(bool admin, string userName, byte timeout)
+        {
+            try
+            {
+                return await m_manager.Enrollment.EnrollSingleAsync(admin, userName, timeout);
+            }
+            catch (TimeoutException)
+            {
+                LogInfo("单帧录入超时，改用集成单帧录入重试");
+                await ResetFaceFlowIfPossibleAsync("录入重试");
+                return await m_manager.Enrollment.EnrollIntegratedAsync(admin, userName, FaceDirection.Middle, timeout, true, true);
+            }
+        }
+
+        private async Task<List<FaceUserInfo>> GetAllUsersWithFallbackAsync()
+        {
+            try
+            {
+                return await m_manager.Users.GetAllUserInfos2Async();
+            }
+            catch (TimeoutException)
+            {
+                LogInfo("扩展用户列表超时，改用普通用户列表查询");
+                return await m_manager.Users.GetAllUserInfosAsync();
+            }
+        }
+
+        private void OnSerialDropdownChanged(int _)
+        {
+            var selected = SelectedDropdownText(m_serialDropdown);
+            if (!string.IsNullOrWhiteSpace(selected) && selected != "手动输入串口" && m_serialInput != null)
+            {
+                m_serialInput.text = selected;
+            }
+        }
+
+        private string ReadPortName()
+        {
+            var selected = SelectedDropdownText(m_serialDropdown);
+            if (!string.IsNullOrWhiteSpace(selected) && selected != "手动输入串口")
+            {
+                return selected;
+            }
+
+            return m_serialInput != null ? m_serialInput.text.Trim() : string.Empty;
+        }
+
+        private static int ReadInt(InputField input, int fallback)
+        {
+            return input != null && int.TryParse(input.text, out var value) ? value : fallback;
+        }
+
+        private static string SelectedDropdownText(Dropdown dropdown)
+        {
+            if (dropdown == null || dropdown.options == null || dropdown.options.Count == 0)
+            {
+                return string.Empty;
+            }
+
+            return dropdown.options[Mathf.Clamp(dropdown.value, 0, dropdown.options.Count - 1)].text;
+        }
+
+        private static void SetDropdownOptions(Dropdown dropdown, IReadOnlyList<string> values, string emptyText)
+        {
+            if (dropdown == null)
+            {
+                return;
+            }
+
+            dropdown.ClearOptions();
+            var options = new List<string>();
+            if (values != null)
+            {
+                for (var i = 0; i < values.Count; i++)
+                {
+                    if (!string.IsNullOrWhiteSpace(values[i]))
+                    {
+                        options.Add(values[i]);
+                    }
+                }
+            }
+
+            if (options.Count == 0)
+            {
+                options.Add(emptyText);
+            }
+
+            dropdown.AddOptions(options);
+            dropdown.value = 0;
+            dropdown.RefreshShownValue();
+        }
+
+        private async void RunAsync(Func<Task> action)
+        {
+            try
+            {
+                await action();
+                RefreshStatus();
+            }
+            catch (Exception ex)
+            {
+                LogError(ex.Message);
+                SetResult("错误: " + ex.Message);
+                RefreshStatus();
+            }
+        }
+
+        private void SetResult(string message)
+        {
+            if (m_resultText != null)
+            {
+                m_resultText.text = message;
+            }
+        }
+
+        private void LogInfo(string message)
+        {
+            m_logger?.Info(message);
+        }
+
+        private void LogError(string message)
+        {
+            m_logger?.Error(message);
+        }
+    }
+}
+
+
diff --git a/Samples~/Face Detection Demo/Scripts/FaceDetectionDemoLogger.cs b/Samples~/Face Detection Demo/Scripts/FaceDetectionDemoLogger.cs
new file mode 100644
index 0000000..c6020c5
--- /dev/null
+++ b/Samples~/Face Detection Demo/Scripts/FaceDetectionDemoLogger.cs	
@@ -0,0 +1,79 @@
+using System;
+using System.Text;
+using UnityEngine;
+using UnityEngine.UI;
+
+namespace Aisu.SIM1.Face.Samples.FaceDetectionDemo
+{
+    /// <summary>
+    /// MVP 操作日志窗口。
+    /// </summary>
+    public sealed class FaceDetectionDemoLogger : MonoBehaviour
+    {
+        [SerializeField] private Text m_logText;             // 日志文本。
+        [SerializeField] private ScrollRect m_scrollRect;    // 日志滚动视图。
+
+        private readonly StringBuilder m_buffer = new StringBuilder(8192); // 日志缓存。
+
+        /// <summary>
+        /// 绑定 UI。
+        /// </summary>
+        public void Bind(Text logText, ScrollRect scrollRect)
+        {
+            m_logText = logText;
+            m_scrollRect = scrollRect;
+        }
+
+        /// <summary>
+        /// 写入普通日志。
+        /// </summary>
+        public void Info(string message)
+        {
+            Append("INFO", message);
+        }
+
+        /// <summary>
+        /// 写入错误日志。
+        /// </summary>
+        public void Error(string message)
+        {
+            Append("ERROR", message);
+        }
+
+        /// <summary>
+        /// 清空日志。
+        /// </summary>
+        public void Clear()
+        {
+            m_buffer.Length = 0;
+            Refresh();
+        }
+
+        private void Append(string level, string message)
+        {
+            m_buffer.Append('[')
+                .Append(DateTime.Now.ToString("HH:mm:ss"))
+                .Append("] ")
+                .Append(level)
+                .Append("  ")
+                .AppendLine(message ?? string.Empty);
+            Refresh();
+        }
+
+        private void Refresh()
+        {
+            if (m_logText != null)
+            {
+                m_logText.text = m_buffer.ToString();
+            }
+
+            if (m_scrollRect != null)
+            {
+                Canvas.ForceUpdateCanvases();
+                m_scrollRect.verticalNormalizedPosition = 0f;
+            }
+        }
+    }
+}
+
+
diff --git a/Samples~/Face Detection Demo/Scripts/FaceDetectionDemoUserList.cs b/Samples~/Face Detection Demo/Scripts/FaceDetectionDemoUserList.cs
new file mode 100644
index 0000000..4070816
--- /dev/null
+++ b/Samples~/Face Detection Demo/Scripts/FaceDetectionDemoUserList.cs	
@@ -0,0 +1,126 @@
+using System;
+using System.Collections.Generic;
+using Aisu.SIM1.Face.Models;
+using UnityEngine;
+using UnityEngine.UI;
+
+namespace Aisu.SIM1.Face.Samples.FaceDetectionDemo
+{
+    /// <summary>
+    /// MVP 用户列表窗口。
+    /// </summary>
+    public sealed class FaceDetectionDemoUserList : MonoBehaviour
+    {
+        [SerializeField] private Transform m_content;            // 列表容器。
+        [SerializeField] private Font m_font;                    // UI 字体。
+
+        private Action<int> m_deleteHandler;                     // 删除回调。
+
+        /// <summary>
+        /// 绑定 UI。
+        /// </summary>
+        public void Bind(Transform content, Font font, Action<int> deleteHandler)
+        {
+            m_content = content;
+            m_font = font;
+            m_deleteHandler = deleteHandler;
+        }
+
+        /// <summary>
+        /// 刷新用户列表。
+        /// </summary>
+        public void SetUsers(IList<FaceUserInfo> users)
+        {
+            Clear();
+            if (users == null || users.Count == 0)
+            {
+                AddText("暂无用户数据");
+                return;
+            }
+
+            for (var i = 0; i < users.Count; i++)
+            {
+                AddRow(users[i]);
+            }
+        }
+
+        /// <summary>
+        /// 清空列表。
+        /// </summary>
+        public void Clear()
+        {
+            if (m_content == null)
+            {
+                return;
+            }
+
+            for (var i = m_content.childCount - 1; i >= 0; i--)
+            {
+                Destroy(m_content.GetChild(i).gameObject);
+            }
+        }
+
+        private void AddRow(FaceUserInfo user)
+        {
+            var row = new GameObject("User_" + user.UserId, typeof(RectTransform), typeof(HorizontalLayoutGroup), typeof(Image));
+            row.transform.SetParent(m_content, false);
+            row.GetComponent<Image>().color = new Color(0.94f, 0.96f, 0.98f);
+            var layout = row.GetComponent<HorizontalLayoutGroup>();
+            layout.padding = new RectOffset(8, 8, 6, 6);
+            layout.spacing = 8;
+            layout.childControlWidth = true;
+            layout.childForceExpandWidth = false;
+            row.AddComponent<LayoutElement>().preferredHeight = 44;
+
+            AddText(row.transform, $"ID: {user.UserId}  姓名: {user.UserName}  管理员: {user.IsAdmin}", 1f);
+            AddButton(row.transform, "删除", () => m_deleteHandler?.Invoke(user.UserId));
+        }
+
+        private void AddText(string text)
+        {
+            AddText(m_content, text, 1f);
+        }
+
+        private Text AddText(Transform parent, string text, float flexibleWidth)
+        {
+            var go = new GameObject("Text", typeof(RectTransform), typeof(Text));
+            go.transform.SetParent(parent, false);
+            var label = go.GetComponent<Text>();
+            label.font = m_font;
+            label.fontSize = 22;
+            label.color = Color.black;
+            label.alignment = TextAnchor.MiddleLeft;
+            label.text = text;
+            go.AddComponent<LayoutElement>().flexibleWidth = flexibleWidth;
+            return label;
+        }
+
+        private void AddButton(Transform parent, string text, UnityEngine.Events.UnityAction action)
+        {
+            var go = new GameObject(text, typeof(RectTransform), typeof(Image), typeof(Button));
+            go.transform.SetParent(parent, false);
+            go.GetComponent<Image>().color = new Color(0.82f, 0.88f, 0.95f);
+            var button = go.GetComponent<Button>();
+            button.onClick.AddListener(action);
+            var layout = go.AddComponent<LayoutElement>();
+            layout.preferredWidth = 92;
+            layout.preferredHeight = 34;
+
+            var labelGo = new GameObject("Text", typeof(RectTransform), typeof(Text));
+            labelGo.transform.SetParent(go.transform, false);
+            var rect = labelGo.GetComponent<RectTransform>();
+            rect.anchorMin = Vector2.zero;
+            rect.anchorMax = Vector2.one;
+            rect.offsetMin = Vector2.zero;
+            rect.offsetMax = Vector2.zero;
+            var label = labelGo.GetComponent<Text>();
+            label.font = m_font;
+            label.fontSize = 20;
+            label.color = Color.black;
+            label.alignment = TextAnchor.MiddleCenter;
+            label.text = text;
+        }
+    }
+}
+
+
diff --git a/Samples~/SI-M1 Face Demo/Aisu.SIM1.Face.Samples.asmdef b/Samples~/SI-M1 Face Demo/Aisu.SIM1.Face.Samples.asmdef
new file mode 100644
index 0000000..9489ab6
--- /dev/null
+++ b/Samples~/SI-M1 Face Demo/Aisu.SIM1.Face.Samples.asmdef	
@@ -0,0 +1,16 @@
+{
+  "name": "Aisu.SIM1.Face.Samples",
+  "rootNamespace": "Aisu.SIM1.Face.Samples",
+  "references": [
+    "Aisu.SIM1.Face.Runtime"
+  ],
+  "includePlatforms": [],
+  "excludePlatforms": [],
+  "allowUnsafeCode": false,
+  "overrideReferences": false,
+  "precompiledReferences": [],
+  "autoReferenced": true,
+  "defineConstraints": [],
+  "versionDefines": [],
+  "noEngineReferences": false
+}
diff --git a/Samples~/SI-M1 Face Demo/Editor/Aisu.SIM1.Face.Samples.Editor.asmdef b/Samples~/SI-M1 Face Demo/Editor/Aisu.SIM1.Face.Samples.Editor.asmdef
new file mode 100644
index 0000000..f0766bd
--- /dev/null
+++ b/Samples~/SI-M1 Face Demo/Editor/Aisu.SIM1.Face.Samples.Editor.asmdef	
@@ -0,0 +1,19 @@
+{
+  "name": "Aisu.SIM1.Face.Samples.Editor",
+  "rootNamespace": "Aisu.SIM1.Face.Editor",
+  "references": [
+    "Aisu.SIM1.Face.Runtime",
+    "Aisu.SIM1.Face.Samples"
+  ],
+  "includePlatforms": [
+    "Editor"
+  ],
+  "excludePlatforms": [],
+  "allowUnsafeCode": false,
+  "overrideReferences": false,
+  "precompiledReferences": [],
+  "autoReferenced": true,
+  "defineConstraints": [],
+  "versionDefines": [],
+  "noEngineReferences": false
+}
diff --git a/Samples~/SI-M1 Face Demo/Editor/FaceModuleDemoSceneGenerator.cs b/Samples~/SI-M1 Face Demo/Editor/FaceModuleDemoSceneGenerator.cs
new file mode 100644
index 0000000..f3d967e
--- /dev/null
+++ b/Samples~/SI-M1 Face Demo/Editor/FaceModuleDemoSceneGenerator.cs	
@@ -0,0 +1,39 @@
+#if UNITY_EDITOR
+using System.IO;
+using Aisu.SIM1.Face.Core;
+using Aisu.SIM1.Face.UI.Common;
+using UnityEditor;
+using UnityEditor.SceneManagement;
+using UnityEngine;
+
+namespace Aisu.SIM1.Face.Editor
+{
+    /// <summary>
+    /// 生成 SI-M1 全功能 Demo 场景。
+    /// </summary>
+    public static class FaceModuleDemoSceneGenerator
+    {
+        private const string ScenePath = "Assets/SI-M1 Face Demo/Scenes/FaceModuleDemo.unity"; // Demo 场景保存路径。
+
+        /// <summary>
+        /// 创建并保存 Demo 场景。
+        /// </summary>
+        [MenuItem("AISU/SI-M1 Face SDK/Regenerate Imported Demo Scene")]
+        public static void Generate()
+        {
+            Directory.CreateDirectory(Path.GetDirectoryName(ScenePath));
+            var scene = EditorSceneManager.NewScene(NewSceneSetup.EmptyScene, NewSceneMode.Single);
+            var managerGo = new GameObject("FaceModuleManager");
+            managerGo.AddComponent<FaceModuleManager>();
+
+            var bootstrapGo = new GameObject("FaceModuleDemoBootstrap");
+            bootstrapGo.AddComponent<FaceModuleDemoBootstrap>();
+
+            EditorSceneManager.SaveScene(scene, ScenePath);
+            AssetDatabase.Refresh();
+            Selection.activeObject = bootstrapGo;
+            Debug.Log("FaceModule demo scene generated: " + ScenePath);
+        }
+    }
+}
+#endif
diff --git a/Samples~/SI-M1 Face Demo/Scripts/Core/FaceModuleKeyboardTester.cs b/Samples~/SI-M1 Face Demo/Scripts/Core/FaceModuleKeyboardTester.cs
new file mode 100644
index 0000000..a244ffa
--- /dev/null
+++ b/Samples~/SI-M1 Face Demo/Scripts/Core/FaceModuleKeyboardTester.cs	
@@ -0,0 +1,1347 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+using Aisu.SIM1.Face.Models;
+using Aisu.SIM1.Face.Protocol;
+using UnityEngine;
+
+namespace Aisu.SIM1.Face.Core
+{
+    /// <summary>
+    /// FaceModule 键盘功能测试脚本，用于不依赖 UI 面板快速验证串口与业务接口。
+    /// </summary>
+    public sealed class FaceModuleKeyboardTester : MonoBehaviour
+    {
+        [Header("Manager 引用")]
+        // 场景中的 FaceModuleManager，不填时自动查找或创建。
+        public FaceModuleManager Manager;
+
+        [Header("串口参数（A/Q/W）")]
+        // 是否使用 Mock 模组。
+        public bool UseMock;
+        // 串口名称；示例 COM3，按当前设备实际串口修改。
+        public string PortName = "COM3";
+        // 串口波特率。
+        public int BaudRate = 115200;
+        // 打开串口后等待 READY 的超时时间。
+        public int ReadyTimeoutMs = 3000;
+
+        [Header("人脸检测/验证参数（S/Z/X）")]
+        // 验证超时时间，单位秒。
+        public byte VerifyTimeout = 10;
+        // 最大识别次数。
+        public byte MaxRecognitionTimes = 30;
+        // 是否开启自动验证。
+        public bool AutoVerifyEnable = true;
+
+        [Header("注册用户参数（E/R/T/F）")]
+        // 注册用户名。
+        public string EnrollUserName = "TestUser";
+        // 注册用户是否为管理员。
+        public bool EnrollAsAdmin;
+        // 注册方向。
+        public FaceDirection EnrollDirection = FaceDirection.Middle;
+        // 注册超时时间，单位秒。
+        public byte EnrollTimeout = 20;
+        // 集成录入是否使用单帧模式。
+        public bool IntegratedSingleFrame;
+        // 集成录入是否查重。
+        public bool IntegratedDuplicateCheck = true;
+
+        [Header("用户管理参数（D/M/G/H/J）")]
+        // 查询 / 删除使用的用户 ID。
+        public int UserId = 1;
+        // 是否使用 GET_ALL_USERID2 查询所有用户。
+        public bool UseGetAllUserId2;
+
+        [Header("二维码参数（C）")]
+        // 扫码超时时间，单位秒。
+        public byte QrTimeout = 10;
+
+        [Header("图片抓拍参数（V/B/N）")]
+        // 大图 DPI。
+        public ImageDpi LargeImageDpi = ImageDpi.Dpi480x640;
+
+        [Header("照片注册参数（P/O）")]
+        // 照片或特征文件路径。
+        public string PhotoRegisterFilePath;
+        // 照片注册 BioType。
+        public BioType PhotoBioType = BioType.NormalPhoto;
+        // 照片注册用户名。
+        public string PhotoUserName = "PhotoUser";
+        // 照片注册是否查重。
+        public bool PhotoDuplicateCheck = true;
+        // 指定 ID 照片注册使用的用户 ID。
+        public int PhotoUserId = 100;
+
+        [Header("特征参数（L/K）")]
+        // 特征类型。
+        public FeatureType FeatureType = FeatureType.ColorFace;
+        // 写入特征文件路径。
+        public string FeatureFilePath;
+        // 写入特征使用的用户名。
+        public string FeatureUserName = "FeatureUser";
+
+        [Header("高级参数（1/2/3）")]
+        // RGB 识别阈值 0-4。
+        [Range(0, 4)] public byte RgbLevel = 2;
+        // 是否启用查重。
+        public bool DuplicateCheckEnable = true;
+        // Demo Mode 开关。
+        public bool DemoModeEnable;
+
+        [Header("UVC 参数（U/I/Y）")]
+        // USB Type。
+        public byte UsbType = 0x20;
+        // UVC 码率。
+        public byte UvcBitrateMbps = 8;
+        // MJPG 质量。
+        [Range(10, 100)] public byte MjpgQuality = 80;
+        // 图像镜像。
+        public bool UvcMirror;
+        // 180 度旋转。
+        public bool UvcRotate180;
+        // 人脸框显示。
+        public bool FaceLocationVisible = true;
+
+        [Header("加密参数（4/5/6）")]
+        // Release Key，16 bytes Hex，例如：00 01 02 ...
+        public string ReleaseKeyHex;
+        // Debug Key，16 bytes Hex，例如：00 01 02 ...
+        public string DebugKeyHex;
+        // Seed，4 bytes Hex。
+        public string SeedHex;
+        // 加密模式。
+        public byte EncryptionMode;
+
+        [Header("固件升级参数（7）")]
+        // 固件升级按键说明。
+        public string FirmwareKey = "7 启动固件升级";
+
+        [Header("串口指令解析（Space）")]
+        // 待解析的 TX 串口 Hex 指令，按空格键后只解析为中文说明，不会发送到串口。
+        [TextArea(2, 6)] public string TxSerialCommandHex = "EF AA 10 00 00 10";
+        // 待解析的 RX 串口 Hex 内容，可填模组返回的 REPLY / NOTE。
+        [TextArea(2, 6)] public string RxSerialCommandHex = "EF AA 01 00 01 00 00";
+        // 兼容旧字段，留空 TX / RX 时会解析这里的内容。
+        [HideInInspector] public string SerialCommandHex;
+
+        private Action m_readyHandler;                              // READY 事件回调。
+        private Action<string> m_rawLogHandler;                     // 原始日志事件回调。
+        private Action<FaceResultCode, string> m_errorHandler;      // 错误事件回调。
+        private Action<FaceFaceStateNote> m_faceStateHandler;       // 人脸状态事件回调。
+
+        [Header("按键说明")]
+        // A 打开串口，Q 关闭串口，W 等待 READY / GET STATUS 探测。
+        public string ConnectionKeys = "A 打开串口，Q 关闭串口，W 等待 READY / 主动探测";
+        // S 检测人脸，Z 自动验证，X 停止/RESET。
+        public string VerifyKeys = "S 检测人脸，Z 自动验证，X RESET";
+        // E 单帧注册，R 交互注册，T 集成注册，F 取消注册。
+        public string EnrollKeys = "E 单帧注册，R 交互注册，T 集成注册，F 取消注册";
+        // D 查询所有用户 ID，G 查询用户，H 删除用户，J 删除全部用户。
+        public string UserKeys = "D 查询所有用户 ID，M 查询所有用户信息，G 查询用户，H 删除用户，J 删除全部用户";
+        // C 扫码，V 普通抓拍，B 人脸抓拍，N 大图抓拍。
+        public string MediaKeys = "C 扫码，V 普通抓拍，B 人脸抓拍，N 大图抓拍";
+        // P 照片注册，O 指定 ID 照片注册，L 读特征，K 写特征。
+        public string AdvancedKeys = "P 照片注册，O 指定 ID 照片注册，L 读特征，K 写特征";
+        // U 读 UVC，I 设置 UVC，Y 人脸框，数字 1/2/3 分别设置 RGB/查重/Demo。
+        public string SettingKeys = "U 读 UVC，I 设置 UVC，Y 人脸框，1 RGB，2 查重，3 Demo";
+        // 数字 4/5/6/7 分别设置 Release Key、Debug Key、Init Encryption、固件升级。
+        public string SystemKeys = "4 Release Key，5 Debug Key，6 初始化加密，7 固件升级，Space 解析串口指令";
+
+        #region Unity API
+
+        /// <summary>
+        /// 初始化测试脚本。
+        /// </summary>
+        private void Awake()
+        {
+            EnsureManager();
+            BindLogs();
+        }
+
+        private void OnDestroy()
+        {
+            UnbindLogs();
+        }
+
+        /// <summary>
+        /// 每帧检测键盘输入并触发测试功能。
+        /// </summary>
+        private void Update()
+        {
+            if (Input.GetKeyDown(KeyCode.A)) OpenSerial();
+            if (Input.GetKeyDown(KeyCode.Q)) CloseSerial();
+            if (Input.GetKeyDown(KeyCode.W)) WaitReadyOrProbe();
+
+            if (Input.GetKeyDown(KeyCode.S)) VerifyFace();
+            if (Input.GetKeyDown(KeyCode.Z)) AutoVerify();
+            if (Input.GetKeyDown(KeyCode.X)) ResetModule();
+
+            if (Input.GetKeyDown(KeyCode.E)) EnrollSingle();
+            if (Input.GetKeyDown(KeyCode.R)) Enroll();
+            if (Input.GetKeyDown(KeyCode.T)) EnrollIntegrated();
+            if (Input.GetKeyDown(KeyCode.F)) FaceReset();
+
+            if (Input.GetKeyDown(KeyCode.D)) GetAllUserIds();
+            if (Input.GetKeyDown(KeyCode.M)) GetAllUserInfos();
+            if (Input.GetKeyDown(KeyCode.G)) GetUserInfo();
+            if (Input.GetKeyDown(KeyCode.H)) DeleteUser();
+            if (Input.GetKeyDown(KeyCode.J)) DeleteAllUsers();
+
+            if (Input.GetKeyDown(KeyCode.C)) ScanQrCode();
+            if (Input.GetKeyDown(KeyCode.V)) SnapImage();
+            if (Input.GetKeyDown(KeyCode.B)) SnapFaceImage();
+            if (Input.GetKeyDown(KeyCode.N)) SnapLargeImage();
+
+            if (Input.GetKeyDown(KeyCode.P)) EnrollWithPhoto();
+            if (Input.GetKeyDown(KeyCode.O)) EnrollWithPhotoAndId();
+            if (Input.GetKeyDown(KeyCode.L)) ReadFeature();
+            if (Input.GetKeyDown(KeyCode.K)) WriteFeature();
+
+            if (Input.GetKeyDown(KeyCode.U)) ReadUvc();
+            if (Input.GetKeyDown(KeyCode.I)) SetUvc();
+            if (Input.GetKeyDown(KeyCode.Y)) SetFaceLocationVisible();
+            if (Input.GetKeyDown(KeyCode.Alpha1)) SetRgbLevel();
+            if (Input.GetKeyDown(KeyCode.Alpha2)) SetDuplicateCheck();
+            if (Input.GetKeyDown(KeyCode.Alpha3)) SetDemoMode();
+            if (Input.GetKeyDown(KeyCode.Alpha4)) SetReleaseKey();
+            if (Input.GetKeyDown(KeyCode.Alpha5)) SetDebugKey();
+            if (Input.GetKeyDown(KeyCode.Alpha6)) InitEncryption();
+            if (Input.GetKeyDown(KeyCode.Alpha7)) UpgradeFirmware();
+            if (Input.GetKeyDown(KeyCode.Space)) ParseSerialCommand();
+        }
+
+        #endregion
+
+        /// <summary>
+        /// 确保 Manager 存在。
+        /// </summary>
+        private void EnsureManager()
+        {
+            if (Manager != null)
+            {
+                return;
+            }
+
+            Manager = FindObjectOfType<FaceModuleManager>();
+            if (Manager == null)
+            {
+                Manager = new GameObject("FaceModuleManager").AddComponent<FaceModuleManager>();
+            }
+        }
+
+        /// <summary>
+        /// 绑定日志事件。
+        /// </summary>
+        private void BindLogs()
+        {
+            UnbindLogs();
+            m_readyHandler = () => Log("收到 READY，模组已就绪");
+            m_rawLogHandler = message => Log("原始数据：" + message);
+            m_errorHandler = (code, message) => LogError("错误码：" + code + "，原因：" + message);
+            m_faceStateHandler = state => Log("人脸状态：" + FaceProtocolEncoding.FaceStateMessage(state.State));
+            Manager.OnReady += m_readyHandler;
+            Manager.OnRawLog += m_rawLogHandler;
+            Manager.OnError += m_errorHandler;
+            Manager.OnFaceStateUpdated += m_faceStateHandler;
+        }
+
+        private void UnbindLogs()
+        {
+            if (Manager == null)
+            {
+                return;
+            }
+
+            if (m_readyHandler != null)
+            {
+                Manager.OnReady -= m_readyHandler;
+            }
+
+            if (m_rawLogHandler != null)
+            {
+                Manager.OnRawLog -= m_rawLogHandler;
+            }
+
+            if (m_errorHandler != null)
+            {
+                Manager.OnError -= m_errorHandler;
+            }
+
+            if (m_faceStateHandler != null)
+            {
+                Manager.OnFaceStateUpdated -= m_faceStateHandler;
+            }
+
+            m_readyHandler = null;
+            m_rawLogHandler = null;
+            m_errorHandler = null;
+            m_faceStateHandler = null;
+        }
+
+        /// <summary>
+        /// 打开串口。
+        /// </summary>
+        public async void OpenSerial()
+        {
+            try
+            {
+                Manager.Configure(UseMock, PortName, BaudRate);
+                Manager.Open();
+                Log("串口已打开：" + PortName + "，波特率：" + BaudRate);
+                await Manager.WaitReadyAsync(ReadyTimeoutMs);
+                Log("已收到 READY。");
+            }
+            catch (Exception ex)
+            {
+                Log("未收到 READY，开始使用 GET STATUS 主动探测。原因：" + ex.Message);
+                await ProbeReadyAfterOpen();
+            }
+        }
+
+        /// <summary>
+        /// 关闭串口。
+        /// </summary>
+        public void CloseSerial()
+        {
+            Manager.Close();
+            Log("串口已关闭。");
+        }
+
+        /// <summary>
+        /// 等待 READY 或主动探测。
+        /// </summary>
+        public async void WaitReadyOrProbe()
+        {
+            try
+            {
+                await Manager.WaitReadyAsync(ReadyTimeoutMs);
+                Log("已收到 READY。");
+            }
+            catch
+            {
+                await ProbeReadyAfterOpen();
+            }
+        }
+
+        /// <summary>
+        /// 使用 GET STATUS 主动探测 READY。
+        /// </summary>
+        private async System.Threading.Tasks.Task ProbeReadyAfterOpen()
+        {
+            try
+            {
+                var status = await Manager.ProbeReadyByStatusAsync();
+                Log("主动探测成功，当前模组状态：" + status);
+            }
+            catch (Exception ex)
+            {
+                LogError("主动探测失败：" + ex.Message);
+            }
+        }
+
+        /// <summary>
+        /// 检测人脸 / 普通验证。
+        /// </summary>
+        public async void VerifyFace()
+        {
+            try
+            {
+                var result = await Manager.Verify.VerifyAsync(VerifyTimeout, MaxRecognitionTimes);
+                Log("人脸验证完成：成功=" + result.Success + "，用户ID=" + result.UserId + "，姓名=" + result.UserName + "，管理员=" + result.IsAdmin);
+            }
+            catch (Exception ex) { LogError("人脸验证失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 自动验证。
+        /// </summary>
+        public async void AutoVerify()
+        {
+            try
+            {
+                var result = await Manager.Verify.AutoVerifyAsync(AutoVerifyEnable, VerifyTimeout);
+                Log("自动验证完成：成功=" + result.Success + "，用户ID=" + result.UserId);
+            }
+            catch (Exception ex) { LogError("自动验证失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// RESET。
+        /// </summary>
+        public async void ResetModule()
+        {
+            try { await Manager.Basic.ResetAsync(); Log("RESET 成功。"); }
+            catch (Exception ex) { LogError("RESET 失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// FACE RESET。
+        /// </summary>
+        public async void FaceReset()
+        {
+            try { await Manager.Basic.FaceResetAsync(); Log("FACE RESET 成功。"); }
+            catch (Exception ex) { LogError("FACE RESET 失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 单帧注册。
+        /// </summary>
+        public async void EnrollSingle()
+        {
+            try
+            {
+                var result = await Manager.Enrollment.EnrollSingleAsync(EnrollAsAdmin, EnrollUserName, EnrollTimeout);
+                Log("单帧注册完成：成功=" + result.Success + "，用户ID=" + result.UserId + "，方向=" + result.Direction);
+                await ConfirmEnrollResult(result);
+            }
+            catch (Exception ex) { LogError("单帧注册失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 交互注册。
+        /// </summary>
+        public async void Enroll()
+        {
+            try
+            {
+                var result = await Manager.Enrollment.EnrollAsync(EnrollAsAdmin, EnrollUserName, EnrollDirection, EnrollTimeout);
+                Log("交互注册完成：成功=" + result.Success + "，用户ID=" + result.UserId + "，方向=" + result.Direction);
+                await ConfirmEnrollResult(result);
+            }
+            catch (Exception ex) { LogError("交互注册失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 集成注册。
+        /// </summary>
+        public async void EnrollIntegrated()
+        {
+            try
+            {
+                var result = await Manager.Enrollment.EnrollIntegratedAsync(EnrollAsAdmin, EnrollUserName, EnrollDirection, EnrollTimeout, IntegratedSingleFrame, IntegratedDuplicateCheck);
+                Log("集成注册完成：成功=" + result.Success + "，用户ID=" + result.UserId + "，方向=" + result.Direction);
+                await ConfirmEnrollResult(result);
+            }
+            catch (Exception ex) { LogError("集成注册失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 注册成功后查询用户信息，确认姓名和用户 ID 已经写入模组。
+        /// </summary>
+        private async System.Threading.Tasks.Task ConfirmEnrollResult(FaceEnrollResult result)
+        {
+            if (!result.Success || result.UserId <= 0)
+            {
+                return;
+            }
+
+            try
+            {
+                var info = await Manager.Users.GetUserInfoAsync(result.UserId);
+                Log("注册确认成功：ID=" + info.UserId + "，姓名=" + info.UserName + "，管理员=" + info.IsAdmin);
+            }
+            catch (Exception ex)
+            {
+                LogError("注册已返回成功，但查询用户确认失败：" + ex.Message);
+            }
+        }
+
+        /// <summary>
+        /// 查询所有用户 ID。
+        /// </summary>
+        public async void GetAllUserIds()
+        {
+            try
+            {
+                var ids = UseGetAllUserId2 ? await Manager.Users.GetAllUserIds2Async() : await Manager.Users.GetAllUserIdsAsync();
+                Log("用户 ID 列表：" + string.Join(",", ids));
+            }
+            catch (Exception ex) { LogError("查询用户 ID 列表失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 查询所有用户信息。
+        /// </summary>
+        public async void GetAllUserInfos()
+        {
+            try
+            {
+                var infos = UseGetAllUserId2 ? await Manager.Users.GetAllUserInfos2Async() : await Manager.Users.GetAllUserInfosAsync();
+                var builder = new StringBuilder();
+                builder.AppendLine("用户信息列表，共 " + infos.Count + " 个：");
+                for (var i = 0; i < infos.Count; i++)
+                {
+                    builder.AppendLine("ID=" + infos[i].UserId + "，姓名=" + infos[i].UserName + "，管理员=" + infos[i].IsAdmin);
+                }
+
+                Log(builder.ToString().TrimEnd());
+            }
+            catch (Exception ex) { LogError("查询所有用户信息失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 查询用户信息。
+        /// </summary>
+        public async void GetUserInfo()
+        {
+            try
+            {
+                var info = await Manager.Users.GetUserInfoAsync(UserId);
+                Log("用户信息：ID=" + info.UserId + "，姓名=" + info.UserName + "，管理员=" + info.IsAdmin);
+            }
+            catch (Exception ex) { LogError("查询用户信息失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 删除用户。
+        /// </summary>
+        public async void DeleteUser()
+        {
+            try { await Manager.Users.DeleteUserAsync(UserId); Log("删除用户成功，用户ID：" + UserId); }
+            catch (Exception ex) { LogError("删除用户失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 删除全部用户。
+        /// </summary>
+        public async void DeleteAllUsers()
+        {
+            try { await Manager.Users.DeleteAllAsync(); Log("删除全部用户成功。"); }
+            catch (Exception ex) { LogError("删除全部用户失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 扫描二维码。
+        /// </summary>
+        public async void ScanQrCode()
+        {
+            try { Log("二维码内容：" + await Manager.QrCode.ScanQrCodeAsync(QrTimeout)); }
+            catch (Exception ex) { LogError("扫描二维码失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 抓拍普通图片。
+        /// </summary>
+        public async void SnapImage()
+        {
+            try { LogImageResult("普通图片", await Manager.Images.SnapUploadImageAsync()); }
+            catch (Exception ex) { LogError("抓拍普通图片失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 抓拍人脸图片。
+        /// </summary>
+        public async void SnapFaceImage()
+        {
+            try { LogImageResult("人脸图片", await Manager.Images.SnapUploadFaceImageAsync()); }
+            catch (Exception ex) { LogError("抓拍人脸图片失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 抓拍大图。
+        /// </summary>
+        public async void SnapLargeImage()
+        {
+            try { LogImageResult("大图", await Manager.Images.SnapUploadLargeImageAsync(LargeImageDpi)); }
+            catch (Exception ex) { LogError("抓拍大图失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 照片注册。
+        /// </summary>
+        public async void EnrollWithPhoto()
+        {
+            try
+            {
+                var bytes = System.IO.File.ReadAllBytes(PhotoRegisterFilePath);
+                var result = await Manager.Images.EnrollWithPhotoAsync(bytes, PhotoBioType, PhotoUserName, PhotoDuplicateCheck, LogProgress);
+                Log("照片注册完成：成功=" + result.Success + "，用户ID=" + result.UserId);
+            }
+            catch (Exception ex) { LogError("照片注册失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 指定 ID 照片注册。
+        /// </summary>
+        public async void EnrollWithPhotoAndId()
+        {
+            try
+            {
+                var bytes = System.IO.File.ReadAllBytes(PhotoRegisterFilePath);
+                var result = await Manager.Images.EnrollWithPhotoAndIdAsync(PhotoUserId, bytes, PhotoBioType, PhotoUserName, PhotoDuplicateCheck, LogProgress);
+                Log("指定 ID 照片注册完成：成功=" + result.Success + "，用户ID=" + result.UserId);
+            }
+            catch (Exception ex) { LogError("指定 ID 照片注册失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 读取特征。
+        /// </summary>
+        public async void ReadFeature()
+        {
+            try
+            {
+                var bytes = await Manager.Features.ReadFeatureAsync(UserId, FeatureType);
+                Log("读取特征完成，长度：" + bytes.Length + " bytes");
+            }
+            catch (Exception ex) { LogError("读取特征失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 写入特征。
+        /// </summary>
+        public async void WriteFeature()
+        {
+            try
+            {
+                var bytes = System.IO.File.ReadAllBytes(FeatureFilePath);
+                var result = await Manager.Features.WriteFeatureAsync(bytes, FeatureType, FeatureUserName, LogProgress);
+                Log("写入特征完成：成功=" + result.Success + "，用户ID=" + result.UserId);
+            }
+            catch (Exception ex) { LogError("写入特征失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 读取 UVC 参数。
+        /// </summary>
+        public async void ReadUvc()
+        {
+            try
+            {
+                var p = await Manager.Uvc.ReadUsbUvcParametersAsync();
+                Log("UVC 参数：USB=0x" + p.UsbType.ToString("X2") + "，码率=" + p.BitrateMbps + "，质量=" + p.MjpgQuality + "，镜像=" + p.Mirror + "，旋转180=" + p.Rotate180);
+            }
+            catch (Exception ex) { LogError("读取 UVC 参数失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 设置 UVC 参数。
+        /// </summary>
+        public async void SetUvc()
+        {
+            try
+            {
+                await Manager.Uvc.SetUsbUvcParametersAsync(new UsbUvcParameters
+                {
+                    UsbType = UsbType,
+                    BitrateMbps = UvcBitrateMbps,
+                    MjpgQuality = MjpgQuality,
+                    Mirror = UvcMirror,
+                    Rotate180 = UvcRotate180
+                });
+                Log("设置 UVC 参数成功。");
+            }
+            catch (Exception ex) { LogError("设置 UVC 参数失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 设置人脸框显示。
+        /// </summary>
+        public async void SetFaceLocationVisible()
+        {
+            try { await Manager.Uvc.SetFaceLocationDisplayAsync(FaceLocationVisible); Log("设置人脸框显示成功，当前值：" + FaceLocationVisible); }
+            catch (Exception ex) { LogError("设置人脸框显示失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 设置 RGB_LEVEL。
+        /// </summary>
+        public async void SetRgbLevel()
+        {
+            try { await Manager.Uvc.SetRgbLevelAsync(RgbLevel); Log("设置 RGB_LEVEL 成功，当前值：" + RgbLevel); }
+            catch (Exception ex) { LogError("设置 RGB_LEVEL 失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 设置查重。
+        /// </summary>
+        public async void SetDuplicateCheck()
+        {
+            try { await Manager.Uvc.SetDuplicateCheckAsync(DuplicateCheckEnable); Log("设置查重成功，启用查重：" + DuplicateCheckEnable); }
+            catch (Exception ex) { LogError("设置查重失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 设置 Demo Mode。
+        /// </summary>
+        public async void SetDemoMode()
+        {
+            try { await Manager.Basic.SetDemoModeAsync(DemoModeEnable); Log("设置 Demo Mode 成功，当前值：" + DemoModeEnable); }
+            catch (Exception ex) { LogError("设置 Demo Mode 失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 设置 Release Key。
+        /// </summary>
+        public async void SetReleaseKey()
+        {
+            try { await Manager.Encryption.SetReleaseEncryptionKeyAsync(ParseHex(ReleaseKeyHex, 16)); Log("设置 Release Key 成功。"); }
+            catch (Exception ex) { LogError("设置 Release Key 失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 设置 Debug Key。
+        /// </summary>
+        public async void SetDebugKey()
+        {
+            try { await Manager.Encryption.SetDebugEncryptionKeyAsync(ParseHex(DebugKeyHex, 16)); Log("设置 Debug Key 成功。"); }
+            catch (Exception ex) { LogError("设置 Debug Key 失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 初始化加密。
+        /// </summary>
+        public async void InitEncryption()
+        {
+            try { await Manager.Encryption.InitEncryptionAsync(ParseHex(SeedHex, 4), EncryptionMode); Log("初始化加密成功。"); }
+            catch (Exception ex) { LogError("初始化加密失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 启动固件升级。
+        /// </summary>
+        public async void UpgradeFirmware()
+        {
+            try { await Manager.Basic.UpgradeFirmwareAsync(); Log("固件升级命令已发送。"); }
+            catch (Exception ex) { LogError("固件升级命令发送失败：" + ex.Message); }
+        }
+
+        /// <summary>
+        /// 将 Inspector 输入的串口 Hex 指令解析为中文说明。
+        /// </summary>
+        public void ParseSerialCommand()
+        {
+            try
+            {
+                var hasTx = !string.IsNullOrWhiteSpace(TxSerialCommandHex);
+                var hasRx = !string.IsNullOrWhiteSpace(RxSerialCommandHex);
+                if (!hasTx && !hasRx && !string.IsNullOrWhiteSpace(SerialCommandHex))
+                {
+                    Log("兼容旧字段解析：\n" + DescribeSerialPackets(ParseHexFlexible(SerialCommandHex)));
+                    return;
+                }
+
+                var builder = new StringBuilder();
+                if (hasTx)
+                {
+                    builder.AppendLine("TX 内容解析：");
+                    builder.AppendLine(DescribeSerialPackets(ParseHexFlexible(TxSerialCommandHex)));
+                }
+
+                if (hasRx)
+                {
+                    if (builder.Length > 0)
+                    {
+                        builder.AppendLine();
+                    }
+
+                    builder.AppendLine("RX 内容解析：");
+                    builder.AppendLine(DescribeSerialPackets(ParseHexFlexible(RxSerialCommandHex)));
+                }
+
+                Log(builder.Length > 0 ? builder.ToString().TrimEnd() : "请先填写 TX 或 RX 串口 Hex 内容。");
+            }
+            catch (Exception ex)
+            {
+                LogError("串口指令解析失败：" + ex.Message);
+            }
+        }
+
+        /// <summary>
+        /// 解析一段串口 bytes 中的所有完整协议包。
+        /// </summary>
+        private static string DescribeSerialPackets(byte[] bytes)
+        {
+            if (bytes == null || bytes.Length == 0)
+            {
+                return "串口指令为空。";
+            }
+
+            var builder = new StringBuilder();
+            var offset = 0;
+            var index = 1;
+            while (offset < bytes.Length)
+            {
+                if (offset + FaceModuleConstants.HeaderLength + FaceModuleConstants.ChecksumLength > bytes.Length)
+                {
+                    builder.AppendLine("第 " + index + " 包：剩余字节不足一个完整包头。");
+                    break;
+                }
+
+                if (bytes[offset] != FaceModuleConstants.SyncWordHigh || bytes[offset + 1] != FaceModuleConstants.SyncWordLow)
+                {
+                    builder.AppendLine("第 " + index + " 包：同步头错误，应为 EF AA，当前位置为 " + ToHex(bytes, offset, Math.Min(2, bytes.Length - offset)) + "。");
+                    break;
+                }
+
+                var msgId = bytes[offset + 2];
+                var size = (ushort)((bytes[offset + 3] << 8) | bytes[offset + 4]);
+                var packetLength = FaceModuleConstants.HeaderLength + size + FaceModuleConstants.ChecksumLength;
+                if (offset + packetLength > bytes.Length)
+                {
+                    builder.AppendLine("第 " + index + " 包：声明 DATA 长度为 " + size + "，但输入字节不完整。");
+                    break;
+                }
+
+                var data = new byte[size];
+                if (size > 0)
+                {
+                    Buffer.BlockCopy(bytes, offset + FaceModuleConstants.HeaderLength, data, 0, size);
+                }
+
+                var checksum = bytes[offset + packetLength - 1];
+                var expected = FacePacketBuilder.CalculateChecksum(msgId, size, data);
+                builder.AppendLine("第 " + index + " 包：");
+                builder.AppendLine("类型：" + DescribeMessageType(msgId));
+                builder.AppendLine("MID/MsgID：0x" + msgId.ToString("X2"));
+                builder.AppendLine("DATA 长度：" + size);
+                builder.AppendLine("DATA：" + (data.Length > 0 ? ToHex(data, 0, data.Length) : "无"));
+                builder.AppendLine("校验：" + (checksum == expected ? "正确" : "错误，应为 0x" + expected.ToString("X2")));
+                builder.AppendLine(DescribePacketData(msgId, data));
+
+                offset += packetLength;
+                index++;
+            }
+
+            return builder.ToString().TrimEnd();
+        }
+
+        /// <summary>
+        /// 解析协议包类型。
+        /// </summary>
+        private static string DescribeMessageType(byte msgId)
+        {
+            if (msgId == (byte)FaceMessageType.Reply)
+            {
+                return "模组回复 REPLY";
+            }
+
+            if (msgId == (byte)FaceMessageType.Note)
+            {
+                return "模组主动通知 NOTE";
+            }
+
+            return "主控发送命令：" + DescribeCommand((FaceCommandId)msgId);
+        }
+
+        /// <summary>
+        /// 解析协议包 DATA。
+        /// </summary>
+        private static string DescribePacketData(byte msgId, byte[] data)
+        {
+            if (msgId == (byte)FaceMessageType.Reply)
+            {
+                return DescribeReplyData(data);
+            }
+
+            if (msgId == (byte)FaceMessageType.Note)
+            {
+                return DescribeNoteData(data);
+            }
+
+            return DescribeCommandData((FaceCommandId)msgId, data);
+        }
+
+        /// <summary>
+        /// 解析 REPLY 数据。
+        /// </summary>
+        private static string DescribeReplyData(byte[] data)
+        {
+            if (data == null || data.Length < 2)
+            {
+                return "回复解析：DATA 长度不足，至少需要 MID + RESULT。";
+            }
+
+            var command = (FaceCommandId)data[0];
+            var result = (FaceResultCode)data[1];
+            var payload = Slice(data, 2, data.Length - 2);
+            var builder = new StringBuilder();
+            builder.AppendLine("回复命令：" + DescribeCommand(command));
+            builder.AppendLine("结果码：0x" + ((byte)result).ToString("X2") + "，" + FaceProtocolEncoding.ResultMessage(result));
+            builder.Append("回复内容：" + DescribeReplyPayload(command, payload));
+            return builder.ToString();
+        }
+
+        /// <summary>
+        /// 解析 NOTE 数据。
+        /// </summary>
+        private static string DescribeNoteData(byte[] data)
+        {
+            if (data == null || data.Length < 1)
+            {
+                return "通知解析：DATA 长度不足，至少需要 NID。";
+            }
+
+            var noteId = (FaceNoteId)data[0];
+            var payload = Slice(data, 1, data.Length - 1);
+            switch (noteId)
+            {
+                case FaceNoteId.Ready:
+                    return "通知内容：READY，模组已就绪。";
+                case FaceNoteId.FaceState:
+                    return "通知内容：人脸状态，" + DescribeFaceStatePayload(payload);
+                case FaceNoteId.QrData:
+                    return "通知内容：二维码数据，" + Encoding.UTF8.GetString(payload);
+                default:
+                    return "通知内容：" + noteId + "，原始 DATA=" + ToHex(payload, 0, payload.Length);
+            }
+        }
+
+        /// <summary>
+        /// 解析主控命令 DATA。
+        /// </summary>
+        private static string DescribeCommandData(FaceCommandId command, byte[] data)
+        {
+            switch (command)
+            {
+                case FaceCommandId.Reset:
+                case FaceCommandId.GetStatus:
+                case FaceCommandId.FaceReset:
+                case FaceCommandId.GetVersion:
+                case FaceCommandId.GetSn:
+                case FaceCommandId.ReadUsbUvcParameters:
+                case FaceCommandId.UpgradeFirmware:
+                    return "命令内容：" + DescribeCommand(command) + "，无参数。";
+                case FaceCommandId.Verify:
+                    return data != null && data.Length == 2 ? DescribeAutoVerifyData(data) : DescribeVerifyData(data);
+                case FaceCommandId.Enroll:
+                case FaceCommandId.EnrollSingle:
+                    return DescribeEnrollData(command, data, false);
+                case FaceCommandId.EnrollIntegrated:
+                    return DescribeEnrollData(command, data, true);
+                case FaceCommandId.DeleteUser:
+                case FaceCommandId.GetUserInfo:
+                    return "命令内容：" + DescribeCommand(command) + "，用户ID=" + ReadUInt16Safe(data, 0);
+                case FaceCommandId.DeleteAll:
+                    return "命令内容：删除全部用户。";
+                case FaceCommandId.GetAllUserId:
+                case FaceCommandId.GetAllUserId2:
+                    return "命令内容：" + DescribeCommand(command) + "，页索引=" + ReadByteSafe(data, 0);
+                case FaceCommandId.ScanQrCode:
+                    return "命令内容：扫描二维码，超时=" + ReadByteSafe(data, 1) + " 秒。";
+                case FaceCommandId.SnapUploadLargeImage:
+                    return "命令内容：抓拍大图，DPI=" + ReadByteSafe(data, 0) + "。";
+                case FaceCommandId.SetUsbUvcParameters:
+                    return DescribeSetUvcData(data);
+                case FaceCommandId.SetFaceLocationDisplay:
+                    return "命令内容：设置人脸框显示=" + (ReadByteSafe(data, 0) != 0) + "。";
+                case FaceCommandId.RgbLevel:
+                    return "命令内容：设置 RGB_LEVEL=" + ReadByteSafe(data, 0) + "。";
+                case FaceCommandId.DuplicateCheck:
+                    return data == null || data.Length == 0 ? "命令内容：查询查重状态。" : "命令内容：设置查重=" + (ReadByteSafe(data, 0) == 0) + "。";
+                case FaceCommandId.DemoMode:
+                    return "命令内容：设置 Demo Mode=" + (ReadByteSafe(data, 0) != 0) + "。";
+                case FaceCommandId.ReadFeature:
+                    return "命令内容：读取特征，用户ID=" + ReadUInt16Safe(data, 2) + "，特征类型=" + ReadByteSafe(data, 4) + "。";
+                case FaceCommandId.WriteFeature:
+                    return DescribeWriteFeatureInitData(data);
+                case FaceCommandId.EnrollWithPhoto:
+                case FaceCommandId.EnrollWithPhotoAndId:
+                    return DescribePhotoEnrollInitData(command, data);
+                default:
+                    return "命令内容：" + DescribeCommand(command) + "，原始 DATA=" + (data == null || data.Length == 0 ? "无" : ToHex(data, 0, data.Length));
+            }
+        }
+
+        /// <summary>
+        /// 解析 VERIFY 命令参数。
+        /// </summary>
+        private static string DescribeVerifyData(byte[] data)
+        {
+            return "命令内容：人脸验证，立即检测=" + ReadByteSafe(data, 0) + "，超时=" + ReadByteSafe(data, 1) + " 秒，最大识别次数=" + ReadByteSafe(data, 2) + "。";
+        }
+
+        /// <summary>
+        /// 解析 AUTO_VERIFY 命令参数。
+        /// </summary>
+        private static string DescribeAutoVerifyData(byte[] data)
+        {
+            return "命令内容：自动验证，启用=" + (ReadByteSafe(data, 0) != 0) + "，超时=" + ReadByteSafe(data, 1) + " 秒。";
+        }
+
+        /// <summary>
+        /// 解析录入命令参数。
+        /// </summary>
+        private static string DescribeEnrollData(FaceCommandId command, byte[] data, bool integrated)
+        {
+            var name = data != null && data.Length > 1 ? FaceProtocolEncoding.DecodeUserName(Slice(data, 1, Math.Min(FaceModuleConstants.UserNameSize, data.Length - 1))) : string.Empty;
+            var directionOffset = 1 + FaceModuleConstants.UserNameSize;
+            var builder = new StringBuilder();
+            builder.Append("命令内容：" + DescribeCommand(command));
+            builder.Append("，管理员=" + (ReadByteSafe(data, 0) != 0));
+            builder.Append("，用户名=" + name);
+            builder.Append("，方向=" + (FaceDirection)ReadByteSafe(data, directionOffset));
+            builder.Append("，超时=" + ReadByteSafe(data, directionOffset + 1) + " 秒");
+            if (integrated)
+            {
+                builder.Append("，单帧=" + (ReadByteSafe(data, directionOffset + 2) != 0));
+                builder.Append("，查重=" + (ReadByteSafe(data, directionOffset + 3) == 0));
+            }
+
+            builder.Append("。");
+            return builder.ToString();
+        }
+
+        /// <summary>
+        /// 解析设置 UVC 参数。
+        /// </summary>
+        private static string DescribeSetUvcData(byte[] data)
+        {
+            var attributes = ReadByteSafe(data, 3);
+            return "命令内容：设置 UVC，USB=0x" + ReadByteSafe(data, 0).ToString("X2") + "，码率=" + ReadByteSafe(data, 1) + "Mbps，质量=" + ReadByteSafe(data, 2) + "，镜像=" + ((attributes & 0x01) != 0) + "，旋转180=" + ((attributes & 0x02) != 0) + "。";
+        }
+
+        /// <summary>
+        /// 解析照片注册初始化参数。
+        /// </summary>
+        private static string DescribePhotoEnrollInitData(FaceCommandId command, byte[] data)
+        {
+            var hasId = command == FaceCommandId.EnrollWithPhotoAndId;
+            var fileSizeOffset = hasId ? 4 : 2;
+            var nameLengthOffset = fileSizeOffset + 5;
+            var builder = new StringBuilder();
+            builder.Append("命令内容：" + DescribeCommand(command));
+            if (hasId)
+            {
+                builder.Append("，指定用户ID=" + ReadUInt16Safe(data, 2));
+            }
+
+            builder.Append("，文件长度=" + ReadUInt32Safe(data, fileSizeOffset));
+            builder.Append("，BioType=" + ReadByteSafe(data, fileSizeOffset + 4));
+            builder.Append("，用户名=" + ReadVariableNameSafe(data, nameLengthOffset));
+            var duplicateOffset = nameLengthOffset + 1 + ReadByteSafe(data, nameLengthOffset);
+            builder.Append("，查重=" + (ReadByteSafe(data, duplicateOffset) == 0) + "。");
+            return builder.ToString();
+        }
+
+        /// <summary>
+        /// 解析写特征初始化参数。
+        /// </summary>
+        private static string DescribeWriteFeatureInitData(byte[] data)
+        {
+            return "命令内容：写入特征，特征类型=" + ReadByteSafe(data, 2) + "，用户名=" + ReadVariableNameSafe(data, 3) + "。";
+        }
+
+        /// <summary>
+        /// 解析 REPLY 业务数据。
+        /// </summary>
+        private static string DescribeReplyPayload(FaceCommandId command, byte[] payload)
+        {
+            switch (command)
+            {
+                case FaceCommandId.GetStatus:
+                    return "模组状态=" + (FaceModuleStatus)ReadByteSafe(payload, 0) + "。";
+                case FaceCommandId.Verify:
+                case FaceCommandId.GetUserInfo:
+                    return "用户ID=" + ReadUInt16Safe(payload, 0) + "，用户名=" + FaceProtocolEncoding.DecodeUserName(Slice(payload, 2, Math.Min(FaceModuleConstants.UserNameSize, Math.Max(0, payload.Length - 2)))) + "，管理员=" + (ReadByteSafe(payload, 34) != 0) + "。";
+                case FaceCommandId.Enroll:
+                case FaceCommandId.EnrollSingle:
+                case FaceCommandId.EnrollIntegrated:
+                case FaceCommandId.EnrollWithPhoto:
+                case FaceCommandId.EnrollWithPhotoAndId:
+                case FaceCommandId.WriteFeature:
+                    return "用户ID=" + ReadUInt16Safe(payload, 0) + "，方向/附加值=" + ReadByteSafe(payload, 2) + "。";
+                case FaceCommandId.GetAllUserId:
+                    return DescribeUserIdList(payload, false);
+                case FaceCommandId.GetAllUserId2:
+                    return DescribeUserIdList(payload, true);
+                case FaceCommandId.ReadUsbUvcParameters:
+                    return DescribeSetUvcData(payload);
+                default:
+                    return payload == null || payload.Length == 0 ? "无。" : ToHex(payload, 0, payload.Length);
+            }
+        }
+
+        /// <summary>
+        /// 解析用户 ID 列表。
+        /// </summary>
+        private static string DescribeUserIdList(byte[] payload, bool twoByteCount)
+        {
+            var count = twoByteCount ? ReadUInt16Safe(payload, 0) : ReadByteSafe(payload, 0);
+            var offset = twoByteCount ? 2 : 1;
+            var ids = new List<string>();
+            for (var i = 0; i < count && offset + 1 < payload.Length; i++, offset += 2)
+            {
+                ids.Add(ReadUInt16Safe(payload, offset).ToString());
+            }
+
+            return "用户数量=" + count + "，用户ID列表=" + string.Join(",", ids) + "。";
+        }
+
+        /// <summary>
+        /// 解析人脸状态通知。
+        /// </summary>
+        private static string DescribeFaceStatePayload(byte[] payload)
+        {
+            if (payload == null || payload.Length < 2)
+            {
+                return "状态数据不足。";
+            }
+
+            var state = (FaceStateCode)ReadUInt16Safe(payload, 0);
+            return FaceProtocolEncoding.FaceStateMessage(state);
+        }
+
+        /// <summary>
+        /// 返回命令中文名称。
+        /// </summary>
+        private static string DescribeCommand(FaceCommandId command)
+        {
+            switch (command)
+            {
+                case FaceCommandId.Reset: return "复位模组";
+                case FaceCommandId.GetStatus: return "获取状态";
+                case FaceCommandId.Verify: return "人脸验证 / 自动验证";
+                case FaceCommandId.Enroll: return "交互式人脸录入";
+                case FaceCommandId.EnrollSingle: return "单帧人脸录入";
+                case FaceCommandId.DeleteUser: return "删除用户";
+                case FaceCommandId.DeleteAll: return "删除全部用户";
+                case FaceCommandId.GetUserInfo: return "查询用户信息";
+                case FaceCommandId.FaceReset: return "取消当前人脸流程";
+                case FaceCommandId.GetAllUserId: return "查询所有用户 ID";
+                case FaceCommandId.GetAllUserId2: return "查询所有用户 ID 扩展";
+                case FaceCommandId.EnrollIntegrated: return "集成式人脸录入";
+                case FaceCommandId.GetVersion: return "获取版本";
+                case FaceCommandId.InitEncryption: return "初始化加密";
+                case FaceCommandId.SetReleaseEncKey: return "设置 Release Key";
+                case FaceCommandId.SetDebugEncKey: return "设置 Debug Key";
+                case FaceCommandId.ScanQrCode: return "扫描二维码";
+                case FaceCommandId.SnapUploadImage: return "抓拍普通图片";
+                case FaceCommandId.SnapUploadFaceImage: return "抓拍人脸图片";
+                case FaceCommandId.EnrollSnapFaceImage: return "抓拍人脸后注册";
+                case FaceCommandId.SnapUploadLargeImage: return "抓拍大图";
+                case FaceCommandId.GetSn: return "获取设备 SN";
+                case FaceCommandId.ReadUsbUvcParameters: return "读取 UVC 参数";
+                case FaceCommandId.SetUsbUvcParameters: return "设置 UVC 参数";
+                case FaceCommandId.SetFaceLocationDisplay: return "设置人脸框显示";
+                case FaceCommandId.RgbLevel: return "设置 RGB_LEVEL";
+                case FaceCommandId.EnrollWithPhotoAndId: return "指定 ID 照片注册";
+                case FaceCommandId.UpgradeFirmware: return "固件升级";
+                case FaceCommandId.EnrollWithPhoto: return "照片注册";
+                case FaceCommandId.ReadFeature: return "读取特征";
+                case FaceCommandId.WriteFeature: return "写入特征";
+                case FaceCommandId.DuplicateCheck: return "查重设置";
+                case FaceCommandId.DemoMode: return "Demo Mode";
+                default: return "未知命令 0x" + ((byte)command).ToString("X2");
+            }
+        }
+
+        /// <summary>
+        /// 输出图片结果。
+        /// </summary>
+        private void LogImageResult(string name, FaceImageResult result)
+        {
+            Log(name + "抓拍完成：字节数=" + result.Bytes.Length + "，用户ID=" + result.UserId + "，贴图是否生成=" + (result.Texture != null));
+        }
+
+        /// <summary>
+        /// 输出进度。
+        /// </summary>
+        private void LogProgress(int sent, int total)
+        {
+            Log("发送进度：" + sent + "/" + total);
+        }
+
+        /// <summary>
+        /// 解析固定长度 Hex。
+        /// </summary>
+        private static byte[] ParseHex(string text, int expectedLength)
+        {
+            var parts = text.Split(new[] { ' ', '-', '\t', '\r', '\n' }, StringSplitOptions.RemoveEmptyEntries);
+            if (parts.Length != expectedLength)
+            {
+                throw new ArgumentException("Hex 长度必须为 " + expectedLength + " bytes");
+            }
+
+            var bytes = new byte[parts.Length];
+            for (var i = 0; i < parts.Length; i++)
+            {
+                bytes[i] = Convert.ToByte(parts[i], 16);
+            }
+
+            return bytes;
+        }
+
+        /// <summary>
+        /// 解析任意长度 Hex 字符串。
+        /// </summary>
+        private static byte[] ParseHexFlexible(string text)
+        {
+            if (string.IsNullOrWhiteSpace(text))
+            {
+                return Array.Empty<byte>();
+            }
+
+            var normalized = text.Replace("0x", string.Empty).Replace("0X", string.Empty).Replace("TX", " ").Replace("tx", " ").Replace("Rx", " ").Replace("RX", " ").Replace("rx", " ");
+            var parts = normalized.Split(new[] { ' ', '-', ',', ':', '：', '\t', '\r', '\n' }, StringSplitOptions.RemoveEmptyEntries);
+            if (parts.Length == 1 && parts[0].Length > 2 && IsHexText(parts[0]))
+            {
+                var compact = parts[0];
+                if (compact.Length % 2 != 0)
+                {
+                    throw new ArgumentException("连续 Hex 字符数量必须为偶数。");
+                }
+
+                var compactBytes = new byte[compact.Length / 2];
+                for (var i = 0; i < compactBytes.Length; i++)
+                {
+                    compactBytes[i] = Convert.ToByte(compact.Substring(i * 2, 2), 16);
+                }
+
+                return compactBytes;
+            }
+
+            var result = new List<byte>();
+            for (var i = 0; i < parts.Length; i++)
+            {
+                if (!IsHexByteText(parts[i]))
+                {
+                    continue;
+                }
+
+                result.Add(Convert.ToByte(parts[i], 16));
+            }
+
+            if (result.Count == 0)
+            {
+                throw new ArgumentException("没有找到有效 Hex 字节。");
+            }
+
+            return result.ToArray();
+        }
+
+        /// <summary>
+        /// 判断字符串是否全部为 Hex 字符。
+        /// </summary>
+        private static bool IsHexText(string text)
+        {
+            if (string.IsNullOrEmpty(text))
+            {
+                return false;
+            }
+
+            for (var i = 0; i < text.Length; i++)
+            {
+                if (!IsHexChar(text[i]))
+                {
+                    return false;
+                }
+            }
+
+            return true;
+        }
+
+        /// <summary>
+        /// 判断字符串是否为一个 Hex byte。
+        /// </summary>
+        private static bool IsHexByteText(string text)
+        {
+            return text != null && text.Length == 2 && IsHexText(text);
+        }
+
+        /// <summary>
+        /// 判断字符是否为 Hex 字符。
+        /// </summary>
+        private static bool IsHexChar(char value)
+        {
+            return value >= '0' && value <= '9' || value >= 'a' && value <= 'f' || value >= 'A' && value <= 'F';
+        }
+
+        /// <summary>
+        /// 截取 byte 数组。
+        /// </summary>
+        private static byte[] Slice(byte[] bytes, int offset, int length)
+        {
+            if (bytes == null || offset < 0 || length <= 0 || offset >= bytes.Length)
+            {
+                return Array.Empty<byte>();
+            }
+
+            length = Math.Min(length, bytes.Length - offset);
+            var result = new byte[length];
+            Buffer.BlockCopy(bytes, offset, result, 0, length);
+            return result;
+        }
+
+        /// <summary>
+        /// 安全读取 1 byte。
+        /// </summary>
+        private static byte ReadByteSafe(byte[] bytes, int offset)
+        {
+            return bytes != null && offset >= 0 && offset < bytes.Length ? bytes[offset] : (byte)0;
+        }
+
+        /// <summary>
+        /// 安全读取 UInt16。
+        /// </summary>
+        private static int ReadUInt16Safe(byte[] bytes, int offset)
+        {
+            return bytes != null && offset >= 0 && offset + 1 < bytes.Length ? (bytes[offset] << 8) | bytes[offset + 1] : 0;
+        }
+
+        /// <summary>
+        /// 安全读取 UInt32。
+        /// </summary>
+        private static uint ReadUInt32Safe(byte[] bytes, int offset)
+        {
+            if (bytes == null || offset < 0 || offset + 3 >= bytes.Length)
+            {
+                return 0;
+            }
+
+            return (uint)((bytes[offset] << 24) | (bytes[offset + 1] << 16) | (bytes[offset + 2] << 8) | bytes[offset + 3]);
+        }
+
+        /// <summary>
+        /// 安全读取变长 UTF-8 名称。
+        /// </summary>
+        private static string ReadVariableNameSafe(byte[] bytes, int lengthOffset)
+        {
+            var length = ReadByteSafe(bytes, lengthOffset);
+            return FaceProtocolEncoding.DecodeUserName(Slice(bytes, lengthOffset + 1, length));
+        }
+
+        /// <summary>
+        /// 转换 Hex 字符串。
+        /// </summary>
+        private static string ToHex(byte[] bytes, int offset, int length)
+        {
+            if (bytes == null || length <= 0)
+            {
+                return string.Empty;
+            }
+
+            var builder = new StringBuilder();
+            var end = Math.Min(bytes.Length, offset + length);
+            for (var i = offset; i < end; i++)
+            {
+                if (builder.Length > 0)
+                {
+                    builder.Append(' ');
+                }
+
+                builder.Append(bytes[i].ToString("X2"));
+            }
+
+            return builder.ToString();
+        }
+
+        /// <summary>
+        /// 输出普通日志。
+        /// </summary>
+        private void Log(string message)
+        {
+            Debug.Log("[FaceModule键盘测试] " + message);
+        }
+
+        /// <summary>
+        /// 输出错误日志。
+        /// </summary>
+        private void LogError(string message)
+        {
+            Debug.LogError("[FaceModule键盘测试] " + message);
+        }
+    }
+}
diff --git a/Samples~/SI-M1 Face Demo/UI/Common/FaceModuleDemoBootstrap.cs b/Samples~/SI-M1 Face Demo/UI/Common/FaceModuleDemoBootstrap.cs
new file mode 100644
index 0000000..05f3a98
--- /dev/null
+++ b/Samples~/SI-M1 Face Demo/UI/Common/FaceModuleDemoBootstrap.cs	
@@ -0,0 +1,173 @@
+using Aisu.SIM1.Face.Core;
+using UnityEngine;
+using UnityEngine.EventSystems;
+using UnityEngine.UI;
+
+namespace Aisu.SIM1.Face.UI.Common
+{
+    /// <summary>
+    /// Demo 场景运行时构建器。
+    /// </summary>
+    public sealed class FaceModuleDemoBootstrap : MonoBehaviour
+    {
+        #region Unity API
+
+        /// <summary>
+        /// 执行 Awake 方法。
+        /// </summary>
+        private void Awake()
+        {
+            Build();
+        }
+
+        #endregion
+
+        /// <summary>
+        /// 构建完整 UGUI 页面。
+        /// </summary>
+        public void Build()
+        {
+            if (FindObjectOfType<EventSystem>() == null)
+            {
+                var eventSystem = new GameObject("EventSystem");
+                eventSystem.AddComponent<EventSystem>();
+                eventSystem.AddComponent<StandaloneInputModule>();
+            }
+
+            var font = Resources.GetBuiltinResource<Font>("Arial.ttf");
+            var builder = new FaceModuleUiBuilder(font);
+            var manager = FindObjectOfType<FaceModuleManager>() ?? new GameObject("FaceModuleManager").AddComponent<FaceModuleManager>();
+
+            var canvasGo = FaceModuleUiBuilder.Create("Canvas", transform);
+            var canvas = canvasGo.AddComponent<Canvas>();
+            canvas.renderMode = RenderMode.ScreenSpaceOverlay;
+            canvasGo.AddComponent<GraphicRaycaster>();
+            var scaler = canvasGo.AddComponent<CanvasScaler>();
+            scaler.uiScaleMode = CanvasScaler.ScaleMode.ScaleWithScreenSize;
+            scaler.referenceResolution = new Vector2(1920, 1080);
+
+            var safe = FaceModuleUiBuilder.Create("SafeArea", canvasGo.transform);
+            FaceModuleUiBuilder.Stretch(safe.GetComponent<RectTransform>());
+            var safeLayout = safe.AddComponent<VerticalLayoutGroup>();
+            safeLayout.padding = new RectOffset(16, 16, 16, 16);
+            safeLayout.spacing = 12;
+            safeLayout.childControlWidth = true;
+            safeLayout.childForceExpandWidth = true;
+
+            var top = FaceModuleUiBuilder.Create("TopStatusBar", safe.transform);
+            top.AddComponent<Image>().color = new Color(0.9f, 0.94f, 0.97f);
+            var topLayoutElement = top.AddComponent<LayoutElement>();
+            topLayoutElement.preferredHeight = 54;
+            var topLayout = top.AddComponent<HorizontalLayoutGroup>();
+            topLayout.padding = new RectOffset(12, 12, 8, 8);
+            topLayout.spacing = 20;
+            var statusBar = top.AddComponent<FaceModuleStatusBar>();
+            statusBar.Bind(
+                builder.Text(top.transform, "未连接", 20),
+                builder.Text(top.transform, "未 READY", 20),
+                builder.Text(top.transform, "状态: Invalid", 20),
+                builder.Text(top.transform, "命令:", 20),
+                builder.Text(top.transform, "错误:", 20));
+
+            var body = FaceModuleUiBuilder.Create("Body", safe.transform);
+            var bodyLayoutElement = body.AddComponent<LayoutElement>();
+            bodyLayoutElement.flexibleHeight = 1;
+            var bodyLayout = body.AddComponent<HorizontalLayoutGroup>();
+            bodyLayout.spacing = 12;
+            bodyLayout.childControlHeight = true;
+            bodyLayout.childForceExpandHeight = true;
+
+            var navigation = FaceModuleUiBuilder.Create("NavigationPanel", body.transform).AddComponent<FaceModuleNavigationPanel>();
+            navigation.gameObject.AddComponent<Image>().color = new Color(0.86f, 0.9f, 0.94f);
+            var navLayoutElement = navigation.gameObject.AddComponent<LayoutElement>();
+            navLayoutElement.preferredWidth = 240;
+            var navLayout = navigation.gameObject.AddComponent<VerticalLayoutGroup>();
+            navLayout.padding = new RectOffset(10, 10, 10, 10);
+            navLayout.spacing = 8;
+
+            var pageContainer = FaceModuleUiBuilder.Create("PageContainer", body.transform);
+            pageContainer.AddComponent<Image>().color = new Color(0.98f, 0.99f, 1f);
+            pageContainer.AddComponent<LayoutElement>().flexibleWidth = 1;
+
+            var bottom = FaceModuleUiBuilder.Create("BottomLogPanel", safe.transform);
+            bottom.AddComponent<Image>().color = new Color(0.08f, 0.09f, 0.1f);
+            bottom.AddComponent<LayoutElement>().preferredHeight = 220;
+            var bottomLayout = bottom.AddComponent<VerticalLayoutGroup>();
+            bottomLayout.padding = new RectOffset(8, 8, 8, 8);
+            bottomLayout.spacing = 6;
+            var logPanel = bottom.AddComponent<FaceModuleLogPanel>();
+            var autoScroll = builder.Toggle(bottom.transform, "自动滚动", true);
+            var scroll = builder.ScrollView(bottom.transform, out var logText);
+            logText.color = Color.white;
+            logPanel.Bind(logText, scroll, autoScroll);
+            var logButtons = builder.Row(bottom.transform);
+            builder.Button(logButtons.transform, "清空日志", logPanel.Clear);
+            builder.Button(logButtons.transform, "保存日志", logPanel.Save);
+
+            var loadingGo = FaceModuleUiBuilder.Create("LoadingView", canvasGo.transform);
+            loadingGo.AddComponent<Image>().color = new Color(0, 0, 0, 0.25f);
+            FaceModuleUiBuilder.Stretch(loadingGo.GetComponent<RectTransform>());
+            var loadingLayout = loadingGo.AddComponent<VerticalLayoutGroup>();
+            loadingLayout.childAlignment = TextAnchor.MiddleCenter;
+            var loading = loadingGo.AddComponent<FaceModuleLoadingView>();
+            loading.Bind(builder.Text(loadingGo.transform, "处理中...", 28, TextAnchor.MiddleCenter), builder.Slider(loadingGo.transform));
+
+            var dialogGo = FaceModuleUiBuilder.Create("ConfirmDialog", canvasGo.transform);
+            dialogGo.AddComponent<Image>().color = new Color(0, 0, 0, 0.35f);
+            FaceModuleUiBuilder.Stretch(dialogGo.GetComponent<RectTransform>());
+            var dialogLayout = dialogGo.AddComponent<VerticalLayoutGroup>();
+            dialogLayout.childAlignment = TextAnchor.MiddleCenter;
+            dialogLayout.spacing = 12;
+            var dialog = dialogGo.AddComponent<FaceModuleConfirmDialog>();
+            var dialogText = builder.Text(dialogGo.transform, "确认操作？", 26, TextAnchor.MiddleCenter);
+            var dialogButtons = builder.Row(dialogGo.transform);
+            var confirmButton = builder.Button(dialogButtons.transform, "确认", () => { });
+            var cancelButton = builder.Button(dialogButtons.transform, "取消", () => { });
+            dialog.Bind(dialogText, confirmButton, cancelButton);
+
+            var mainPanel = canvasGo.AddComponent<FaceModuleMainPanel>();
+            mainPanel.Bind(statusBar, navigation, logPanel, loading);
+
+            BuildPages(pageContainer.transform, builder, mainPanel);
+            mainPanel.Init(manager);
+            mainPanel.ShowPage("Connect");
+        }
+
+        /// <summary>
+        /// 构建 Demo 功能页面。
+        /// </summary>
+        private void BuildPages(Transform pageContainer, FaceModuleUiBuilder builder, FaceModuleMainPanel mainPanel)
+        {
+            AddPage<global::Aisu.SIM1.Face.UI.Pages.FaceConnectPage>(pageContainer, builder, mainPanel, "Connect", "连接");
+            AddPage<global::Aisu.SIM1.Face.UI.Pages.FaceProtocolDebugPage>(pageContainer, builder, mainPanel, "ProtocolDebug", "协议调试");
+            AddPage<global::Aisu.SIM1.Face.UI.Pages.FaceVerifyPage>(pageContainer, builder, mainPanel, "Verify", "人脸验证");
+            AddPage<global::Aisu.SIM1.Face.UI.Pages.FaceEnrollPage>(pageContainer, builder, mainPanel, "Enroll", "人脸录入");
+            AddPage<global::Aisu.SIM1.Face.UI.Pages.FaceUserManagePage>(pageContainer, builder, mainPanel, "UserManage", "用户管理");
+            AddPage<global::Aisu.SIM1.Face.UI.Pages.FaceQrCodePage>(pageContainer, builder, mainPanel, "QrCode", "二维码");
+            AddPage<global::Aisu.SIM1.Face.UI.Pages.FaceImagePage>(pageContainer, builder, mainPanel, "Image", "图片抓拍");
+            AddPage<global::Aisu.SIM1.Face.UI.Pages.FacePhotoEnrollPage>(pageContainer, builder, mainPanel, "PhotoEnroll", "照片注册");
+            AddPage<global::Aisu.SIM1.Face.UI.Pages.FaceFeaturePage>(pageContainer, builder, mainPanel, "Feature", "特征管理");
+            AddPage<global::Aisu.SIM1.Face.UI.Pages.FaceUvcSettingsPage>(pageContainer, builder, mainPanel, "Uvc", "UVC 设置");
+            AddPage<global::Aisu.SIM1.Face.UI.Pages.FaceAdvancedSettingsPage>(pageContainer, builder, mainPanel, "Advanced", "高级设置");
+            AddPage<global::Aisu.SIM1.Face.UI.Pages.FaceEncryptionPage>(pageContainer, builder, mainPanel, "Encryption", "加密");
+            AddPage<global::Aisu.SIM1.Face.UI.Pages.FaceFirmwarePage>(pageContainer, builder, mainPanel, "Firmware", "固件升级");
+        }
+
+        /// <summary>
+        /// 添加 Demo 功能页面。
+        /// </summary>
+        private void AddPage<T>(Transform parent, FaceModuleUiBuilder builder, FaceModuleMainPanel mainPanel, string pageName, string label) where T : FaceModulePageBase
+        {
+            var pageGo = FaceModuleUiBuilder.Create(pageName + "Page", parent);
+            FaceModuleUiBuilder.Stretch(pageGo.GetComponent<RectTransform>());
+            var layout = pageGo.AddComponent<VerticalLayoutGroup>();
+            layout.padding = new RectOffset(16, 16, 16, 16);
+            layout.spacing = 10;
+            layout.childControlWidth = true;
+            layout.childForceExpandWidth = true;
+            var page = pageGo.AddComponent<T>();
+            page.Build(builder);
+            mainPanel.RegisterPage(pageName, label, page, builder);
+        }
+    }
+}
diff --git a/Samples~/SI-M1 Face Demo/UI/Common/FaceModuleUiCommon.cs b/Samples~/SI-M1 Face Demo/UI/Common/FaceModuleUiCommon.cs
new file mode 100644
index 0000000..eb604bb
--- /dev/null
+++ b/Samples~/SI-M1 Face Demo/UI/Common/FaceModuleUiCommon.cs	
@@ -0,0 +1,927 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using Aisu.SIM1.Face.Core;
+using Aisu.SIM1.Face.Protocol;
+using UnityEngine;
+using UnityEngine.UI;
+
+namespace Aisu.SIM1.Face.UI.Common
+{
+    /// <summary>
+    /// FaceModule UI 公共状态。
+    /// </summary>
+    public sealed class FaceModuleUiState
+    {
+        // 公开数据字段。
+        public bool IsBusy;
+        // 公开数据字段。
+        public string CurrentPage;
+        // 公开数据字段。
+        public string LastResult;
+        // 公开数据字段。
+        public float Progress;
+    }
+
+    /// <summary>
+    /// 所有功能页面的基类。
+    /// </summary>
+    public abstract class FaceModulePageBase : MonoBehaviour
+    {
+        // 内部状态字段。
+        protected FaceModuleManager m_manager;
+        // 内部状态字段。
+        protected FaceModuleLogPanel m_logPanel;
+        // 内部状态字段。
+        protected FaceModuleLoadingView m_loadingView;
+        // 内部状态字段。
+        protected Text m_resultText;
+
+        /// <summary>
+        /// 初始化页面。
+        /// </summary>
+        public virtual void Init(FaceModuleManager manager, FaceModuleLogPanel logPanel, FaceModuleLoadingView loadingView)
+        {
+            m_manager = manager;
+            m_logPanel = logPanel;
+            m_loadingView = loadingView;
+        }
+
+        /// <summary>
+        /// 页面显示。
+        /// </summary>
+        public virtual void Show()
+        {
+            gameObject.SetActive(true);
+        }
+
+        /// <summary>
+        /// 页面隐藏。
+        /// </summary>
+        public virtual void Hide()
+        {
+            gameObject.SetActive(false);
+        }
+
+        /// <summary>
+        /// 由代码生成页面内容。
+        /// </summary>
+        public virtual void Build(FaceModuleUiBuilder builder)
+        {
+        }
+
+        /// <summary>
+        /// 执行 RequireConnected 方法。
+        /// </summary>
+        protected bool RequireConnected()
+        {
+            if (m_manager != null && m_manager.IsOpen)
+            {
+                return true;
+            }
+
+            SetResult("模组未连接");
+            return false;
+        }
+
+        /// <summary>
+        /// 执行 RequireReady 方法。
+        /// </summary>
+        protected bool RequireReady()
+        {
+            if (RequireConnected() && m_manager.IsReady)
+            {
+                return true;
+            }
+
+            SetResult("模组未 READY");
+            return false;
+        }
+
+        /// <summary>
+        /// 执行 SetResult 方法。
+        /// </summary>
+        protected void SetResult(string message)
+        {
+            if (m_resultText != null)
+            {
+                m_resultText.text = message;
+            }
+
+            m_logPanel?.Info(message);
+        }
+
+        /// <summary>
+        /// 执行 SetError 方法。
+        /// </summary>
+        protected void SetError(Exception exception)
+        {
+            SetResult(exception.Message);
+            m_logPanel?.Error(exception.Message);
+            Debug.LogException(exception);
+        }
+
+        /// <summary>
+        /// 执行 ReadByte 方法。
+        /// </summary>
+        protected byte ReadByte(InputField input, byte fallback)
+        {
+            return input != null && byte.TryParse(input.text, out var value) ? value : fallback;
+        }
+
+        /// <summary>
+        /// 执行 ReadInt 方法。
+        /// </summary>
+        protected int ReadInt(InputField input, int fallback)
+        {
+            return input != null && int.TryParse(input.text, out var value) ? value : fallback;
+        }
+
+        /// <summary>
+        /// 执行 ReadText 方法。
+        /// </summary>
+        protected string ReadText(InputField input)
+        {
+            return input != null ? input.text : string.Empty;
+        }
+
+        /// <summary>
+        /// 执行 RunWithButton 方法。
+        /// </summary>
+        protected void RunWithButton(Button button, Func<System.Threading.Tasks.Task> action)
+        {
+            if (button != null)
+            {
+                button.interactable = false;
+            }
+
+            RunAsync(async () =>
+            {
+                try
+                {
+                    await action();
+                }
+                finally
+                {
+                    if (button != null)
+                    {
+                        button.interactable = true;
+                    }
+                }
+            });
+        }
+
+        /// <summary>
+        /// 执行 RunAsync 方法。
+        /// </summary>
+        protected async void RunAsync(Func<System.Threading.Tasks.Task> action)
+        {
+            try
+            {
+                m_loadingView?.Show("处理中...");
+                await action();
+            }
+            catch (Exception ex)
+            {
+                SetError(ex);
+            }
+            finally
+            {
+                m_loadingView?.Hide();
+            }
+        }
+    }
+
+    /// <summary>
+    /// 顶部状态栏。
+    /// </summary>
+    public sealed class FaceModuleStatusBar : MonoBehaviour
+    {
+        // Inspector 绑定字段。
+        [SerializeField] private Text m_connectionText;
+        // Inspector 绑定字段。
+        [SerializeField] private Text m_readyText;
+        // Inspector 绑定字段。
+        [SerializeField] private Text m_statusText;
+        // Inspector 绑定字段。
+        [SerializeField] private Text m_commandText;
+        // Inspector 绑定字段。
+        [SerializeField] private Text m_errorText;
+        // 内部状态字段。
+        private FaceModuleManager m_manager;
+        private Action<FaceResultCode, string> m_errorHandler; // Manager 错误事件回调。
+
+        #region Unity API
+
+        /// <summary>
+        /// 执行 Update 方法。
+        /// </summary>
+        private void Update()
+        {
+            Refresh();
+        }
+
+        #endregion
+
+        /// <summary>
+        /// 初始化状态栏。
+        /// </summary>
+        public void Init(FaceModuleManager manager)
+        {
+            if (m_manager != null && m_errorHandler != null)
+            {
+                m_manager.OnError -= m_errorHandler;
+            }
+
+            m_manager = manager;
+            if (m_manager != null)
+            {
+                m_errorHandler = (_, message) =>
+                {
+                    if (m_errorText != null)
+                    {
+                        m_errorText.text = "错误: " + message;
+                    }
+                };
+                m_manager.OnError += m_errorHandler;
+            }
+
+            Refresh();
+        }
+
+        private void OnDestroy()
+        {
+            if (m_manager != null && m_errorHandler != null)
+            {
+                m_manager.OnError -= m_errorHandler;
+            }
+        }
+
+        /// <summary>
+        /// 绑定状态栏文本。
+        /// </summary>
+        public void Bind(Text connectionText, Text readyText, Text statusText, Text commandText, Text errorText)
+        {
+            m_connectionText = connectionText;
+            m_readyText = readyText;
+            m_statusText = statusText;
+            m_commandText = commandText;
+            m_errorText = errorText;
+        }
+
+        /// <summary>
+        /// 刷新显示。
+        /// </summary>
+        public void Refresh()
+        {
+            if (m_manager == null)
+            {
+                return;
+            }
+
+            if (m_connectionText != null) m_connectionText.text = m_manager.IsReady ? "硬件已连接" : (m_manager.IsOpen ? "端口已打开" : "未连接");
+            if (m_readyText != null) m_readyText.text = m_manager.IsReady ? "READY" : "未 READY";
+            if (m_statusText != null) m_statusText.text = "状态: " + m_manager.CurrentStatus;
+            if (m_commandText != null) m_commandText.text = "命令: " + m_manager.CurrentCommand;
+            if (m_errorText != null && !string.IsNullOrEmpty(m_manager.LastError)) m_errorText.text = "错误: " + m_manager.LastError;
+        }
+    }
+
+    /// <summary>
+    /// 左侧导航栏。
+    /// </summary>
+    public sealed class FaceModuleNavigationPanel : MonoBehaviour
+    {
+        private readonly List<Button> m_buttons = new List<Button>();
+        // 内部状态字段。
+        private FaceModuleMainPanel m_mainPanel;
+
+        /// <summary>
+        /// 初始化导航栏。
+        /// </summary>
+        public void Init(FaceModuleMainPanel mainPanel)
+        {
+            m_mainPanel = mainPanel;
+        }
+
+        /// <summary>
+        /// 添加页面导航按钮。
+        /// </summary>
+        public void AddNavigation(string pageName, string label, FaceModuleUiBuilder builder)
+        {
+            var button = builder.Button(transform, label, () => m_mainPanel.ShowPage(pageName));
+            m_buttons.Add(button);
+        }
+    }
+
+    /// <summary>
+    /// 底部日志面板。
+    /// </summary>
+    public sealed class FaceModuleLogPanel : MonoBehaviour
+    {
+        // Inspector 绑定字段。
+        [SerializeField] private Text m_logText;
+        // Inspector 绑定字段。
+        [SerializeField] private ScrollRect m_scrollRect;
+        // Inspector 绑定字段。
+        [SerializeField] private Toggle m_autoScrollToggle;
+        private readonly List<string> m_lines = new List<string>();
+        private FaceModuleManager m_manager;                  // 当前绑定的 Manager。
+        private Action<FaceResultCode, string> m_errorHandler; // Manager 错误事件回调。
+        private Action m_readyHandler;                         // Manager READY 事件回调。
+
+        /// <summary>
+        /// 绑定日志 UI。
+        /// </summary>
+        public void Bind(Text logText, ScrollRect scrollRect, Toggle autoScrollToggle)
+        {
+            m_logText = logText;
+            m_scrollRect = scrollRect;
+            m_autoScrollToggle = autoScrollToggle;
+        }
+
+        /// <summary>
+        /// 连接 Manager 日志事件。
+        /// </summary>
+        public void Init(FaceModuleManager manager)
+        {
+            UnbindManagerEvents();
+            m_manager = manager;
+            if (manager == null)
+            {
+                return;
+            }
+
+            m_errorHandler = (_, message) => Error(message);
+            m_readyHandler = () => Info("模组 READY");
+            manager.OnRawLog += Raw;
+            manager.OnError += m_errorHandler;
+            manager.OnReady += m_readyHandler;
+        }
+
+        private void OnDestroy()
+        {
+            UnbindManagerEvents();
+        }
+
+        /// <summary>
+        /// 添加业务日志。
+        /// </summary>
+        public void Info(string message)
+        {
+            Append("INFO", message);
+        }
+
+        /// <summary>
+        /// 添加错误日志。
+        /// </summary>
+        public void Error(string message)
+        {
+            Append("ERROR", message);
+        }
+
+        /// <summary>
+        /// 添加原始收发日志。
+        /// </summary>
+        public void Raw(string message)
+        {
+            var tag = message.StartsWith("TX", StringComparison.OrdinalIgnoreCase) ? "TX" : "RX";
+            var body = message.Length > 3 ? message.Substring(3) : message;
+            Append(tag, body);
+        }
+
+        /// <summary>
+        /// 清空日志。
+        /// </summary>
+        public void Clear()
+        {
+            m_lines.Clear();
+            RefreshText();
+        }
+
+        /// <summary>
+        /// 保存日志到本地。
+        /// </summary>
+        public void Save()
+        {
+            var dir = Path.Combine(Application.persistentDataPath, "FaceModuleLogs");
+            Directory.CreateDirectory(dir);
+            File.WriteAllLines(Path.Combine(dir, DateTime.Now.ToString("yyyyMMdd_HHmmss") + ".log"), m_lines);
+            Info("日志已保存: " + dir);
+        }
+
+        /// <summary>
+        /// 执行 Append 方法。
+        /// </summary>
+        private void Append(string tag, string message)
+        {
+            m_lines.Add($"[{DateTime.Now:HH:mm:ss.fff}][{tag}] {message}");
+            if (m_lines.Count > 1000)
+            {
+                m_lines.RemoveAt(0);
+            }
+
+            RefreshText();
+        }
+
+        /// <summary>
+        /// 执行 RefreshText 方法。
+        /// </summary>
+        private void RefreshText()
+        {
+            if (m_logText != null)
+            {
+                m_logText.text = string.Join("\n", m_lines);
+            }
+
+            if (m_scrollRect != null && (m_autoScrollToggle == null || m_autoScrollToggle.isOn))
+            {
+                Canvas.ForceUpdateCanvases();
+                m_scrollRect.verticalNormalizedPosition = 0f;
+            }
+        }
+
+        private void UnbindManagerEvents()
+        {
+            if (m_manager == null)
+            {
+                return;
+            }
+
+            m_manager.OnRawLog -= Raw;
+            if (m_errorHandler != null)
+            {
+                m_manager.OnError -= m_errorHandler;
+            }
+
+            if (m_readyHandler != null)
+            {
+                m_manager.OnReady -= m_readyHandler;
+            }
+        }
+    }
+
+    /// <summary>
+    /// Loading / 进度提示。
+    /// </summary>
+    public sealed class FaceModuleLoadingView : MonoBehaviour
+    {
+        // Inspector 绑定字段。
+        [SerializeField] private Text m_messageText;
+        // Inspector 绑定字段。
+        [SerializeField] private Slider m_progressSlider;
+
+        /// <summary>
+        /// 绑定控件。
+        /// </summary>
+        public void Bind(Text messageText, Slider progressSlider)
+        {
+            m_messageText = messageText;
+            m_progressSlider = progressSlider;
+            Hide();
+        }
+
+        /// <summary>
+        /// 显示 Loading。
+        /// </summary>
+        public void Show(string message)
+        {
+            gameObject.SetActive(true);
+            if (m_messageText != null) m_messageText.text = message;
+        }
+
+        /// <summary>
+        /// 设置进度。
+        /// </summary>
+        public void SetProgress(float value)
+        {
+            if (m_progressSlider != null) m_progressSlider.value = Mathf.Clamp01(value);
+        }
+
+        /// <summary>
+        /// 隐藏 Loading。
+        /// </summary>
+        public void Hide()
+        {
+            gameObject.SetActive(false);
+        }
+    }
+
+    /// <summary>
+    /// 二次确认弹窗。
+    /// </summary>
+    public sealed class FaceModuleConfirmDialog : MonoBehaviour
+    {
+        // Inspector 绑定字段。
+        [SerializeField] private Text m_messageText;
+        // Inspector 绑定字段。
+        [SerializeField] private Button m_confirmButton;
+        // Inspector 绑定字段。
+        [SerializeField] private Button m_cancelButton;
+        // 内部状态字段。
+        private Action m_onConfirm;
+
+        /// <summary>
+        /// 绑定控件。
+        /// </summary>
+        public void Bind(Text messageText, Button confirmButton, Button cancelButton)
+        {
+            m_messageText = messageText;
+            m_confirmButton = confirmButton;
+            m_cancelButton = cancelButton;
+            m_confirmButton.onClick.AddListener(Confirm);
+            m_cancelButton.onClick.AddListener(Hide);
+            Hide();
+        }
+
+        /// <summary>
+        /// 显示确认框。
+        /// </summary>
+        public void Show(string message, Action onConfirm)
+        {
+            m_onConfirm = onConfirm;
+            if (m_messageText != null) m_messageText.text = message;
+            gameObject.SetActive(true);
+        }
+
+        /// <summary>
+        /// 隐藏确认框。
+        /// </summary>
+        public void Hide()
+        {
+            gameObject.SetActive(false);
+        }
+
+        /// <summary>
+        /// 执行 Confirm 方法。
+        /// </summary>
+        private void Confirm()
+        {
+            Hide();
+            m_onConfirm?.Invoke();
+        }
+    }
+
+    /// <summary>
+    /// 运行时 UI 构建辅助器。
+    /// </summary>
+    public sealed class FaceModuleUiBuilder
+    {
+        // 内部状态字段。
+        private readonly Font m_font;
+
+        /// <summary>
+        /// 执行 FaceModuleUiBuilder 方法。
+        /// </summary>
+        public FaceModuleUiBuilder(Font font)
+        {
+            m_font = font ?? Resources.GetBuiltinResource<Font>("Arial.ttf");
+        }
+
+        /// <summary>
+        /// 执行 Text 方法。
+        /// </summary>
+        public Text Text(Transform parent, string text, int size = 22, TextAnchor anchor = TextAnchor.MiddleLeft)
+        {
+            var go = Create("Text", parent);
+            var component = go.AddComponent<Text>();
+            component.font = m_font;
+            component.text = text;
+            component.fontSize = size;
+            component.color = new Color(0.08f, 0.09f, 0.1f);
+            component.alignment = anchor;
+            component.horizontalOverflow = HorizontalWrapMode.Wrap;
+            component.verticalOverflow = VerticalWrapMode.Overflow;
+            return component;
+        }
+
+        /// <summary>
+        /// 执行 Button 方法。
+        /// </summary>
+        public Button Button(Transform parent, string label, UnityEngine.Events.UnityAction onClick)
+        {
+            var go = Create("Button_" + label, parent);
+            var image = go.AddComponent<Image>();
+            image.color = new Color(0.13f, 0.28f, 0.47f);
+            var button = go.AddComponent<Button>();
+            button.targetGraphic = image;
+            button.onClick.AddListener(onClick);
+            var text = Text(go.transform, label, 20, TextAnchor.MiddleCenter);
+            text.color = Color.white;
+            Stretch(text.rectTransform);
+            var layout = go.AddComponent<LayoutElement>();
+            layout.preferredHeight = 42;
+            layout.minHeight = 36;
+            return button;
+        }
+
+        /// <summary>
+        /// 执行 Input 方法。
+        /// </summary>
+        public InputField Input(Transform parent, string placeholder, string value = "")
+        {
+            var go = Create("Input_" + placeholder, parent);
+            var image = go.AddComponent<Image>();
+            image.color = Color.white;
+            var input = go.AddComponent<InputField>();
+            var text = Text(go.transform, value, 20);
+            text.color = Color.black;
+            Stretch(text.rectTransform, 10, 10, 4, 4);
+            input.textComponent = text;
+            var place = Text(go.transform, placeholder, 20);
+            place.color = new Color(0.45f, 0.48f, 0.52f);
+            Stretch(place.rectTransform, 10, 10, 4, 4);
+            input.placeholder = place;
+            var layout = go.AddComponent<LayoutElement>();
+            layout.preferredHeight = 38;
+            return input;
+        }
+
+        /// <summary>
+        /// 执行 Toggle 方法。
+        /// </summary>
+        public Toggle Toggle(Transform parent, string label, bool value)
+        {
+            var go = Create("Toggle_" + label, parent);
+            var toggle = go.AddComponent<Toggle>();
+            var row = go.AddComponent<HorizontalLayoutGroup>();
+            row.spacing = 8;
+            row.childControlWidth = false;
+            row.childControlHeight = true;
+            var box = Create("CheckmarkBox", go.transform);
+            var boxImage = box.AddComponent<Image>();
+            boxImage.color = Color.white;
+            var boxLayout = box.AddComponent<LayoutElement>();
+            boxLayout.preferredWidth = 28;
+            boxLayout.preferredHeight = 28;
+            var mark = Create("Checkmark", box.transform);
+            var markImage = mark.AddComponent<Image>();
+            markImage.color = new Color(0.1f, 0.5f, 0.25f);
+            Stretch(markImage.rectTransform, 5, 5, 5, 5);
+            toggle.targetGraphic = boxImage;
+            toggle.graphic = markImage;
+            toggle.isOn = value;
+            Text(go.transform, label, 20);
+            return toggle;
+        }
+
+        /// <summary>
+        /// 执行 Dropdown 方法。
+        /// </summary>
+        public Dropdown Dropdown(Transform parent, IList<string> options)
+        {
+            var go = Create("Dropdown", parent);
+            var image = go.AddComponent<Image>();
+            image.color = Color.white;
+            var dropdown = go.AddComponent<Dropdown>();
+            dropdown.captionText = Text(go.transform, options.Count > 0 ? options[0] : string.Empty, 20);
+            Stretch(dropdown.captionText.rectTransform, 10, 32, 4, 4);
+            BuildDropdownTemplate(dropdown, go.transform);
+            dropdown.options.Clear();
+            foreach (var option in options)
+            {
+                dropdown.options.Add(new Dropdown.OptionData(option));
+            }
+
+            var layout = go.AddComponent<LayoutElement>();
+            layout.preferredHeight = 38;
+            return dropdown;
+        }
+
+        private void BuildDropdownTemplate(Dropdown dropdown, Transform parent)
+        {
+            var template = Create("Template", parent);
+            template.SetActive(false);
+            var templateImage = template.AddComponent<Image>();
+            templateImage.color = Color.white;
+            var templateRect = template.GetComponent<RectTransform>();
+            templateRect.anchorMin = new Vector2(0, 0);
+            templateRect.anchorMax = new Vector2(1, 0);
+            templateRect.pivot = new Vector2(0.5f, 1);
+            templateRect.anchoredPosition = new Vector2(0, 2);
+            templateRect.sizeDelta = new Vector2(0, 180);
+
+            var scroll = template.AddComponent<ScrollRect>();
+            scroll.horizontal = false;
+
+            var viewport = Create("Viewport", template.transform);
+            viewport.AddComponent<Image>().color = Color.white;
+            var mask = viewport.AddComponent<Mask>();
+            mask.showMaskGraphic = false;
+            Stretch(viewport.GetComponent<RectTransform>());
+
+            var content = Create("Content", viewport.transform);
+            var contentRect = content.GetComponent<RectTransform>();
+            contentRect.anchorMin = new Vector2(0, 1);
+            contentRect.anchorMax = new Vector2(1, 1);
+            contentRect.pivot = new Vector2(0.5f, 1);
+            contentRect.anchoredPosition = Vector2.zero;
+            contentRect.sizeDelta = new Vector2(0, 0);
+            var contentLayout = content.AddComponent<VerticalLayoutGroup>();
+            contentLayout.childControlWidth = true;
+            contentLayout.childControlHeight = true;
+            contentLayout.childForceExpandWidth = true;
+            contentLayout.childForceExpandHeight = false;
+            content.AddComponent<ContentSizeFitter>().verticalFit = ContentSizeFitter.FitMode.PreferredSize;
+
+            var item = Create("Item", content.transform);
+            var itemToggle = item.AddComponent<Toggle>();
+            item.AddComponent<Image>().color = new Color(0.96f, 0.97f, 0.98f);
+            item.AddComponent<LayoutElement>().preferredHeight = 32;
+
+            var checkmark = Create("Item Checkmark", item.transform).AddComponent<Image>();
+            checkmark.color = new Color(0.1f, 0.5f, 0.25f);
+            var checkmarkRect = checkmark.rectTransform;
+            checkmarkRect.anchorMin = new Vector2(0, 0.5f);
+            checkmarkRect.anchorMax = new Vector2(0, 0.5f);
+            checkmarkRect.sizeDelta = new Vector2(18, 18);
+            checkmarkRect.anchoredPosition = new Vector2(14, 0);
+
+            var itemLabel = Text(item.transform, "Option", 18);
+            Stretch(itemLabel.rectTransform, 32, 8, 4, 4);
+            itemToggle.targetGraphic = item.GetComponent<Image>();
+            itemToggle.graphic = checkmark;
+
+            scroll.viewport = viewport.GetComponent<RectTransform>();
+            scroll.content = contentRect;
+            dropdown.template = templateRect;
+            dropdown.itemText = itemLabel;
+        }
+
+        /// <summary>
+        /// 执行 Slider 方法。
+        /// </summary>
+        public Slider Slider(Transform parent)
+        {
+            var go = Create("Slider", parent);
+            var slider = go.AddComponent<Slider>();
+            slider.minValue = 0;
+            slider.maxValue = 1;
+            var bg = Create("Background", go.transform).AddComponent<Image>();
+            bg.color = new Color(0.8f, 0.82f, 0.85f);
+            Stretch(bg.rectTransform, 0, 0, 10, 10);
+            var fill = Create("Fill", go.transform).AddComponent<Image>();
+            fill.color = new Color(0.1f, 0.55f, 0.35f);
+            Stretch(fill.rectTransform, 0, 0, 10, 10);
+            slider.fillRect = fill.rectTransform;
+            var layout = go.AddComponent<LayoutElement>();
+            layout.preferredHeight = 28;
+            return slider;
+        }
+
+        /// <summary>
+        /// 执行 Section 方法。
+        /// </summary>
+        public GameObject Section(Transform parent, string title)
+        {
+            var section = Create("Section_" + title, parent);
+            var layout = section.AddComponent<VerticalLayoutGroup>();
+            layout.padding = new RectOffset(12, 12, 10, 10);
+            layout.spacing = 8;
+            layout.childControlWidth = true;
+            layout.childForceExpandWidth = true;
+            section.AddComponent<Image>().color = new Color(0.94f, 0.96f, 0.98f);
+            Text(section.transform, title, 24);
+            return section;
+        }
+
+        /// <summary>
+        /// 执行 Row 方法。
+        /// </summary>
+        public GameObject Row(Transform parent)
+        {
+            var row = Create("Row", parent);
+            var layout = row.AddComponent<HorizontalLayoutGroup>();
+            layout.spacing = 8;
+            layout.childControlHeight = true;
+            layout.childControlWidth = true;
+            return row;
+        }
+
+        /// <summary>
+        /// 执行 ScrollView 方法。
+        /// </summary>
+        public ScrollRect ScrollView(Transform parent, out Text contentText)
+        {
+            var root = Create("ScrollView", parent);
+            root.AddComponent<Image>().color = Color.white;
+            var viewport = Create("Viewport", root.transform);
+            var mask = viewport.AddComponent<Mask>();
+            mask.showMaskGraphic = false;
+            viewport.AddComponent<Image>().color = Color.white;
+            Stretch(viewport.GetComponent<RectTransform>());
+            var content = Create("Content", viewport.transform);
+            var contentRect = content.GetComponent<RectTransform>();
+            contentRect.anchorMin = new Vector2(0, 1);
+            contentRect.anchorMax = new Vector2(1, 1);
+            contentRect.pivot = new Vector2(0.5f, 1);
+            contentText = Text(content.transform, string.Empty, 18, TextAnchor.UpperLeft);
+            contentText.rectTransform.sizeDelta = new Vector2(0, 800);
+            Stretch(contentText.rectTransform);
+            var scroll = root.AddComponent<ScrollRect>();
+            scroll.viewport = viewport.GetComponent<RectTransform>();
+            scroll.content = contentRect;
+            scroll.horizontal = false;
+            var layout = root.AddComponent<LayoutElement>();
+            layout.preferredHeight = 180;
+            return scroll;
+        }
+
+        /// <summary>
+        /// 执行 Create 方法。
+        /// </summary>
+        public static GameObject Create(string name, Transform parent)
+        {
+            var go = new GameObject(name, typeof(RectTransform));
+            go.transform.SetParent(parent, false);
+            return go;
+        }
+
+        /// <summary>
+        /// 执行 Stretch 方法。
+        /// </summary>
+        public static void Stretch(RectTransform rect, float left = 0, float right = 0, float top = 0, float bottom = 0)
+        {
+            rect.anchorMin = Vector2.zero;
+            rect.anchorMax = Vector2.one;
+            rect.offsetMin = new Vector2(left, bottom);
+            rect.offsetMax = new Vector2(-right, -top);
+        }
+    }
+
+    /// <summary>
+    /// 主面板，负责页面初始化和切换。
+    /// </summary>
+    public sealed class FaceModuleMainPanel : MonoBehaviour
+    {
+        // Inspector 绑定字段。
+        [SerializeField] private FaceModuleManager m_manager;
+        // Inspector 绑定字段。
+        [SerializeField] private FaceModuleStatusBar m_statusBar;
+        // Inspector 绑定字段。
+        [SerializeField] private FaceModuleNavigationPanel m_navigationPanel;
+        // Inspector 绑定字段。
+        [SerializeField] private FaceModuleLogPanel m_logPanel;
+        // Inspector 绑定字段。
+        [SerializeField] private FaceModuleLoadingView m_loadingView;
+        private readonly Dictionary<string, FaceModulePageBase> m_pages = new Dictionary<string, FaceModulePageBase>();
+
+        /// <summary>
+        /// 初始化主面板。
+        /// </summary>
+        public void Init(FaceModuleManager manager)
+        {
+            m_manager = manager;
+            m_statusBar?.Init(m_manager);
+            m_logPanel?.Init(m_manager);
+            m_navigationPanel?.Init(this);
+
+            foreach (var pair in m_pages)
+            {
+                pair.Value.Init(m_manager, m_logPanel, m_loadingView);
+                pair.Value.Hide();
+            }
+        }
+
+        /// <summary>
+        /// 绑定公共组件。
+        /// </summary>
+        public void Bind(FaceModuleStatusBar statusBar, FaceModuleNavigationPanel navigationPanel, FaceModuleLogPanel logPanel, FaceModuleLoadingView loadingView)
+        {
+            m_statusBar = statusBar;
+            m_navigationPanel = navigationPanel;
+            m_logPanel = logPanel;
+            m_loadingView = loadingView;
+        }
+
+        /// <summary>
+        /// 注册页面。
+        /// </summary>
+        public void RegisterPage(string pageName, string label, FaceModulePageBase page, FaceModuleUiBuilder builder)
+        {
+            m_pages[pageName] = page;
+            m_navigationPanel.AddNavigation(pageName, label, builder);
+        }
+
+        /// <summary>
+        /// 显示指定页面。
+        /// </summary>
+        public void ShowPage(string pageName)
+        {
+            foreach (var pair in m_pages)
+            {
+                if (pair.Key == pageName)
+                {
+                    pair.Value.Show();
+                }
+                else
+                {
+                    pair.Value.Hide();
+                }
+            }
+
+            m_logPanel?.Info("切换页面: " + pageName);
+        }
+    }
+
+}
diff --git a/Samples~/SI-M1 Face Demo/UI/Pages/FaceModuleAdvancedPages.cs b/Samples~/SI-M1 Face Demo/UI/Pages/FaceModuleAdvancedPages.cs
new file mode 100644
index 0000000..153cca1
--- /dev/null
+++ b/Samples~/SI-M1 Face Demo/UI/Pages/FaceModuleAdvancedPages.cs	
@@ -0,0 +1,511 @@
+using System;
+using System.IO;
+using Aisu.SIM1.Face.Models;
+using Aisu.SIM1.Face.Protocol;
+using Aisu.SIM1.Face.UI.Common;
+using UnityEngine;
+using UnityEngine.UI;
+
+namespace Aisu.SIM1.Face.UI.Pages
+{
+    public sealed class FacePhotoEnrollPage : FaceModulePageBase
+    {
+        // 内部状态字段。
+        private InputField m_filePathInput;
+        // 内部状态字段。
+        private Text m_fileSizeText;
+        // 内部状态字段。
+        private Dropdown m_bioTypeDropdown;
+        // 内部状态字段。
+        private InputField m_userNameInput;
+        // 内部状态字段。
+        private Toggle m_duplicateToggle;
+        // 内部状态字段。
+        private Toggle m_specifyUserIdToggle;
+        // 内部状态字段。
+        private InputField m_userIdInput;
+        // 内部状态字段。
+        private Slider m_progress;
+        // 内部状态字段。
+        private Text m_seqText;
+        // 内部状态字段。
+        private Text m_userIdText;
+
+        public override void Build(FaceModuleUiBuilder builder)
+        {
+            builder.Text(transform, "照片 / 特征注册", 30);
+            m_filePathInput = builder.Input(transform, "文件路径", string.Empty);
+            var row = builder.Row(transform);
+            builder.Button(row.transform, "刷新文件信息", RefreshFileInfo);
+            builder.Button(row.transform, "使用 0xF7 注册", EnrollWithPhoto);
+            builder.Button(row.transform, "使用 0xD7 指定 ID 注册", EnrollWithPhotoAndId);
+            m_fileSizeText = builder.Text(transform, "文件大小: -");
+            m_bioTypeDropdown = builder.Dropdown(transform, new[] { "普通照片", "加密照片", "普通特征码", "压缩特征码" });
+            m_userNameInput = builder.Input(transform, "用户姓名", "User");
+            m_duplicateToggle = builder.Toggle(transform, "启用查重", true);
+            m_specifyUserIdToggle = builder.Toggle(transform, "指定 UserID", false);
+            m_userIdInput = builder.Input(transform, "指定 UserID", "1");
+            m_progress = builder.Slider(transform);
+            m_seqText = builder.Text(transform, "当前 Seq: -");
+            m_userIdText = builder.Text(transform, "注册 UserID: -");
+            m_resultText = builder.Text(transform, "注册结果: -");
+        }
+
+        /// <summary>刷新文件大小显示。</summary>
+        /// <summary>
+        /// 执行 RefreshFileInfo 方法。
+        /// </summary>
+        public void RefreshFileInfo()
+        {
+            var path = ReadText(m_filePathInput);
+            m_fileSizeText.text = File.Exists(path) ? "文件大小: " + new FileInfo(path).Length + " bytes" : "文件不存在";
+        }
+
+        /// <summary>使用 0xF7 注册。</summary>
+        /// <summary>
+        /// 执行 EnrollWithPhoto 方法。
+        /// </summary>
+        public void EnrollWithPhoto()
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireReady()) return;
+                var bytes = ReadValidFile();
+                var result = await m_manager.Images.EnrollWithPhotoAsync(bytes, (BioType)m_bioTypeDropdown.value, ReadText(m_userNameInput), m_duplicateToggle.isOn, OnProgress);
+                ShowEnrollResult(result);
+            });
+        }
+
+        /// <summary>使用 0xD7 指定 ID 注册。</summary>
+        /// <summary>
+        /// 执行 EnrollWithPhotoAndId 方法。
+        /// </summary>
+        public void EnrollWithPhotoAndId()
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireReady()) return;
+                var bytes = ReadValidFile();
+                var userId = ReadInt(m_userIdInput, 0);
+                if (!m_specifyUserIdToggle.isOn)
+                {
+                    SetResult("请先启用指定 UserID");
+                    return;
+                }
+
+                var result = await m_manager.Images.EnrollWithPhotoAndIdAsync(userId, bytes, (BioType)m_bioTypeDropdown.value, ReadText(m_userNameInput), m_duplicateToggle.isOn, OnProgress);
+                ShowEnrollResult(result);
+            });
+        }
+
+        /// <summary>
+        /// 执行 ReadValidFile 方法。
+        /// </summary>
+        private byte[] ReadValidFile()
+        {
+            var path = ReadText(m_filePathInput);
+            if (!File.Exists(path)) throw new FileNotFoundException("文件不存在", path);
+            var bytes = File.ReadAllBytes(path);
+            if (bytes.Length == 0) throw new InvalidOperationException("文件为空");
+            if (bytes.Length > 8 * 1024 * 1024) throw new InvalidOperationException("文件过大，建议小于 8MB");
+            return bytes;
+        }
+
+        /// <summary>
+        /// 执行 OnProgress 方法。
+        /// </summary>
+        private void OnProgress(int sent, int total)
+        {
+            m_progress.value = total > 0 ? (float)sent / total : 0;
+            m_seqText.text = "当前 Seq: " + Mathf.CeilToInt((float)sent / FaceModuleConstants.PhotoRegisterMtu);
+        }
+
+        /// <summary>
+        /// 执行 ShowEnrollResult 方法。
+        /// </summary>
+        private void ShowEnrollResult(FaceEnrollResult result)
+        {
+            m_userIdText.text = "注册 UserID: " + result.UserId;
+            SetResult(result.Success ? "注册成功" : FaceProtocolEncoding.ResultMessage(result.ResultCode));
+        }
+    }
+
+    public sealed class FaceFeaturePage : FaceModulePageBase
+    {
+        // 内部状态字段。
+        private InputField m_userIdInput;
+        // 内部状态字段。
+        private Dropdown m_featureTypeDropdown;
+        // 内部状态字段。
+        private InputField m_filePathInput;
+        // 内部状态字段。
+        private InputField m_userNameInput;
+        // 内部状态字段。
+        private Slider m_progress;
+        // 内部状态字段。
+        private Text m_seqText;
+        // 内部状态字段。
+        private Text m_lengthText;
+        // 内部状态字段。
+        private byte[] m_lastFeature;
+
+        public override void Build(FaceModuleUiBuilder builder)
+        {
+            builder.Text(transform, "特征管理", 30);
+            m_userIdInput = builder.Input(transform, "UserID", "1");
+            m_featureTypeDropdown = builder.Dropdown(transform, new[] { "彩色人脸模板", "彩色 + 红外人脸模板", "掌纹掌静脉模板" });
+            m_filePathInput = builder.Input(transform, "特征文件路径", string.Empty);
+            m_userNameInput = builder.Input(transform, "用户姓名", "FeatureUser");
+            var row = builder.Row(transform);
+            builder.Button(row.transform, "读取特征", ReadFeature);
+            builder.Button(row.transform, "保存特征文件", SaveFeature);
+            builder.Button(row.transform, "写入特征", WriteFeature);
+            m_progress = builder.Slider(transform);
+            m_seqText = builder.Text(transform, "当前 Seq: -");
+            m_lengthText = builder.Text(transform, "特征长度: -");
+            m_resultText = builder.Text(transform, "操作结果: -");
+        }
+
+        /// <summary>读取特征。</summary>
+        /// <summary>
+        /// 执行 ReadFeature 方法。
+        /// </summary>
+        public void ReadFeature()
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireReady()) return;
+                m_lastFeature = await m_manager.Features.ReadFeatureAsync(ReadInt(m_userIdInput, 0), FeatureTypeValue());
+                m_lengthText.text = "特征长度: " + (m_lastFeature == null ? 0 : m_lastFeature.Length);
+                SetResult(m_lastFeature.Length > 0 ? "特征读取完成" : "读取命令已完成，未收到特征数据");
+            });
+        }
+
+        /// <summary>保存特征文件。</summary>
+        /// <summary>
+        /// 执行 SaveFeature 方法。
+        /// </summary>
+        public void SaveFeature()
+        {
+            if (m_lastFeature == null || m_lastFeature.Length == 0)
+            {
+                SetResult("没有可保存的特征数据");
+                return;
+            }
+
+            var dir = Path.Combine(Application.persistentDataPath, "FaceModuleFeatures");
+            Directory.CreateDirectory(dir);
+            var name = $"{DateTime.Now:yyyyMMdd_HHmmss}_User_{ReadInt(m_userIdInput, 0)}_Feature_{FeatureTypeValue()}.bin";
+            File.WriteAllBytes(Path.Combine(dir, name), m_lastFeature);
+            SetResult("特征已保存: " + dir);
+        }
+
+        /// <summary>写入特征。</summary>
+        /// <summary>
+        /// 执行 WriteFeature 方法。
+        /// </summary>
+        public void WriteFeature()
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireReady()) return;
+                var path = ReadText(m_filePathInput);
+                if (!File.Exists(path)) throw new FileNotFoundException("特征文件不存在", path);
+                var bytes = File.ReadAllBytes(path);
+                var result = await m_manager.Features.WriteFeatureAsync(bytes, FeatureTypeValue(), ReadText(m_userNameInput), OnProgress);
+                SetResult(result.Success ? "写入成功 UserID=" + result.UserId : FaceProtocolEncoding.ResultMessage(result.ResultCode));
+            });
+        }
+
+        /// <summary>
+        /// 执行 FeatureTypeValue 方法。
+        /// </summary>
+        private FeatureType FeatureTypeValue()
+        {
+            return (FeatureType)(m_featureTypeDropdown.value + 1);
+        }
+
+        /// <summary>
+        /// 执行 OnProgress 方法。
+        /// </summary>
+        private void OnProgress(int sent, int total)
+        {
+            m_progress.value = total > 0 ? (float)sent / total : 0;
+            m_seqText.text = "当前 Seq: " + Mathf.CeilToInt((float)sent / FaceModuleConstants.FeaturePacketSize);
+            m_lengthText.text = "特征长度: " + total;
+        }
+    }
+
+    public sealed class FaceUvcSettingsPage : FaceModulePageBase
+    {
+        // 内部状态字段。
+        private Dropdown m_usbTypeDropdown;
+        // 内部状态字段。
+        private InputField m_bitrateInput;
+        // 内部状态字段。
+        private InputField m_qualityInput;
+        // 内部状态字段。
+        private Toggle m_mirrorToggle;
+        // 内部状态字段。
+        private Toggle m_rotateToggle;
+        // 内部状态字段。
+        private Toggle m_faceBoxToggle;
+
+        public override void Build(FaceModuleUiBuilder builder)
+        {
+            builder.Text(transform, "UVC 设置", 30);
+            m_usbTypeDropdown = builder.Dropdown(transform, new[] { "USB1.1 Bulk 0x11", "USB2.0 Bulk 0x20", "USB1.1 ISOC 0x91", "USB2.0 ISOC 0xA0" });
+            m_bitrateInput = builder.Input(transform, "UVC 码率 Mbps", "8");
+            m_qualityInput = builder.Input(transform, "MJPG 质量 10-100", "80");
+            m_mirrorToggle = builder.Toggle(transform, "镜像", false);
+            m_rotateToggle = builder.Toggle(transform, "180 度倒转", false);
+            m_faceBoxToggle = builder.Toggle(transform, "显示人脸框", true);
+            var row = builder.Row(transform);
+            builder.Button(row.transform, "读取 UVC 参数", ReadUvc);
+            builder.Button(row.transform, "设置 UVC 参数", SetUvc);
+            builder.Button(row.transform, "设置人脸框显示", SetFaceBox);
+            m_resultText = builder.Text(transform, "操作结果: -");
+        }
+
+        /// <summary>
+        /// 执行 ReadUvc 方法。
+        /// </summary>
+        public void ReadUvc()
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireReady()) return;
+                var p = await m_manager.Uvc.ReadUsbUvcParametersAsync();
+                m_bitrateInput.text = p.BitrateMbps.ToString();
+                m_qualityInput.text = p.MjpgQuality.ToString();
+                m_mirrorToggle.isOn = p.Mirror;
+                m_rotateToggle.isOn = p.Rotate180;
+                SetResult("UVC 参数读取成功");
+            });
+        }
+
+        /// <summary>
+        /// 执行 SetUvc 方法。
+        /// </summary>
+        public void SetUvc()
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireReady()) return;
+                var bitrate = ReadByte(m_bitrateInput, 8);
+                var quality = Mathf.Clamp(ReadByte(m_qualityInput, 80), 10, 100);
+                await m_manager.Uvc.SetUsbUvcParametersAsync(new UsbUvcParameters
+                {
+                    UsbType = UsbTypeValue(),
+                    BitrateMbps = bitrate,
+                    MjpgQuality = (byte)quality,
+                    Mirror = m_mirrorToggle.isOn,
+                    Rotate180 = m_rotateToggle.isOn
+                });
+                SetResult("UVC 参数设置成功");
+            });
+        }
+
+        /// <summary>
+        /// 执行 SetFaceBox 方法。
+        /// </summary>
+        public void SetFaceBox()
+        {
+            RunAsync(async () => { if (RequireReady()) { await m_manager.Uvc.SetFaceLocationDisplayAsync(m_faceBoxToggle.isOn); SetResult("人脸框显示设置成功"); } });
+        }
+
+        /// <summary>
+        /// 执行 UsbTypeValue 方法。
+        /// </summary>
+        private byte UsbTypeValue()
+        {
+            switch (m_usbTypeDropdown.value)
+            {
+                case 0: return 0x11;
+                case 1: return 0x20;
+                case 2: return 0x91;
+                default: return 0xA0;
+            }
+        }
+    }
+
+    public sealed class FaceAdvancedSettingsPage : FaceModulePageBase
+    {
+        // 内部状态字段。
+        private Dropdown m_rgbDropdown;
+        // 内部状态字段。
+        private Toggle m_duplicateToggle;
+        // 内部状态字段。
+        private Toggle m_demoToggle;
+
+        public override void Build(FaceModuleUiBuilder builder)
+        {
+            builder.Text(transform, "高级设置", 30);
+            m_rgbDropdown = builder.Dropdown(transform, new[] { "0", "1", "2 默认", "3", "4" });
+            m_rgbDropdown.value = 2;
+            m_duplicateToggle = builder.Toggle(transform, "启用查重", true);
+            m_demoToggle = builder.Toggle(transform, "Demo Mode: 所有人可解锁，但仍做活体检测", false);
+            var row = builder.Row(transform);
+            builder.Button(row.transform, "设置 RGB_LEVEL", SetRgb);
+            builder.Button(row.transform, "设置查重", SetDuplicate);
+            builder.Button(row.transform, "读取查重状态", ReadDuplicate);
+            builder.Button(row.transform, "设置 Demo Mode", SetDemoMode);
+            m_resultText = builder.Text(transform, "操作结果: -");
+        }
+
+        /// <summary>
+        /// 执行 SetRgb 方法。
+        /// </summary>
+        public void SetRgb()
+        {
+            RunAsync(async () => { if (RequireReady()) { await m_manager.Uvc.SetRgbLevelAsync((byte)m_rgbDropdown.value); SetResult("RGB_LEVEL 设置成功"); } });
+        }
+
+        /// <summary>
+        /// 执行 SetDuplicate 方法。
+        /// </summary>
+        public void SetDuplicate()
+        {
+            RunAsync(async () => { if (RequireReady()) { await m_manager.Uvc.SetDuplicateCheckAsync(m_duplicateToggle.isOn); SetResult("查重设置成功"); } });
+        }
+
+        /// <summary>
+        /// 执行 ReadDuplicate 方法。
+        /// </summary>
+        public void ReadDuplicate()
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireReady()) return;
+                m_duplicateToggle.isOn = await m_manager.Uvc.ReadDuplicateCheckAsync();
+                SetResult("查重状态已读取");
+            });
+        }
+
+        /// <summary>
+        /// 执行 SetDemoMode 方法。
+        /// </summary>
+        public void SetDemoMode()
+        {
+            RunAsync(async () => { if (RequireReady()) { await m_manager.Basic.SetDemoModeAsync(m_demoToggle.isOn); SetResult("Demo Mode 设置成功"); } });
+        }
+    }
+
+    public sealed class FaceEncryptionPage : FaceModulePageBase
+    {
+        // 内部状态字段。
+        private InputField m_releaseKeyInput;
+        // 内部状态字段。
+        private InputField m_debugKeyInput;
+        // 内部状态字段。
+        private InputField m_seedInput;
+        // 内部状态字段。
+        private Text m_stateText;
+
+        public override void Build(FaceModuleUiBuilder builder)
+        {
+            builder.Text(transform, "加密通信", 30);
+            m_releaseKeyInput = builder.Input(transform, "Release Key 16 bytes Hex", string.Empty);
+            m_debugKeyInput = builder.Input(transform, "Debug Key 16 bytes Hex", string.Empty);
+            m_seedInput = builder.Input(transform, "Seed 4 bytes Hex", string.Empty);
+            var row = builder.Row(transform);
+            builder.Button(row.transform, "设置 Release Key", SetReleaseKey);
+            builder.Button(row.transform, "设置 Debug Key", SetDebugKey);
+            builder.Button(row.transform, "生成随机 Seed", GenerateSeed);
+            builder.Button(row.transform, "Init Encryption", InitEncryption);
+            m_stateText = builder.Text(transform, "当前加密状态: 加密算法未接入，当前仅完成协议入口");
+            m_resultText = builder.Text(transform, "操作结果: -");
+        }
+
+        /// <summary>
+        /// 执行 SetReleaseKey 方法。
+        /// </summary>
+        public void SetReleaseKey()
+        {
+            RunAsync(async () => { if (RequireReady()) { await m_manager.Encryption.SetReleaseEncryptionKeyAsync(ParseHex(m_releaseKeyInput.text, 16)); SetResult("Release Key 设置成功"); } });
+        }
+
+        /// <summary>
+        /// 执行 SetDebugKey 方法。
+        /// </summary>
+        public void SetDebugKey()
+        {
+            RunAsync(async () => { if (RequireReady()) { await m_manager.Encryption.SetDebugEncryptionKeyAsync(ParseHex(m_debugKeyInput.text, 16)); SetResult("Debug Key 设置成功"); } });
+        }
+
+        /// <summary>
+        /// 执行 GenerateSeed 方法。
+        /// </summary>
+        public void GenerateSeed()
+        {
+            var bytes = new byte[4];
+            using (var rng = new System.Security.Cryptography.RNGCryptoServiceProvider())
+            {
+                rng.GetBytes(bytes);
+            }
+
+            m_seedInput.text = BitConverter.ToString(bytes).Replace("-", " ");
+            SetResult("Seed 已生成");
+        }
+
+        /// <summary>
+        /// 执行 InitEncryption 方法。
+        /// </summary>
+        public void InitEncryption()
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireReady()) return;
+                await m_manager.Encryption.InitEncryptionAsync(ParseHex(m_seedInput.text, 4), 0);
+                m_stateText.text = "当前加密状态: 协议入口已调用，供应商算法仍未接入";
+                SetResult("Init Encryption 完成");
+            });
+        }
+
+        /// <summary>
+        /// 执行 ParseHex 方法。
+        /// </summary>
+        private static byte[] ParseHex(string text, int expectedLength)
+        {
+            var parts = text.Split(new[] { ' ', '-', '\t', '\r', '\n' }, StringSplitOptions.RemoveEmptyEntries);
+            if (parts.Length != expectedLength) throw new ArgumentException("需要 " + expectedLength + " bytes Hex");
+            var bytes = new byte[parts.Length];
+            for (var i = 0; i < parts.Length; i++) bytes[i] = Convert.ToByte(parts[i], 16);
+            return bytes;
+        }
+    }
+
+    public sealed class FaceFirmwarePage : FaceModulePageBase
+    {
+        // 内部状态字段。
+        private Slider m_progress;
+        // 内部状态字段。
+        private Text m_percentText;
+
+        public override void Build(FaceModuleUiBuilder builder)
+        {
+            builder.Text(transform, "固件升级", 30);
+            builder.Text(transform, "风险提示: 升级过程中不要断电；固件文件应由 U 盘或模组侧准备。", 22);
+            builder.Button(transform, "启动 U 盘升级", StartUpgrade);
+            m_progress = builder.Slider(transform);
+            m_percentText = builder.Text(transform, "当前进度: 0%");
+            m_resultText = builder.Text(transform, "操作结果: -");
+        }
+
+        /// <summary>启动 U 盘固件升级。</summary>
+        /// <summary>
+        /// 执行 StartUpgrade 方法。
+        /// </summary>
+        public void StartUpgrade()
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireReady()) return;
+                await m_manager.Basic.UpgradeFirmwareAsync();
+                m_progress.value = 1;
+                m_percentText.text = "当前进度: 已启动";
+                SetResult("固件升级命令已发送");
+            });
+        }
+    }
+}
diff --git a/Samples~/SI-M1 Face Demo/UI/Pages/FaceModulePages.cs b/Samples~/SI-M1 Face Demo/UI/Pages/FaceModulePages.cs
new file mode 100644
index 0000000..4530c3b
--- /dev/null
+++ b/Samples~/SI-M1 Face Demo/UI/Pages/FaceModulePages.cs	
@@ -0,0 +1,940 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Text;
+using Aisu.SIM1.Face.Core;
+using Aisu.SIM1.Face.Models;
+using Aisu.SIM1.Face.Protocol;
+using Aisu.SIM1.Face.UI.Common;
+using UnityEngine;
+using UnityEngine.UI;
+
+namespace Aisu.SIM1.Face.UI.Pages
+{
+    public sealed class FaceConnectPage : FaceModulePageBase
+    {
+        // Inspector 绑定字段。
+        [SerializeField] private InputField m_portInput;
+        // Inspector 绑定字段。
+        [SerializeField] private InputField m_baudRateInput;
+        // Inspector 绑定字段。
+        [SerializeField] private Toggle m_mockToggle;
+        // Inspector 绑定字段。
+        [SerializeField] private Text m_connectionText;
+        // Inspector 绑定字段。
+        [SerializeField] private Text m_readyText;
+        // Inspector 绑定字段。
+        [SerializeField] private Text m_moduleStatusText;
+        // Inspector 绑定字段。
+        [SerializeField] private Text m_licenseText;
+        // Inspector 绑定字段。
+        [SerializeField] private Text m_versionText;
+        // Inspector 绑定字段。
+        [SerializeField] private Text m_snText;
+
+        public override void Build(FaceModuleUiBuilder builder)
+        {
+            builder.Text(transform, "连接 / 基础状态", 30);
+            var form = builder.Section(transform, "通信配置");
+            m_portInput = builder.Input(form.transform, "串口号", "COM3");
+            m_baudRateInput = builder.Input(form.transform, "波特率", "115200");
+            m_mockToggle = builder.Toggle(form.transform, "Editor 使用 Mock 模式", IsEditorMockEnabled());
+            var row = builder.Row(form.transform);
+            builder.Button(row.transform, "打开连接", OpenConnection);
+            builder.Button(row.transform, "关闭连接", CloseConnection);
+            builder.Button(row.transform, "等待 READY", WaitReady);
+
+            var actions = builder.Section(transform, "基础命令");
+            var actionRow = builder.Row(actions.transform);
+            builder.Button(actionRow.transform, "RESET", ResetModule);
+            builder.Button(actionRow.transform, "GET STATUS", GetStatus);
+            builder.Button(actionRow.transform, "GET VERSION", GetVersion);
+            builder.Button(actionRow.transform, "GET SN", GetSn);
+
+            var info = builder.Section(transform, "状态");
+            m_connectionText = builder.Text(info.transform, "连接状态: 未连接");
+            m_readyText = builder.Text(info.transform, "READY: 未 READY");
+            m_moduleStatusText = builder.Text(info.transform, "模组状态: Invalid");
+            m_licenseText = builder.Text(info.transform, "授权: Mock 模式不需要授权");
+            m_versionText = builder.Text(info.transform, "版本: -");
+            m_snText = builder.Text(info.transform, "SN: -");
+            m_resultText = builder.Text(info.transform, "结果: -");
+        }
+
+        /// <summary>打开通信连接。</summary>
+        /// <summary>
+        /// 执行 OpenConnection 方法。
+        /// </summary>
+        public void OpenConnection()
+        {
+            RunAsync(async () =>
+            {
+                var useMock = m_mockToggle != null && m_mockToggle.isOn;
+                var baud = ReadInt(m_baudRateInput, 115200);
+                if (!useMock && !ValidateLicenseBeforeOpen())
+                {
+                    return;
+                }
+
+                m_manager.Configure(useMock, ReadText(m_portInput), baud);
+                m_manager.Open();
+
+                if (useMock)
+                {
+                    await m_manager.WaitReadyAsync();
+                    RefreshState();
+                    SetResult("Mock 模组已连接");
+                    return;
+                }
+
+                try
+                {
+                    await m_manager.WaitReadyAsync();
+                    RefreshState();
+                    SetResult("硬件连接成功，已收到 READY");
+                }
+                catch
+                {
+                    try
+                    {
+                        var status = await m_manager.ProbeReadyByStatusAsync();
+                        RefreshState();
+                        m_moduleStatusText.text = "模组状态: " + status;
+                        SetResult("硬件连接成功，未收到 READY NOTE，但 GET STATUS 探测成功");
+                    }
+                    catch
+                    {
+                        m_manager.Close();
+                        RefreshState();
+                        throw new TimeoutException("未收到硬件 READY，GET STATUS 也无响应，请检查串口、波特率、电源和接线");
+                    }
+                }
+            });
+        }
+
+        /// <summary>关闭通信连接。</summary>
+        /// <summary>
+        /// 执行 CloseConnection 方法。
+        /// </summary>
+        public void CloseConnection()
+        {
+            m_manager.Close();
+            RefreshState();
+            SetResult("连接已关闭");
+        }
+
+        /// <summary>等待 READY NOTE。</summary>
+        /// <summary>
+        /// 执行 WaitReady 方法。
+        /// </summary>
+        public void WaitReady()
+        {
+            RunAsync(async () =>
+            {
+                await m_manager.WaitReadyAsync();
+                RefreshState();
+                SetResult("模组 READY");
+            });
+        }
+
+        /// <summary>复位模组。</summary>
+        /// <summary>
+        /// 执行 ResetModule 方法。
+        /// </summary>
+        public void ResetModule()
+        {
+            RunAsync(async () => { if (RequireConnected()) { await m_manager.Basic.ResetAsync(); SetResult("RESET 成功"); } });
+        }
+
+        /// <summary>获取模组状态。</summary>
+        /// <summary>
+        /// 执行 GetStatus 方法。
+        /// </summary>
+        public void GetStatus()
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireConnected()) return;
+                var status = await m_manager.ProbeReadyByStatusAsync();
+                RefreshState();
+                m_moduleStatusText.text = "模组状态: " + status;
+                SetResult("状态获取成功");
+            });
+        }
+
+        /// <summary>获取版本。</summary>
+        /// <summary>
+        /// 执行 GetVersion 方法。
+        /// </summary>
+        public void GetVersion()
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireConnected()) return;
+                m_versionText.text = "版本: " + await m_manager.Basic.GetVersionAsync();
+                SetResult("版本获取成功");
+            });
+        }
+
+        /// <summary>获取 SN。</summary>
+        /// <summary>
+        /// 执行 GetSn 方法。
+        /// </summary>
+        public void GetSn()
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireConnected()) return;
+                m_snText.text = "SN: " + await m_manager.Basic.GetSnAsync();
+                SetResult("SN 获取成功");
+            });
+        }
+
+        /// <summary>
+        /// 执行 RefreshState 方法。
+        /// </summary>
+        private void RefreshState()
+        {
+            var state = m_manager.IsReady ? "硬件已连接" : (m_manager.IsOpen ? "端口已打开，未 READY" : "未连接");
+            m_connectionText.text = "连接状态: " + state;
+            m_readyText.text = "READY: " + (m_manager.IsReady ? "READY" : "未 READY");
+            RefreshLicenseState(m_mockToggle != null && m_mockToggle.isOn);
+        }
+
+        /// <summary>
+        /// 真实串口连接前检查授权。
+        /// </summary>
+        private bool ValidateLicenseBeforeOpen()
+        {
+            var path = FaceLicenseManager.GetDefaultLicensePath();
+            var status = FaceLicenseManager.LoadAndVerify(path);
+            if (status == FaceLicenseStatus.Valid)
+            {
+                RefreshLicenseState(false);
+                return true;
+            }
+
+            var message = "授权无效，无法打开真实串口。路径: " + path + "，原因: " + FaceLicenseManager.LastError;
+            if (m_licenseText != null)
+            {
+                m_licenseText.text = "授权: " + message;
+            }
+
+            SetResult(message);
+            return false;
+        }
+
+        /// <summary>
+        /// 刷新授权状态显示。
+        /// </summary>
+        private void RefreshLicenseState(bool useMock)
+        {
+            if (m_licenseText == null)
+            {
+                return;
+            }
+
+            if (useMock)
+            {
+                m_licenseText.text = "授权: Mock 模式不需要授权";
+                return;
+            }
+
+            if (FaceLicenseManager.Status == FaceLicenseStatus.Valid && FaceLicenseManager.Payload != null)
+            {
+                m_licenseText.text = "授权: 有效，剩余 " + FaceLicenseVerifier.GetRemainingDays(FaceLicenseManager.Payload) + " 天";
+                return;
+            }
+
+            m_licenseText.text = "授权: 未验证，文件路径 " + FaceLicenseManager.GetDefaultLicensePath();
+        }
+
+        private bool IsEditorMockEnabled()
+        {
+            if (m_manager == null)
+            {
+                return true;
+            }
+
+            return m_manager.Settings != null ? m_manager.Settings.UseMockInEditor : m_manager.Config.UseMockInEditor;
+        }
+    }
+
+    public sealed class FaceProtocolDebugPage : FaceModulePageBase
+    {
+        // Inspector 绑定字段。
+        [SerializeField] private InputField m_hexInput;
+        // Inspector 绑定字段。
+        [SerializeField] private Text m_parseText;
+        private readonly FacePacketParser m_parser = new FacePacketParser();
+        private FaceModuleManager m_boundManager; // 已订阅事件的 Manager。
+
+        public override void Build(FaceModuleUiBuilder builder)
+        {
+            builder.Text(transform, "协议调试", 30);
+            m_hexInput = builder.Input(transform, "EF AA 10 00 00 10", "EF AA 10 00 00 10");
+            var row = builder.Row(transform);
+            builder.Button(row.transform, "发送 Hex", SendHex);
+            builder.Button(row.transform, "清空输入", () => m_hexInput.text = string.Empty);
+            m_parseText = builder.Text(transform, "解析结果: -", 20, TextAnchor.UpperLeft);
+            m_resultText = builder.Text(transform, "结果: -");
+        }
+
+        public override void Init(FaceModuleManager manager, FaceModuleLogPanel logPanel, FaceModuleLoadingView loadingView)
+        {
+            UnbindManagerEvents();
+            base.Init(manager, logPanel, loadingView);
+            m_boundManager = m_manager;
+            m_manager.OnRawLog += ParseRaw;
+        }
+
+        private void OnDestroy()
+        {
+            UnbindManagerEvents();
+        }
+
+        /// <summary>发送原始 Hex 数据。</summary>
+        /// <summary>
+        /// 执行 SendHex 方法。
+        /// </summary>
+        public void SendHex()
+        {
+            try
+            {
+                if (!RequireConnected()) return;
+                var bytes = ParseHex(ReadText(m_hexInput));
+                m_manager.SendRawBytes(bytes);
+                SetResult("Hex 已发送");
+            }
+            catch (Exception ex) { SetError(ex); }
+        }
+
+        /// <summary>
+        /// 执行 ParseRaw 方法。
+        /// </summary>
+        private void ParseRaw(string line)
+        {
+            var index = line.IndexOf(' ');
+            if (index < 0) return;
+            try
+            {
+                var packets = m_parser.Push(ParseHex(line.Substring(index + 1)));
+                foreach (var packet in packets)
+                {
+                    m_parseText.text = $"MsgID=0x{packet.MsgId:X2}\nSize={packet.Size}\nData={BitConverter.ToString(packet.Data)}\nChecksum=0x{packet.Checksum:X2}\nValid={packet.IsValid}";
+                }
+            }
+            catch { }
+        }
+
+        /// <summary>
+        /// 执行 ParseHex 方法。
+        /// </summary>
+        private static byte[] ParseHex(string text)
+        {
+            var parts = text.Split(new[] { ' ', '\t', '\r', '\n', '-' }, StringSplitOptions.RemoveEmptyEntries);
+            var bytes = new byte[parts.Length];
+            for (var i = 0; i < parts.Length; i++)
+            {
+                bytes[i] = Convert.ToByte(parts[i], 16);
+            }
+
+            return bytes;
+        }
+
+        private void UnbindManagerEvents()
+        {
+            if (m_boundManager != null)
+            {
+                m_boundManager.OnRawLog -= ParseRaw;
+                m_boundManager = null;
+            }
+        }
+    }
+
+    public sealed class FaceVerifyPage : FaceModulePageBase
+    {
+        // 内部状态字段。
+        private InputField m_timeoutInput;
+        // 内部状态字段。
+        private InputField m_maxTimesInput;
+        // 内部状态字段。
+        private Toggle m_autoToggle;
+        // 内部状态字段。
+        private Text m_faceStateText;
+        // 内部状态字段。
+        private Text m_poseText;
+        // 内部状态字段。
+        private Text m_boxText;
+        // 内部状态字段。
+        private Text m_userIdText;
+        // 内部状态字段。
+        private Text m_userNameText;
+        // 内部状态字段。
+        private Text m_adminText;
+        // 内部状态字段。
+        private Text m_unlockText;
+        private FaceModuleManager m_boundManager; // 已订阅事件的 Manager。
+
+        public override void Build(FaceModuleUiBuilder builder)
+        {
+            builder.Text(transform, "人脸验证", 30);
+            m_timeoutInput = builder.Input(transform, "超时时间", "10");
+            m_maxTimesInput = builder.Input(transform, "最大识别次数", "30");
+            m_autoToggle = builder.Toggle(transform, "自动探测验证", false);
+            var row = builder.Row(transform);
+            builder.Button(row.transform, "开始验证", StartVerify);
+            builder.Button(row.transform, "停止 / RESET", StopVerify);
+            m_faceStateText = builder.Text(transform, "人脸状态: -");
+            m_poseText = builder.Text(transform, "Yaw/Pitch/Roll: -");
+            m_boxText = builder.Text(transform, "人脸框: -");
+            m_userIdText = builder.Text(transform, "UserID: -");
+            m_userNameText = builder.Text(transform, "UserName: -");
+            m_adminText = builder.Text(transform, "Admin: -");
+            m_unlockText = builder.Text(transform, "UnlockStatus: -");
+            m_resultText = builder.Text(transform, "结果: -");
+        }
+
+        public override void Init(FaceModuleManager manager, FaceModuleLogPanel logPanel, FaceModuleLoadingView loadingView)
+        {
+            UnbindManagerEvents();
+            base.Init(manager, logPanel, loadingView);
+            m_boundManager = m_manager;
+            m_manager.OnFaceStateUpdated += OnFaceState;
+        }
+
+        private void OnDestroy()
+        {
+            UnbindManagerEvents();
+        }
+
+        /// <summary>开始验证或自动验证。</summary>
+        /// <summary>
+        /// 执行 StartVerify 方法。
+        /// </summary>
+        public void StartVerify()
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireReady()) return;
+                var result = m_autoToggle.isOn
+                    ? await m_manager.Verify.AutoVerifyAsync(true, ReadByte(m_timeoutInput, 10))
+                    : await m_manager.Verify.VerifyAsync(ReadByte(m_timeoutInput, 10), ReadByte(m_maxTimesInput, 30));
+                ShowResult(result);
+            });
+        }
+
+        /// <summary>停止验证。</summary>
+        /// <summary>
+        /// 执行 StopVerify 方法。
+        /// </summary>
+        public void StopVerify()
+        {
+            RunAsync(async () => { if (RequireConnected()) { await m_manager.Basic.ResetAsync(); SetResult("已停止验证"); } });
+        }
+
+        /// <summary>
+        /// 执行 OnFaceState 方法。
+        /// </summary>
+        private void OnFaceState(FaceFaceStateNote state)
+        {
+            m_faceStateText.text = "人脸状态: " + FaceProtocolEncoding.FaceStateMessage(state.State);
+            m_poseText.text = $"Yaw/Pitch/Roll: {state.Yaw}/{state.Pitch}/{state.Roll}";
+            m_boxText.text = $"人脸框: L{state.Left} T{state.Top} R{state.Right} B{state.Bottom}";
+        }
+
+        /// <summary>
+        /// 执行 ShowResult 方法。
+        /// </summary>
+        private void ShowResult(FaceVerifyResult result)
+        {
+            m_userIdText.text = "UserID: " + result.UserId;
+            m_userNameText.text = "UserName: " + result.UserName;
+            m_adminText.text = "Admin: " + result.IsAdmin;
+            m_unlockText.text = "UnlockStatus: " + result.UnlockStatus;
+            SetResult(result.Success ? "验证成功" : FaceProtocolEncoding.ResultMessage(result.ResultCode));
+        }
+
+        private void UnbindManagerEvents()
+        {
+            if (m_boundManager != null)
+            {
+                m_boundManager.OnFaceStateUpdated -= OnFaceState;
+                m_boundManager = null;
+            }
+        }
+    }
+
+    public sealed class FaceEnrollPage : FaceModulePageBase
+    {
+        // 内部状态字段。
+        private InputField m_nameInput;
+        // 内部状态字段。
+        private Toggle m_adminToggle;
+        // 内部状态字段。
+        private Dropdown m_modeDropdown;
+        // 内部状态字段。
+        private Dropdown m_directionDropdown;
+        // 内部状态字段。
+        private Dropdown m_enrollTypeDropdown;
+        // 内部状态字段。
+        private Toggle m_duplicateToggle;
+        // 内部状态字段。
+        private InputField m_timeoutInput;
+        // 内部状态字段。
+        private Text m_faceStateText;
+        // 内部状态字段。
+        private Text m_poseText;
+        // 内部状态字段。
+        private Text m_directionText;
+        // 内部状态字段。
+        private Text m_userIdText;
+        private FaceModuleManager m_boundManager;              // 已订阅事件的 Manager。
+        private Action<FaceFaceStateNote> m_faceStateHandler;  // 人脸状态事件回调。
+
+        public override void Build(FaceModuleUiBuilder builder)
+        {
+            builder.Text(transform, "人脸录入", 30);
+            m_nameInput = builder.Input(transform, "用户姓名", "User");
+            m_adminToggle = builder.Toggle(transform, "管理员", false);
+            m_modeDropdown = builder.Dropdown(transform, new[] { "交互录入 ENROLL", "单帧录入 ENROLL_SINGLE", "集成录入 ENROLL_ITG" });
+            m_directionDropdown = builder.Dropdown(transform, new[] { "正脸", "朝上", "朝下", "朝左", "朝右" });
+            m_enrollTypeDropdown = builder.Dropdown(transform, new[] { "交互", "单帧" });
+            m_duplicateToggle = builder.Toggle(transform, "允许重复录入", false);
+            m_timeoutInput = builder.Input(transform, "超时时间", "20");
+            var row = builder.Row(transform);
+            builder.Button(row.transform, "开始录入", StartEnroll);
+            builder.Button(row.transform, "取消录入", CancelEnroll);
+            m_faceStateText = builder.Text(transform, "人脸状态: -");
+            m_poseText = builder.Text(transform, "姿态: -");
+            m_directionText = builder.Text(transform, "已录入方向: -");
+            m_userIdText = builder.Text(transform, "最终 UserID: -");
+            m_resultText = builder.Text(transform, "ResultCode: -");
+        }
+
+        public override void Init(FaceModuleManager manager, FaceModuleLogPanel logPanel, FaceModuleLoadingView loadingView)
+        {
+            UnbindManagerEvents();
+            base.Init(manager, logPanel, loadingView);
+            m_boundManager = m_manager;
+            m_faceStateHandler = state =>
+            {
+                m_faceStateText.text = FaceProtocolEncoding.FaceStateMessage(state.State);
+                m_poseText.text = $"Yaw/Pitch/Roll: {state.Yaw}/{state.Pitch}/{state.Roll}";
+            };
+            m_manager.OnFaceStateUpdated += m_faceStateHandler;
+        }
+
+        private void OnDestroy()
+        {
+            UnbindManagerEvents();
+        }
+
+        /// <summary>开始录入。</summary>
+        /// <summary>
+        /// 执行 StartEnroll 方法。
+        /// </summary>
+        public void StartEnroll()
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireReady()) return;
+                if (FaceProtocolEncoding.GetUserNameByteCount(ReadText(m_nameInput)) > FaceModuleConstants.UserNameSize)
+                {
+                    SetResult("用户名 UTF-8 编码超过 32 bytes");
+                    return;
+                }
+
+                FaceEnrollResult result;
+                if (m_modeDropdown.value == 1)
+                {
+                    result = await m_manager.Enrollment.EnrollSingleAsync(m_adminToggle.isOn, ReadText(m_nameInput), ReadByte(m_timeoutInput, 20));
+                }
+                else if (m_modeDropdown.value == 2)
+                {
+                    result = await m_manager.Enrollment.EnrollIntegratedAsync(m_adminToggle.isOn, ReadText(m_nameInput), Direction(), ReadByte(m_timeoutInput, 20), m_enrollTypeDropdown.value == 1, !m_duplicateToggle.isOn);
+                }
+                else
+                {
+                    result = await m_manager.Enrollment.EnrollAsync(m_adminToggle.isOn, ReadText(m_nameInput), Direction(), ReadByte(m_timeoutInput, 20));
+                }
+
+                m_userIdText.text = "最终 UserID: " + result.UserId;
+                m_directionText.text = "已录入方向: " + DirectionText(result.Direction);
+                if (result.Success)
+                {
+                    await ConfirmEnrollResult(result.UserId);
+                }
+                else
+                {
+                    SetResult(FaceProtocolEncoding.ResultMessage(result.ResultCode));
+                }
+            });
+        }
+
+        /// <summary>
+        /// 录入成功后读取用户信息，确认模组已写入用户表。
+        /// </summary>
+        private async System.Threading.Tasks.Task ConfirmEnrollResult(int userId)
+        {
+            try
+            {
+                var info = await m_manager.Users.GetUserInfoAsync(userId);
+                SetResult("录入成功，已确认用户: ID=" + info.UserId + " 姓名=" + info.UserName + " 管理员=" + info.IsAdmin);
+            }
+            catch (Exception ex)
+            {
+                SetResult("录入成功，但查询用户确认失败: " + ex.Message);
+            }
+        }
+
+        /// <summary>取消录入。</summary>
+        /// <summary>
+        /// 执行 CancelEnroll 方法。
+        /// </summary>
+        public void CancelEnroll()
+        {
+            RunAsync(async () => { if (RequireConnected()) { await m_manager.Basic.FaceResetAsync(); SetResult("已取消录入"); } });
+        }
+
+        /// <summary>
+        /// 执行 Direction 方法。
+        /// </summary>
+        private FaceDirection Direction()
+        {
+            switch (m_directionDropdown.value)
+            {
+                case 1: return FaceDirection.Up;
+                case 2: return FaceDirection.Down;
+                case 3: return FaceDirection.Left;
+                case 4: return FaceDirection.Right;
+                default: return FaceDirection.Middle;
+            }
+        }
+
+        /// <summary>
+        /// 执行 DirectionText 方法。
+        /// </summary>
+        private string DirectionText(FaceDirection direction)
+        {
+            return direction.ToString();
+        }
+
+        private void UnbindManagerEvents()
+        {
+            if (m_boundManager != null && m_faceStateHandler != null)
+            {
+                m_boundManager.OnFaceStateUpdated -= m_faceStateHandler;
+            }
+
+            m_boundManager = null;
+            m_faceStateHandler = null;
+        }
+    }
+
+    public sealed class FaceUserManagePage : FaceModulePageBase
+    {
+        // 内部状态字段。
+        private InputField m_userIdInput;
+        // 内部状态字段。
+        private Text m_listText;
+        // 内部状态字段。
+        private Text m_detailText;
+        // 内部状态字段。
+        private FaceModuleConfirmDialog m_confirmDialog;
+
+        public override void Build(FaceModuleUiBuilder builder)
+        {
+            builder.Text(transform, "用户管理", 30);
+            m_userIdInput = builder.Input(transform, "UserID", "1");
+            var row = builder.Row(transform);
+            builder.Button(row.transform, "查询用户", QueryUser);
+            builder.Button(row.transform, "删除用户", DeleteUser);
+            builder.Button(row.transform, "删除全部", DeleteAll);
+            var row2 = builder.Row(transform);
+            builder.Button(row2.transform, "获取所有 ID", QueryAll);
+            builder.Button(row2.transform, "获取所有 ID2", QueryAll2);
+            var scroll = builder.ScrollView(transform, out m_listText);
+            scroll.GetComponent<LayoutElement>().preferredHeight = 240;
+            m_detailText = builder.Text(transform, "用户详情: -");
+            m_resultText = builder.Text(transform, "结果: -");
+        }
+
+        public override void Init(FaceModuleManager manager, FaceModuleLogPanel logPanel, FaceModuleLoadingView loadingView)
+        {
+            base.Init(manager, logPanel, loadingView);
+            m_confirmDialog = FindObjectOfType<FaceModuleConfirmDialog>(true);
+        }
+
+        /// <summary>
+        /// 执行 QueryUser 方法。
+        /// </summary>
+        public void QueryUser()
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireReady()) return;
+                var info = await m_manager.Users.GetUserInfoAsync(ReadInt(m_userIdInput, 0));
+                m_detailText.text = $"用户详情: ID={info.UserId} Name={info.UserName} Admin={info.IsAdmin}";
+                SetResult("查询成功");
+            });
+        }
+
+        /// <summary>
+        /// 执行 DeleteUser 方法。
+        /// </summary>
+        public void DeleteUser()
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireReady()) return;
+                await m_manager.Users.DeleteUserAsync(ReadInt(m_userIdInput, 0));
+                SetResult("删除成功");
+                await RefreshIds(false);
+            });
+        }
+
+        /// <summary>
+        /// 执行 DeleteAll 方法。
+        /// </summary>
+        public void DeleteAll()
+        {
+            if (m_confirmDialog != null)
+            {
+                m_confirmDialog.Show("确定删除全部用户？该操作不可撤销。", DeleteAllConfirmed);
+                return;
+            }
+
+            DeleteAllConfirmed();
+        }
+
+        /// <summary>
+        /// 执行 DeleteAllConfirmed 方法。
+        /// </summary>
+        private void DeleteAllConfirmed()
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireReady()) return;
+                await m_manager.Users.DeleteAllAsync();
+                SetResult("全部用户已删除");
+                await RefreshIds(false);
+            });
+        }
+
+        /// <summary>
+        /// 执行 QueryAll 方法。
+        /// </summary>
+        public void QueryAll()
+        {
+            RunAsync(async () => { if (RequireReady()) await RefreshIds(false); });
+        }
+
+        /// <summary>
+        /// 执行 QueryAll2 方法。
+        /// </summary>
+        public void QueryAll2()
+        {
+            RunAsync(async () => { if (RequireReady()) await RefreshIds(true); });
+        }
+
+        /// <summary>
+        /// 执行 RefreshIds 方法。
+        /// </summary>
+        private async System.Threading.Tasks.Task RefreshIds(bool useV2)
+        {
+            var ids = useV2 ? await m_manager.Users.GetAllUserIds2Async() : await m_manager.Users.GetAllUserIdsAsync();
+            m_listText.text = string.Join("\n", ids.ConvertAll(id => "UserID: " + id));
+            SetResult("用户列表已刷新");
+        }
+    }
+
+    public sealed class FaceQrCodePage : FaceModulePageBase
+    {
+        // 内部状态字段。
+        private InputField m_timeoutInput;
+        // 内部状态字段。
+        private Text m_qrText;
+        private FaceModuleManager m_boundManager; // 已订阅事件的 Manager。
+
+        public override void Build(FaceModuleUiBuilder builder)
+        {
+            builder.Text(transform, "二维码", 30);
+            m_timeoutInput = builder.Input(transform, "扫码超时时间", "10");
+            var row = builder.Row(transform);
+            builder.Button(row.transform, "开始扫码", Scan);
+            builder.Button(row.transform, "自动探测二维码", AutoScan);
+            builder.Button(row.transform, "停止", Stop);
+            builder.Button(row.transform, "复制内容", Copy);
+            m_qrText = builder.Text(transform, "二维码内容: -", 22, TextAnchor.UpperLeft);
+            m_resultText = builder.Text(transform, "扫码状态: -");
+        }
+
+        public override void Init(FaceModuleManager manager, FaceModuleLogPanel logPanel, FaceModuleLoadingView loadingView)
+        {
+            UnbindManagerEvents();
+            base.Init(manager, logPanel, loadingView);
+            m_boundManager = m_manager;
+            m_manager.OnQrCodeReceived += OnQrCodeReceived;
+        }
+
+        private void OnDestroy()
+        {
+            UnbindManagerEvents();
+        }
+
+        /// <summary>
+        /// 执行 Scan 方法。
+        /// </summary>
+        public void Scan()
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireReady()) return;
+                var qr = await m_manager.QrCode.ScanQrCodeAsync(ReadByte(m_timeoutInput, 10));
+                m_qrText.text = "二维码内容: " + qr;
+                SetResult(string.IsNullOrEmpty(qr) ? "二维码为空" : "扫码成功");
+            });
+        }
+
+        /// <summary>
+        /// 执行 AutoScan 方法。
+        /// </summary>
+        public void AutoScan()
+        {
+            RunAsync(async () => { if (RequireReady()) { await m_manager.Verify.AutoVerifyAsync(true, ReadByte(m_timeoutInput, 10)); SetResult("自动探测已启动"); } });
+        }
+
+        /// <summary>
+        /// 执行 Stop 方法。
+        /// </summary>
+        public void Stop()
+        {
+            RunAsync(async () => { if (RequireConnected()) { await m_manager.Basic.ResetAsync(); SetResult("已停止"); } });
+        }
+
+        /// <summary>
+        /// 执行 Copy 方法。
+        /// </summary>
+        public void Copy()
+        {
+            GUIUtility.systemCopyBuffer = m_qrText.text.Replace("二维码内容: ", string.Empty);
+            SetResult("已复制到剪贴板");
+        }
+
+        private void OnQrCodeReceived(string qr)
+        {
+            m_qrText.text = "二维码内容: " + qr;
+        }
+
+        private void UnbindManagerEvents()
+        {
+            if (m_boundManager != null)
+            {
+                m_boundManager.OnQrCodeReceived -= OnQrCodeReceived;
+                m_boundManager = null;
+            }
+        }
+    }
+
+    public sealed class FaceImagePage : FaceModulePageBase
+    {
+        // 内部状态字段。
+        private Dropdown m_dpiDropdown;
+        // 内部状态字段。
+        private Slider m_progress;
+        // 内部状态字段。
+        private Text m_sizeText;
+        // 内部状态字段。
+        private RawImage m_preview;
+        // 内部状态字段。
+        private Text m_userIdText;
+        // 内部状态字段。
+        private byte[] m_lastBytes;
+        // 内部状态字段。
+        private string m_lastType;
+
+        public override void Build(FaceModuleUiBuilder builder)
+        {
+            builder.Text(transform, "图片抓拍", 30);
+            m_dpiDropdown = builder.Dropdown(transform, new[] { "480x640", "600x800", "1200x1600" });
+            var row = builder.Row(transform);
+            builder.Button(row.transform, "抓拍普通图片", () => Snap("Normal"));
+            builder.Button(row.transform, "抓拍人脸图片", () => Snap("Face"));
+            builder.Button(row.transform, "抓拍大图", () => Snap("Large"));
+            builder.Button(row.transform, "保存图片", SaveImage);
+            builder.Button(row.transform, "清空图片", ClearImage);
+            m_progress = builder.Slider(transform);
+            m_sizeText = builder.Text(transform, "图片大小: -");
+            m_userIdText = builder.Text(transform, "本地匹配 UserID: -");
+            var previewGo = FaceModuleUiBuilder.Create("Preview", transform);
+            previewGo.AddComponent<LayoutElement>().preferredHeight = 360;
+            previewGo.AddComponent<Image>().color = Color.white;
+            m_preview = FaceModuleUiBuilder.Create("RawImage", previewGo.transform).AddComponent<RawImage>();
+            FaceModuleUiBuilder.Stretch(m_preview.rectTransform);
+            m_resultText = builder.Text(transform, "结果: -");
+        }
+
+        /// <summary>
+        /// 执行 Snap 方法。
+        /// </summary>
+        public void Snap(string type)
+        {
+            RunAsync(async () =>
+            {
+                if (!RequireReady()) return;
+                FaceImageResult result;
+                if (type == "Face") result = await m_manager.Images.SnapUploadFaceImageAsync();
+                else if (type == "Large") result = await m_manager.Images.SnapUploadLargeImageAsync((ImageDpi)m_dpiDropdown.value);
+                else result = await m_manager.Images.SnapUploadImageAsync();
+                m_lastBytes = result.Bytes;
+                m_lastType = type;
+                m_preview.texture = result.Texture;
+                m_sizeText.text = "图片大小: " + (m_lastBytes == null ? 0 : m_lastBytes.Length) + " bytes";
+                m_userIdText.text = "本地匹配 UserID: " + result.UserId;
+                m_progress.value = 1;
+                SetResult(result.Bytes.Length > 0 ? "图片接收完成" : "抓拍命令已完成，未收到图片数据");
+            });
+        }
+
+        /// <summary>
+        /// 执行 SaveImage 方法。
+        /// </summary>
+        public void SaveImage()
+        {
+            if (m_lastBytes == null || m_lastBytes.Length == 0)
+            {
+                SetResult("没有可保存的图片");
+                return;
+            }
+
+            var dir = Path.Combine(Application.persistentDataPath, "FaceModuleImages");
+            Directory.CreateDirectory(dir);
+            File.WriteAllBytes(Path.Combine(dir, DateTime.Now.ToString("yyyyMMdd_HHmmss_") + m_lastType + ImageExtension(m_lastBytes)), m_lastBytes);
+            SetResult("图片已保存: " + dir);
+        }
+
+        /// <summary>
+        /// 执行 ClearImage 方法。
+        /// </summary>
+        public void ClearImage()
+        {
+            m_lastBytes = null;
+            m_preview.texture = null;
+            m_sizeText.text = "图片大小: -";
+            m_userIdText.text = "本地匹配 UserID: -";
+            m_progress.value = 0;
+            SetResult("已清空图片");
+        }
+
+        private static string ImageExtension(byte[] bytes)
+        {
+            if (bytes != null && bytes.Length >= 4 && bytes[0] == 0x89 && bytes[1] == 0x50 && bytes[2] == 0x4E && bytes[3] == 0x47)
+            {
+                return ".png";
+            }
+
+            return ".jpg";
+        }
+    }
+}
diff --git a/Samples~/SI-M1 Face Demo/UI/ViewModels/FaceModuleViewModels.cs b/Samples~/SI-M1 Face Demo/UI/ViewModels/FaceModuleViewModels.cs
new file mode 100644
index 0000000..1e21fce
--- /dev/null
+++ b/Samples~/SI-M1 Face Demo/UI/ViewModels/FaceModuleViewModels.cs	
@@ -0,0 +1,78 @@
+using UnityEngine;
+using UnityEngine.UI;
+
+namespace Aisu.SIM1.Face.UI.ViewModels
+{
+    /// <summary>
+    /// 用户列表项视图。
+    /// </summary>
+    public sealed class FaceUserListItemView : MonoBehaviour
+    {
+        // Inspector 绑定字段。
+        [SerializeField] private Text m_userIdText;
+        // 内部状态字段。
+        private int m_userId;
+
+        // 公开数据字段。
+        public int UserId => m_userId;
+
+        /// <summary>
+        /// 绑定用户 ID。
+        /// </summary>
+        public void Bind(int userId)
+        {
+            m_userId = userId;
+            if (m_userIdText != null)
+            {
+                m_userIdText.text = "UserID: " + userId;
+            }
+        }
+    }
+
+    /// <summary>
+    /// 日志列表项视图。
+    /// </summary>
+    public sealed class FaceLogItemView : MonoBehaviour
+    {
+        // Inspector 绑定字段。
+        [SerializeField] private Text m_logText;
+
+        /// <summary>
+        /// 绑定日志文本。
+        /// </summary>
+        public void Bind(string log)
+        {
+            if (m_logText != null)
+            {
+                m_logText.text = log;
+            }
+        }
+    }
+
+    /// <summary>
+    /// 图片预览视图。
+    /// </summary>
+    public sealed class FaceImagePreviewView : MonoBehaviour
+    {
+        // Inspector 绑定字段。
+        [SerializeField] private RawImage m_previewImage;
+        // Inspector 绑定字段。
+        [SerializeField] private Text m_sizeText;
+
+        /// <summary>
+        /// 显示图片。
+        /// </summary>
+        public void Bind(Texture2D texture, int byteLength)
+        {
+            if (m_previewImage != null)
+            {
+                m_previewImage.texture = texture;
+            }
+
+            if (m_sizeText != null)
+            {
+                m_sizeText.text = byteLength + " bytes";
+            }
+        }
+    }
+}