dsh-plugin-table-zoom 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## [0.1.0] - 2026-08-21
+
+- 新功能：**聊天表格浮窗**——聊天里 markdown 表格太长（≥9 行含表头）或
+  横向溢出（超宽）看不完时，表格下方出现「⛶ 浮窗查看」按钮，点击弹出
+  独立可滚动的小浮窗完整显示表格，并支持一键复制为 Markdown。
+- 长表判定：行数 ≥ `MIN_ROWS`（9，含表头）或横向溢出 > 2px；短表不打扰。
+- 浮窗展示原表格的克隆，聊天里的表格保持不变；关闭按钮 / Esc / 点击遮罩
+  均可关闭，打开期间锁定页面滚动。
+- 纯前端 DOM 增强（MutationObserver + rAF 合帧扫描），零运行时依赖，
+  不注册工具、无服务端逻辑；服务端半边为空实现，以自带 bundle patch
+  挂载进 profile（与 dsh-notify / dsh-plugin-image-tools 同款机制）。
+- 测试：selfcheck 12 项纯函数用例 + 假 DOM 端到端冒烟 6 项
+  （按钮注入/幂等/短表跳过/浮窗开合/滚动还原/剪贴板复制）。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-plugin-table-zoom contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,81 @@
+# dsh-plugin-table-zoom
+
+DeepSeek Harness (dsh) Web GUI 聊天表格浮窗插件。
+
+聊天里模型输出的 markdown 表格经常**很长（行数多）或很宽（横向溢出）**，
+在对话流里一次看不完：要上下滚动聊天、左右拖动才能看完。本插件在长表上方
+自动注入一个小按钮「⛶ 浮窗查看」，点击后弹出**独立可滚动的小浮窗**完整显示
+表格，并支持**一键复制为 Markdown**。
+
+纯前端 DOM 增强：不改核心包、不注册工具、无服务端逻辑、零运行时依赖。
+
+## 效果
+
+- 长表（≥ 9 行含表头，或横向溢出超过 2px）表格下方出现右对齐的「⛶ 浮窗查看」按钮；
+- 短表不打扰；
+- 点击按钮弹出浮窗：标题显示「表格 · N 行 × M 列」，正文可独立滚动（横竖都行），
+  关闭按钮 / Esc / 点击遮罩均可关闭，打开期间锁定聊天页滚动；
+- 浮窗头部「复制为 Markdown」按钮一键复制整表（单元格内联换行折叠、管道符转义）；
+- 浮窗里展示的是**原表格的克隆**，聊天里的表格保持不变，也不会被重复增强。
+
+## 安装
+
+本插件是纯客户端插件，需作为 bundle 挂载进 dsh 的 Web profile
+（与 dsh-notify / dsh-plugin-image-tools 同款机制）。
+
+1. 安装依赖（在 profile 目录，例如 `~/.dsh/profiles/web`）：
+
+   ```bash
+   npm install dsh-plugin-table-zoom
+   # 或从 GitHub 直装
+   npm install github:Pasumao/dsh-plugin-table-zoom
+   ```
+
+2. 在 profile 的 `package.json` 的 `dsh.profile.bundles` 里加入该插件：
+
+   ```jsonc
+   "dsh": {
+     "profile": {
+       "bundles": [
+         /* ...已有的 bundle... */,
+         "dsh-plugin-table-zoom"
+       ]
+     }
+   }
+   ```
+
+3. 在 profile 目录执行 `pnpm install`（或 `npm install`）；
+4. **重启 `dsh web`**（launcher 重新拉起），新插件才会进入浏览器 bundle。
+
+> 若以本地目录开发调试，可用 `link:` 依赖替换第 1 步：
+> `"dsh-plugin-table-zoom": "link:D:/path/to/dsh-plugin-table-zoom"`。
+
+## 工作原理
+
+- 服务端半边（`lib/index.js`）：空实现。插件以「自带 bundle patch」方式挂载进
+  profile，客户端半边由 `dsh.client` 声明经 `/plugins/dsh-plugin-table-zoom/client.js`
+  送达浏览器（与 dsh-notify / dsh-plugin-image-tools 同款机制）。
+- 客户端半边（`lib/client.js`）：MutationObserver 观察 `document.body`，
+  rAF 合帧扫描 markdown 表格（核心渲染器把表格包在类名含 `tableScroll` 的
+  容器里），对长表在容器后注入按钮行；按钮点击后命令式创建浮窗（复用
+  image-tools 的 lightbox 模式：纯 DOM 单节点变更，不插入/移除 React 管理的
+  结构，重渲染时安全）。
+
+## 开发
+
+```sh
+npm run selfcheck    # 纯函数离线测试（识别/长表判定/Markdown 序列化）
+npm run smoke        # selfcheck + 假 DOM 端到端冒烟（按钮注入/浮窗开合/复制）
+npm run pack         # 打包
+```
+
+## 兼容性
+
+- 目标：DeepSeek Harness Web GUI（dsh web），皮肤与主题 CSS 变量自适应；
+- 依赖浏览器 `MutationObserver` / `requestAnimationFrame`，无 DOM 环境自动禁用；
+- 不影响其他插件：只认 `tableScroll` 容器内的表格，跳过浮窗与 image-tools
+  lightbox 内的表格。
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,7 @@
+# dsh-plugin-table-zoom bundle patch: 挂载一行，交给 profile 的
+# dsh.profile.bundles（与 dsh-notify / dsh-plugin-image-tools 同款机制）自动应用。
+# `name` 必须等于 package.json 的 `name`（loader 按该名从 profile 的
+# node_modules 解析插件模块）。
+- insert:
+    - id: dsh-plugin-table-zoom
+      name: dsh-plugin-table-zoom

package/lib/client.js

