@yfwu2020/dsh-selection-explain 0.13.1 → 0.14.0

package/lib/client.js

@@ -59,7 +59,8 @@ function selectionDetached(range) {
 function insideEditable(node) {
   var element = node && node.nodeType === 1 ? node : node && node.parentElement;
   if (!element || !element.closest) return false;
-  return !!element.closest("input, textarea");
+  if (element.isContentEditable === true) return true;
+  return !!element.closest('input, textarea, [contenteditable]:not([contenteditable="false"])');
 }
 function formatDuration(ms) {
   return ms < 1e3 ? ms + "ms" : (ms / 1e3).toFixed(1) + "s";
@@ -983,6 +984,36 @@ function createSettingsController(env) {
 function createSelectionController(env) {
   var preferences = env.preferences || createPreferences();
   var checkPending = false;
+  var dismissedRange = null;
+  var floatInteracting = false;
+  var floatInteractionVersion = 0;
+  function beginFloatInteraction() {
+    floatInteracting = true;
+    floatInteractionVersion += 1;
+  }
+  function endFloatInteraction() {
+    if (!floatInteracting) return;
+    var version = floatInteractionVersion;
+    env.later(function() {
+      if (version !== floatInteractionVersion) return;
+      floatInteracting = false;
+      syncPlatformSurface();
+    }, 0);
+  }
+  function sameRange(a, b) {
+    if (!a || !b || !a.startContainer || !b.startContainer) return false;
+    return a.startContainer === b.startContainer && a.startOffset === b.startOffset && a.endContainer === b.endContainer && a.endOffset === b.endOffset;
+  }
+  function currentDocumentRange() {
+    try {
+      var selection = window.getSelection();
+      if (!selection || !selection.rangeCount) return null;
+      var range = selection.getRangeAt(0);
+      return typeof range.cloneRange === "function" ? range.cloneRange() : range;
+    } catch (error) {
+      return null;
+    }
+  }
   function scheduleCheck() {
     if (checkPending) return;
     checkPending = true;
@@ -1068,6 +1099,12 @@ function createSelectionController(env) {
       env.hideQuoteButton();
       return;
     }
+    if (dismissedRange && !sameRange(range, dismissedRange)) dismissedRange = null;
+    if (dismissedRange) {
+      env.state.quoteSelection = null;
+      env.hideQuoteButton();
+      return;
+    }
     var inPanel = insidePanelContent(range.startContainer) || insidePanelContent(range.endContainer);
     env.state.bridgeActive = false;
     if (!inPanel && (insideOwnUI(range.startContainer) || insideOwnUI(range.endContainer))) {
@@ -1138,6 +1175,11 @@ function createSelectionController(env) {
       hideButton();
       return;
     }
+    if (dismissedRange && !sameRange(range, dismissedRange)) dismissedRange = null;
+    if (dismissedRange) {
+      hideButton();
+      return;
+    }
     var rects = range.getClientRects();
     var rect = rects && rects.length > 0 ? rects[rects.length - 1] : range.getBoundingClientRect();
     if (!rect || rect.width === 0 && rect.height === 0) {
@@ -1158,6 +1200,9 @@ function createSelectionController(env) {
       void env.button.offsetWidth;
       setButtonPop(true);
     }
+    watchPlatformSurface();
+    env.later(refreshPlacement, 0);
+    env.later(refreshPlacement, 80);
     env.startMicWatch();
   }
   function hideButton() {
@@ -1165,18 +1210,142 @@ function createSelectionController(env) {
     setButtonPop(false);
     if (!env.vcardState.open) env.stopMicWatch();
   }
+  function surfaceSnapshot() {
+    if (typeof document === "undefined" || typeof document.querySelector !== "function") {
+      return { rect: null, visible: false, dismissed: true };
+    }
+    var node = document.querySelector("[data-text-interaction-surface]");
+    if (!node) return { rect: null, visible: false, dismissed: true };
+    if (node.getAttribute("aria-hidden") === "true") return { rect: null, visible: false, dismissed: true };
+    var view = node.ownerDocument && node.ownerDocument.defaultView;
+    if (view && typeof view.getComputedStyle === "function") {
+      try {
+        if (view.getComputedStyle(node).visibility === "hidden") return { rect: null, visible: false, dismissed: false };
+      } catch (error) {
+      }
+    }
+    var box = typeof node.getBoundingClientRect === "function" ? node.getBoundingClientRect() : null;
+    if (!box || !box.width || !box.height) return { rect: null, visible: false, dismissed: false };
+    return { rect: box, visible: true, dismissed: false };
+  }
+  function platformSurface() {
+    return surfaceSnapshot().rect;
+  }
   function placeFloat(node, rect) {
+    if (floatInteracting) return false;
     var wasHidden = node.style.display !== "inline-flex";
     node.style.display = "inline-flex";
     var width = node.offsetWidth || 62;
-    var height = node.offsetHeight || 28;
-    var left = clamp(rect.right - width, 8, Math.max(8, window.innerWidth - width - 8));
-    var top = rect.top - height - 7;
-    if (top < 8) top = Math.min(rect.bottom + 7, window.innerHeight - height - 8);
+    var height = node.offsetHeight || 30;
+    var surface = platformSurface();
+    var left;
+    var top;
+    if (surface) {
+      var gap = 8;
+      left = surface.right + gap;
+      top = surface.top + (surface.height - height) / 2;
+      var dock = "right";
+      if (left + width > window.innerWidth - 8) {
+        left = surface.left - gap - width;
+        dock = "left";
+        if (left < 8) {
+          left = clamp(surface.left, 8, Math.max(8, window.innerWidth - width - 8));
+          top = surface.bottom + gap;
+          dock = "below";
+        }
+      }
+      node.setAttribute("data-dock", dock);
+    } else {
+      left = clamp(rect.right - width, 8, Math.max(8, window.innerWidth - width - 8));
+      top = rect.top - height - 7;
+      if (top < 8) top = Math.min(rect.bottom + 7, window.innerHeight - height - 8);
+      node.removeAttribute("data-dock");
+    }
+    top = clamp(top, 8, Math.max(8, window.innerHeight - height - 8));
     node.style.left = Math.round(left) + "px";
     node.style.top = Math.round(top) + "px";
     return wasHidden;
   }
+  function visibleFloat() {
+    if (env.button.style.display === "inline-flex") {
+      return { node: env.button, rect: env.state.selection && env.state.selection.rect || null };
+    }
+    if (env.quoteButton.style.display === "inline-flex") {
+      return { node: env.quoteButton, rect: env.state.quoteSelection && env.state.quoteSelection.rect || null };
+    }
+    return null;
+  }
+  function refreshPlacement() {
+    var current = visibleFloat();
+    if (!current) return false;
+    if (!current.rect && !platformSurface()) return false;
+    placeFloat(current.node, current.rect);
+    return true;
+  }
+  function followPlatformSurface() {
+    if (!platformSurface()) return false;
+    return refreshPlacement();
+  }
+  var surfaceObserver = null;
+  var surfaceObserved = null;
+  var surfaceVisible = false;
+  var surfaceScrolledOut = false;
+  function restoreFloating() {
+    var stored = env.state.selection;
+    if (!stored || !stored.rect || stored.source !== "document") return;
+    var live = currentDocumentRange();
+    if (!live || !sameRange(live, stored.range)) return;
+    if (dismissedRange && sameRange(live, dismissedRange)) return;
+    if (env.panelOpen) showQuoteButton(stored.rect);
+    else showButton(stored.rect);
+  }
+  function watchPlatformSurface() {
+    if (typeof MutationObserver !== "function") return;
+    var node = typeof document !== "undefined" && typeof document.querySelector === "function" ? document.querySelector("[data-text-interaction-surface]") : null;
+    if (!node) return;
+    if (surfaceObserver && surfaceObserved === node && node.isConnected !== false) return;
+    if (surfaceObserver) {
+      try {
+        surfaceObserver.disconnect();
+      } catch (error) {
+      }
+      surfaceObserver = null;
+    }
+    surfaceObserved = node;
+    surfaceVisible = surfaceSnapshot().visible;
+    surfaceObserver = new MutationObserver(syncPlatformSurface);
+    surfaceObserver.observe(node, {
+      attributes: true,
+      attributeFilter: ["aria-hidden", "style", "class"],
+      childList: true
+    });
+  }
+  function syncPlatformSurface() {
+    if (floatInteracting) return;
+    var next = surfaceSnapshot();
+    var changed = next.visible !== surfaceVisible;
+    surfaceVisible = next.visible;
+    if (changed && !next.visible) {
+      if (next.dismissed) {
+        dismissedRange = currentDocumentRange();
+        surfaceScrolledOut = false;
+      } else {
+        surfaceScrolledOut = true;
+      }
+      hideButton();
+      env.hideQuoteButton();
+      return;
+    }
+    if (changed && next.visible) {
+      var restore = surfaceScrolledOut;
+      surfaceScrolledOut = false;
+      if (restore) {
+        restoreFloating();
+        return;
+      }
+    }
+    refreshPlacement();
+  }
   function setQuotePop(on) {
     if (on) env.quoteButton.setAttribute("data-pop", "1");
     else env.quoteButton.removeAttribute("data-pop");
@@ -1187,8 +1356,21 @@ function createSelectionController(env) {
       void env.quoteButton.offsetWidth;
       setQuotePop(true);
     }
+    watchPlatformSurface();
+    env.later(refreshPlacement, 0);
+    env.later(refreshPlacement, 80);
     env.startMicWatch();
   }
+  function dispose() {
+    if (surfaceObserver) {
+      try {
+        surfaceObserver.disconnect();
+      } catch (error) {
+      }
+      surfaceObserver = null;
+    }
+    surfaceObserved = null;
+  }
   return {
     hideButton,
     showQuoteButton,
@@ -1198,7 +1380,12 @@ function createSelectionController(env) {
     scheduleCheck,
     panelSourceLabel,
     insidePanelContent,
-    turnLabelOf
+    turnLabelOf,
+    refreshPlacement,
+    followPlatformSurface,
+    beginFloatInteraction,
+    endFloatInteraction,
+    dispose
   };
 }
 
@@ -1217,11 +1404,15 @@ function describeContainer(element) {
   try {
     if (element.closest("pre") || element.closest("code")) return "\u4EE3\u7801\u5757";
     if (element.closest("table")) return "\u8868\u683C";
-    var message = element.closest('[data-message-role],[data-role],[data-testid*="message"],article');
-    if (message) {
-      var role = message.getAttribute("data-message-role") || message.getAttribute("data-role") || "";
-      if (role === "user") return "\u5BF9\u8BDD\u6D88\u606F\uFF08\u7528\u6237\uFF09";
-      if (role === "assistant") return "\u5BF9\u8BDD\u6D88\u606F\uFF08\u52A9\u624B\uFF09";
+    if (element.closest('[data-message-role="user"],[data-role="user"],[data-chat-flow-kind="user"]')) return "\u5BF9\u8BDD\u6D88\u606F\uFF08\u7528\u6237\uFF09";
+    if (element.closest(
+      '[data-message-role="assistant"],[data-role="assistant"],[data-chat-flow-kind="assistant"],[data-chat-group-part="response"],[data-chat-group-part="reasoning"]'
+    )) {
+      return "\u5BF9\u8BDD\u6D88\u606F\uFF08\u52A9\u624B\uFF09";
+    }
+    if (element.closest(
+      '[data-message-role],[data-role],[data-chat-flow-kind],[data-chat-group-part],[data-message-bubble],[data-testid*="message"],article'
+    )) {
       return "\u5BF9\u8BDD\u6D88\u606F";
     }
   } catch (error) {
@@ -5156,6 +5347,7 @@ function createPanelController(env) {
     env.sendAsk(options.askFirst, null, refs, note);
   }
   function openPanelWithInner(text, context, label, anchor, keyContext, options) {
+    env.cancelBackground();
     if (options && options.shotRef !== void 0) {
       openPanelForShot(anchor, options);
       return;
@@ -5477,15 +5669,6 @@ function createPanelController(env) {
     env.hideQuoteButton();
     env.state.quoteSelection = null;
     env.cancelVoice();
-    if (env.state.request) {
-      env.state.aborted = true;
-      env.state.request.abort();
-      env.state.request = null;
-    }
-    if (env.state.askRequest) {
-      env.state.stopped = true;
-      env.state.askRequest.abort();
-    }
     releaseRenderedContent();
     env.paintPill();
     env.syncRouteWatch();
@@ -7390,6 +7573,7 @@ function createHistoryController(env) {
     }
   }
   function applyHistoryEntry(entry, source) {
+    env.cancelBackground();
     var parts = entry.parts || {};
     env.state.parts = { translation: parts.translation || "", detail: parts.detail || "" };
     var replayTurns = Array.isArray(entry.turns) ? entry.turns : [];
@@ -7812,6 +7996,24 @@ function createConversationController(env) {
     }
     return false;
   }
+  function cancelBackground() {
+    var request = env.state.request;
+    if (request) {
+      env.state.request = null;
+      try {
+        request.abort();
+      } catch (error) {
+      }
+    }
+    var ask2 = env.state.askRequest;
+    if (ask2) {
+      env.state.askRequest = null;
+      try {
+        ask2.abort();
+      } catch (error) {
+      }
+    }
+  }
   async function ask(question) {
     var generating = env.state.asking || env.state.phase === "loading" || env.state.phase === "streaming";
     if (generating) {
@@ -7919,7 +8121,7 @@ function createConversationController(env) {
     var requestKey = env.state.cacheKey;
     env.state.stopped = false;
     var askController = new AbortController();
-    env.state.askRequest = {
+    var askHandle = {
       abort: function() {
         try {
           askController.abort();
@@ -7927,8 +8129,19 @@ function createConversationController(env) {
         }
       }
     };
+    env.state.askRequest = askHandle;
     function finish(error) {
       env.timerScope.clear(timer);
+      if (env.state.askRequest !== askHandle) {
+        answerTurn.asking = false;
+        answerTurn.streaming = false;
+        if (env.state.askRequest === null) {
+          env.state.asking = false;
+          env.state.toolBusy = false;
+          refreshAskState();
+        }
+        return;
+      }
       env.state.asking = false;
       env.state.toolBusy = false;
       env.clearTransientNotice(answerTurn);
@@ -8001,6 +8214,7 @@ function createConversationController(env) {
       var decoder = new TextDecoder();
       var buffer = "";
       function handle(block) {
+        if (env.state.askRequest !== askHandle) return;
         var lines = block.split("\n");
         for (var i = 0; i < lines.length; i++) {
           var line = lines[i];
@@ -8203,7 +8417,7 @@ function createConversationController(env) {
     env.state.cacheState = "miss";
     if (env.state.request) env.state.request.abort();
     var controller = new AbortController();
-    env.state.request = {
+    var handle = {
       abort: function() {
         try {
           controller.abort();
@@ -8211,6 +8425,7 @@ function createConversationController(env) {
         }
       }
     };
+    env.state.request = handle;
     env.state.raw = "";
     env.state.phase = "loading";
     env.state.error = "";
@@ -8244,7 +8459,7 @@ function createConversationController(env) {
       env.state.toolBusy = false;
       env.state.elapsed = Date.now() - env.state.startedAt;
       stopTicker();
-      env.state.request = null;
+      if (env.state.request === handle) env.state.request = null;
       clearWaiting();
       env.paint();
     }
@@ -8265,7 +8480,7 @@ function createConversationController(env) {
       env.state.chars = env.state.raw.length;
       env.state.toolBusy = false;
       stopTicker();
-      env.state.request = null;
+      if (env.state.request === handle) env.state.request = null;
       clearWaiting();
       if (cacheKey) env.cache.set(cacheKey, { parts: { ...env.state.parts }, turns: env.state.turns.slice() });
       if (env.state.turns === requestTurns && env.state.cacheKey === requestKey) env.saveHistory();
@@ -8273,6 +8488,7 @@ function createConversationController(env) {
     }
     var dirty = false;
     function handleEvent(block) {
+      if (env.state.request !== handle) return;
       var lines = block.split("\n");
       for (var i = 0; i < lines.length; i++) {
         var line = lines[i];
@@ -8364,7 +8580,7 @@ function createConversationController(env) {
       if (!response.body || !response.body.getReader) {
         return response.text().then(function(text) {
           text.split("\n\n").forEach(handleEvent);
-          succeed();
+          if (env.state.request === handle) succeed();
         });
       }
       var reader = response.body.getReader();
@@ -8374,7 +8590,7 @@ function createConversationController(env) {
         return reader.read().then(function(result) {
           if (result.done) {
             if (buffer.trim()) handleEvent(buffer);
-            if (env.state.phase !== "done" && env.state.phase !== "error") succeed();
+            if (env.state.request === handle && env.state.phase !== "done" && env.state.phase !== "error") succeed();
             return;
           }
           buffer += decoder.decode(result.value, { stream: true });
@@ -8393,6 +8609,7 @@ function createConversationController(env) {
     }).catch(function(error) {
       if (error && error.name === "AbortError") {
         if (env.state.aborted) fail("\u4E2D\u6B62");
+        else stopTicker();
         return;
       }
       fail(String(error && error.message || error));
@@ -8484,6 +8701,7 @@ function createConversationController(env) {
     refreshAskState,
     isGenerating,
     stopCurrent,
+    cancelBackground,
     sendAsk,
     runRequest,
     showWaiting,
@@ -10123,6 +10341,9 @@ function createControllers(env) {
     get runRequest() {
       return conversationController.runRequest;
     },
+    get cancelBackground() {
+      return conversationController.cancelBackground;
+    },
     get vcardHandoff() {
       return voiceCardController.vcardHandoff;
     },
@@ -10344,6 +10565,9 @@ function createControllers(env) {
     get clearWaiting() {
       return conversationController.clearWaiting;
     },
+    get cancelBackground() {
+      return conversationController.cancelBackground;
+    },
     get showWaiting() {
       return conversationController.showWaiting;
     },
@@ -10771,10 +10995,20 @@ function bindClientEvents(env) {
     if (env.quoteButton.contains(target)) return;
     if (env.pill.contains(target)) return;
     env.historyController.hideHistoryList();
+    if (target && typeof target.closest === "function" && target.closest("[data-text-interaction-surface]")) return;
     if (env.panel.contains(target)) return;
     env.selectionController.hideButton();
     env.voiceCardController.hideQuoteButton();
   }, true);
+  var offFloatPointerDown = listen(window, "pointerdown", function(event) {
+    if (event.button !== 0) return;
+    if (env.button.contains(event.target) || env.quoteButton.contains(event.target)) {
+      env.selectionController.beginFloatInteraction();
+    }
+  }, true);
+  var offFloatPointerUp = listen(window, "pointerup", env.selectionController.endFloatInteraction, true);
+  var offFloatPointerCancel = listen(window, "pointercancel", env.selectionController.endFloatInteraction, true);
+  var offFloatBlur = listen(window, "blur", env.selectionController.endFloatInteraction);
   var offButtonDown = listen(env.button, "mousedown", function(event) {
     event.preventDefault();
     event.stopPropagation();
@@ -10798,8 +11032,10 @@ function bindClientEvents(env) {
     env.voiceCardController.hideQuoteButton();
   });
   var offScroll = listen(window, "scroll", function(event) {
-    env.selectionController.hideButton();
-    env.voiceCardController.hideQuoteButton();
+    if (!env.selectionController.followPlatformSurface()) {
+      env.selectionController.hideButton();
+      env.voiceCardController.hideQuoteButton();
+    }
     var target = event && event.target;
     var insideList = !!(target && target.nodeType && env.historyList.contains(target));
     if (env.historyList.style.display === "flex" && !insideList) env.historyController.hideHistoryList();
@@ -10881,8 +11117,10 @@ function bindClientEvents(env) {
     applyPreviewHeight(frame, frame.parentNode && frame.parentNode.parentNode);
   });
   var offResize = listen(window, "resize", function() {
-    env.selectionController.hideButton();
-    env.voiceCardController.hideQuoteButton();
+    if (!env.selectionController.followPlatformSurface()) {
+      env.selectionController.hideButton();
+      env.voiceCardController.hideQuoteButton();
+    }
     env.conversationController.autoGrowAskBox();
     env.panelController.keepInsideViewport();
     if (env.historyList.style.display === "flex") env.historyController.placeHistoryList();
@@ -11029,6 +11267,10 @@ function bindClientEvents(env) {
     offSelectionChange();
     offVoiceEscape();
     offMouseDown();
+    offFloatPointerDown();
+    offFloatPointerUp();
+    offFloatPointerCancel();
+    offFloatBlur();
     offButtonDown();
     offButtonClick();
     offQuoteDown();
@@ -11082,17 +11324,24 @@ function bindClientEvents(env) {
 var CSS = [
   // 浮现动效：从锚点（右下角 = 贴着选区那侧）弹性放大。
   // 初始 74% + 6px 下移，缓动带过冲；时长 240ms —— 超过 ~300ms 连续划选会显得拖沓。
-  ".dsh-sel-btn{transform-origin:100% 100%;position:fixed;display:none;align-items:center;gap:5px;height:28px;padding:0 11px;border:0;border-radius:999px;",
-  // 浮标按钮保持**原样**：跟随主题主色（默认蓝 #3b6ef5），不跟面板的青色统一
-  "background:var(--dsw-alias-button-primary-fill,#3b6ef5);color:var(--dsw-alias-label-primary-foreground,#fff);",
-  "font:500 12px/1 " + FONT + ";cursor:pointer;white-space:nowrap;user-select:none;",
-  "box-shadow:0 6px 20px rgba(0,0,0,.24);transition:transform .1s ease,filter .1s ease}",
+  // 与 DSH 内置「引用文本」浮层同族：同一套设计变量、同一尺寸（30px 高 / 13px 字号 / 999 圆角）。
+  // 两枚按钮并排时看起来是一条工具条；深浅色交给宿主的 token 自动切换。
+  ".dsh-sel-btn{transform-origin:100% 100%;position:fixed;display:none;align-items:center;gap:6px;height:30px;padding:5px 10px;border:0;border-radius:999px;",
+  "background:var(--dsw-alias-button-floating-fill,#fff);color:var(--dsw-alias-label-primary,#0f1115);",
+  "font:400 13px/20px var(--dsw-font-family," + FONT + ");cursor:pointer;white-space:nowrap;user-select:none;",
+  "box-shadow:var(--dsw-elevation-panel,0 0 0 .5px #0000001f,0 3px 8px #00000008,0 0 16px #00000005);",
+  "transition:transform .1s ease,background .12s ease}",
+  // 停靠方向决定浮现原点：从贴着内置浮层的那一侧长出来。
+  '.dsh-sel-btn[data-dock="right"]{transform-origin:0% 100%}',
+  '.dsh-sel-btn[data-dock="left"]{transform-origin:100% 100%}',
+  '.dsh-sel-btn[data-dock="below"]{transform-origin:50% 0%}',
   "@keyframes dsh-sel-pop{from{opacity:0;transform:scale(.74) translateY(6px)}to{opacity:1;transform:none}}",
   // 只在"从隐藏到显示"那一次挂上这个类；animationend 后摘掉，
   // 否则 fill:both 会把 transform 钉在 none 上，:active 的按压缩放就永远不生效了
   // 用 data 属性而不是类名：类名不动，外面按 .dsh-sel-btn 找它/量它都不会被影响
   '.dsh-sel-btn[data-pop="1"]{animation:dsh-sel-pop .24s cubic-bezier(.34,1.56,.64,1) both}',
-  ".dsh-sel-btn:hover{filter:brightness(1.08)}",
+  // 悬停也走内置浮层的那一档底色（以前是对主色蓝做 brightness，换成浅底会发灰）。
+  ".dsh-sel-btn:hover{background:var(--dsw-alias-button-floating-hover,#f1f3f5)}",
   ".dsh-sel-btn:active{transform:scale(.97)}",
   // 图标：13px 画布 + **左移 1px**。
   // 为什么要有这个负外边距：画布是 16×16、图形墨迹只占中间 ~11px，左右各留 ~2px 空白，
@@ -12034,7 +12283,7 @@ function createClientView() {
   quoteButton.style.zIndex = String(Z_PANEL + 1);
   quoteButton.style.pointerEvents = "auto";
   quoteButton.appendChild(quoteIcon());
-  quoteButton.appendChild(el("span", null, "\u5F15\u7528"));
+  quoteButton.appendChild(el("span", null, "\u5F15\u7528\u5230\u5C0F\u7A97"));
   layer.appendChild(quoteButton);
   var pill = el("div", "dsh-sel-pill");
   pill.setAttribute("role", "button");
@@ -12374,6 +12623,24 @@ function createTimerScope() {
 
 // src/client/index.js
 function apply(ctx) {
+  var instanceId = "sel-" + Date.now().toString(36) + "-" + Math.random().toString(36).slice(2, 8);
+  try {
+    if (typeof window !== "undefined" && typeof window.__dshSelectionExplainDispose === "function") {
+      window.__dshSelectionExplainDispose();
+    }
+  } catch (error) {
+  }
+  function pruneForeignLayers() {
+    if (typeof document === "undefined" || typeof document.querySelectorAll !== "function") return;
+    var layers = document.querySelectorAll('.dsh-sel-layer[data-dsh-floating-owner="explanation"]');
+    for (var index = 0; index < layers.length; index += 1) {
+      var node = layers[index];
+      if (node && node.getAttribute("data-dsh-sel-instance") !== instanceId && node.parentNode) {
+        node.parentNode.removeChild(node);
+      }
+    }
+  }
+  pruneForeignLayers();
   var state = createClientState();
   var runtime = createPanelRuntime();
   var pillState = createPillState();
@@ -12382,6 +12649,14 @@ function apply(ctx) {
   var timerScope = createTimerScope();
   var view = createClientView();
   var { settingsSheet, modelMenu, settingsNote, settingsNoteText, settingsRail, settingsBody, pill, panel, settingsScrim, settingsButton, layer, body, translationSection, detailSection, button, quoteButton, askRow, quotesBox, expandButton, quote, retryButton, closeButton, askBox, pillName, pillMeta, pillCaret, pillStar, historyButton, chatLog, askSend, promoteButton, attachBox, attachNote, attachInput, modelPillName, modelPillTier, modelPill, webMode, cellMd, cellWeb, voiceActivityText, voiceActivity, voiceDot, voiceActionSlot, captureRow, askTools, askSpacer, micButton, waveSvg, voiceStop, voiceCancel, waveBars, prefSeg, settingsBack, settingsClose, settingsReset, addButton, head, gripCorner, gripRight, gripBottom, styleEl } = view;
+  layer.setAttribute("data-dsh-sel-instance", instanceId);
+  var foreignLayerObserver = null;
+  if (typeof MutationObserver === "function" && typeof document !== "undefined" && document.body) {
+    foreignLayerObserver = new MutationObserver(function() {
+      pruneForeignLayers();
+    });
+    foreignLayerObserver.observe(document.body, { childList: true });
+  }
   var { settingsController, selectionController, voiceCardController, quotesController, previewController, lightboxController, panelController, pillController, historyController, conversationController, attachController, shotController, modelsController, voiceController } = createControllers({
     get preferences() {
       return preferences;
@@ -12881,7 +13156,7 @@ function apply(ctx) {
       return head;
     }
   });
-  window.__dshSelectionExplain = {
+  var debugHook = window.__dshSelectionExplain = {
     /** 截图提问的状态（调试/自动化）。 */
     shot: function() {
       return shotController.state();
@@ -13463,6 +13738,12 @@ function apply(ctx) {
           // ⚠️ 必须给数组：设置页渲染列表时会 `[...row.aliases]`，
           // 留成 undefined 会直接抛 TypeError，整个快捷键弹窗打不开（实测踩到）。
           aliases: [],
+          // DSH 0.2.2 起这两个字段是命令契约的一部分（Web 运行时的分发与原生菜单都会读）：
+          //   · regions：哪些输入区域允许触发。截图是全局动作，页面/输入框/终端都给。
+          //   · modals：允许在哪些模态浮层里触发；空数组 = 任何模态开着都不抢键。
+          // 缺了它们桌面端还能靠 priority 短路"侥幸"可用，但 Web 端会直接抛 TypeError。
+          regions: ["page", "editable", "terminal"],
+          modals: [],
           // 键位是**物理键 + 修饰键**的结构（不是 "Mod+Shift+X" 这种字符串）：
           // code 必须是 KeyA-Z / Digit0-9 / F1-24 这类物理 code，modifiers 是 meta/control/alt/shift/primary
           // （primary 在 macOS 上是 ⌘、Windows 上是 Ctrl）。
@@ -13497,7 +13778,10 @@ function apply(ctx) {
     if (typeof console !== "undefined" && console.log) {
       console.log("[dsh-selection-explain] \u5212\u8BCD\u89E3\u8BFB\u5DF2\u5C31\u7EEA\uFF08\u9009\u4E2D\u6587\u5B57\u8BD5\u8BD5\uFF09");
     }
-    return function() {
+    var cleaned = false;
+    function cleanup() {
+      if (cleaned) return;
+      cleaned = true;
       runtime.panelOpen = false;
       timerScope.dispose();
       cache.dispose();
@@ -13509,6 +13793,7 @@ function apply(ctx) {
       panelController.releaseRenderedContent();
       if (state.askRequest) state.askRequest.abort();
       clientEvents.dispose();
+      selectionController.dispose();
       if (floatWatchId) clearInterval(floatWatchId);
       voiceController.cancelVoice();
       if (historyController.chatGrowWatch) historyController.chatGrowWatch.disconnect();
@@ -13525,6 +13810,13 @@ function apply(ctx) {
         pillState.pillObserver = null;
       }
       if (fullViewObserver) fullViewObserver.disconnect();
+      if (foreignLayerObserver) {
+        try {
+          foreignLayerObserver.disconnect();
+        } catch (error) {
+        }
+        foreignLayerObserver = null;
+      }
       if (typeof offSlot === "function") offSlot();
       if (previewController.bridgeScanId) clearTimeout(previewController.bridgeScanId);
       previewController.bridgeScanId = 0;
@@ -13561,11 +13853,21 @@ function apply(ctx) {
       if (pill.parentNode) pill.parentNode.removeChild(pill);
       if (styleEl.parentNode) styleEl.parentNode.removeChild(styleEl);
       try {
-        delete window.__dshSelectionExplain;
+        if (window.__dshSelectionExplain === debugHook) delete window.__dshSelectionExplain;
       } catch (error) {
-        window.__dshSelectionExplain = void 0;
+        if (window.__dshSelectionExplain === debugHook) window.__dshSelectionExplain = void 0;
       }
-    };
+      try {
+        if (window.__dshSelectionExplainDispose === cleanup) delete window.__dshSelectionExplainDispose;
+      } catch (error) {
+        if (window.__dshSelectionExplainDispose === cleanup) window.__dshSelectionExplainDispose = void 0;
+      }
+    }
+    try {
+      window.__dshSelectionExplainDispose = cleanup;
+    } catch (error) {
+    }
+    return cleanup;
   }, "@yfwu2020/dsh-selection-explain: \u5212\u8BCD\u89E3\u8BFB UI");
 }
 var inject = ["slots", "shortcuts"];