@yfwu2020/dsh-selection-explain 0.8.3 → 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` 也能摸到输入框和 🎤。
@@ -356,6 +357,42 @@ curl -s http://127.0.0.1:3080/selection-explain/api/ping
 
 ---
 
+## 档位兜底：「关」档不被支持时自动降级
+
+有些模型**不接受关闭推理**（上游直接 `400 invalid_request_error`）。首轮默认就是 `off`，
+撞上这种模型时整个划词解读会全挂。
+
+处理方式：
+
+- 撞到一次就**记住这个 provider/model**（`${DSH_HOME:-~/.dsh}/selection-explain/leaky-off.json`
+  的 `noOff` 字段），改用 **`low`**（最接近"关"的可接受档位）重试同一轮，并推一条 notice 说明。
+- **下次不再尝试 `off`** —— 直接发 `low`，不再先失败一轮（省一个来回的时延，也不闪报错）。
+- 重试只在"这一轮一个字都还没吐出来"时进行：已经出正文的失败不重试，避免把半截答案丢掉。
+- 兜底覆盖**三种轮次**（首轮 / 详解 / 追问）。以前只对追问生效、而且要客户端显式传了档位才触发，
+  所以首轮撞上这种模型时无人兜底。
+
+## 拖动与改大小
+
+小窗可以拖标题栏挪位置，拖右下角（或右/下边缘）改大小。
+
+**位置和尺寸是两回事，只有尺寸会记住：**
+
+- **位置不记**。每次开窗都按选区重新锚定：落在选区下方，下方放不下就翻到选区上方，
+  再夹进视口。拖动只对这一次有效，关掉重开就回到划词的地方 —— 这是刻意的设计。
+- **尺寸记**。拖角调过的大小存在 host 上（`${DSH_HOME:-~/.dsh}/selection-explain/panel.json`，
+  接口 `GET/POST /selection-explain/api/panel`，载荷只有 `{w,h}`），
+  刷新、换标签页、换浏览器 profile 都回到那个大小。
+- **双击右下角角标**恢复默认尺寸（清掉存档）。
+
+其余约定：
+
+- 尺寸下限 320×240，且始终夹在视口内（窗口缩小也不会超出）。上限是视口大小。
+- 用户拉过大小后，设置页那条约 560px 的高度下限就**不再插手**（`data-resized` 标记）。
+- 改动过程中不写盘，松手后防抖 300ms 再存 —— 不然每帧一个请求。
+- 改大小用 **pointer 事件**（不是 mouse）：触控板/触屏一样能拖，并且 `setPointerCapture`
+  保证鼠标划出窗口也不会丢掉这一轮。
+- 只有**真的拖动过**才会触发存档逻辑（点一下角标不算改了大小）。
+
 ## 配置
 
 ### 方式一：在小窗里改（推荐）

package/lib/client.js

@@ -29,6 +29,8 @@ window.__ModuleLoader__.load({
     var PROMOTE = '/selection-explain/api/promote'
     /** 胶囊拖到别处后的位置（记在 host 上：拖到别处→存，吸附回右下角→清，挂载→读回来）。 */
     var PILL_POS = '/selection-explain/api/pill'
+    /** 小窗的**尺寸**（改过大小之后记在 host 上，刷新后回到那个大小）。位置不记。 */
+    var PANEL_SIZE = '/selection-explain/api/panel'
     var HISTORY = '/selection-explain/api/history'
     /** 模型清单（带每个模型支持的推理等级）。 */
     var MODELS = '/selection-explain/api/models'
@@ -215,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
@@ -330,11 +348,47 @@ window.__ModuleLoader__.load({
       '.dsh-sel-layer[data-theme=dark]{--sel-a1:#4ecdc4;--sel-a1-text:#6fe3d8;--sel-a2:#4ecdc4;--sel-a2-text:#6fe3d8;',
       '--sel-fill:#4ecdc4;--sel-fill-fg:#052b26;',
       '--sel-a2-soft:color-mix(in srgb,var(--sel-a2) 16%,transparent);--sel-a1-soft:color-mix(in srgb,var(--sel-a1) 16%,transparent)}',
-      '.dsh-sel-panel{position:fixed;display:none;flex-direction:column;width:min(540px,calc(100vw - 20px));max-height:min(78vh,720px);',
-      '.dsh-sel-panel[data-stage=translation]{width:min(440px,calc(100vw - 20px))}',
+      // ⚠️ 声明块必须在**同一段字符串里收尾**。
+      // 以前这里是 `...max-height:...;` 后面直接接了一条完整规则 `[data-stage=translation]{...}`，
+      // `.dsh-sel-panel{` 的 `}` 于是永远没出现 —— 那条阶段规则被当成块内的**非法声明**整条丢弃，
+      // "首轮收窄到 440" 从来没生效过（实测计算宽度一直是 540）。后面几段的 border-radius /
+      // overflow 之所以没事，是因为 CSS 出错恢复会跳过坏声明继续往下读。
+      // 单测只断言了 data-stage 这个**属性**，而桩 DOM 没有布局，所以一直没暴露。
+      // box-sizing:border-box 是**必须**的：拖角改大小时我们把 getBoundingClientRect()（含边框）
+      // 的宽高写回 style.width/height，而它们默认按 content-box 解释 —— 差一个边框宽（1px），
+      // 于是"存进去 → 读回来"每来一轮就胖 1px，拖几次就明显走形（实测 584 存进去、读回来 586）。
+      '.dsh-sel-panel{position:fixed;display:none;flex-direction:column;box-sizing:border-box;width:min(540px,calc(100vw - 20px));max-height:min(78vh,720px);',
       'border-radius:16px;overflow:hidden;background:var(--dsw-alias-bg-layer-1,Canvas);color:var(--dsw-alias-label-primary,CanvasText);',
       'border:.5px solid var(--dsw-alias-border-l3,rgba(140,140,140,.35));box-shadow:0 20px 52px rgba(0,0,0,.3);',
       'font:400 13.5px/1.7 ' + FONT + '}',
+      // 这里曾经有一条 `.dsh-sel-panel[data-stage=translation]{width:440px}`：
+      // "首轮只出翻译时收窄一点"。它因为上面那个漏掉的 `}` 一直是死代码，修好闭合之后才真正生效，
+      // 一生效就暴露了问题 —— 宽度会**在追问那一刻从 440 跳到 540**（见 syncPanelStage 的判定），
+      // 用户看到同一个窗口自己变宽，问"怎么有追问和没追问的宽度不一样"。
+      // 决定：**统一成 540，宽度不随阶段变**。少一档就没这档子事，也没有"什么时候会跳"的心智负担。
+      // （data-stage 本身保留 —— 它还决定追问输入框显不显示，见 renderPanel。）
+      // 设置抽屉开着时只补**高度**下限，**不动宽度**。
+      //
+      // 抽屉是 inset:0 贴在面板上的：面板多宽，抽屉就多宽 —— 这是要的（设置窗口与小窗等宽，
+      // 开抽屉时小窗不该"胖一圈"）。但高度不能不管：面板高度是由"解读内容有多长"撑出来的，
+      // 刚开窗（只出了翻译）时面板才 ~115px 高，设置列表只剩 17px 可视高度（实测）。
+      // 所以只给 min-height；宽度交给面板自己的规则（首轮 440 / 其余 540），抽屉自动跟随。
+      // min-height 用 min() 与 max-height 同源，视口矮时两者相等，不会顶出屏幕。
+      // 只在**用户没自己改过尺寸**时才补这个下限：他拉过大小就按他的来（min-height 会压过 inline height）
+      '.dsh-sel-panel[data-settings="1"]:not([data-resized="1"]){min-height:min(560px,78vh)}',
+      // 改大小手柄：右下角一个角标 + 右边/下边各一条（细，不抢视线；hover/拖动时才明显）
+      // z-index 比设置抽屉(6)高 —— 但抽屉开着时整体隐藏（见下面的规则）：
+      // 抽屉页脚右侧就是「关闭」按钮，角标压上去会误点。
+      '.dsh-sel-grip{position:absolute;z-index:7;background:transparent;touch-action:none}',
+      '.dsh-sel-grip-corner{right:0;bottom:0;width:16px;height:16px;cursor:nwse-resize}',
+      '.dsh-sel-grip-r{right:0;top:12px;bottom:16px;width:6px;cursor:ew-resize}',
+      '.dsh-sel-grip-b{left:12px;right:16px;bottom:0;height:6px;cursor:ns-resize}',
+      // 手柄**不画任何常驻标识**：以前角上有一道小斜纹（两条 1.5px 边框拼的直角），
+      // 在浅色面板上看着像多出来的一笔，用户明确要求去掉。
+      // 保留 hover 时边缘的高亮（只在鼠标移上去时出现，不占视觉）——
+      // 加上 cursor: nwse-resize / ew-resize / ns-resize，可发现性还在。
+      // 抽屉开着时收起手柄（页脚右侧是「关闭」按钮，别让角标压上去）
+      '.dsh-sel-panel[data-settings="1"] .dsh-sel-grip{display:none}',
       '.dsh-sel-head{display:flex;align-items:center;gap:8px;padding:10px 10px 10px 14px;cursor:grab;user-select:none;',
       'border-bottom:.5px solid var(--dsw-alias-border-l4,rgba(140,140,140,.22))}',
       '.dsh-sel-head:active{cursor:grabbing}',
@@ -2481,6 +2535,15 @@ window.__ModuleLoader__.load({
       settingsSheet.appendChild(settingsHead)
       settingsSheet.appendChild(settingsMain)
       settingsSheet.appendChild(settingsFoot)
+      // ── 改大小手柄（右下角 + 右边缘 + 下边缘）──
+      // 小窗的尺寸/位置都由这里驱动；拖完记在 host 上（见 savePanelBox）。
+      var gripCorner = el('div', 'dsh-sel-grip dsh-sel-grip-corner')
+      var gripRight = el('div', 'dsh-sel-grip dsh-sel-grip-r')
+      var gripBottom = el('div', 'dsh-sel-grip dsh-sel-grip-b')
+      gripCorner.title = '拖动改大小（双击恢复默认）'
+      panel.appendChild(gripCorner)
+      panel.appendChild(gripRight)
+      panel.appendChild(gripBottom)
       panel.appendChild(settingsScrim)
       panel.appendChild(settingsSheet)
 
@@ -3292,6 +3355,8 @@ window.__ModuleLoader__.load({
       function openSettings() {
         if (settingsOpen) return
         settingsOpen = true
+        // 抽屉贴着面板（inset:0），所以给面板一个合适的尺寸下限 —— 否则内容短时抽屉被压成一条
+        panel.setAttribute('data-settings', '1')
         settingsSheet.setAttribute('data-open', '1')
         settingsScrim.setAttribute('data-open', '1')
         settingsButton.setAttribute('aria-pressed', 'true')
@@ -3306,6 +3371,7 @@ window.__ModuleLoader__.load({
       function closeSettings() {
         if (!settingsOpen) return
         settingsOpen = false
+        panel.removeAttribute('data-settings')
         closeModelPicks()
         settingsSheet.setAttribute('data-open', '0')
         settingsScrim.setAttribute('data-open', '0')
@@ -3463,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)
       }
 
       /**
@@ -3564,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
@@ -3648,6 +3735,12 @@ window.__ModuleLoader__.load({
           return
         }
         var range = selection.getRangeAt(0)
+        // 选中的节点被整个摘掉了（流式回答重渲染 / 消息换掉）：那段文字已经不在屏幕上，
+        // 浮标不该留着（否则点下去解读的是一段不存在的文字）
+        if (selectionDetached(range)) {
+          hideButton()
+          return
+        }
         if (insideEditable(range.startContainer)) {
           hideButton()
           return
@@ -5225,6 +5318,209 @@ window.__ModuleLoader__.load({
         return { left: rect.left, top: rect.top, right: rect.right, bottom: rect.bottom, width: rect.width, height: rect.height }
       }
 
+      /**
+       * 小窗的尺寸（用户拖角改过之后才有值；null = 用 CSS 里的默认尺寸）。
+       *
+       * **只记尺寸，不记位置**：小窗每次开窗都必须按选区重新锚定（见 showPanel），
+       * 这是既有的设计 —— 位置一旦被记住，开窗就不再跟着划词的地方走，等于把那套锚定架空了。
+       * 尺寸是用户明确调过的东西，跨开窗保留才合理。
+       */
+      var panelSize = null
+      var panelSizeAsked = false
+      var panelSizeTimer = 0
+      /** 正在拖手柄 / 拖标题栏时，别让 window resize 的夹取插一脚。 */
+      var panelInteracting = false
+      /**
+       * 尺寸下限：比"设置页要放得下"低一点就行。真实约束在 CSS/JS 里：
+       * 太窄了模型下拉和提示文案会挤成一团，太矮了正文没得看。
+       */
+      var PANEL_MIN_W = 320
+      var PANEL_MIN_H = 240
+
+      /**
+       * 开窗时应用"记住的尺寸"。
+       *
+       * ⚠️ 宽度是**固定值**，高度只能是**上限**（max-height）。
+       *
+       * 高度要是写成固定值，新开一个会话（内容只有一小段翻译）时面板会硬撑到上次那么大，
+       * 下面留一大片空白 —— 那是回退。以前高度一直是内容撑的（`max-height` 只是个天花板），
+       * 这个手感必须保住：内容短就短，内容长才长到上限、再滚动。
+       *
+       * 所以每次开窗都把 `height` **清掉**（回到自适应），只把用户调过的高度当作新的天花板。
+       * 用户当场拖出来的尺寸在**本次**打开里照旧生效（拖动时直接写 inline height），
+       * 只是下次开窗会重新按内容自适应 —— 既没有空白，拖动也看得见反馈。
+       */
+      function applyPanelSizeOnOpen() {
+        // 先还原成"内容撑高 + CSS 默认天花板"
+        panel.style.height = ''
+        panel.style.maxHeight = ''
+        if (!panelSize) {
+          panel.style.width = ''
+          panel.removeAttribute('data-resized')
+          return
+        }
+        panel.style.width = Math.round(panelSize.w) + 'px'
+        panel.style.maxHeight = Math.round(panelSize.h) + 'px'
+        // 打过标记：设置页那条约 560 的 min-height 就别再插手了（用户已经自己定了高）
+        panel.setAttribute('data-resized', '1')
+      }
+
+      /** 当前尺寸（读实际渲染值，比拿变量算更稳 —— 拖拽过程中变量会漂）。 */
+      function currentPanelSize() {
+        var rect = panel.getBoundingClientRect()
+        return { w: rect.width, h: rect.height }
+      }
+
+      /** 夹进视口：改大小/窗口变化后都调，保证手柄还在屏幕里、小窗不会超出可视区。 */
+      function clampPanelSize(size) {
+        var maxW = Math.max(PANEL_MIN_W, window.innerWidth - 8)
+        var maxH = Math.max(PANEL_MIN_H, window.innerHeight - 8)
+        return {
+          w: Math.min(maxW, Math.max(PANEL_MIN_W, size.w)),
+          h: Math.min(maxH, Math.max(PANEL_MIN_H, size.h)),
+        }
+      }
+
+      /**
+       * 把面板夹回可视区。
+       *
+       * **每次尺寸变化之后都要调**：位置是当初按旧尺寸算好的，尺寸一变就可能把面板顶出屏幕。
+       * 用户报的就是这个 —— 小窗贴着屏幕边缘时双击角标恢复默认尺寸，一部分直接跑到屏幕外。
+       * 优先保住左上角（那是用户看到的锚点），右边/下边放不下才往回收。
+       */
+      function clampPanelPosition() {
+        var rect = panel.getBoundingClientRect()
+        var maxLeft = Math.max(4, window.innerWidth - rect.width - 4)
+        var maxTop = Math.max(4, window.innerHeight - rect.height - 4)
+        panel.style.left = Math.round(Math.min(Math.max(rect.left, 4), maxLeft)) + 'px'
+        panel.style.top = Math.round(Math.min(Math.max(rect.top, 4), maxTop)) + 'px'
+        if (historyList.style.display === 'flex') placeHistoryList()
+      }
+
+      /** 存到 host（防抖：拖动过程中每帧都存会把接口打爆）。 */
+      function savePanelSize() {
+        if (panelSizeTimer) clearTimeout(panelSizeTimer)
+        panelSizeTimer = setTimeout(function () {
+          panelSizeTimer = 0
+          var size = clampPanelSize(currentPanelSize())
+          panelSize = size
+          fetch(PANEL_SIZE, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ size: size }),
+          }).catch(function () { /* 存不上不影响使用，下次再改还会存 */ })
+        }, 300)
+      }
+
+      /** 挂载时问一次（异步，回来再摆；用户已经动过就以用户的为准）。 */
+      function loadPanelSize() {
+        if (panelSizeAsked) return
+        panelSizeAsked = true
+        fetch(PANEL_SIZE)
+          .then(function (res) { return res.json() })
+          .then(function (data) {
+            var size = data && data.size
+            if (!size || panelInteracting) return
+            if (typeof size.w !== 'number' || typeof size.h !== 'number') return
+            panelSize = clampPanelSize(size)
+            if (panelOpen) {
+              applyPanelSizeOnOpen()
+              clampPanelPosition()
+            }
+          })
+          .catch(function () {})
+      }
+
+      /**
+       * 恢复默认尺寸（双击右下角）。
+       *
+       * 和"高度自适应"是**同一个动作**：把整份存档清掉 ——
+       * 宽度回到 CSS 默认（540 / 首轮阶段 440），高度清成 auto 由内容撑（也就是自适应）。
+       *
+       * ⚠️ 必须走 applyPanelSizeOnOpen() 来清，而不是手写两行 `style.width = ''`：
+       * 高度上限是写在 `style.maxHeight` 上的，只清 width/height 会把它留下 ——
+       * 用户先前把窗口**拉小**过的话，双击之后高度仍被旧上限卡着，看着就不像"恢复默认"。
+       */
+      function resetPanelSize() {
+        panelSize = null
+        // ⚠️ 先掐掉还没落盘的那次保存。
+        // savePanelSize 是防抖的，而且**在定时器触发时**才去读当前尺寸 ——
+        // 刚拖完角标马上双击还原时，这一次来不及取消的保存会在 300ms 后读到
+        // "已经还原好的默认尺寸"，又把它当成"用户选的尺寸"写回去：
+        // 还原被无声撤销，宽度还被钉死在那一刻（连带把按阶段收窄那套也废掉）。
+        if (panelSizeTimer) {
+          clearTimeout(panelSizeTimer)
+          panelSizeTimer = 0
+        }
+        applyPanelSizeOnOpen() // 宽度 / 高度 / 高度上限 一次全还原
+        fetch(PANEL_SIZE, {
+          method: 'POST',
+          headers: { 'content-type': 'application/json' },
+          body: JSON.stringify({ clear: true }),
+        }).catch(function () {})
+        // 宽度/高度都变了 → 位置得重夹，否则贴着屏幕边缘时会被顶出去
+        clampPanelPosition()
+        autoGrowAskBox()
+      }
+
+      /**
+       * 拖手柄改大小。
+       *
+       * edge 决定这次动哪几个方向：'se' 角标两个方向都能动，'e' 只动宽，'s' 只动高。
+       * 用 pointer 事件（不是 mouse）：触控板/触屏一样能拖，而且能 setPointerCapture，
+       * 鼠标划出窗口也不会丢掉这一轮（mouse 版本会卡在中途）。
+       */
+      function bindResizeGrip(node, edge) {
+        listen(node, 'pointerdown', function (event) {
+          if (event.button !== undefined && event.button !== 0) return
+          event.preventDefault()
+          event.stopPropagation()
+          var startSize = currentPanelSize()
+          var startX = event.clientX
+          var startY = event.clientY
+          panelInteracting = true
+          var layer = panel.parentNode
+          if (layer) layer.setAttribute('data-resizing', '1')
+          try { node.setPointerCapture(event.pointerId) } catch (error) { /* 老浏览器没有就算了 */ }
+          var changed = 0
+          var move = function (moveEvent) {
+            var next = { w: startSize.w, h: startSize.h }
+            if (edge.indexOf('e') >= 0) next.w = startSize.w + (moveEvent.clientX - startX)
+            if (edge.indexOf('s') >= 0) next.h = startSize.h + (moveEvent.clientY - startY)
+            var clamped = clampPanelSize(next)
+            changed = Math.abs(clamped.w - startSize.w) + Math.abs(clamped.h - startSize.h)
+            panel.style.width = Math.round(clamped.w) + 'px'
+            panel.style.height = Math.round(clamped.h) + 'px'
+            panelSize = clamped
+            panel.setAttribute('data-resized', '1')
+            if (historyList.style.display === 'flex') placeHistoryList()
+          }
+          var up = function () {
+            window.removeEventListener('pointermove', move, true)
+            window.removeEventListener('pointerup', up, true)
+            panelInteracting = false
+            if (layer) layer.removeAttribute('data-resizing')
+            // 尺寸定下来后，正文/输入框要按新高度重新分配（composer 自动撑高那套）
+            autoGrowAskBox()
+            // 尺寸变了 → 位置重夹，别让面板被顶出屏幕
+            if (changed >= 2) {
+              clampPanelPosition()
+              savePanelSize()
+            }
+          }
+          window.addEventListener('pointermove', move, true)
+          window.addEventListener('pointerup', up, true)
+        })
+        // 双击角标 = 恢复默认大小
+        if (edge === 'se') {
+          listen(node, 'dblclick', function (event) {
+            event.preventDefault()
+            event.stopPropagation()
+            resetPanelSize()
+          })
+        }
+      }
+
       function showPanel(anchor) {
         panelOpen = true
         // 键盘用户开窗即可打字：这一轮的输入框一旦可见就聚焦一次（见 focusComposerOnce）
@@ -5236,6 +5532,11 @@ window.__ModuleLoader__.load({
         panel.style.display = 'flex'
         panel.style.left = '0px'
         panel.style.top = '0px'
+        // 每次都按选区重新锚定 —— **不要**在这里插"用上次的位置"的分支：
+        // 位置一旦被记住，开窗就不再跟着划词的地方走，这套锚定逻辑等于被架空。
+        // 尺寸是另一回事：宽度沿用用户调过的，高度**每次开窗都回到自适应**（只保留天花板），
+        // 否则新会话内容短、面板却硬撑成上次那么高，下面留一大片空白。
+        applyPanelSizeOnOpen()
         // 面板刚显示出来才量得到 scrollHeight：草稿里原来的几行要立刻撑开
         autoGrowAskBox()
         var width = panel.offsetWidth
@@ -5399,7 +5700,8 @@ window.__ModuleLoader__.load({
         }
 
         // —— 按阶段重排 ——
-        // 只有翻译时：更窄的面板、不显示小节序号（轻量卡片形态）
+        // 只有翻译时：不显示小节序号（轻量卡片形态）。宽度**不随阶段变**（恒 540）——
+        // 以前这里还顺手收窄到 440，追问一下又跳回 540，用户看着像窗口自己抖了一下。
         var hasDetail = !!(state.parts.detail || stage === 'detail')
         // 追问输入框：**翻译一出来就能问，不必先展开详解**
         var translationReady = state.phase === 'done' && !!state.parts.translation
@@ -7394,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 —— 那是"面板里划词一律不管"年代的写法，
         //  结果就是小窗里划词毫无反应，只有气泡末尾的「引用整条」能用）。
@@ -7408,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，
@@ -7979,6 +8354,7 @@ window.__ModuleLoader__.load({
 
       // 费用胶囊的位置/尺寸会变（展开、缩放、数字变长、插件迟到挂载）→ 自适应频率地贴上去
       loadPillPos() // 先问一句上次拖到哪儿（异步，回来再摆）
+      loadPanelSize() // 小窗的尺寸也问一句（拖角改过之后才有的值；位置不记）
       placePill()
       ensureResizeWatch()
       schedulePillPlacer()
@@ -8007,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 分三级：**从最内层往外退**，一次只退一层（用户按一次不该连关两层）。
         //   ① 设置抽屉开着 → 只收抽屉，小窗留着（用户多半只是改完想接着看解读）；
         //   ② 语音进行中（录音行还在）→ 只取消这一次语音（等价于点 ✕，已经说出来的字留着）；
@@ -9371,10 +9760,12 @@ window.__ModuleLoader__.load({
 
       var offDrag = listen(head, 'mousedown', function (event) {
         if (promoteButton.contains(event.target) || closeButton.contains(event.target)) return
+        if (settingsButton.contains(event.target) || historyButton.contains(event.target)) return
         event.preventDefault()
         var rect = panel.getBoundingClientRect()
         var offsetX = event.clientX - rect.left
         var offsetY = event.clientY - rect.top
+        panelInteracting = true
         var move = function (moveEvent) {
           panel.style.left = clamp(moveEvent.clientX - offsetX, 4, window.innerWidth - rect.width - 4) + 'px'
           panel.style.top = clamp(moveEvent.clientY - offsetY, 4, window.innerHeight - 40) + 'px'
@@ -9383,13 +9774,41 @@ window.__ModuleLoader__.load({
         var up = function () {
           window.removeEventListener('mousemove', move, true)
           window.removeEventListener('mouseup', up, true)
+          panelInteracting = false
+          // **不存位置**：拖动只对这一次有效；下次开窗仍按选区重新锚定。
         }
         window.addEventListener('mousemove', move, true)
         window.addEventListener('mouseup', up, true)
       })
 
+      bindResizeGrip(gripCorner, 'se')
+      bindResizeGrip(gripRight, 'e')
+      bindResizeGrip(gripBottom, 's')
+
+      // 窗口变小：把**尺寸**夹回可视区（位置不归这里管 —— 它由 showPanel 的锚定决定）
+      var offPanelResize = listen(window, 'resize', function () {
+        if (!panelSize || panelInteracting) return
+        var next = clampPanelSize({ w: panelSize.w, h: panelSize.h })
+        if (next.w === panelSize.w && next.h === panelSize.h) return
+        panelSize = next
+        applyPanelSizeOnOpen()
+        clampPanelPosition()
+        savePanelSize()
+      })
+
       // —— 调试钩子（自动化验证用） ——
       window.__dshSelectionExplain = {
+        /** 重新读一次 host 上的小窗尺寸（测试用；正常路径只在挂载时读一次）。 */
+        loadPanelSize: function () {
+          panelSizeAsked = false
+          loadPanelSize()
+          return true
+        },
+        /** 当前小窗几何（测试用：直接读渲染值，不经过变量）。 */
+        panelGeom: function () {
+          var rect = panel.getBoundingClientRect()
+          return { x: rect.left, y: rect.top, w: rect.width, h: rect.height, resized: panel.getAttribute('data-resized') === '1' }
+        },
         /** 重新读一次 host 上的胶囊位置（测试用；正常路径只在挂载时读一次）。 */
         loadPillPos: function () {
           pillPosAsked = false
@@ -9857,6 +10276,8 @@ window.__ModuleLoader__.load({
           offQuotePopEnd()
           offMouseUp()
           offKeyUp()
+          offSelectionChange()
+          if (floatWatchId) clearInterval(floatWatchId)
           offMouseDown()
           offButtonDown()
           offButtonClick()
@@ -9887,6 +10308,7 @@ window.__ModuleLoader__.load({
           cancelVoice()
           offClose()
           offDrag()
+          offPanelResize()
           offPillDown()
           offPillClick()
           offPillEnter()