@@ -0,0 +1,379 @@
+window.__ModuleLoader__.load({
+  id: 'dsh-plugin-table-zoom',
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
+    Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+    // ------------------------------------------------------------------
+    // 样式：一次注入 <style>，类名 dstz-*，全部走主题 CSS 变量。
+    // ------------------------------------------------------------------
+    var CSS = [
+      '.dstz-row{display:flex;justify-content:flex-end;margin-top:2px}',
+      '.dstz-btn{appearance:none;cursor:pointer;display:inline-flex;align-items:center;gap:5px;border:1px solid var(--dsw-alias-border-l2-darkmode-thin);background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary);border-radius:999px;font-size:12px;line-height:18px;padding:3px 10px;font-family:inherit;white-space:nowrap}',
+      '.dstz-btn:hover{color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-interactive-bg-active);background:var(--dsw-alias-interactive-bg-hover)}',
+      '.dstz-btn:focus-visible{outline:2px solid var(--dsw-alias-interactive-bg-active);outline-offset:1px}',
+      '.dstz-popup{position:fixed;inset:0;z-index:9999;background:rgba(8,10,18,.55);display:flex;align-items:center;justify-content:center;padding:24px}',
+      '.dstz-panel{box-sizing:border-box;background:var(--dsw-specific-input-major);border:1px solid var(--dsw-alias-border-l2-darkmode-thin);border-radius:16px;box-shadow:var(--dsw-shadow-lv2);color:var(--dsw-alias-label-primary);width:min(92vw,960px);max-height:min(84vh,720px);flex-direction:column;display:flex;overflow:hidden;--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2)}',
+      '.dstz-panel,.dstz-panel *{box-sizing:border-box}',
+      '.dstz-header{flex-shrink:0;justify-content:space-between;align-items:center;gap:12px;border-bottom:1px solid var(--dsw-alias-border-l2);padding:10px 12px 10px 18px;display:flex}',
+      '.dstz-title{margin:0;font-size:14px;font-weight:500;line-height:20px;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
+      '.dstz-title small{color:var(--dsw-alias-label-tertiary);font-size:12px;font-weight:400;margin-left:8px}',
+      '.dstz-headerActions{flex-shrink:0;align-items:center;gap:8px;display:flex}',
+      '.dstz-body{overscroll-behavior:contain;flex:auto;min-height:0;padding:14px 18px 18px;overflow:auto}',
+      '.dstz-table{border-collapse:collapse;width:max-content;max-width:max-content;color:var(--dsw-alias-label-primary)}',
+      '.dstz-table th{text-align:start;padding:8px 14px;border-bottom:1px solid var(--dsw-alias-border-l3);font:var(--dsw-font-markdown-table-head);white-space:nowrap}',
+      '.dstz-table td{padding:8px 14px;border-bottom:1px solid var(--dsw-alias-border-l2);font:var(--dsw-font-markdown-table)}',
+      '.dstz-table tr:last-child td{border-bottom:none}',
+      '.dstz-iconButton{width:28px;height:28px;color:var(--dsw-alias-label-secondary);cursor:pointer;background:0 0;border:none;border-radius:999px;place-items:center;display:grid;font-size:15px;line-height:1;padding:0}',
+      '.dstz-iconButton:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}',
+      '.dstz-iconButton:focus-visible{outline:2px solid var(--dsw-alias-interactive-bg-active);outline-offset:1px}',
+      '.dstz-copyBtn{appearance:none;cursor:pointer;border-radius:999px;border:1px solid var(--dsw-alias-border-l2-darkmode-thin);background:0 0;color:var(--dsw-alias-label-primary);font-size:12px;line-height:18px;padding:3px 10px;font-family:inherit;white-space:nowrap}',
+      '.dstz-copyBtn:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}',
+      '.dstz-copyBtn:disabled{cursor:default;opacity:.55}',
+      '@media (width<=720px){.dstz-popup{padding:12px}.dstz-panel{width:min(96vw,960px);max-height:88vh}.dstz-body{padding:10px 12px 12px}}'
+    ].join('');
+    var tagId = 'dsh-plugin-table-zoom/zoom.module.css';
+    if (typeof document !== 'undefined' && document.querySelector('style[data-plugin-css=' + JSON.stringify(tagId) + ']') === null) {
+      var tag = document.createElement('style');
+      tag.dataset.plugin = 'dsh-plugin-table-zoom';
+      tag.dataset.pluginCss = tagId;
+      tag.textContent = CSS;
+      document.head.appendChild(tag);
+    }
+
+    // ------------------------------------------------------------------
+    // 常量与文案
+    // ------------------------------------------------------------------
+    /** 行数（含表头）达到该值即视为“长表”，注入浮窗按钮。 */
+    var MIN_ROWS = 9;
+    /** 超过该像素视为横向溢出（表太宽），也注入按钮。 */
+    var OVERFLOW_PX = 2;
+    /** markdown 表格容器类名片段（核心渲染器 tableScroll，CSS Module 哈希前缀）。 */
+    var TABLE_WRAP_HINT = 'tableScroll';
+
+    /** 页面语言是否中文（决定按钮/浮窗文案）。 */
+    function isZh() {
+      return typeof document !== 'undefined' && (document.documentElement.lang || '').toLowerCase().indexOf('zh') === 0;
+    }
+    var zh = isZh();
+    var LABELS = {
+      open: zh ? '\u6d6e\u7a97\u67e5\u770b' : 'Open in popup',
+      title: zh ? '\u8868\u683c' : 'Table',
+      rowsCols: zh ? '\u884c \u00d7 \u5217' : 'rows \u00d7 cols',
+      copy: zh ? '\u590d\u5236\u4e3a Markdown' : 'Copy as Markdown',
+      copied: zh ? '\u5df2\u590d\u5236' : 'Copied',
+      copyFailed: zh ? '\u590d\u5236\u5931\u8d25' : 'Copy failed',
+      close: zh ? '\u5173\u95ed' : 'Close'
+    };
+
+    // ------------------------------------------------------------------
+    // 纯函数（导出供 selfcheck / smoke 测试）
+    // ------------------------------------------------------------------
+
+    /**
+     * 判断一个 <table> 是否位于 markdown 表格容器内（核心渲染器把表格包在
+     * `.tableScroll` 样式的 div 里，类名为 CSS Module 哈希，用属性包含匹配）。
+     * @param {object} table - <table> 元素（或测试用假对象，须有 closest 方法）。
+     * @returns {boolean}
+     */
+    function isMarkdownTable(table) {
+      if (table === null || typeof table !== 'object' || typeof table.closest !== 'function') return false;
+      return table.closest('[class*="' + TABLE_WRAP_HINT + '"]') !== null;
+    }
+
+    /**
+     * 判断表格是否“长”（行数多或横向溢出）而值得注入浮窗按钮。
+     * @param {object} table - <table> 元素（须有 rows 数组/类数组，rows[0].cells）。
+     * @param {object} wrap - 表格容器（须有 scrollWidth / clientWidth）。
+     * @returns {boolean}
+     */
+    function isLongTable(table, wrap) {
+      if (table === null || typeof table !== 'object') return false;
+      var rows = table.rows;
+      var rowCount = rows === null || rows === void 0 ? 0 : rows.length;
+      if (rowCount >= MIN_ROWS) return true;
+      if (wrap !== null && typeof wrap === 'object') {
+        var sw = typeof wrap.scrollWidth === 'number' ? wrap.scrollWidth : 0;
+        var cw = typeof wrap.clientWidth === 'number' ? wrap.clientWidth : 0;
+        if (sw > cw + OVERFLOW_PX) return true;
+      }
+      return false;
+    }
+
+    /**
+     * 把 <table> 序列化为 Markdown 文本（单元格内联换行/管道转义），
+     * 供「复制为 Markdown」使用。纯函数，可离线测试。
+     * @param {object} table - <table> 元素（须有 rows，rows[i].cells，cell.textContent）。
+     * @returns {string}
+     */
+    function tableToMarkdown(table) {
+      if (table === null || typeof table !== 'object' || table.rows === null || table.rows === void 0) return '';
+      var rows = [];
+      for (var r = 0; r < table.rows.length; r++) {
+        var tr = table.rows[r];
+        var cells = tr.cells === null || tr.cells === void 0 ? [] : tr.cells;
+        var row = [];
+        for (var c = 0; c < cells.length; c++) {
+          var text = cells[c].textContent === null || cells[c].textContent === void 0 ? '' : String(cells[c].textContent);
+          row.push(text.replace(/\s*\n\s*/g, ' ').trim().replace(/\|/g, '\\|'));
+        }
+        rows.push(row);
+      }
+      if (rows.length === 0) return '';
+      var width = 0;
+      for (var i = 0; i < rows.length; i++) width = Math.max(width, rows[i].length);
+      var lines = [];
+      var pad = function (row) {
+        var out = [];
+        for (var j = 0; j < width; j++) out.push(j < row.length ? row[j] : '');
+        return out;
+      };
+      var line = function (row) { return '| ' + pad(row).join(' | ') + ' |'; };
+      lines.push(line(rows[0]));
+      var sep = [];
+      for (var k = 0; k < width; k++) sep.push('---');
+      lines.push('| ' + sep.join(' | ') + ' |');
+      for (var m = 1; m < rows.length; m++) lines.push(line(rows[m]));
+      return lines.join('\n');
+    }
+
+    // ------------------------------------------------------------------
+    // 浮窗：命令式 DOM（复用 image-tools lightbox 模式，不触碰 React 结构）
+    // ------------------------------------------------------------------
+    var activePopup = null;
+    var lastTrigger = null;
+
+    /** 关闭当前浮窗并还原页面滚动。 */
+    function closePopup() {
+      if (activePopup === null) return;
+      var popup = activePopup;
+      activePopup = null;
+      if (typeof popup._onKey === 'function') document.removeEventListener('keydown', popup._onKey);
+      popup.remove();
+      document.body.style.overflow = lastTrigger !== null && lastTrigger.bodyOverflow !== void 0 ? lastTrigger.bodyOverflow : '';
+      lastTrigger = null;
+    }
+
+    /** 复制文本到剪贴板（clipboard API，失败时 execCommand 兜底）。@returns {Promise<boolean>} */
+    function copyText(text) {
+      if (typeof navigator !== 'undefined' && navigator.clipboard && typeof navigator.clipboard.writeText === 'function') {
+        return navigator.clipboard.writeText(text).then(function () { return true; }, function () { return legacyCopy(text); });
+      }
+      return Promise.resolve(legacyCopy(text));
+    }
+
+    /** 旧式复制兜底（textarea + execCommand）。 */
+    function legacyCopy(text) {
+      if (typeof document === 'undefined') return false;
+      try {
+        var ta = document.createElement('textarea');
+        ta.value = text;
+        ta.setAttribute('readonly', '');
+        ta.style.position = 'fixed';
+        ta.style.top = '-9999px';
+        document.body.appendChild(ta);
+        ta.select();
+        var ok = document.execCommand('copy');
+        ta.remove();
+        return ok;
+      } catch (e) {
+        return false;
+      }
+    }
+
+    /**
+     * 打开表格浮窗：可滚动容器 + 表格克隆 + 头部（标题/行列数/复制/关闭）。
+     * 克隆而不是移动原表格，聊天里的表格保持不变。
+     * @param {object} table - 原始 <table> 元素。
+     */
+    function openPopup(table) {
+      if (typeof document === 'undefined' || table === null || typeof table !== 'object') return;
+      closePopup();
+
+      var overlay = document.createElement('div');
+      overlay.className = 'dstz-popup';
+      overlay.setAttribute('role', 'dialog');
+      overlay.setAttribute('aria-modal', 'true');
+      overlay.setAttribute('aria-label', LABELS.title);
+
+      var panel = document.createElement('div');
+      panel.className = 'dstz-panel';
+
+      var header = document.createElement('header');
+      header.className = 'dstz-header';
+      var title = document.createElement('h3');
+      title.className = 'dstz-title';
+      title.textContent = LABELS.title;
+      var rowCount = table.rows !== null && table.rows !== void 0 ? table.rows.length : 0;
+      var colCount = rowCount > 0 && table.rows[0].cells !== void 0 ? table.rows[0].cells.length : 0;
+      var small = document.createElement('small');
+      small.textContent = rowCount + ' ' + LABELS.rowsCols + ' ' + colCount;
+      title.appendChild(small);
+
+      var actions = document.createElement('div');
+      actions.className = 'dstz-headerActions';
+
+      var copyBtn = document.createElement('button');
+      copyBtn.type = 'button';
+      copyBtn.className = 'dstz-copyBtn';
+      copyBtn.textContent = LABELS.copy;
+      copyBtn.addEventListener('click', function () {
+        copyBtn.disabled = true;
+        copyText(tableToMarkdown(table)).then(function (ok) {
+          copyBtn.textContent = ok ? LABELS.copied : LABELS.copyFailed;
+          window.setTimeout(function () {
+            copyBtn.textContent = LABELS.copy;
+            copyBtn.disabled = false;
+          }, 1600);
+        });
+      });
+
+      var closeBtn = document.createElement('button');
+      closeBtn.type = 'button';
+      closeBtn.className = 'dstz-iconButton';
+      closeBtn.setAttribute('aria-label', LABELS.close);
+      closeBtn.title = LABELS.close;
+      closeBtn.textContent = '\u2715';
+      closeBtn.addEventListener('click', closePopup);
+
+      actions.appendChild(copyBtn);
+      actions.appendChild(closeBtn);
+      header.appendChild(title);
+      header.appendChild(actions);
+
+      var body = document.createElement('div');
+      body.className = 'dstz-body';
+      var clone = table.cloneNode(true);
+      clone.className = 'dstz-table';
+      body.appendChild(clone);
+
+      panel.appendChild(header);
+      panel.appendChild(body);
+      overlay.appendChild(panel);
+
+      lastTrigger = { bodyOverflow: document.body.style.overflow };
+      document.body.style.overflow = 'hidden';
+
+      var onKey = function (event) {
+        if (event.key === 'Escape') closePopup();
+      };
+      overlay.addEventListener('click', function (event) {
+        if (event.target === overlay) closePopup();
+      });
+      document.addEventListener('keydown', onKey);
+      overlay._onKey = onKey;
+
+      activePopup = overlay;
+      document.body.appendChild(overlay);
+      closeBtn.focus();
+    }
+
+    // ------------------------------------------------------------------
+    // 扫描与按钮注入
+    // ------------------------------------------------------------------
+
+    /** 为单个表格注入「浮窗查看」按钮（容器后插入一行，右对齐）。 */
+    function upgradeTable(table) {
+      if (typeof document === 'undefined') return null;
+      if (!isMarkdownTable(table)) return null;
+      // 跳过浮窗内部（克隆表）与图片 lightbox 内的表格
+      if (typeof table.closest === 'function' && table.closest('.dstz-popup') !== null) return null;
+      if (typeof table.closest === 'function' && table.closest('.dshpick-lightbox') !== null) return null;
+
+      var wrap = table.closest('[class*="' + TABLE_WRAP_HINT + '"]');
+      if (wrap === null || wrap === void 0) return null;
+      if (!isLongTable(table, wrap)) return null;
+
+      // 该表格容器后紧跟的兄弟已经是按钮行则不再重复插入
+      if (wrap.nextElementSibling !== null && wrap.nextElementSibling.classList !== void 0
+          && wrap.nextElementSibling.classList.contains('dstz-row')) {
+        if (table.dataset !== void 0) table.dataset.dstz = '1';
+        return null;
+      }
+
+      var parent = wrap.parentNode;
+      if (parent === null || parent === void 0) return null;
+
+      var row = document.createElement('div');
+      row.className = 'dstz-row';
+      var btn = document.createElement('button');
+      btn.type = 'button';
+      btn.className = 'dstz-btn';
+      btn.setAttribute('aria-label', LABELS.open);
+      btn.title = LABELS.open;
+      var icon = document.createElement('span');
+      icon.setAttribute('aria-hidden', 'true');
+      icon.textContent = '\u26F6';
+      var label = document.createElement('span');
+      label.textContent = LABELS.open;
+      btn.appendChild(icon);
+      btn.appendChild(label);
+      btn.addEventListener('click', function () { openPopup(table); });
+      row.appendChild(btn);
+
+      if (wrap.nextSibling !== null) {
+        parent.insertBefore(row, wrap.nextSibling);
+      } else {
+        parent.appendChild(row);
+      }
+      if (table.dataset !== void 0) table.dataset.dstz = '1';
+      return row;
+    }
+
+    /** 全量扫描：对每个候选表格执行 upgradeTable。 */
+    function upgradeTables() {
+      if (typeof document === 'undefined') return;
+      var tables = document.querySelectorAll('table');
+      for (var i = 0; i < tables.length; i++) upgradeTable(tables[i]);
+    }
+
+    /**
+     * 启动表格增强：MutationObserver 观察 body，rAF 合帧扫描。
+     * @returns {Function|null} 停止函数；无 DOM 环境返回 null。
+     */
+    function startEnhancer() {
+      if (typeof document === 'undefined' || typeof MutationObserver === 'undefined' || typeof requestAnimationFrame === 'undefined') return null;
+      var pending = false;
+      var scan = function () {
+        pending = false;
+        upgradeTables();
+      };
+      var observer = new MutationObserver(function () {
+        if (pending) return;
+        pending = true;
+        requestAnimationFrame(scan);
+      });
+      observer.observe(document.body, { childList: true, subtree: true });
+      scan();
+      return function () {
+        observer.disconnect();
+        closePopup();
+      };
+    }
+
+    // ------------------------------------------------------------------
+    // 插件入口
+    // ------------------------------------------------------------------
+    function apply(ctx) {
+      ctx.effect(function () {
+        return startEnhancer();
+      }, 'dsh-plugin-table-zoom: table popup enhancer');
+    }
+
+    exports.apply = apply;
+    exports.inject = [];
+    // 供自检/冒烟测试复用：纯函数与可测入口。
+    exports.MIN_ROWS = MIN_ROWS;
+    exports.isMarkdownTable = isMarkdownTable;
+    exports.isLongTable = isLongTable;
+    exports.tableToMarkdown = tableToMarkdown;
+    exports.openPopup = openPopup;
+    exports.closePopup = closePopup;
+    exports.copyText = copyText;
+    exports.upgradeTable = upgradeTable;
+    exports.upgradeTables = upgradeTables;
+    exports.startEnhancer = startEnhancer;
+    return module.exports;
+  }
+});

