优化前端，优化前端指令，优化自定义控制

apps/web-console/gesture-control.js

@@ -56,6 +56,8 @@ const state = {
   customizeOpen: false,
   engine: null,
   runtimeReady: false,
+  enabled: true,
+  disabledReason: "",
   cameraStatus: "checking",
   cameraMessage: "正在检测摄像头…",
   cameraCheckSequence: 0,
@@ -114,7 +116,8 @@ function cameraFailureDetails(error) {
 function syncCameraButtonAvailability() {
   const button = $("#gestureStartButton");
   if (!button || state.stream) return;
-  button.disabled = !state.runtimeReady
+  button.disabled = !state.enabled
+    || !state.runtimeReady
     || ["checking", "unavailable", "unsupported"].includes(state.cameraStatus);
 }
 
@@ -693,29 +696,48 @@ function resetMapping() {
 }
 
 function openDrawer() {
-  $("#gestureDrawer").classList.add("open");
-  $("#gestureDrawer").setAttribute("aria-hidden", "false");
-  $("#gestureBackdrop").hidden = false;
-  requestAnimationFrame(() => $("#gestureBackdrop").classList.add("visible"));
-  $("#gestureToggleButton").setAttribute("aria-expanded", "true");
+  if (!state.enabled) {
+    notify(state.disabledReason || "当前运行模式未启用手势控制");
+    return false;
+  }
+  const drawer = $("#gestureDrawer");
+  if (!drawer) return false;
+  drawer.classList.add("open");
+  drawer.setAttribute("aria-hidden", "false");
   document.body.classList.add("gesture-open");
+  return true;
 }
 
 function closeDrawer() {
   stopCamera();
-  $("#gestureDrawer").classList.remove("open");
-  $("#gestureDrawer").setAttribute("aria-hidden", "true");
-  $("#gestureBackdrop").classList.remove("visible");
-  window.setTimeout(() => { $("#gestureBackdrop").hidden = true; }, 240);
-  $("#gestureToggleButton").setAttribute("aria-expanded", "false");
+  const drawer = $("#gestureDrawer");
+  drawer?.classList.remove("open");
+  drawer?.setAttribute("aria-hidden", "true");
   document.body.classList.remove("gesture-open");
 }
 
+function setEnabled(enabled, { reason = "" } = {}) {
+  state.enabled = Boolean(enabled);
+  state.disabledReason = state.enabled ? "" : String(reason || "当前运行模式未启用手势控制");
+  if (!state.enabled) closeDrawer();
+  syncCameraButtonAvailability();
+  const drawer = $("#gestureDrawer");
+  if (drawer) {
+    drawer.dataset.enabled = String(state.enabled);
+    drawer.title = state.disabledReason;
+  }
+}
+
+window.CognitiveAgentGesture = {
+  open: openDrawer,
+  close: closeDrawer,
+  isOpen: () => $("#gestureDrawer")?.classList.contains("open") === true,
+  setEnabled,
+};
+
 document.addEventListener("DOMContentLoaded", async () => {
   $("#gestureStartButton").disabled = true;
-  $("#gestureToggleButton")?.addEventListener("click", openDrawer);
   $("#gestureCloseButton")?.addEventListener("click", closeDrawer);
-  $("#gestureBackdrop")?.addEventListener("click", closeDrawer);
   $("#gestureStartButton")?.addEventListener("click", toggleCamera);
   $("#gestureStopButton")?.addEventListener("click", () => state.engine?.setArmed(false));
   $("#gestureCustomizeButton")?.addEventListener("click", toggleCustomize);