@yfwu2020/dsh-selection-explain 0.9.0 → 0.9.1

package/README.md

@@ -290,6 +290,7 @@ dsh plugin --profile web remove @yfwu2020/dsh-selection-explain
 
 **几个不别扭的细节：**
 
+- **与完整视图聊天小窗共存（0.9.1）**：Esc 优先退出最后点击或操作的展开小窗。点标题、消息或窗内空白就算激活，不要求点中输入框。聊天先收回紧凑条，解读按设置下拉、设置、录音、面板逐层退出；点击两窗之外会清除活动归属，之后先退解读，再按一次收起聊天。每次只退一层，无需重新点击；历史列表属于解读，原生菜单和输入法仍优先。需要解读插件 0.9.1 与完整视图插件 0.1.5 配合，普通分栏保留原 Esc 行为。
 - **点面板外不会关闭面板**。答案留在原地，只有 `✕` / `Esc` / 右下角胶囊能收起——不会因为手滑点一下就得重新问。
 - **输入框跟着内容长高**：写（或说）到第二行就自己撑开，最多约 7 行（132px）；再长就内部滚动并**自动停在最新一行**——不会像以前那样第二行以下的字被裁掉。
 - **开窗即能打字**：小窗打开、输入框出现后会自动获得焦点（只有"你正在别处打字"时才不抢）。`Tab` 也能摸到输入框和 🎤。

package/lib/client.js