package/lib/index.js

@@ -0,0 +1,26 @@
+/**
+ * dsh-plugin-table-zoom — 聊天表格浮窗插件（服务端半边）
+ *
+ * 功能：聊天里 markdown 表格太长（行数多 / 横向超宽）导致一次看不完时，
+ * 在表格上方自动出现一个小按钮「⛶ 浮窗查看」；点击后弹出可滚动的小浮窗，
+ * 完整显示表格（独立于聊天滚动），并支持一键复制为 Markdown。
+ *
+ * 实现完全在客户端半边（lib/client.js）：
+ *   MutationObserver 扫描 DOM 中的 markdown 表格（`.tableScroll` 容器内的
+ *   `<table>`），对长表注入按钮；按钮点击后命令式创建浮窗（复用 image-tools
+ *   的 lightbox 模式，纯 DOM 单节点变更，不触碰 React 管理的结构）。
+ * 服务端半边因此为空实现：插件以「自带 bundle patch」方式挂载进 profile，
+ * 客户端半边由 dsh.client 声明经 /plugins/<id>/client.js 送达浏览器。
+ *
+ * @module dsh-plugin-table-zoom
+ */
+
+export const name = 'dsh-plugin-table-zoom'
+
+/** 服务端不依赖任何宿主服务（所有逻辑在客户端半边）。 */
+export const inject = []
+
+/** 插件入口：空实现。详见文件头注释。 */
+export function apply() {
+  // 无服务端注册项：浮窗协议是纯客户端交互（DOM 增强）。
+}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "dsh-plugin-table-zoom",
+  "description": "DSH 聊天表格浮窗插件：聊天里 markdown 表格太长（行多/超宽）看不完时，表格上方自动出现「浮窗查看」按钮，点击弹出可滚动的小浮窗完整显示表格，并支持一键复制为 Markdown。纯前端 DOM 增强，不改核心包、不注册工具、无服务端逻辑。",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "scripts",
+    "cordis.patch.yml",
+    "CHANGELOG.md",
+    "README.md",
+    "LICENSE",
+    "设计说明.md"
+  ],
+  "scripts": {
+    "selfcheck": "node scripts/selfcheck.mjs",
+    "smoke": "node scripts/selfcheck.mjs && node scripts/smoke-client.mjs",
+    "pack": "npm pack",
+    "prepublishOnly": "npm run smoke"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek",
+    "harness",
+    "cordis",
+    "plugin",
+    "table",
+    "markdown",
+    "popup",
+    "zoom",
+    "float"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Pasumao/dsh-plugin-table-zoom.git"
+  },
+  "homepage": "https://github.com/Pasumao/dsh-plugin-table-zoom#readme",
+  "bugs": {
+    "url": "https://github.com/Pasumao/dsh-plugin-table-zoom/issues"
+  },
+  "license": "MIT",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [],
+      "platform": "web"
+    }
+  }
+}

