dsh-plugin-table-zoom 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## [0.3.2] - 2026-08-22
+
+- README：新增「相关插件」互相引用段（列出同系列已发布插件，npm / GitHub 链接 + 一句话说明），互相引流。
+- **修复：放大/溢出表格里拖动不再被平移劫持**——此前正文内容溢出
+  （缩放后或表超宽）时，左键按住正文任意位置拖动即进入平移，并主动清空
+  选区，导致**无法在放大的表格里框选文字**。现在普通左键拖动保留浏览器
+  原生行为，可直接框选表格文字（含放大后）；滚动条 / 滚轮照常滚动。
+- **平移改为显式手势**：表格超宽/超高时，**按住空格再按住正文拖动**
+  才左右/上下滚动（grab 光标仅在按住空格时出现，拖拽中为 grabbing）；
+  触屏仍走原生滚动；拖动中松开空格即结束平移；关闭浮窗时清理空格监听。
+- 测试：冒烟拆分/新增 2 项（未按空格左键拖动不启动平移 / 按住空格可平移
+  且光标随空格状态切换），共 selfcheck 12 项 + 冒烟 13 项。
+
+## [0.3.1] - 2026-08-22
+
+- **每次打开自适应，不再继承任何布局**：移除尺寸/位置/缩放的跨次记忆
+  （不再读写 localStorage），浮窗每次打开都按表格自然宽度定宽
+  （下限 320；窄表收缩不撑满、**超级大表铺满视口可用宽度**）、居中、
+  缩放 100%；手动拖拽（改大小/移动/缩放）只影响当次打开，关掉再开即回到自适应。
+- **修复：自适应此前从未生效**——旧实现返回值错误（无记忆时返回估算宽 960
+  而非 0）导致自适应分支不执行，小表仍撑满大窗口。
+- **缩放不再跨次继承**：Ctrl+滚轮缩放比例不写入 localStorage，
+  每次打开浮窗都从 100% 开始（标题栏百分比同步复位）。
+- 测试：冒烟调整/新增 3 项（自适应宽度：窄表收缩/宽表封顶/空表兜底；
+  每次打开不继承上次尺寸；openPopup 走自适应下限），
+  共 selfcheck 12 项 + 冒烟 12 项。
+
 ## [0.3.0] - 2026-08-22
 
 - **浮窗可拖动**：不再强制居中——按住标题栏（按钮除外）拖动浮窗位置，

package/README.md

@@ -22,13 +22,17 @@ DeepSeek Harness (dsh) Web GUI 聊天表格浮窗插件。
 - 浮窗头部「复制为 Markdown」按钮一键复制整表（单元格内联换行折叠、管道符转义）；
 - 浮窗里展示的是**原表格的克隆**，聊天里的表格保持不变，也不会被重复增强；
 - **拖拽改尺寸**：浮窗右下角手柄可自由调整大小（最小 320×200，最大到视口留白），
-  调整结果自动记忆，下次打开沿用；
+  只影响当次打开；
+- **每次打开自适应**：浮窗不记忆任何布局——宽度按表格内容自适应（窄表不撑满、
+  超级大表直接铺满视口可用宽度，下限 320）、位置居中、缩放 100%；关掉再开即回到自适应；
 - **拖拽移动**：按住标题栏可把浮窗拖到任意位置（自动限制在页面内，不会拖出屏幕），
-  位置同样自动记忆；
+  位置只影响当次打开；
 - **Ctrl+滚轮缩放**：浮窗内按住 Ctrl 滚动滚轮，表格字体 60%–250% 缩放
-  （步进 10%），标题栏实时显示百分比；
-- **拖拽平移**：表格超宽/超高时，按住正文任意位置即可左右/上下拖动滚动
-  （grab 光标提示；越过 4px 阈值才视为拖动，不干扰文本选择；触屏走原生滚动）；
+  （步进 10%），标题栏实时显示百分比；**缩放不记忆，每次打开回到 100%**；
+- **框选文字**：普通左键在表格（含放大后）里拖动即可框选文字，
+  不会被平移劫持；
+- **按住空格拖拽平移**：表格超宽/超高时，按住空格再按住正文拖动即可
+  左右/上下滚动（grab 光标仅在按住空格时出现；触屏走原生滚动）；
 - **滚动条清晰**：正文滚动条加深加粗，浅色主题下也能看清；
 - **列宽适配**：列宽上限与聊天内一致（`min(30vw, 320px)`），超宽列自动换行收缩，
   表格整体不再撑破浮窗。
@@ -108,6 +112,20 @@ npm run pack         # 打包
 - 不影响其他插件：只认 `tableScroll` 容器内的表格，跳过浮窗与 image-tools
   lightbox 内的表格。
 