@@ -217,6 +217,22 @@ window.__ModuleLoader__.load({
       return value < min ? min : value > max ? max : value
     }
 
+    /**
+     * 选区是不是"指着一段已经不在文档里的文字"。
+     *
+     * 这是"选中的文字被删掉"的第二种形态，跟塌陷（`isCollapsed`）**不是**一回事：
+     * 节点被整个摘掉时（流式回答重渲染 / 消息被替换 / 内容区刷新），Firefox 里选区并不塌陷 ——
+     * `isCollapsed` 仍是 false、`toString()` 还吐得出那段旧文字，可那段文字屏幕上已经没有了。
+     * 只认塌陷的话浮标会赖着不走，点下去解读的是一段**不存在的文字**。
+     *
+     * 取不到 `isConnected`（老环境 / 无浏览器测试的桩 DOM）时一律当"还在"：
+     * 宁可多留一会儿，也不误收一个正常选区。
+     */
+    function selectionDetached(range) {
+      var node = range && range.startContainer
+      return !!node && node.isConnected === false
+    }
+
     /** 选区是否落在输入框里（那里不该弹按钮，避免干扰输入）。 */
     function insideEditable(node) {
       var element = node && node.nodeType === 1 ? node : node && node.parentElement
@@ -3513,8 +3529,23 @@ window.__ModuleLoader__.load({
 
       // —— 选区 → 浮标 ——
 
+      /**
+       * 排一次选区检查（下一拍执行）。
+       *
+       * 同一拍里的多次请求**合并成一次**：`selectionchange` 在打字 / 流式重绘时会连发很多下，
+       * 每下都排一个计时器的话 `timers` 数组会一直长（文件里别处也刻意避开这种写法，
+       * 见 schedulePillIdle 的注释）。合并是安全的 —— 检查读的是"当下"的选区，
+       * 而不是排队那一刻的快照。
+       */
+      var checkPending = false
+
       function scheduleCheck() {
-        later(checkSelection, 0)
+        if (checkPending) return
+        checkPending = true
+        later(function () {
+          checkPending = false
+          checkSelection()
+        }, 0)
       }
 
       /**
@@ -3614,6 +3645,12 @@ window.__ModuleLoader__.load({
         } catch (error) {
           return
         }
+        // 选中的节点被整个摘掉了（流式回答重渲染 / 消息换掉）：那段文字已经不在屏幕上
+        if (selectionDetached(range)) {
+          state.quoteSelection = null
+          hideQuoteButton()
+          return
+        }
         var text = String(selection.toString() || '')
         if (!text.trim() || text.length > MAX_QUOTE_SELECTION) {
           state.quoteSelection = null
@@ -3698,6 +3735,12 @@ window.__ModuleLoader__.load({
           return
         }
         var range = selection.getRangeAt(0)
+        // 选中的节点被整个摘掉了（流式回答重渲染 / 消息换掉）：那段文字已经不在屏幕上，
+        // 浮标不该留着（否则点下去解读的是一段不存在的文字）
+        if (selectionDetached(range)) {
+          hideButton()
+          return
+        }
         if (insideEditable(range.startContainer)) {
           hideButton()
           return
@@ -7653,7 +7696,25 @@ window.__ModuleLoader__.load({
         setQuotePop(false)
       })
 
+      /**
+       * 鼠标是不是按着（拖拽划词进行中）—— 记的是"按下那一刻"。
+       *
+       * 为什么记时刻而不是记一个布尔：松手落在浏览器窗口外时**不会补发 mouseup**，
+       * 布尔一旦卡在 true，`selectionchange` 就被永久忽略 —— 浮标从此再也不会自己收了。
+       * 超过 SELECT_PRESS_STALE_MS 就当已经松开（帧内那条桥用的是同一个兜底，见 bridgeBody）。
+       *
+       * 拖拽期间一律不查选区：时机要和"松手才弹浮标"一致，否则拖到一半浮标就冒出来，
+       * 还跟着手指跑。
+       */
+      var SELECT_PRESS_STALE_MS = 6000
+      var selectPressedAt = 0
+
+      function selectPressing() {
+        return selectPressedAt > 0 && Date.now() - selectPressedAt < SELECT_PRESS_STALE_MS
+      }
+
       var offMouseUp = listen(document, 'mouseup', function (event) {
+        selectPressedAt = 0
         // 面板里的 mouseup **也要走一次检查**：小窗开着时"划小窗正文"正是「引用」的主入口
         // （早先这里对面板直接 return —— 那是"面板里划词一律不管"年代的写法，
         //  结果就是小窗里划词毫无反应，只有气泡末尾的「引用整条」能用）。
@@ -7667,7 +7728,62 @@ window.__ModuleLoader__.load({
         }
       }, true)
 
+      /**
+       * 选中的文字**没了** → 浮标跟着消失。
+       *
+       * 为什么非要有这一条：浮标只在 mouseup 和少数几个键的 keyup 之后被检查，
+       * 而"把选中的字删掉"这两种动作都不在那条路径上 ——
+       *   · Backspace / Delete / 直接打字覆盖 / 剪切 / 撤回（⌘Z）；
+       *   · 内容刷新把选中的节点整个换掉（流式回答重渲染、消息重画）。
+       * 于是浮标赖在屏幕上不走，点下去还会解读一段**屏幕上已经不存在**的文字（用户报的正是这个）。
+       *
+       * `selectionchange` 是浏览器对"选区变了"最权威的信号（塌陷 / 被删 / 被程序改动都会发），
+       * 用它兜住所有非鼠标路径；节点被摘掉但选区没塌陷那种（Firefox）另有 selectionDetached 判死。
+       */
+      var offSelectionChange = listen(document, 'selectionchange', function () {
+        if (selectPressing()) return
+        scheduleCheck()
+      }, true)
+
+      /**
+       * 浮标亮着的时候，隔几拍确认一次"那段文字还在不在"。
+       *
+       * 为什么光有事件还不够：**Chrome 把选中的节点整个摘掉时会悄悄把选区塌陷，却不发
+       * `selectionchange`**（真浏览器实测：替换 textContent 后 `rangeCount` 仍是 1、
+       * `isCollapsed` 变成 true，而事件计数一个都不涨）。流式回答重渲染 / 消息重画走的正是这条路 ——
+       * 只靠事件的话，浮标会一直亮着，点下去解读的是一段屏幕上已经没有的文字。
+       *
+       * 代价是可控的：**只在浮标可见的那几拍里干活**（它不可见时这一拍立刻返回，
+       * 连选区都不读），而且只有发现选区没了/锚点被摘掉时才去排一次检查 ——
+       * 正常亮着的那几拍不做任何 DOM 写。
+       */
+      var FLOAT_WATCH_MS = 400
+
+      function watchFloatLiveness() {
+        // 拖拽划词进行中不查：浮标要等松手才出现（与 mouseup 那条路径同一套时机）
+        if (selectPressing()) return
+        if (button.style.display !== 'inline-flex' && quoteButton.style.display !== 'inline-flex') return
+        var selection = window.getSelection && window.getSelection()
+        if (!selection || selection.rangeCount === 0 || selection.isCollapsed) {
+          // 帧内那条选区**不在本文档**：点浮标会让本文档的选区塌掉，别把它误当成"文字没了"
+          if (state.bridgeActive && state.selection && state.selection.source === 'iframe') return
+          scheduleCheck()
+          return
+        }
+        var range = null
+        try {
+          range = selection.getRangeAt(0)
+        } catch (error) {
+          return
+        }
+        // 选区没塌陷、锚点却被摘掉了（Firefox 的行为）：也当"文字没了"
+        if (selectionDetached(range)) scheduleCheck()
+      }
+
+      var floatWatchId = setInterval(watchFloatLiveness, FLOAT_WATCH_MS)
+
       var offMouseDown = listen(document, 'mousedown', function (event) {
+        selectPressedAt = Date.now()
         var target = event.target
         // 模型菜单：点它自己和胶囊之外**任何地方**都收起。
         // 必须放在最前面 —— 下面的 historyButton / pill / panel 分支都会 return，
@@ -8267,7 +8383,20 @@ window.__ModuleLoader__.load({
       })
 
       var offKeyDown = listen(document, 'keydown', function (event) {
-        if (event.key !== 'Escape' || !panelOpen) return
+        if (event.key !== 'Escape' || !panelOpen || event.defaultPrevented || event.isComposing || event.keyCode === 229) return
+        // 完整视图记录最后点击/操作的小窗；不能只看可能停在另一窗的键盘焦点。
+        var fullViewFrame = document.querySelector('[data-dsh-full-view]')
+        if (fullViewFrame) {
+          var escapeTarget = event.target
+          var canFindEscapeOwner = escapeTarget && typeof escapeTarget.closest === 'function'
+          var expandedChatSelector = '[data-dsh-floating-chat]:not([data-dsh-chat-minimized]):not([data-dsh-chat-hidden])'
+          var activeFloatingWindow = fullViewFrame.getAttribute('data-dsh-active-floating-window')
+          if (activeFloatingWindow === 'chat' && document.querySelector(expandedChatSelector)) return
+          // 与旧版完整视图共存时仍保留原来的键盘焦点判断。
+          if (activeFloatingWindow === null && canFindEscapeOwner && escapeTarget.closest(expandedChatSelector)) return
+          // 宿主菜单可能挂在聊天外；让它先消费 Esc，不连带关闭解读。
+          if (!panel.contains(escapeTarget) && !historyList.contains(escapeTarget) && canFindEscapeOwner && escapeTarget.closest('[role="menu"], [role="listbox"], [data-trigger-menu]')) return
+        }
         // Esc 分三级：**从最内层往外退**，一次只退一层（用户按一次不该连关两层）。
         //   ① 设置抽屉开着 → 只收抽屉，小窗留着（用户多半只是改完想接着看解读）；
         //   ② 语音进行中（录音行还在）→ 只取消这一次语音（等价于点 ✕，已经说出来的字留着）；
@@ -10147,6 +10276,8 @@ window.__ModuleLoader__.load({
           offQuotePopEnd()
           offMouseUp()
           offKeyUp()
+          offSelectionChange()
+          if (floatWatchId) clearInterval(floatWatchId)
           offMouseDown()
           offButtonDown()
           offButtonClick()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yfwu2020/dsh-selection-explain",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "DSH 划词解读：选中文字浮出按钮，点击弹窗流式显示专业中英翻译 + 该文字在当前上下文中的含义详解",
   "type": "module",
   "main": "./lib/index.js",
@@ -42,7 +42,7 @@
   "scripts": {
     "build": "bash scripts/build.sh",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "node scripts/test-filters.mjs && node scripts/test-prompt.mjs && node scripts/test-model-follow.mjs && node scripts/test-bridge.mjs && node scripts/smoke-bridge.mjs && node scripts/smoke-panel.mjs && node scripts/test-client.mjs && node scripts/test-settings-host.mjs && node scripts/test-settings-behavior.mjs && node scripts/test-route-cache.mjs && node scripts/test-transcript.mjs && node scripts/test-guard.mjs && node scripts/test-settings.mjs && node scripts/test-format.mjs && node scripts/test-speech.mjs && node scripts/smoke-voice.mjs",
+    "test": "node scripts/test-filters.mjs && node scripts/test-prompt.mjs && node scripts/test-model-follow.mjs && node scripts/test-bridge.mjs && node scripts/smoke-bridge.mjs && node scripts/smoke-panel.mjs && node scripts/test-escape-focus.mjs && node scripts/test-client.mjs && node scripts/test-settings-host.mjs && node scripts/test-settings-behavior.mjs && node scripts/test-route-cache.mjs && node scripts/test-transcript.mjs && node scripts/test-guard.mjs && node scripts/test-settings.mjs && node scripts/test-format.mjs && node scripts/test-speech.mjs && node scripts/smoke-voice.mjs",
     "test:transcript": "node scripts/test-transcript.mjs",
     "test:guard": "node scripts/test-guard.mjs",
     "test:format": "node scripts/test-format.mjs",

package/scripts/smoke-panel.mjs

@@ -734,6 +734,42 @@ async function main() {
     }
   }
 
+  // ⑨-b 选中的文字被删掉 → 浮标跟着消失（用户报的：文字没了，浮标还赖在屏幕上）
+  {
+    hook.close()
+    await sleep(80)
+    var planBtn2 = document.querySelector('.dsh-sel-btn:not(.dsh-sel-quotebtn)')
+    var docp3 = document.getElementById('docp')
+    selectIn(docp3, 'the migration ran long')
+    mouseUpOn(docp3)
+    var lit = await waitFor(function () {
+      return planBtn2 && planBtn2.style.display !== 'none' && planBtn2.getBoundingClientRect().width > 0
+    }, 1500)
+    check('（准备）主界面划词浮出「✦ 解读」', lit === true, planBtn2 ? planBtn2.style.display : '未找到按钮')
+
+    // ① 选区塌陷（Backspace / Delete / 打字覆盖 / 剪切走的都是这条）：浏览器会发 selectionchange
+    window.getSelection().removeAllRanges()
+    var gone = await waitFor(function () { return planBtn2.style.display === 'none' }, 800)
+    check('选中的文字被删掉（选区塌陷）→ 浮标消失', gone === true, planBtn2 ? planBtn2.style.display : '未找到按钮')
+
+    // ② 选中的节点被整个换掉（流式回答重渲染就是这条）：那段文字没了，浮标也不该留着。
+    //    ⚠️ 先确认浮标**真的收掉了**再往下走：不然 ① 漏掉时浮标一直亮着，
+    //      下面的"再次亮着"会白捡一个 PASS（这条用例就测不出东西了）。
+    var settled = await waitFor(function () { return planBtn2.style.display === 'none' }, 800)
+    check('（准备 ②）① 之后浮标确实是收着的', settled === true, planBtn2 ? planBtn2.style.display : '未找到按钮')
+    selectIn(docp3, 'the migration ran long')
+    mouseUpOn(docp3)
+    var lit2 = await waitFor(function () {
+      return planBtn2 && planBtn2.style.display !== 'none' && planBtn2.getBoundingClientRect().width > 0
+    }, 1500)
+    check('（准备 ②）浮标再次亮着', lit2 === true, planBtn2 ? planBtn2.style.display : '未找到按钮')
+    docp3.textContent = '（这段文字已经被换掉了）'
+    var gone2 = await waitFor(function () { return planBtn2.style.display === 'none' }, 800)
+    check('选中的节点被摘掉（文字被换掉）→ 浮标也消失', gone2 === true, planBtn2 ? planBtn2.style.display : '未找到按钮')
+    docp3.textContent = 'Dev: the migration ran long, so we ship Wednesday.'
+    await sleep(30)
+  }
+
   // ⑩ 浮标图标的**墨迹**要在画布里居中（用户报的："✦ 和 解读 好像没对齐，也没在按钮里居中"）
   //    为什么量 getBBox 而不是截图：浮动按钮是 align-items:center 的 flex，居中的是**画布盒子**，
   //    图形在画布里偏一点，图标就整体偏一点 —— 老星形路径 y 占 1.2~12.4（中心 6.8，不是 8），

package/scripts/test-client.mjs

@@ -1091,6 +1091,62 @@ assert('选中文字后浮标出现', !!button && button.style.display === 'inli
 
 }
 
+// ───────────────────────── 选中的文字被删掉 → 浮标必须消失 ─────────────────────────
+// 用户报的：划词浮标出来之后，把那段文字删了（Backspace / 打字覆盖 / 内容刷新把节点换掉），
+// 浮标还赖在屏幕上不走，点下去解读的是一段**屏幕上已经不存在**的文字。
+{
+  const rect = { left: 40, top: 100, right: 200, bottom: 118, width: 160, height: 18 }
+  /** 造一段"落在 node 上"的选区（锚点就是 node —— isConnected 那条判定要用它）。 */
+  const selectOn = (node, text) => {
+    const range = {
+      startContainer: node,
+      endContainer: node,
+      cloneRange: () => range,
+      getClientRects: () => [rect],
+      getBoundingClientRect: () => rect,
+    }
+    windowStub.getSelection = () => ({
+      isCollapsed: false,
+      rangeCount: 1,
+      toString: () => text,
+      getRangeAt: () => range,
+    })
+  }
+
+  // ① 拖拽划词进行中（鼠标按着）：不弹浮标 —— 时机要和"松手才弹"一致
+  selectOn(textEl, 'the migration ran long')
+  documentStub.dispatch('mousedown', { target: container })
+  documentStub.dispatch('selectionchange', {})
+  await sleep(20)
+  assert('拖拽中（鼠标按着）不弹浮标', button.style.display === 'none', String(button.style.display))
+  documentStub.dispatch('mouseup', { target: container })
+  await sleep(20)
+  assert('松手后照常弹浮标', button.style.display === 'inline-flex', String(button.style.display))
+
+  // ② 选区塌陷（Backspace / Delete / 打字覆盖 / 剪切走的都是这条）：浏览器发 selectionchange
+  windowStub.getSelection = () => ({ isCollapsed: true, rangeCount: 0, toString: () => '' })
+  documentStub.dispatch('selectionchange', {})
+  await sleep(20)
+  assert('选中的文字被删掉（选区塌陷）→ 浮标消失', button.style.display === 'none', String(button.style.display))
+
+  // ③ 选区**没塌陷**、锚点节点却已经被摘掉（Firefox 的行为）：靠 isConnected 判死
+  selectOn(textEl, 'the migration ran long')
+  documentStub.dispatch('mouseup', { target: container })
+  await sleep(20)
+  assert('（准备）浮标重新亮着', button.style.display === 'inline-flex', String(button.style.display))
+  textEl.isConnected = false
+  documentStub.dispatch('selectionchange', {})
+  await sleep(20)
+  assert('选中的节点被摘掉（选区没塌陷）→ 浮标也消失', button.style.display === 'none', String(button.style.display))
+  delete textEl.isConnected
+
+  // 还原成开头那段选区：后面的用例还要点这个浮标开小窗
+  windowStub.getSelection = () => selection
+  documentStub.dispatch('mouseup', { target: body })
+  await sleep(20)
+  assert('（还原）浮标回到可见', button.style.display === 'inline-flex', String(button.style.display))
+}
+
 // 引用（❝）的**离线**契约：浮标进了浮层、CSS 规则齐全（真实交互在宿主可达时另有一段）
 {
   const css = readFileSync(BUNDLE, 'utf8')

package/scripts/test-escape-focus.mjs

@@ -0,0 +1,66 @@
+/** Run the actual document Esc handler with isolated focus and panel state. No host/API access. */
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import vm from 'node:vm'
+const source = readFileSync(new URL('../src/client/index.js', import.meta.url), 'utf8')
+const start = source.indexOf('      var offKeyDown = listen(document,')
+const end = source.indexOf('\n\n      var offSettingsOpen', start)
+assert.ok(start >= 0 && end > start)
+const ask = {}, historyInput = {}, outside = {}, expandedChat = { closest: selector => selector.startsWith('[data-dsh-floating-chat]') ? {} : null }, compactChat = { closest: () => null }, nativeMenu = { closest: selector => selector.startsWith('[role=') ? {} : null }
+let handler, fullView = true, calls = [], activeWindow = null, chatExpanded = true
+const context = vm.createContext({
+  panelOpen: true, settingsOpen: false,
+  panel: { contains: node => node === ask },
+  historyList: { contains: node => node === historyInput },
+  document: { querySelector: selector => selector === '[data-dsh-full-view]' && fullView
+    ? { getAttribute: () => activeWindow }
+    : selector.startsWith('[data-dsh-floating-chat]') && chatExpanded ? {} : null },
+  listen(target, type, callback, capture) { assert.equal(type, 'keydown'); assert.equal(capture, true); handler = callback },
+  captureRow: { getAttribute: () => '0' }, settingsByKey: {},
+  closeModelPicks() { calls.push('menu') },
+  closeSettings() { calls.push('settings'); context.settingsOpen = false },
+  cancelVoice() { calls.push('voice') },
+  closePanel() { calls.push('panel'); context.panelOpen = false },
+})
+new vm.Script(source.slice(start, end)).runInContext(context)
+function escape(target, extra = {}) {
+  const event = { key: 'Escape', target, ...extra, preventDefault() { calls.push('prevent') }, stopPropagation() { calls.push('stop') } }
+  handler(event)
+}
+function reset() { calls = []; activeWindow = null; chatExpanded = true; context.panelOpen = true; context.settingsOpen = false; context.settingsByKey = {}; context.captureRow.getAttribute = () => '0' }
+reset(); activeWindow = 'chat'; escape(ask)
+assert.deepEqual(calls, [], '最后点击聊天后，即使键盘仍在解读输入框，也让聊天先退出')
+reset(); activeWindow = 'explanation'; escape(expandedChat)
+assert.equal(context.panelOpen, false, '最后点击解读消息后，即使键盘仍在聊天，也先退解读')
+reset(); activeWindow = 'none'; escape(expandedChat)
+assert.equal(context.panelOpen, false, '点击两窗外后不使用旧键盘焦点，优先退解读')
+reset(); activeWindow = 'chat'; chatExpanded = false; escape(compactChat)
+assert.equal(context.panelOpen, false, '已收起的聊天不占下一次退出顺序')
+reset()
+escape(outside)
+assert.equal(context.panelOpen, false, '焦点在两窗之外时优先关闭解读')
+reset(); escape(expandedChat)
+assert.deepEqual(calls, [], '展开聊天的 Esc 交给聊天，不关闭解读')
+assert.equal(context.panelOpen, true)
+reset(); escape(compactChat)
+assert.equal(context.panelOpen, false, '聊天收起后焦点留在紧凑条，再按 Esc 仍能关闭解读')
+reset(); escape(nativeMenu)
+assert.deepEqual(calls, [], '原生菜单先处理自身 Esc，不连带关闭解读')
+for (const extra of [{ isComposing: true }, { keyCode: 229 }, { defaultPrevented: true }]) {
+  reset(); escape(ask, extra); assert.deepEqual(calls, [], '输入法或已处理的 Esc 不关闭解读')
+}
+reset(); context.settingsOpen = true; context.settingsByKey = { model: { menu: { getAttribute: () => '1' } } }; escape(ask)
+assert.deepEqual(calls, ['prevent', 'stop', 'menu'])
+assert.equal(context.panelOpen, true)
+reset(); context.settingsOpen = true; escape(ask)
+assert.deepEqual(calls, ['prevent', 'stop', 'settings'])
+assert.equal(context.panelOpen, true)
+reset(); context.captureRow.getAttribute = () => '1'; escape(ask)
+assert.deepEqual(calls, ['prevent', 'stop', 'voice'])
+assert.equal(context.panelOpen, true)
+for (const target of [ask, historyInput]) {
+  reset(); escape(target); assert.deepEqual(calls, ['prevent', 'stop', 'panel']); assert.equal(context.panelOpen, false)
+}
+reset(); fullView = false; escape(outside)
+assert.equal(context.panelOpen, false, '普通分栏保留解读原来的全局 Esc 行为')
+console.log('PASS focused Esc: independent windows, IME, nested settings, voice, history and split-mode behavior')

package/src/client/index.js

@@ -217,6 +217,22 @@ window.__ModuleLoader__.load({
       return value < min ? min : value > max ? max : value
     }
 
+    /**
+     * 选区是不是"指着一段已经不在文档里的文字"。
+     *
+     * 这是"选中的文字被删掉"的第二种形态，跟塌陷（`isCollapsed`）**不是**一回事：
+     * 节点被整个摘掉时（流式回答重渲染 / 消息被替换 / 内容区刷新），Firefox 里选区并不塌陷 ——
+     * `isCollapsed` 仍是 false、`toString()` 还吐得出那段旧文字，可那段文字屏幕上已经没有了。
+     * 只认塌陷的话浮标会赖着不走，点下去解读的是一段**不存在的文字**。
+     *
+     * 取不到 `isConnected`（老环境 / 无浏览器测试的桩 DOM）时一律当"还在"：
+     * 宁可多留一会儿，也不误收一个正常选区。
+     */
+    function selectionDetached(range) {
+      var node = range && range.startContainer
+      return !!node && node.isConnected === false
+    }
+
     /** 选区是否落在输入框里（那里不该弹按钮，避免干扰输入）。 */
     function insideEditable(node) {
       var element = node && node.nodeType === 1 ? node : node && node.parentElement
@@ -3513,8 +3529,23 @@ window.__ModuleLoader__.load({
 
       // —— 选区 → 浮标 ——
 
+      /**
+       * 排一次选区检查（下一拍执行）。
+       *
+       * 同一拍里的多次请求**合并成一次**：`selectionchange` 在打字 / 流式重绘时会连发很多下，
+       * 每下都排一个计时器的话 `timers` 数组会一直长（文件里别处也刻意避开这种写法，
+       * 见 schedulePillIdle 的注释）。合并是安全的 —— 检查读的是"当下"的选区，
+       * 而不是排队那一刻的快照。
+       */
+      var checkPending = false
+
       function scheduleCheck() {
-        later(checkSelection, 0)
+        if (checkPending) return
+        checkPending = true
+        later(function () {
+          checkPending = false
+          checkSelection()
+        }, 0)
       }
 
       /**
@@ -3614,6 +3645,12 @@ window.__ModuleLoader__.load({
         } catch (error) {
           return
         }
+        // 选中的节点被整个摘掉了（流式回答重渲染 / 消息换掉）：那段文字已经不在屏幕上
+        if (selectionDetached(range)) {
+          state.quoteSelection = null
+          hideQuoteButton()
+          return
+        }
         var text = String(selection.toString() || '')
         if (!text.trim() || text.length > MAX_QUOTE_SELECTION) {
           state.quoteSelection = null
@@ -3698,6 +3735,12 @@ window.__ModuleLoader__.load({
           return
         }
         var range = selection.getRangeAt(0)
+        // 选中的节点被整个摘掉了（流式回答重渲染 / 消息换掉）：那段文字已经不在屏幕上，
+        // 浮标不该留着（否则点下去解读的是一段不存在的文字）
+        if (selectionDetached(range)) {
+          hideButton()
+          return
+        }
         if (insideEditable(range.startContainer)) {
           hideButton()
           return
@@ -7653,7 +7696,25 @@ window.__ModuleLoader__.load({
         setQuotePop(false)
       })
 
+      /**
+       * 鼠标是不是按着（拖拽划词进行中）—— 记的是"按下那一刻"。
+       *
+       * 为什么记时刻而不是记一个布尔：松手落在浏览器窗口外时**不会补发 mouseup**，
+       * 布尔一旦卡在 true，`selectionchange` 就被永久忽略 —— 浮标从此再也不会自己收了。
+       * 超过 SELECT_PRESS_STALE_MS 就当已经松开（帧内那条桥用的是同一个兜底，见 bridgeBody）。
+       *
+       * 拖拽期间一律不查选区：时机要和"松手才弹浮标"一致，否则拖到一半浮标就冒出来，
+       * 还跟着手指跑。
+       */
+      var SELECT_PRESS_STALE_MS = 6000
+      var selectPressedAt = 0
+
+      function selectPressing() {
+        return selectPressedAt > 0 && Date.now() - selectPressedAt < SELECT_PRESS_STALE_MS
+      }
+
       var offMouseUp = listen(document, 'mouseup', function (event) {
+        selectPressedAt = 0
         // 面板里的 mouseup **也要走一次检查**：小窗开着时"划小窗正文"正是「引用」的主入口
         // （早先这里对面板直接 return —— 那是"面板里划词一律不管"年代的写法，
         //  结果就是小窗里划词毫无反应，只有气泡末尾的「引用整条」能用）。
@@ -7667,7 +7728,62 @@ window.__ModuleLoader__.load({
         }
       }, true)
 
+      /**
+       * 选中的文字**没了** → 浮标跟着消失。
+       *
+       * 为什么非要有这一条：浮标只在 mouseup 和少数几个键的 keyup 之后被检查，
+       * 而"把选中的字删掉"这两种动作都不在那条路径上 ——
+       *   · Backspace / Delete / 直接打字覆盖 / 剪切 / 撤回（⌘Z）；
+       *   · 内容刷新把选中的节点整个换掉（流式回答重渲染、消息重画）。
+       * 于是浮标赖在屏幕上不走，点下去还会解读一段**屏幕上已经不存在**的文字（用户报的正是这个）。
+       *
+       * `selectionchange` 是浏览器对"选区变了"最权威的信号（塌陷 / 被删 / 被程序改动都会发），
+       * 用它兜住所有非鼠标路径；节点被摘掉但选区没塌陷那种（Firefox）另有 selectionDetached 判死。
+       */
+      var offSelectionChange = listen(document, 'selectionchange', function () {
+        if (selectPressing()) return
+        scheduleCheck()
+      }, true)
+
+      /**
+       * 浮标亮着的时候，隔几拍确认一次"那段文字还在不在"。
+       *
+       * 为什么光有事件还不够：**Chrome 把选中的节点整个摘掉时会悄悄把选区塌陷，却不发
+       * `selectionchange`**（真浏览器实测：替换 textContent 后 `rangeCount` 仍是 1、
+       * `isCollapsed` 变成 true，而事件计数一个都不涨）。流式回答重渲染 / 消息重画走的正是这条路 ——
+       * 只靠事件的话，浮标会一直亮着，点下去解读的是一段屏幕上已经没有的文字。
+       *
+       * 代价是可控的：**只在浮标可见的那几拍里干活**（它不可见时这一拍立刻返回，
+       * 连选区都不读），而且只有发现选区没了/锚点被摘掉时才去排一次检查 ——
+       * 正常亮着的那几拍不做任何 DOM 写。
+       */
+      var FLOAT_WATCH_MS = 400
+
+      function watchFloatLiveness() {
+        // 拖拽划词进行中不查：浮标要等松手才出现（与 mouseup 那条路径同一套时机）
+        if (selectPressing()) return
+        if (button.style.display !== 'inline-flex' && quoteButton.style.display !== 'inline-flex') return
+        var selection = window.getSelection && window.getSelection()
+        if (!selection || selection.rangeCount === 0 || selection.isCollapsed) {
+          // 帧内那条选区**不在本文档**：点浮标会让本文档的选区塌掉，别把它误当成"文字没了"
+          if (state.bridgeActive && state.selection && state.selection.source === 'iframe') return
+          scheduleCheck()
+          return
+        }
+        var range = null
+        try {
+          range = selection.getRangeAt(0)
+        } catch (error) {
+          return
+        }
+        // 选区没塌陷、锚点却被摘掉了（Firefox 的行为）：也当"文字没了"
+        if (selectionDetached(range)) scheduleCheck()
+      }
+
+      var floatWatchId = setInterval(watchFloatLiveness, FLOAT_WATCH_MS)
+
       var offMouseDown = listen(document, 'mousedown', function (event) {
+        selectPressedAt = Date.now()
         var target = event.target
         // 模型菜单：点它自己和胶囊之外**任何地方**都收起。
         // 必须放在最前面 —— 下面的 historyButton / pill / panel 分支都会 return，
@@ -8267,7 +8383,20 @@ window.__ModuleLoader__.load({
       })
 
       var offKeyDown = listen(document, 'keydown', function (event) {
-        if (event.key !== 'Escape' || !panelOpen) return
+        if (event.key !== 'Escape' || !panelOpen || event.defaultPrevented || event.isComposing || event.keyCode === 229) return
+        // 完整视图记录最后点击/操作的小窗；不能只看可能停在另一窗的键盘焦点。
+        var fullViewFrame = document.querySelector('[data-dsh-full-view]')
+        if (fullViewFrame) {
+          var escapeTarget = event.target
+          var canFindEscapeOwner = escapeTarget && typeof escapeTarget.closest === 'function'
+          var expandedChatSelector = '[data-dsh-floating-chat]:not([data-dsh-chat-minimized]):not([data-dsh-chat-hidden])'
+          var activeFloatingWindow = fullViewFrame.getAttribute('data-dsh-active-floating-window')
+          if (activeFloatingWindow === 'chat' && document.querySelector(expandedChatSelector)) return
+          // 与旧版完整视图共存时仍保留原来的键盘焦点判断。
+          if (activeFloatingWindow === null && canFindEscapeOwner && escapeTarget.closest(expandedChatSelector)) return
+          // 宿主菜单可能挂在聊天外；让它先消费 Esc，不连带关闭解读。
+          if (!panel.contains(escapeTarget) && !historyList.contains(escapeTarget) && canFindEscapeOwner && escapeTarget.closest('[role="menu"], [role="listbox"], [data-trigger-menu]')) return
+        }
         // Esc 分三级：**从最内层往外退**，一次只退一层（用户按一次不该连关两层）。
         //   ① 设置抽屉开着 → 只收抽屉，小窗留着（用户多半只是改完想接着看解读）；
         //   ② 语音进行中（录音行还在）→ 只取消这一次语音（等价于点 ✕，已经说出来的字留着）；
@@ -10147,6 +10276,8 @@ window.__ModuleLoader__.load({
           offQuotePopEnd()
           offMouseUp()
           offKeyUp()
+          offSelectionChange()
+          if (floatWatchId) clearInterval(floatWatchId)
           offMouseDown()
           offButtonDown()
           offButtonClick()