package/scripts/selfcheck.mjs

@@ -0,0 +1,121 @@
+/**
+ * dsh-plugin-table-zoom 自检：对 lib/client.js 导出的纯函数做离线冒烟测试。
+ * 运行：node scripts/selfcheck.mjs
+ */
+import { readFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { strict as assert } from 'node:assert'
+
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
+
+// 1) 模拟浏览器模块加载器并物化 factory（本插件不依赖 react，无需 shim require）
+let spec = null
+globalThis.window = {
+  __ModuleLoader__: { load: (value) => { spec = value } },
+}
+const code = readFileSync(join(ROOT, 'lib', 'client.js'), 'utf8')
+new Function(code)()
+assert.ok(spec !== null, 'module loader not invoked')
+assert.equal(spec.id, 'dsh-plugin-table-zoom')
+
+const mod = spec.factory((name) => { throw new Error(`unexpected require: ${name}`) })
+assert.equal(typeof mod.apply, 'function')
+assert.deepEqual(mod.inject, [])
+assert.equal(typeof mod.isMarkdownTable, 'function')
+assert.equal(typeof mod.isLongTable, 'function')
+assert.equal(typeof mod.tableToMarkdown, 'function')
+assert.equal(typeof mod.openPopup, 'function')
+assert.equal(typeof mod.closePopup, 'function')
+assert.equal(typeof mod.copyText, 'function')
+
+let passed = 0
+function ok(name, fn) {
+  fn()
+  passed += 1
+  console.log(`  ok  ${name}`)
+}
+
+console.log('[dsh-plugin-table-zoom] selfcheck')
+
+// --- isMarkdownTable：识别 markdown 表格容器（类名哈希含 tableScroll） ---
+ok('isMarkdownTable 命中 tableScroll 容器', () => {
+  const table = { closest: (sel) => sel.includes('tableScroll') ? {} : null }
+  assert.equal(mod.isMarkdownTable(table), true)
+})
+ok('isMarkdownTable 拒绝普通表格', () => {
+  const table = { closest: () => null }
+  assert.equal(mod.isMarkdownTable(table), false)
+})
+ok('isMarkdownTable 拒绝 null / 无 closest', () => {
+  assert.equal(mod.isMarkdownTable(null), false)
+  assert.equal(mod.isMarkdownTable({}), false)
+})
+
+// --- isLongTable：行数多或横向溢出 ---
+ok('isLongTable 行数达标', () => {
+  const table = { rows: new Array(mod.MIN_ROWS).fill({}) }
+  assert.equal(mod.isLongTable(table, { scrollWidth: 100, clientWidth: 100 }), true)
+})
+ok('isLongTable 行数少但横向溢出', () => {
+  const table = { rows: [{}, {}] }
+  assert.equal(mod.isLongTable(table, { scrollWidth: 500, clientWidth: 300 }), true)
+})
+ok('isLongTable 都未达标', () => {
+  const table = { rows: [{}, {}] }
+  assert.equal(mod.isLongTable(table, { scrollWidth: 100, clientWidth: 100 }), false)
+})
+ok('isLongTable 缺 wrap 时只看行数', () => {
+  const table = { rows: new Array(mod.MIN_ROWS).fill({}) }
+  assert.equal(mod.isLongTable(table, null), true)
+  assert.equal(mod.isLongTable({ rows: [{}] }, null), false)
+})
+
+// --- tableToMarkdown：单元格转义 / 内联换行 / 对齐 ---
+ok('tableToMarkdown 基础表格', () => {
+  const table = {
+    rows: [
+      { cells: [{ textContent: '名称' }, { textContent: '数值' }] },
+      { cells: [{ textContent: '甲' }, { textContent: '12' }] },
+      { cells: [{ textContent: '乙' }, { textContent: '34' }] },
+    ],
+  }
+  assert.equal(
+    mod.tableToMarkdown(table),
+    '| 名称 | 数值 |\n| --- | --- |\n| 甲 | 12 |\n| 乙 | 34 |',
+  )
+})
+ok('tableToMarkdown 转义管道符', () => {
+  const table = {
+    rows: [
+      { cells: [{ textContent: 'A|B' }] },
+      { cells: [{ textContent: 'C' }] },
+    ],
+  }
+  const out = mod.tableToMarkdown(table)
+  assert.ok(out.includes('A\\|B'), out)
+})
+ok('tableToMarkdown 折叠内联换行', () => {
+  const table = {
+    rows: [
+      { cells: [{ textContent: '多\n行' }] },
+    ],
+  }
+  assert.ok(mod.tableToMarkdown(table).includes('多 行'))
+})
+ok('tableToMarkdown 补齐短行', () => {
+  const table = {
+    rows: [
+      { cells: [{ textContent: 'a' }, { textContent: 'b' }] },
+      { cells: [{ textContent: 'c' }] },
+    ],
+  }
+  const out = mod.tableToMarkdown(table)
+  assert.ok(out.includes('| c |  |'), out)
+})
+ok('tableToMarkdown 空表', () => {
+  assert.equal(mod.tableToMarkdown({ rows: [] }), '')
+  assert.equal(mod.tableToMarkdown(null), '')
+})
+
+console.log(`[dsh-plugin-table-zoom] selfcheck: ${passed} passed`)

package/scripts/smoke-client.mjs

@@ -0,0 +1,254 @@
+/**
+ * dsh-plugin-table-zoom 客户端冒烟测试：
+ * 用 Node 模拟浏览器模块加载器执行 lib/client.js，再用一个最小假 DOM
+ * 验证端到端行为：
+ *   1. 模块加载、apply/inject 导出正常；
+ *   2. upgradeTable 在长表容器后注入「浮窗查看」按钮行，短表不注入；
+ *   3. openPopup 创建浮窗（标题含行列数、表格克隆、关闭按钮），
+ *      closePopup 关闭并还原 body 滚动；
+ *   4. 表格克隆在浮窗内不会被再次增强（跳过 .dstz-popup）。
+ *
+ * 运行：node scripts/smoke-client.mjs
+ */
+import { readFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { strict as assert } from 'node:assert'
+
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
+
+// ---------------------------------------------------------------------------
+// 最小假 DOM（够 upgradeTable / openPopup / closePopup 使用）
+// ---------------------------------------------------------------------------
+function makeEl(tag) {
+  const el = {
+    tagName: tag.toUpperCase(),
+    children: [],
+    parentNode: null,
+    className: '',
+    dataset: {},
+    style: {},
+    _text: '',
+    attributes: {},
+    listeners: {},
+    _onKey: null,
+    setAttribute(k, v) { this.attributes[k] = String(v) },
+    getAttribute(k) { return this.attributes[k] ?? null },
+    appendChild(child) {
+      this.children.push(child)
+      child.parentNode = this
+      return child
+    },
+    insertBefore(child, ref) {
+      const idx = this.children.indexOf(ref)
+      if (idx < 0) this.children.push(child)
+      else this.children.splice(idx, 0, child)
+      child.parentNode = this
+      return child
+    },
+    remove() {
+      if (this.parentNode) {
+        const idx = this.parentNode.children.indexOf(this)
+        if (idx >= 0) this.parentNode.children.splice(idx, 1)
+        this.parentNode = null
+      }
+    },
+    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: this, stopPropagation() {}, ...event })
+    },
+    focus() { this._focused = true },
+    cloneNode(deep) {
+      const copy = makeEl(this.tagName)
+      copy.className = this.className
+      copy._text = this._text
+      copy.dataset = { ...this.dataset }
+      if (deep) {
+        copy.children = this.children.map((c) => c.cloneNode(true))
+        for (const c of copy.children) c.parentNode = copy
+      }
+      return copy
+    },
+    querySelector(sel) {
+      for (const c of this.children) {
+        if (c.matches && c.matches(sel)) return c
+        const hit = c.querySelector ? c.querySelector(sel) : null
+        if (hit) return hit
+      }
+      return null
+    },
+    matches(sel) {
+      if (sel.startsWith('.')) return this.className.split(/\s+/).includes(sel.slice(1))
+      return false
+    },
+  }
+  Object.defineProperty(el, 'textContent', {
+    get() {
+      return this._text + this.children.map((c) => c.textContent).join('')
+    },
+    set(v) { this._text = String(v) },
+  })
+  Object.defineProperty(el, 'nextElementSibling', {
+    get() {
+      if (!this.parentNode) return null
+      const siblings = this.parentNode.children
+      const idx = siblings.indexOf(this)
+      if (idx < 0) return null
+      return siblings[idx + 1] ?? null
+    },
+  })
+  Object.defineProperty(el, 'classList', {
+    value: {
+      contains: (c) => el.className.split(/\s+/).includes(c),
+      add: (...cs) => { for (const c of cs) if (!el.classList.contains(c)) el.className += (el.className ? ' ' : '') + c },
+      remove: (...cs) => {
+        const keep = el.className.split(/\s+/).filter((c) => !cs.includes(c))
+        el.className = keep.join(' ')
+      },
+    },
+  })
+  return el
+}
+
+const documentEl = {
+  documentElement: { lang: 'zh-CN' },
+  head: makeEl('head'),
+  body: makeEl('body'),
+  createElement: (tag) => makeEl(tag),
+  querySelector: () => null,
+  querySelectorAll: () => [],
+  addEventListener() {},
+  removeEventListener() {},
+}
+globalThis.document = documentEl
+globalThis.window = { setTimeout: (fn) => fn() }
+Object.defineProperty(globalThis, 'navigator', {
+  value: { clipboard: { writeText: async (t) => { globalThis.__copied = t } } },
+  configurable: true,
+})
+globalThis.requestAnimationFrame = (fn) => fn()
+
+let passed = 0
+function ok(name, fn) {
+  fn()
+  passed += 1
+  console.log(`  ok  ${name}`)
+}
+
+console.log('[dsh-plugin-table-zoom] smoke-client')
+
+// 1) 模块加载与导出
+let spec = null
+globalThis.window.__ModuleLoader__ = { load: (value) => { spec = value } }
+const code = readFileSync(join(ROOT, 'lib', 'client.js'), 'utf8')
+new Function(code)()
+assert.ok(spec !== null, 'module loader not invoked')
+assert.equal(spec.id, 'dsh-plugin-table-zoom')
+const mod = spec.factory((name) => { throw new Error(`unexpected require: ${name}`) })
+assert.equal(typeof mod.apply, 'function')
+assert.equal(typeof mod.upgradeTable, 'function')
+assert.equal(typeof mod.upgradeTables, 'function')
+assert.equal(typeof mod.openPopup, 'function')
+assert.equal(typeof mod.closePopup, 'function')
+assert.equal(typeof mod.startEnhancer, 'function')
+assert.equal(typeof mod.tableToMarkdown, 'function')
+
+// 2) 长表注入按钮行
+ok('upgradeTable 为长表注入按钮行', () => {
+  const parent = makeEl('div')
+  const wrap = makeEl('div')
+  wrap.className = 'x_tableScroll_y'
+  wrap.scrollWidth = 100
+  wrap.clientWidth = 100
+  const table = makeEl('table')
+  table.closest = (sel) => sel.includes('tableScroll') ? wrap : null
+  table.rows = new Array(mod.MIN_ROWS).fill({ cells: [] })
+  parent.appendChild(wrap)
+  const row = mod.upgradeTable(table)
+  assert.ok(row !== null)
+  assert.ok(row.classList.contains('dstz-row'))
+  assert.equal(row.children[0].className, 'dstz-btn')
+  assert.equal(table.dataset.dstz, '1')
+  // 幂等：再次调用不重复插入
+  const again = mod.upgradeTable(table)
+  assert.equal(again, null)
+  assert.equal(parent.children.filter((c) => c.classList.contains('dstz-row')).length, 1)
+})
+
+ok('upgradeTable 跳过短表', () => {
+  const parent = makeEl('div')
+  const wrap = makeEl('div')
+  wrap.className = 'x_tableScroll_y'
+  wrap.scrollWidth = 100
+  wrap.clientWidth = 100
+  const table = makeEl('table')
+  table.closest = (sel) => sel.includes('tableScroll') ? wrap : null
+  table.rows = [{ cells: [] }, { cells: [] }]
+  parent.appendChild(wrap)
+  assert.equal(mod.upgradeTable(table), null)
+})
+
+ok('upgradeTable 跳过浮窗内克隆表', () => {
+  const popup = makeEl('div')
+  popup.className = 'dstz-popup'
+  const wrap = makeEl('div')
+  wrap.className = 'x_tableScroll_y'
+  const table = makeEl('table')
+  table.closest = (sel) => {
+    if (sel.includes('tableScroll')) return wrap
+    if (sel.startsWith('.dstz-popup')) return popup
+    return null
+  }
+  table.rows = new Array(mod.MIN_ROWS).fill({ cells: [] })
+  popup.appendChild(wrap)
+  assert.equal(mod.upgradeTable(table), null)
+})
+
+// 3) 浮窗开合
+ok('openPopup 创建浮窗并克隆表格', () => {
+  const table = makeEl('table')
+  const row1 = makeEl('tr'); row1.cells = [{ textContent: '列A' }, { textContent: '列B' }]
+  const row2 = makeEl('tr'); row2.cells = [{ textContent: '1' }, { textContent: '2' }]
+  table.rows = [row1, row2]
+  table.appendChild(row1)
+  table.appendChild(row2)
+  mod.openPopup(table)
+  const popup = documentEl.body.children.find((c) => c.className === 'dstz-popup')
+  assert.ok(popup !== undefined, 'popup not appended')
+  const panel = popup.children[0]
+  assert.equal(panel.className, 'dstz-panel')
+  const titleText = panel.children[0].textContent
+  assert.ok(titleText.includes('2'), 'title should include row count: ' + titleText)
+  const clone = panel.children[1].children[0]
+  assert.equal(clone.className, 'dstz-table')
+  assert.equal(clone.children.length, 2, 'clone should carry both rows')
+  assert.equal(documentEl.body.style.overflow, 'hidden', 'body scroll locked')
+})
+
+ok('closePopup 关闭浮窗并还原滚动', () => {
+  mod.closePopup() // 清掉上一条用例遗留的浮窗
+  documentEl.body.style.overflow = 'auto'
+  const table = makeEl('table')
+  table.rows = []
+  mod.openPopup(table)
+  assert.equal(documentEl.body.style.overflow, 'hidden')
+  mod.closePopup()
+  assert.equal(documentEl.body.children.filter((c) => c.className === 'dstz-popup').length, 0)
+  assert.equal(documentEl.body.style.overflow, 'auto')
+})
+
+// 4) 复制为 Markdown（走 navigator.clipboard 假实现）
+ok('copyText 写入剪贴板', async () => {
+  await mod.copyText('| a |\n| --- |')
+  assert.equal(globalThis.__copied, '| a |\n| --- |')
+})
+
+console.log(`[dsh-plugin-table-zoom] smoke-client: ${passed} passed`)

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