+## 相关插件
+
+本插件属于 **Pasumao 的 dsh 插件生态**，同系列已发布插件可搭配使用：
+
+| 插件（npm） | GitHub | 说明 |
+|---|---|---|
+| [dsh-notify](https://www.npmjs.com/package/dsh-notify) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-notify) | Windows 原生通知 + 系统托盘 |
+| [dsh-plugin-choice-refresh](https://www.npmjs.com/package/dsh-plugin-choice-refresh) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-choice-refresh) | 选择增强：重新生成选项 / 更多选项 |
+| [dsh-plugin-dev-kb](https://www.npmjs.com/package/dsh-plugin-dev-kb) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-dev-kb) | 插件开发知识库（官方文档完整镜像 + 技能） |
+| [dsh-plugin-image-tools](https://www.npmjs.com/package/dsh-plugin-image-tools) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-image-tools) | 图片选择卡 + 回复内嵌图片 + 盲模型收图 |
+| [dsh-plugin-workbench](https://www.npmjs.com/package/dsh-plugin-workbench) | [GitHub 仓库](https://github.com/Pasumao/dsh-plugin-workbench) | VS Code 风格文件浏览器 + 可编辑预览 |
+
+> 本系列其余插件见 [Pasumao · dsh 插件](https://github.com/Pasumao)；觉得好用欢迎到 GitHub 点 ⭐。
+
 ## AI 生成声明
 
 代码与文档由 AI 辅助生成（DeepSeek Harness），均经人工审查与实机验证

package/lib/client.js

@@ -203,11 +203,10 @@ window.__ModuleLoader__.load({
     }
 
     // ------------------------------------------------------------------
-    // 浮窗布局：拖拽改大小 + 拖标题栏移动 + Ctrl+滚轮缩放 + 布局记忆
+    // 浮窗布局：拖拽改大小 + 拖标题栏移动 + Ctrl+滚轮缩放
+    // 不记忆任何布局：每次打开都按表格内容自适应宽度并居中，手动拖拽只影响当次。
     // ------------------------------------------------------------------
 
-    /** localStorage 键：记住用户最后一次手动调整的浮窗布局（尺寸/位置/缩放）。 */
-    var SIZE_KEY = 'dsh-plugin-table-zoom:popup-size';
     var MIN_POPUP_W = 320;
     var MIN_POPUP_H = 200;
     /** 浮窗距视口边缘的最小留白。 */
@@ -236,52 +235,25 @@ window.__ModuleLoader__.load({
       return 800;
     }
 
-    /** 读取上次记忆的浮窗布局；无记录/损坏/隐私模式返回 null。 */
-    function readSavedSize() {
-      try {
-        if (typeof localStorage === 'undefined') return null;
-        var raw = localStorage.getItem(SIZE_KEY);
-        if (raw === null || raw === '') return null;
-        var v = JSON.parse(raw);
-        if (v === null || typeof v !== 'object') return null;
-        return {
-          w: Number(v.w) || 0,
-          h: Number(v.h) || 0,
-          x: typeof v.x === 'number' ? v.x : null,
-          y: typeof v.y === 'number' ? v.y : null,
-          zoom: typeof v.zoom === 'number' && v.zoom > 0 ? v.zoom : 1
-        };
-      } catch (e) {
-        return null;
-      }
-    }
-
     /**
-     * 打开浮窗时套用上次记忆的布局（尺寸/位置/缩放，按当前视口收窄）。
-     * 无记忆时尺寸用 CSS 默认、位置居中。返回本次生效的 {w,h,x,y,zoom}。
+     * 每次打开都按表格自然宽度自适应面板宽度
+     * （正文左右 padding 36 + 面板边框 2；下限 320，上限为视口减去留白——
+     * 超级大表直接铺满最大可用宽度）。
      */
-    function applySavedLayout(panel) {
-      var v = readSavedSize();
-      var vw = viewportW();
-      var vh = viewportH();
-      var maxW = vw - POPUP_MARGIN;
-      var maxH = vh - POPUP_MARGIN;
-      if (maxW < MIN_POPUP_W || maxH < MIN_POPUP_H) return { w: 0, h: 0, x: 0, y: 0, zoom: 1 };
-      var w = v !== null && v.w > 0 ? clamp(v.w, MIN_POPUP_W, maxW) : 0;
-      var h = v !== null && v.h > 0 ? clamp(v.h, MIN_POPUP_H, maxH) : 0;
-      if (w > 0) {
-        panel.style.width = w + 'px';
-        panel.style.maxHeight = 'none';
-      }
-      if (h > 0) panel.style.height = h + 'px';
-      var pw = w > 0 ? w : Math.min(960, maxW);
-      var ph = h > 0 ? h : Math.min(720, maxH);
-      var x = v !== null && v.x !== null ? clamp(v.x, 0, Math.max(0, vw - pw)) : Math.round((vw - pw) / 2);
-      var y = v !== null && v.y !== null ? clamp(v.y, 0, Math.max(0, vh - ph)) : Math.round((vh - ph) / 2);
-      panel.style.left = x + 'px';
-      panel.style.top = y + 'px';
-      var zoom = v !== null ? clamp(v.zoom, ZOOM_MIN, ZOOM_MAX) : 1;
-      return { w: pw, h: ph, x: x, y: y, zoom: zoom };
+    function applyAdaptiveWidth(panel, clone) {
+      var tableW = typeof clone.offsetWidth === 'number' && clone.offsetWidth > 0 ? clone.offsetWidth : 0;
+      var maxW = viewportW() - POPUP_MARGIN;
+      var w = clamp(tableW + 38, MIN_POPUP_W, Math.max(MIN_POPUP_W, maxW));
+      panel.style.width = w + 'px';
+    }
+
+    /** 把面板按实际尺寸重新居中（自适应改宽后调用；测不到尺寸时跳过）。 */
+    function centerPanel(panel) {
+      var w = panel.offsetWidth;
+      var h = panel.offsetHeight;
+      if (typeof w !== 'number' || w <= 0 || typeof h !== 'number' || h <= 0) return;
+      panel.style.left = Math.round((viewportW() - w) / 2) + 'px';
+      panel.style.top = Math.round((viewportH() - h) / 2) + 'px';
     }
 
     /** 把面板位置限制在视口内（完全可见，不越出页面）。 */
@@ -307,32 +279,19 @@ window.__ModuleLoader__.load({
       panel.style.top = y + 'px';
     }
 
-    /** 拖拽结束后记忆当前布局（尺寸/位置/缩放；localStorage 不可用时静默跳过）。 */
-    function saveLayout(panel, zoom) {
-      try {
-        if (typeof localStorage === 'undefined') return;
-        var rect = panel.getBoundingClientRect();
-        if (rect === null || typeof rect !== 'object') return;
-        var prev = readSavedSize();
-        var record = {
-          w: Math.round(rect.width),
-          h: Math.round(rect.height),
-          x: typeof rect.left === 'number' ? Math.round(rect.left) : 0,
-          y: typeof rect.top === 'number' ? Math.round(rect.top) : 0,
-          zoom: typeof zoom === 'number' && zoom > 0 ? Math.round(zoom * 100) / 100 : (prev !== null && prev.zoom > 0 ? prev.zoom : 1)
-        };
-        localStorage.setItem(SIZE_KEY, JSON.stringify(record));
-      } catch (e) {
-        /* 隐私模式等场景忽略 */
-      }
-    }
-
-    /** 内容溢出时给正文加 grab 光标提示（可拖拽平移）。 */
+    /**
+     * 内容溢出且按住空格（平移预备）时才给正文加 grab 光标提示。
+     * 空格状态由 attachPan 维护在 body._dstzSpaceArmed 上；
+     * 布局变化（打开/改尺寸/缩放）后调用本函数即可同步光标。
+     */
     function refreshGrabbable(body) {
       var overX = body.scrollWidth > body.clientWidth + 1;
       var overY = body.scrollHeight > body.clientHeight + 1;
-      if (overX || overY) body.classList.add('dstz-grabbable');
-      else body.classList.remove('dstz-grabbable');
+      if ((overX || overY) && body._dstzSpaceArmed === true) {
+        body.classList.add('dstz-grabbable');
+      } else {
+        body.classList.remove('dstz-grabbable');
+      }
     }
 
     /** 命中可交互元素（链接/按钮/输入框等）时让给默认行为，不启动拖拽。 */
@@ -343,7 +302,7 @@ window.__ModuleLoader__.load({
 
     /**
      * 给面板挂载「拖右下角改尺寸」：指针捕获 + _suppressClick 防止拖完
-     * 松手落在遮罩上误触发关闭。尺寸写入 inline style 并记忆到 localStorage。
+     * 松手落在遮罩上误触发关闭。尺寸只影响当次打开，不持久化。
      * @param {object} panel - .dstz-panel 元素。
      * @param {object} overlay - .dstz-popup 元素（承载 _suppressClick）。
      */
@@ -382,7 +341,6 @@ window.__ModuleLoader__.load({
         state = null;
         panel.classList.remove('dstz-resizing');
         clampPanelPosition(panel);
-        saveLayout(panel);
         window.setTimeout(function () { overlay._suppressClick = false; }, 0);
       };
       handle.addEventListener('pointerdown', begin);
@@ -394,7 +352,7 @@ window.__ModuleLoader__.load({
 
     /**
      * 给标题栏挂载「拖拽移动」：按住标题栏（按钮除外）拖动面板位置，
-     * 位置限制在视口内（不越出页面）；拖动结束记忆位置。
+     * 位置限制在视口内（不越出页面）；位置不记忆，下次打开重新居中。
      * @param {object} panel - .dstz-panel 元素（children[0] 为标题栏）。
      * @param {object} overlay - .dstz-popup 元素（承载 _suppressClick）。
      */
@@ -431,32 +389,72 @@ window.__ModuleLoader__.load({
         var wasMoved = state.moved;
         state = null;
         header.classList.remove('dstz-dragging');
-        if (wasMoved) {
-          saveLayout(panel);
-          window.setTimeout(function () { overlay._suppressClick = false; }, 0);
-        }
+        if (wasMoved) window.setTimeout(function () { overlay._suppressClick = false; }, 0);
       };
       header.addEventListener('pointerup', end);
       header.addEventListener('pointercancel', end);
     }
 
     /**
-     * 给正文挂载「拖拽平移」：内容溢出时按住表格左右/上下拖动即可滚动
-     * （鼠标/触控笔；触屏保留原生滚动）。越过 4px 阈值才视为拖动，
-     * 避免干扰文本选择；拖动结束松手落在遮罩上不会误关浮窗。
+     * 给正文挂载「按住空格拖动平移」：内容溢出时，按住空格再按住表格
+     * 左右/上下拖动即可滚动（鼠标/触控笔；触屏保留原生滚动）。
+     * 普通左键拖动不再被平移劫持，而是保留浏览器原生行为——可在表格
+     * （含放大后）里直接框选文字；只有按住空格时拖动才平移。
+     * grab 光标仅在按住空格悬停正文且内容溢出时出现；
+     * 拖动结束松手落在遮罩上不会误关浮窗。
      * @param {object} body - .dstz-body 元素。
-     * @param {object} overlay - .dstz-popup 元素（承载 _suppressClick）。
+     * @param {object} overlay - .dstz-popup 元素（承载 _suppressClick / _cleanups）。
      */
     function attachPan(body, overlay) {
       var state = null;
+      var endPan = function () {
+        if (state === null) return;
+        state = null;
+        body.classList.remove('dstz-panning');
+        window.setTimeout(function () { overlay._suppressClick = false; }, 0);
+      };
+      var setArmed = function (on) {
+        body._dstzSpaceArmed = on === true;
+        refreshGrabbable(body);
+      };
+      var onKeyDown = function (e) {
+        if (e.key === ' ' || e.code === 'Space') setArmed(true);
+      };
+      var onKeyUp = function (e) {
+        if (e.key === ' ' || e.code === 'Space') {
+          setArmed(false);
+          if (state !== null) endPan(); // 拖动中松开空格：结束平移
+        }
+      };
+      var onBlur = function () {
+        setArmed(false);
+        if (state !== null) endPan();
+      };
+      if (typeof window !== 'undefined' && typeof window.addEventListener === 'function') {
+        window.addEventListener('keydown', onKeyDown, true);
+        window.addEventListener('keyup', onKeyUp, true);
+        window.addEventListener('blur', onBlur);
+        if (Array.isArray(overlay._cleanups)) {
+          overlay._cleanups.push(function () {
+            window.removeEventListener('keydown', onKeyDown, true);
+            window.removeEventListener('keyup', onKeyUp, true);
+            window.removeEventListener('blur', onBlur);
+            setArmed(false);
+          });
+        }
+      }
       body.addEventListener('pointerdown', function (e) {
         if (e.button !== 0) return;
         if (e.pointerType !== undefined && e.pointerType !== 'mouse' && e.pointerType !== 'pen') return;
+        if (!body._dstzSpaceArmed) return; // 未按住空格：让给浏览器原生文本选择（框选文字）
         if (isInteractive(e.target)) return;
         var overX = body.scrollWidth > body.clientWidth + 1;
         var overY = body.scrollHeight > body.clientHeight + 1;
         if (!overX && !overY) return;
-        state = { x: e.clientX, y: e.clientY, sl: body.scrollLeft, st: body.scrollTop, moved: false };
+        if (typeof e.preventDefault === 'function') e.preventDefault();
+        state = { x: e.clientX, y: e.clientY, sl: body.scrollLeft, st: body.scrollTop };
+        body.classList.add('dstz-panning');
+        overlay._suppressClick = true;
         if (typeof body.setPointerCapture === 'function') {
           try { body.setPointerCapture(e.pointerId); } catch (err) { /* ignore */ }
         }
@@ -465,28 +463,12 @@ window.__ModuleLoader__.load({
         if (state === null) return;
         var dx = e.clientX - state.x;
         var dy = e.clientY - state.y;
-        if (!state.moved && Math.abs(dx) + Math.abs(dy) < 4) return;
-        if (!state.moved) {
-          state.moved = true;
-          body.classList.add('dstz-panning');
-          overlay._suppressClick = true;
-          if (typeof document !== 'undefined' && typeof document.getSelection === 'function') {
-            try { document.getSelection().removeAllRanges(); } catch (err) { /* ignore */ }
-          }
-        }
         body.scrollLeft = state.sl - dx;
         body.scrollTop = state.st - dy;
         if (typeof e.preventDefault === 'function') e.preventDefault();
       });
-      var end = function () {
-        if (state === null) return;
-        var wasMoved = state.moved;
-        state = null;
-        body.classList.remove('dstz-panning');
-        if (wasMoved) window.setTimeout(function () { overlay._suppressClick = false; }, 0);
-      };
-      body.addEventListener('pointerup', end);
-      body.addEventListener('pointercancel', end);
+      body.addEventListener('pointerup', endPan);
+      body.addEventListener('pointercancel', endPan);
     }
 
     /**
@@ -559,7 +541,10 @@ window.__ModuleLoader__.load({
       panel.appendChild(body);
       overlay.appendChild(panel);
 
-      // 拖拽改尺寸 + 拖标题栏移动 + 内容溢出拖拽平移 + 布局记忆 + Ctrl+滚轮缩放
+      // 清理登记（attachPan 等挂载的全局监听会 push 进来，关闭时统一移除）
+      overlay._cleanups = [];
+
+      // 拖拽改尺寸 + 拖标题栏移动 + 内容溢出拖拽平移 + Ctrl+滚轮缩放
       attachResize(panel, overlay);
       attachMove(panel, overlay);
       attachPan(body, overlay);
@@ -571,16 +556,14 @@ window.__ModuleLoader__.load({
         small.textContent = rowCount + ' ' + LABELS.rowsCols + ' ' + colCount
           + (Math.abs(zoom - 1) > 0.001 ? ' \u00b7 ' + Math.round(zoom * 100) + '%' : '');
       };
-      var layout = applySavedLayout(panel);
-      applyZoom(layout.zoom);
+      applyZoom(1); // 不继承上次的缩放，每次都从 100% 开始
       refreshGrabbable(body);
 
-      // Ctrl+滚轮：缩放表格字体（阻止浏览器整页缩放）
+      // Ctrl+滚轮：缩放表格字体（阻止浏览器整页缩放；缩放不写入 localStorage）
       var onWheel = function (e) {
         if (!e.ctrlKey) return;
         if (typeof e.preventDefault === 'function') e.preventDefault();
         applyZoom(e.deltaY < 0 ? zoom + ZOOM_STEP : zoom - ZOOM_STEP);
-        saveLayout(panel, zoom);
       };
       panel.addEventListener('wheel', onWheel, { passive: false });
 
@@ -596,7 +579,6 @@ window.__ModuleLoader__.load({
         clampPanelPosition(panel);
         refreshGrabbable(body);
       };
-      overlay._cleanups = [];
       if (typeof window !== 'undefined' && typeof window.addEventListener === 'function') {
         window.addEventListener('resize', onWindowResize);
         overlay._cleanups.push(function () {
@@ -623,6 +605,10 @@ window.__ModuleLoader__.load({
 
       activePopup = overlay;
       document.body.appendChild(overlay);
+      // 每次打开都按表格自然宽度自适应，并按实际尺寸重新居中（不继承上次的尺寸/位置）
+      applyAdaptiveWidth(panel, clone);
+      centerPanel(panel);
+      refreshGrabbable(body);
       closeBtn.focus();
     }
 
@@ -734,9 +720,7 @@ window.__ModuleLoader__.load({
     exports.attachResize = attachResize;
     exports.attachMove = attachMove;
     exports.attachPan = attachPan;
-    exports.applySavedLayout = applySavedLayout;
-    exports.saveLayout = saveLayout;
-    exports.readSavedSize = readSavedSize;
+    exports.applyAdaptiveWidth = applyAdaptiveWidth;
     exports.clampPanelPosition = clampPanelPosition;
     exports.refreshGrabbable = refreshGrabbable;
     return module.exports;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-plugin-table-zoom",
   "description": "DSH 聊天表格浮窗插件：聊天里 markdown 表格太长（行多/超宽）看不完时，表格上方自动出现「浮窗查看」按钮，点击弹出可滚动的小浮窗完整显示表格，并支持一键复制为 Markdown。纯前端 DOM 增强，不改核心包、不注册工具、无服务端逻辑。",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "type": "module",
   "main": "lib/index.js",
   "exports": {

package/scripts/smoke-client.mjs

@@ -7,9 +7,10 @@
  *   3. openPopup 创建浮窗（标题含行列数、表格克隆、关闭按钮），
  *      closePopup 关闭并还原 body 滚动；
  *   4. 表格克隆在浮窗内不会被再次增强（跳过 .dstz-popup）；
- *   5. 右下角改尺寸手柄可拖拽改面板大小并记忆到 localStorage，
- *      再次打开复用记忆布局；内容溢出时正文可拖拽平移；
- *      标题栏可拖拽移动浮窗（不越出视口）；Ctrl+滚轮缩放表格字体。
+ *   5. 右下角改尺寸手柄可拖拽改面板大小；溢出时左键拖动保留原生文本
+ *      选择（不启动平移），按住空格拖动才平移；标题栏可拖拽移动浮窗
+ *      （不越出视口）；Ctrl+滚轮缩放表格字体；
+ *      每次打开都按内容自适应宽度并居中（不继承上次的尺寸/位置/缩放）。
  *
  * 运行：node scripts/smoke-client.mjs
  */
@@ -132,7 +133,22 @@ const documentEl = {
   removeEventListener() {},
 }
 globalThis.document = documentEl
-globalThis.window = { setTimeout: (fn) => fn() }
+globalThis.window = {
+  setTimeout: (fn) => fn(),
+  _listeners: {},
+  addEventListener(type, fn) { (this._listeners[type] ??= []).push(fn) },
+  removeEventListener(type, fn) {
+    const arr = this._listeners[type]
+    if (!arr) return
+    const idx = arr.indexOf(fn)
+    if (idx >= 0) arr.splice(idx, 1)
+  },
+  dispatch(type, event = {}) {
+    const arr = this._listeners[type]
+    if (!arr) return
+    for (const fn of [...arr]) fn({ target: documentEl, stopPropagation() {}, ...event })
+  },
+}
 Object.defineProperty(globalThis, 'navigator', {
   value: { clipboard: { writeText: async (t) => { globalThis.__copied = t } } },
   configurable: true,
@@ -254,17 +270,7 @@ ok('copyText 写入剪贴板', async () => {
   assert.equal(globalThis.__copied, '| a |\n| --- |')
 })
 
-// 5) 浮窗改尺寸 + 尺寸记忆 + 拖拽平移
-// 假 localStorage：验证尺寸记忆读写（真实环境缺失时各函数均已兜底）
-const sizeStore = new Map()
-Object.defineProperty(globalThis, 'localStorage', {
-  value: {
-    getItem: (k) => (sizeStore.has(k) ? sizeStore.get(k) : null),
-    setItem: (k, v) => { sizeStore.set(k, String(v)) },
-    removeItem: (k) => { sizeStore.delete(k) },
-  },
-  configurable: true,
-})
+// 5) 浮窗改尺寸 + 自适应 + 拖拽平移（无布局记忆：每次打开都自适应并居中）
 
 ok('openPopup 挂载右下角改尺寸手柄并可拖拽', () => {
   mod.closePopup()
@@ -275,6 +281,9 @@ ok('openPopup 挂载右下角改尺寸手柄并可拖拽', () => {
   const panel = popup.children[0]
   const handle = panel.children.find((c) => c.className === 'dstz-resizeSE')
   assert.ok(handle !== undefined, 'resize handle not mounted')
+  // 假 DOM 无真实布局：显式给一个起始尺寸，验证拖拽按 delta 改大小
+  panel.style.width = '800px'
+  panel.style.height = '400px'
   panel.getBoundingClientRect = () => ({
     width: parseInt(panel.style.width, 10) || 800,
     height: parseInt(panel.style.height, 10) || 400,
@@ -286,31 +295,32 @@ ok('openPopup 挂载右下角改尺寸手柄并可拖拽', () => {
   assert.equal(panel.style.maxHeight, 'none')
   assert.ok(popup._suppressClick === true, 'drag should suppress overlay close')
   handle.dispatch('pointerup', {})
-  const saved = JSON.parse(sizeStore.get('dsh-plugin-table-zoom:popup-size'))
-  assert.equal(saved.w, 960)
-  assert.equal(saved.h, 460)
   assert.ok(popup._suppressClick === false, 'suppress flag reset after drag')
   mod.closePopup()
 })
 
-ok('applySavedLayout 复用上次记忆的布局', () => {
+ok('每次打开不继承上次尺寸，始终按内容自适应', () => {
   mod.closePopup()
   const table = makeEl('table')
   table.rows = []
   mod.openPopup(table)
-  const popup = documentEl.body.children.find((c) => c.className === 'dstz-popup')
-  const panel = popup.children[0]
-  const clone = panel.children[1].children[0]
-  assert.equal(panel.style.width, '960px')
-  assert.equal(panel.style.height, '460px')
-  assert.equal(panel.style.maxHeight, 'none')
-  assert.equal(panel.style.left, '0px')
-  assert.equal(panel.style.top, '0px')
-  assert.equal(clone.style.zoom, '1')
+  let popup = documentEl.body.children.find((c) => c.className === 'dstz-popup')
+  let panel = popup.children[0]
+  assert.equal(panel.style.width, '320px', '首次打开走自适应（假 DOM 无布局 → 下限 320）')
+  // 模拟当次手动改大
+  panel.style.width = '800px'
+  panel.style.height = '500px'
+  mod.closePopup()
+  // 重新打开：应回到自适应宽度，而不是继承 800px
+  mod.openPopup(table)
+  popup = documentEl.body.children.find((c) => c.className === 'dstz-popup')
+  panel = popup.children[0]
+  assert.equal(panel.style.width, '320px', '再次打开仍自适应，不继承上次尺寸')
+  assert.notEqual(panel.style.height, '500px')
   mod.closePopup()
 })
 
-ok('溢出时正文可拖拽平移', () => {
+ok('溢出时左键拖动不启动平移（保留原生文本选择）', () => {
   mod.closePopup()
   const table = makeEl('table')
   table.rows = []
@@ -324,28 +334,61 @@ ok('溢出时正文可拖拽平移', () => {
   body.scrollLeft = 300
   body.scrollTop = 100
   mod.refreshGrabbable(body)
-  assert.ok(body.classList.contains('dstz-grabbable'), 'overflow should show grab cursor')
+  assert.ok(!body.classList.contains('dstz-grabbable'), '未按空格时不应显示 grab 光标')
+  // 未按空格：左键拖动不进入平移，也不吞掉遮罩点击（让给浏览器原生框选文字）
   body.dispatch('pointerdown', { button: 0, clientX: 10, clientY: 10, pointerId: 1 })
   body.dispatch('pointermove', { clientX: 110, clientY: 60 })
-  assert.ok(body.classList.contains('dstz-panning'), 'panning class while dragging')
+  assert.ok(!body.classList.contains('dstz-panning'), '未按空格拖动不应进入平移')
+  assert.equal(body.scrollLeft, 300)
+  assert.equal(body.scrollTop, 100)
+  assert.ok(popup._suppressClick !== true, '未按空格拖动不应吞掉遮罩点击')
+  body.dispatch('pointerup', {})
+  mod.closePopup()
+})
+
+ok('按住空格拖动可平移溢出内容，光标随空格状态切换', () => {
+  mod.closePopup()
+  const table = makeEl('table')
+  table.rows = []
+  mod.openPopup(table)
+  const popup = documentEl.body.children.find((c) => c.className === 'dstz-popup')
+  const body = popup.children[0].children[1]
+  body.scrollWidth = 1200
+  body.clientWidth = 600
+  body.scrollHeight = 400
+  body.clientHeight = 300
+  body.scrollLeft = 300
+  body.scrollTop = 100
+  // 按住空格：内容溢出时出现 grab 光标
+  globalThis.window.dispatch('keydown', { key: ' ', code: 'Space' })
+  assert.ok(body.classList.contains('dstz-grabbable'), '按住空格且溢出时应显示 grab 光标')
+  body.dispatch('pointerdown', { button: 0, clientX: 10, clientY: 10, pointerId: 1 })
+  body.dispatch('pointermove', { clientX: 110, clientY: 60 })
+  assert.ok(body.classList.contains('dstz-panning'), '按住空格拖动应进入平移')
   assert.equal(body.scrollLeft, 200)
   assert.equal(body.scrollTop, 50)
-  assert.ok(popup._suppressClick === true, 'pan should suppress overlay close')
+  assert.ok(popup._suppressClick === true, '平移应吞掉遮罩关闭')
   body.dispatch('pointerup', {})
-  assert.ok(!body.classList.contains('dstz-panning'), 'panning class cleared on release')
-  assert.ok(popup._suppressClick === false, 'suppress flag reset after pan')
+  assert.ok(!body.classList.contains('dstz-panning'), '松手后退出平移')
+  assert.ok(popup._suppressClick === false, '平移结束恢复遮罩点击')
+  // 松开空格：grab 光标消失
+  globalThis.window.dispatch('keyup', { key: ' ', code: 'Space' })
+  assert.ok(!body.classList.contains('dstz-grabbable'), '松开空格后 grab 光标消失')
   mod.closePopup()
 })
 
 ok('标题栏可拖拽移动浮窗（不越出视口）', () => {
   mod.closePopup()
-  sizeStore.delete('dsh-plugin-table-zoom:popup-size') // 清掉记忆，用默认尺寸测移动
   const table = makeEl('table')
   table.rows = []
   mod.openPopup(table)
   const popup = documentEl.body.children.find((c) => c.className === 'dstz-popup')
   const panel = popup.children[0]
   const header = panel.children[0]
+  assert.equal(panel.style.width, '320px', '打开即自适应（假 DOM 无布局 → 下限 320）')
+  // 假 DOM 无真实布局：显式给起始位置，验证拖拽按 delta 移动
+  panel.style.left = '160px'
+  panel.style.top = '40px'
   panel.getBoundingClientRect = () => ({
     width: parseInt(panel.style.width, 10) || 800,
     height: parseInt(panel.style.height, 10) || 400,
@@ -386,4 +429,19 @@ ok('Ctrl+滚轮缩放表格字体', () => {
   mod.closePopup()
 })
 
+ok('applyAdaptiveWidth 按表格自然宽度自适应（窄表收缩、宽表铺满视口）', () => {
+  const panel = makeEl('div')
+  const clone = makeEl('table')
+  clone.offsetWidth = 500
+  mod.applyAdaptiveWidth(panel, clone)
+  assert.equal(panel.style.width, '538px')
+  // 超级大表：铺满视口可用宽度（假 DOM 视口 1280 - 留白 48 = 1232）
+  clone.offsetWidth = 3000
+  mod.applyAdaptiveWidth(panel, clone)
+  assert.equal(panel.style.width, '1232px')
+  clone.offsetWidth = 0
+  mod.applyAdaptiveWidth(panel, clone)
+  assert.equal(panel.style.width, '320px')
+})
+
 console.log(`[dsh-plugin-table-zoom] smoke-client: ${passed} passed`)

package//350/256/276/350/256/241/350/257/264/346/230/216.md

@@ -47,15 +47,21 @@ cordis.patch.yml         挂载一行，交 profile 的 dsh.profile.bundles 自
 - 正文：独立滚动（横竖），表格克隆带 `dstz-table` 类，样式全部走主题 CSS 变量；
 - **改尺寸**：右下角有拖拽手柄，按住可自由调整浮窗大小（最小 320×200，
   上限为视口减去遮罩留白）；
+- **每次打开自适应**：浮窗**不记忆任何布局**——尺寸按表格自然宽度自适应
+  （下限 320，窄表不撑满、超级大表铺满视口可用宽度）、位置居中、缩放 100%；
+  手动拖拽（改大小/移动/缩放）只影响当次打开，关掉再开即回到自适应；
 - **拖拽移动**：按住标题栏（按钮除外）可拖动浮窗位置，位置限制在视口内、
-  不越出页面；尺寸与位置都记忆到 `localStorage`，下次打开自动复用；
+  不越出页面；
 - **Ctrl+滚轮缩放**：浮窗内按住 Ctrl 滚动滚轮可放大/缩小表格字体
-  （60%–250%，步进 10%），标题栏实时显示百分比，缩放比例随布局一起记忆；
+  （60%–250%，步进 10%），标题栏实时显示百分比；缩放不记忆，
+  每次打开都从 100% 开始；
 - **滚动条**：正文滚动条加深加粗（WebKit 伪元素 + Firefox `scrollbar-color`），
   浅色主题下也清晰可见；
-- **拖拽平移**：表格内容溢出正文时，鼠标/触控笔按住表格即可左右/上下拖动
-  滚动（grab/grabbing 光标提示）；越过 4px 阈值才视为拖动，避免干扰文本
-  选择；触屏保留浏览器原生滚动；拖完松手落在遮罩上不会误关浮窗；
+- **框选文字优先**：普通左键拖动保留浏览器原生文本选择（表格放大后也能
+  直接框选文字），不再被平移劫持；
+- **按住空格拖拽平移**：表格内容溢出正文时，按住空格再按住表格即可
+  左右/上下拖动滚动（grab 光标仅在按住空格时出现，拖拽中为 grabbing；
+  触屏保留浏览器原生滚动）；拖完松手落在遮罩上不会误关浮窗；
 - **列宽上限**：与核心渲染器 `tableScroll` 一致（`max-width:min(30vw,320px)`、
   `min-width:100px`），超宽列在浮窗内收缩换行，表整体不再超出浮窗。
 
@@ -64,4 +70,4 @@ cordis.patch.yml         挂载一行，交 profile 的 dsh.profile.bundles 自
 - 只认 `tableScroll` 容器内的表格；浮窗内克隆表与 image-tools lightbox 内的表格跳过；
 - 不提供服务端工具/路由/配置；无 React 依赖（零运行时依赖）；
 - 复制为 Markdown 优先 clipboard API，失败时 execCommand 兜底；
-- 尺寸记忆依赖 localStorage，隐私模式等不可用场景静默跳过（浮窗仍可用默认尺寸）。
+- 不写 localStorage：浮窗布局（尺寸/位置/缩放）不跨次记忆，每次打开都自适应。