@@ -0,0 +1,53 @@
+# dsh-plugin-table-zoom 设计说明
+
+## 目标
+
+给 dsh Web GUI 聊天增加一项能力：模型输出的 markdown 表格太长/太宽一次看不完时，
+表格下方出现「浮窗查看」按钮，点击弹出独立可滚动的小浮窗完整显示表格，并可一键
+复制为 Markdown。
+
+## 现状（原生链路）
+
+```
+模型文本（markdown 表格）
+  → 核心渲染器 MarkdownText（micromark 直接 mdast→React）
+      → renderTable：<div class="…tableScroll"><table>…</table></div>
+  → 长表在对话流里：整条消息很高，表格行数多时上下滚动才能看完；
+    表很宽时 tableScroll 容器横向滚动，但视野受限。
+```
+
+## 关键约束
+
+- 核心 MarkdownText 是 frozen 静态模块（`dsh-client-ui-primitives`），**无法包装
+  MarkdownText**，消息渲染也没有 content 级 slot。因此按钮注入走「DOM 渐进增强」
+  而不是改渲染器——与 dsh-plugin-image-tools 的回复内嵌图片增强同一模式：
+  `MutationObserver` + `requestAnimationFrame` 合帧扫描，命令式 DOM 单节点变更，
+  不插入/移除 React 管理的结构，重渲染时安全。
+- 表格容器类名是 CSS Module 哈希（如 `_tableScroll_1nba0_174`），**不能用固定类名
+  匹配**，改用属性包含匹配 `[class*="tableScroll"]`（核心渲染器恒定使用该片段）。
+- 浮窗展示的是 `table.cloneNode(true)` 克隆，不是移动原表格：聊天里的表格保持
+  不变，且克隆表位于 `.dstz-popup` 内，扫描器会跳过，不会被重复增强。
+- 短表不打扰：行数 ≥ 9（含表头）或横向溢出 > 2px 才注入按钮。
+
+## 实现结构
+
+```
+lib/index.js   服务端半边：空实现（纯客户端插件，自带 bundle patch 挂载）
+lib/client.js  客户端半边：样式注入 + 纯函数（识别/长表判定/Markdown 序列化）
+               + 按钮注入 + 浮窗（开合/滚动锁定/复制）
+scripts/selfcheck.mjs    纯函数离线测试
+scripts/smoke-client.mjs 假 DOM 端到端冒烟（按钮注入/浮窗开合/复制）
+cordis.patch.yml         挂载一行，交 profile 的 dsh.profile.bundles 自动应用
+```
+
+## 浮窗行为
+
+- 打开：锁定 body 滚动；Esc / 关闭按钮 / 点击遮罩关闭并还原滚动；
+- 头部：标题「表格 · N 行 × M 列」+「复制为 Markdown」+ 关闭按钮；
+- 正文：独立滚动（横竖），表格克隆带 `dstz-table` 类，样式全部走主题 CSS 变量。
+
+## 边界与不做的事
+
+- 只认 `tableScroll` 容器内的表格；浮窗内克隆表与 image-tools lightbox 内的表格跳过；
+- 不提供服务端工具/路由/配置；无 React 依赖（零运行时依赖）；
+- 复制为 Markdown 优先 clipboard API，失败时 execCommand 兜底。