dsh-mobile-ui 0.2.6 → 0.2.9

package/client.js

@@ -271,31 +271,44 @@ window.__ModuleLoader__.load({
 			   而容器在 header 里的横坐标随「有无子代理/后台任务」变化 —— 候选方案 right:0 在容器靠右时
 			   可用、靠左时左溢出；fixed 与容器位置无关（实测两种场景都在视口内）。
 			   ⚠️ hash 前缀（QsffPG_ / _1nxmc_）会随 dsh 升级漂移、失效是静默的（退回溢出），
-			   升级后跑 tests/live-probe.py 复核（已覆盖后台任务菜单）。 */
+			   升级后跑 tests/live-probe.py 复核（已覆盖后台任务菜单）。
+			   🔴 2026-09-28 实证（dsh 0.1.7）：_list_1nxmc_ → _list_gzo7u_，且上游改用
+			   `--dsh-menu-anchor` CSS 变量定位 ⇒ 旧选择器整条失配、菜单左溢 61px
+			   （用户报「三个点显示不全」）。已改用**语义锚点**
+			   `[class*=headerUtilities] [role=menu]` —— 只依赖 headerUtilities 这个语义后缀、
+			   不含 hash 前缀；0.1.5 与 0.1.7 双版本实测均生效
+			   （对比脚本 tests/try-menu-fix.py：注入前后 rect 从 [-61,…] 回到 [8,…]）。 */
 			/* ⚠️ popover 的 top 必须落在**触发按钮下方**：菜单弹出后若盖住按钮本身，
 			   用户再点一下（想关掉/重开）时点击落在菜单上 —— 体感就是「点了没反应」
 			   （2026-09-14 用户报「三个点按钮点击没反应」：实测命中率只有 2/6，
 			   菜单 [8,76,374,42] 正好压在 tabs 行的按钮 80..106 上）。
 			   · QsffPG：触发按钮在 header 第二行 42..70 ⇒ top 74
 			   · _1nxmc_（「更多操作」）：触发按钮在 tabs 行 80..106 ⇒ top 122 */
-			"  body.dsh-mobile-ui [class*=QsffPG_menu],body.dsh-mobile-ui [role=menu][class*=_list_1nxmc_]{position:fixed !important;left:8px !important;right:8px !important;width:auto !important;min-width:0 !important;max-width:none !important;max-height:calc(100vh - 150px) !important;overflow:auto !important;top:calc(var(--dsh-mobile-popover-top,74px) + env(safe-area-inset-top,0px)) !important}",
-			"  body.dsh-mobile-ui [role=menu][class*=_list_1nxmc_]{--dsh-mobile-popover-top:122px}",
+			"  body.dsh-mobile-ui [class*=QsffPG_menu],body.dsh-mobile-ui [class*=headerUtilities] [role=menu]{position:fixed !important;left:8px !important;right:8px !important;width:auto !important;min-width:0 !important;max-width:none !important;max-height:calc(100vh - 150px) !important;overflow:auto !important;top:calc(var(--dsh-mobile-popover-top,74px) + env(safe-area-inset-top,0px)) !important}",
+			"  body.dsh-mobile-ui [class*=headerUtilities] [role=menu]{--dsh-mobile-popover-top:122px}",
 			/* ── 手机端 header 瘦身 + 正文占比（2026-09-14，用户反馈「标题栏三行有点乱 / 正文显得窄」）──
 			   实测 390px：header 138px（titleRow 三行）＋ 输入区 272px ⇒ 正文只剩 434px（占屏 51%）。
 			   三行里第三行是「终端打开 / 选择打开方式 / 更多操作 / 打开右侧边栏」——前两个点了是在
-			   **服务器上**开终端（手机上什么也看不到）、右侧边栏早被本插件隐藏（点了空白），
+			   **服务器上**开终端（手机上什么也看不到）、右侧边栏自 2026-09-28 起改由工具组 ▥ 以浮层打开（此前被本插件隐藏、点了空白），
 			   只有「更多操作」（下载 Session 日志）有用。处理：
 			     ① 整行隐藏（行空掉后 header 少 32px）；
 			     ② 「更多操作」改由**插件注入到 tabs 行空白处的按钮代理**（点击转发给上游按钮，
 			        上游按钮仍留在 DOM 里只是不可见，程序化 click 照常触发 React 逻辑）；
 			     ③ tabs 行右侧本来空着 246px，顺带放「折叠输入框」开关。
 			   隐藏后 titleRow 只剩 titleCluster 一行组（crumbs 行 + headerActions 行），header ≈ 105px。 */
-						/* ⚠️ headerUtilities 用「移出文档流但保留坐标」而不是 display:none：
+						/* ⚠️⚠️ headerUtilities 用「移出文档流但保留坐标」而不是 display:none：
 			   上游「更多操作」按钮的菜单位置由它自己的 getBoundingClientRect 算出，display:none 时
 			   该矩形全 0 ⇒ 菜单渲染成 0×0 根本看不见（2026-09-14 实测踩到）。
-			   改成 absolute + opacity:0 + pointer-events:none：不占布局高度（header 照样瘦身）、
-			   矩形照常可测、人也点不到（点击由 tabs 行的代理按钮转发）。 */
-			"  body.dsh-mobile-ui [class*=wSkVaW_headerUtilities]{position:absolute !important;top:74px !important;left:40px !important;opacity:0 !important;pointer-events:none !important}",
+			   ⚠️⚠️ 更不能再用 opacity:0（0.2.5–0.2.7 的写法，错）：**opacity 是「组不透明度」，祖先
+			   为 0 会让整棵子树（含弹层）一起透明** —— 实测「更多操作」菜单就挂在这棵子树里
+			   （祖先链：menu → span._root_1nxmc_ → div → headerUtilities），于是菜单**弹出来了、几何也正确**
+			   （实测 rect=[8,122,396,42]、含「下载 Session 日志」），却**完全看不见**，还因继承
+			   pointer-events:none 而**点不动** ⇒ 用户第三次反馈「点三个点还是没反应」的真根因
+			   （2026-09-15 定案；前两轮修的把手死区/竞态都是真问题，但不是这一条）。
+			   ✅ 正解 = visibility:hidden：同样不占布局、getBoundingClientRect 照常可测，
+			   且 **visibility 可被后代用 visible 覆盖**（opacity 不行）⇒ 弹层照常显示、照常可点。 */
+			"  body.dsh-mobile-ui [class*=wSkVaW_headerUtilities]{position:absolute !important;top:74px !important;left:40px !important;visibility:hidden !important}",
+			"  body.dsh-mobile-ui [class*=wSkVaW_headerUtilities] [role=menu],body.dsh-mobile-ui [class*=wSkVaW_headerUtilities] [class*=_list_1nxmc_],body.dsh-mobile-ui [class*=wSkVaW_headerUtilities] [class*=_portal_],body.dsh-mobile-ui [class*=wSkVaW_headerUtilities] [class*=QsffPG_menu]{visibility:visible !important;pointer-events:auto !important}",
 			"  body.dsh-mobile-ui [class*=wSkVaW_headerCorner]{display:none !important}",
 			/* 抽屉入口（原右上角悬浮汉堡 top:48/right:12，42px）在 header 从 138 降到 107 后
 			   正好压在第二行（后台任务）与 tabs 行上 —— vision 复核截图时抓到。
@@ -316,12 +329,31 @@ window.__ModuleLoader__.load({
 			"  body.dsh-mobile-ui #dsh-mobile-tab-tools button{width:36px !important;height:34px !important;min-width:36px !important;display:inline-flex !important;align-items:center !important;justify-content:center !important;padding:0 !important;border:none !important;border-radius:8px !important;background:transparent !important;color:var(--dsw-alias-label-secondary,rgba(255,255,255,.7)) !important;cursor:pointer !important}",
 			"  body.dsh-mobile-ui #dsh-mobile-tab-tools button:active{background:var(--dsw-alias-interactive-bg-hover,rgba(255,255,255,.08)) !important}",
 			"  body.dsh-mobile-ui #dsh-mobile-tab-tools svg{width:18px !important;height:18px !important;fill:none !important;stroke:currentColor !important;stroke-width:1.8 !important;stroke-linecap:round !important;stroke-linejoin:round !important}",
+			/* ⚠️⚠️ 隐形死区：右侧栏 resize 把手的残留（2026-09-14 定案，用户报「三个点没反应」的真根因）
+			   上游 pI_x6G_handle 是 rightbarCol 的拖拽热区：position:absolute;top:0;bottom:0;
+			   width:8px;margin-left:-4px;z-index:11;pointer-events:auto，left 是**固定像素**（实测 276px）。
+			   折叠右侧栏时 rightbarCol 收缩成 height:0（实测 rect=[0,915,412,0]），
+			   **但把手不跟着消失**，仍以 8px 宽、**贯穿整个视口高度**（0→915）钉在 x=276..284。
+			   后果：那一整列 8px 宽的 tap 全被吃掉（手机上没有 col-resize，用户只会觉得「点了没反应」），
+			   正文区的按钮/输入框也一并被挡。实测（同一份 client.js，仅视口不同）：
+			     412px：⋯ 按钮 260..296 的中心 278 落在 276..284 内 ⇒ elementFromPoint=handle，tap 开合命中 0/5
+			     390/435/460px：按钮恰好错开这条带 ⇒ 5/5（所以这个 bug「挑宽度」，极难靠换机型复现）
+			   移动端不需要 col-resize ⇒ 直接移除；同时给工具组抬 z-index 做第二道保险
+			   （把手 z-index:11，工具组 z-index:30，即便将来又冒出别的覆盖层也压不住按钮）。 */
+			"  body.dsh-mobile-ui [class*=pI_x6G_handle]{display:none !important}",
+			"  body.dsh-mobile-ui #dsh-mobile-tab-tools{position:relative !important;z-index:30 !important}",
 			/* ── 折叠输入区（阅读模式）：省下 composerSeat 的 ~272px，全部让给正文 ──
 			   触发方式：tabs 行的键盘按钮（状态存 localStorage，刷新后保持）。
 			   ⚠️ 提问卡片（ask_user_question）就渲染在 composerSeat 里 ⇒ 折叠状态下若检测到卡片，
 			   JS 会强制展开（见 sync 里的 qaOpen 分支），否则用户看不到问题。 */
 			"  body.dsh-mobile-ui.dsh-mobile-composer-hidden [class*=composerSeat],body.dsh-mobile-ui.dsh-mobile-composer-hidden [class*=composerStack],body.dsh-mobile-ui.dsh-mobile-composer-hidden [class*=uV2eYG_root]{display:none !important}",
 			"  body.dsh-mobile-ui #dsh-mobile-tab-tools button.dsh-mobile-on{background:var(--dsw-specific-selector,rgba(255,255,255,.12)) !important;color:var(--dsw-alias-label-primary,rgba(255,255,255,.9)) !important}",
+			/* ── 右侧边栏（工作区文件/终端）以浮层呈现（2026-09-28 新增，用户要「打开工作区文件的按钮」）──
+			   上游的「打开右侧边栏」按钮与 rightbarCol 都在，但本插件为拿正文宽度把 frame 改成单列
+			   （minmax(0,1fr)）⇒ rightbarCol 落到第二行且 height:0（实测 rect=[0,839,412,0]），
+			   点了也是空白。故给入口按钮 + 这条规则：打开时把 rightbarCol 提成覆盖整屏的浮层
+			   （不挤压正文），关闭仍走上游自带的「收起右侧边栏」（面板右上角，实测 rect=[378,10,28,28]）。 */
+			"  body.dsh-mobile-ui.dsh-mobile-rightbar [class*=rightbarCol]{position:fixed !important;inset:0 !important;width:auto !important;height:auto !important;z-index:2147482950 !important;display:block !important;background:var(--dsw-alias-bg-layer-1,#16171b) !important}",
 			/* 输入框聚焦反馈 */
 			"  body.dsh-mobile-ui textarea:focus,body.dsh-mobile-ui [class*=input]:focus-within{outline:none;box-shadow:0 0 0 2px var(--dsw-alias-brand-primary,rgba(79,124,255,.45))}",
 			/* 消息流操作按钮（复制/反馈/分享）触摸目标提升。
@@ -572,7 +604,7 @@ window.__ModuleLoader__.load({
 							   开着就什么都不做 —— 交给上游关掉，真正的 toggle。 */
 							more.addEventListener("pointerdown", function () {
 								try {
-									more.__menuWasOpen = !!document.querySelector("[role=menu][class*=_list_1nxmc_]");
+									more.__menuWasOpen = !!document.querySelector("[class*=headerUtilities] [role=menu]");
 								} catch (err) { more.__menuWasOpen = false; }
 							}, true);
 							more.addEventListener("click", function (e) {
@@ -610,8 +642,22 @@ window.__ModuleLoader__.load({
 									openDrawer();
 								} catch (err) { /* 静默 */ }
 							});
+							/* 右侧边栏（工作区文件/终端）入口 —— 见 CSS 段说明 */
+							var panelBtn = document.createElement("button");
+							panelBtn.type = "button";
+							panelBtn.id = "dsh-mobile-rightbar-toggle";
+							panelBtn.setAttribute("aria-label", "工作区文件");
+							panelBtn.innerHTML = "<svg viewBox='0 0 24 24'><rect x='3' y='4' width='18' height='16' rx='2'/><path d='M14 4v16'/></svg>";
+							panelBtn.addEventListener("click", function (e) {
+								try {
+									e.preventDefault();
+									e.stopPropagation();
+									toggleRightbar();
+								} catch (err) { /* 静默 */ }
+							});
 							box.appendChild(more);
 							box.appendChild(fold);
+							box.appendChild(panelBtn);
 							box.appendChild(menuBtn);
 							tabs.appendChild(box);
 						}
@@ -655,6 +701,62 @@ window.__ModuleLoader__.load({
 					if (tabbar) tabbar.style.display = "";
 				}
 
+				/* ── 右侧边栏（工作区文件/终端）开关（2026-09-28 新增）──────────────────────────
+				   用户要「打开工作区文件的按钮」。上游按钮与面板都在，但本插件为拿正文宽度把 frame 改成单列
+				   ⇒ rightbarCol 落到第二行且 height:0（实测 rect=[0,839,412,0]），点了也是空白。
+				   做法：代理上游「打开右侧边栏」→ 给 body 加 class → CSS 把 rightbarCol 提成覆盖整屏的浮层
+				   （不挤压正文）；关闭走上游自带的「收起右侧边栏」（面板右上角）。
+				   ⚠️ 上游按钮 label 随状态变（打开 ⇄ 收起），且 hash 类名会漂移 ⇒ 一律按 aria-label 精确选。 */
+				var rightbarOpenedAt = 0;   /* 打开时刻，用于避开 React 尚未更新 label 的窗口 */
+				function rightbarOpen() {
+					try { return document.body.classList.contains("dsh-mobile-rightbar"); } catch (e) { return false; }
+				}
+				function syncRightbarBtn() {
+					try {
+						/* 双向同步（2026-09-28 实测补）：用户可能直接点面板内上游自带的
+						   「收起右侧边栏」关闭 —— 那时我们的浮层 class 必须跟着清掉，否则
+						   class 残留会让面板继续以 fixed 全屏显示（表现为「关不掉」）。
+						   判据用上游按钮 label：面板开着时是「收起右侧边栏」、收起后回到
+						   「打开右侧边栏」。⚠️ 刚打开 1.2s 内不判定（React 还没换 label，会误清）。 */
+						if (mq.matches && rightbarOpen() && Date.now() - rightbarOpenedAt > 1200
+							&& document.querySelector('button[aria-label="打开右侧边栏"]')) {
+							document.body.classList.remove("dsh-mobile-rightbar");
+						}
+						var b = document.getElementById("dsh-mobile-rightbar-toggle");
+						if (b) b.classList.toggle("dsh-mobile-on", rightbarOpen());
+					} catch (e) { /* 静默 */ }
+				}
+				function openRightbar() {
+					/* 浮层只是**移动端**的替代方案：PC 用上游原生三列布局，插件完全不介入 */
+					if (!mq.matches) return;
+					try {
+						var up = document.querySelector('button[aria-label="打开右侧边栏"]');
+						if (up) up.click();
+						document.body.classList.add("dsh-mobile-rightbar");
+						rightbarOpenedAt = Date.now();
+						/* 面板在被 display 期间没算过尺寸 ⇒ 触发一次 resize 让它重新布局 */
+						setTimeout(function () { try { window.dispatchEvent(new Event("resize")); } catch (e) {} }, 350);
+					} catch (e) { /* 静默 */ }
+					syncRightbarBtn();
+				}
+				function closeRightbar() {
+					/* ⚠️ 非移动端绝不能点上游按钮（PC 的右侧栏是上游默认可见状态）——只清自己的 class */
+					if (!mq.matches) { resetRightbarOverlay(); return; }
+					try {
+						var up = document.querySelector('button[aria-label="收起右侧边栏"]');
+						if (up) up.click();
+						document.body.classList.remove("dsh-mobile-rightbar");
+					} catch (e) { /* 静默 */ }
+					syncRightbarBtn();
+				}
+				/* 只清插件自己的浮层状态，**绝不触碰上游按钮** —— 用于「非移动端」与「离开移动端」。
+				   ⚠️ 2026-09-28 事故：非移动端分支原先误调 closeRightbar()，而它会在 PC 上点上游
+				   「收起右侧边栏」⇒ 每次 sync（MutationObserver 触发）都把用户本来开着的右侧栏收起，
+				   表现为「PC 端不停打开/关闭右侧栏」。 */
+				function resetRightbarOverlay() {
+					try { document.body.classList.remove("dsh-mobile-rightbar"); } catch (e) { /* 静默 */ }
+				}
+				function toggleRightbar() { if (rightbarOpen()) closeRightbar(); else openRightbar(); }
 				function sync() {
 					try {
 						if (mq.matches) {
@@ -714,13 +816,14 @@ window.__ModuleLoader__.load({
 							   top:42 全宽后，右上角的汉堡按钮正好压在菜单首行右侧 —— vision 复核截图时发现
 							   「第一行的耗时被按钮遮住」，故菜单开着时也隐藏它） */
 							var popOpen = !!(document.querySelector(
-								"[class*=QsffPG_menu],[role=menu][class*=_list_1nxmc_]"));
+								"[class*=QsffPG_menu],[class*=headerUtilities] [role=menu]"));
 							if (tabbar) {
 								tabbar.style.display = (drawerOpen || settingsOpen || qaOpen || popOpen)
 									? "none" : "";
 							}
 							/* tabs 行工具按钮（更多操作代理 + 折叠输入区）—— React 重渲染后重建 */
 							ensureTabTools();
+							syncRightbarBtn();
 						} else {
 							document.body.classList.remove("dsh-mobile-ui");
 							qaOpen = false;
@@ -732,6 +835,7 @@ window.__ModuleLoader__.load({
 							var side2 = getSidebar();
 							if (side2) side2.style.display = "";
 							closeDrawer();
+							resetRightbarOverlay();   /* PC 端只清插件状态，绝不碰上游右侧栏 */
 							if (tabbar) tabbar.style.display = "none";
 						}
 					} catch (e) { /* 同步失败静默 */ }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mobile-ui",
-  "version": "0.2.6",
+  "version": "0.2.9",
   "description": "Mobile UI for the DeepSeek Harness Web GUI: responsive layout, overlay session drawer, 44px touch targets, safe-area support, reading enhancements (≤768px, zero desktop impact)",
   "type": "module",
   "main": "index.js",

package/tests/dump-header.py

@@ -0,0 +1,120 @@
+#!/usr/bin/env python3
+"""打开一个真实会话，dump 会话头部（header）里所有按钮的几何/可见性，定位 ⋯ 与 ☰ 的问题。
+
+用法: python3 dump-header.py <base-url> <token-file> [--title 片段] [--width 390]
+"""
+import sys
+
+from playwright.sync_api import sync_playwright
+
+BASE = sys.argv[1]
+TOKF = sys.argv[2]
+TITLE = sys.argv[sys.argv.index("--title") + 1] if "--title" in sys.argv else None
+WIDTH = int(sys.argv[sys.argv.index("--width") + 1]) if "--width" in sys.argv else 390
+TAG = sys.argv[sys.argv.index("--tag") + 1] if "--tag" in sys.argv else "dump"
+TOKEN = open(TOKF, encoding="utf-8").read().strip()
+
+DUMP_JS = """
+() => {
+  const out = [];
+  const seen = new Set();
+  document.querySelectorAll("button, [role=button], a[class*=btn]").forEach((el) => {
+    const r = el.getBoundingClientRect();
+    if (r.width === 0 && r.height === 0) return;
+    if (r.top < -5 || r.top > 260) return;          // 只看贴顶的头部区域（排除滚出屏的内容）
+    if (r.left < -5 || r.left > window.innerWidth + 5) return;
+    const cs = getComputedStyle(el);
+    let op = 1, vis = "visible", pe = "auto", node = el;
+    while (node && node !== document.documentElement) {
+      const s = getComputedStyle(node);
+      op *= parseFloat(s.opacity || "1");
+      if (s.visibility === "hidden") vis = "hidden";
+      if (s.pointerEvents === "none") pe = "none";
+      node = node.parentElement;
+    }
+    const key = (el.id || "") + "|" + (el.className || "").toString().slice(0, 40) + "|" + Math.round(r.left) + "," + Math.round(r.top);
+    if (seen.has(key)) return;
+    seen.add(key);
+    out.push({
+      id: el.id || null,
+      cls: (el.className || "").toString().slice(0, 70),
+      label: el.getAttribute("aria-label") || (el.innerText || "").trim().slice(0, 14) || null,
+      rect: [Math.round(r.left), Math.round(r.top), Math.round(r.width), Math.round(r.height)],
+      op: +op.toFixed(2), vis, pe,
+      clipped: el.scrollWidth > el.clientWidth + 1 || el.scrollHeight > el.clientHeight + 1,
+      scrollW: el.scrollWidth, clientW: el.clientWidth,
+    });
+  });
+  const tabs = document.querySelector('[class*=tabs]');
+  const header = document.querySelector('[class*=titleRow]') || document.querySelector('[class*=wSkVaW_header]');
+  return {
+    buttons: out,
+    tabsFound: !!tabs,
+    tabsCls: tabs ? tabs.className.toString().slice(0, 90) : null,
+    headerFound: !!header,
+    headerCls: header ? header.className.toString().slice(0, 90) : null,
+    headerRect: header ? (() => { const r = header.getBoundingClientRect(); return [Math.round(r.left), Math.round(r.top), Math.round(r.width), Math.round(r.height)]; })() : null,
+    toolGroup: !!document.querySelector("#dsh-mobile-tab-tools"),
+  };
+}
+"""
+
+with sync_playwright() as p:
+    b = p.chromium.launch()
+    ctx = b.new_context(viewport={"width": WIDTH, "height": 900}, is_mobile=True, has_touch=True, device_scale_factor=2)
+    page = ctx.new_page()
+    page.goto(f"{BASE}/?token={TOKEN}", wait_until="domcontentloaded", timeout=60000)
+    page.wait_for_timeout(6000)
+    print(f"base={BASE} width={WIDTH}")
+
+    # 打开抽屉 → 选一个真实会话（跳过空的新会话）
+    page.click("#dsh-mobile-menu-btn", timeout=8000)
+    page.wait_for_timeout(1500)
+    rows = page.query_selector_all("[role=treeitem][class*=sessionRow]") or page.query_selector_all("[role=treeitem]")
+    picked, title = None, None
+    for row in rows[:12]:
+        txt = (row.inner_text() or "").strip().replace("\n", " ")
+        if TITLE:
+            if TITLE in txt:
+                picked, title = row, txt[:34]
+                break
+        elif "新会话" not in txt and txt:
+            picked, title = row, txt[:34]
+            break
+    if picked is None:
+        print("找不到目标会话"); sys.exit(2)
+    picked.click()
+    page.wait_for_timeout(1500)
+    scrim = page.query_selector("[class*=scrim]")
+    if scrim:
+        try:
+            scrim.click(timeout=3000)
+        except Exception:
+            page.keyboard.press("Escape")
+    # 等会话内容 + 插件 sync（文档：历史可能很大，改用轮询）
+    for i in range(30):
+        page.wait_for_timeout(1000)
+        if page.evaluate("() => !!document.querySelector('#dsh-mobile-tab-tools') || !!document.querySelector('[class*=tabs]')"):
+            break
+    page.wait_for_timeout(2500)
+    print(f"会话：{title}\n")
+    d = page.evaluate(DUMP_JS)
+    print(f"tabs 行: {d['tabsFound']}  cls={d['tabsCls']}")
+    print(f"header : {d['headerFound']}  cls={d['headerCls']}  rect={d['headerRect']}")
+    print(f"插件工具组 #dsh-mobile-tab-tools: {d['toolGroup']}")
+    print("\n--- 头部区域按钮 ---")
+    for x in d["buttons"]:
+        flags = []
+        if x["op"] < 0.9:
+            flags.append(f"op={x['op']}")
+        if x["vis"] != "visible":
+            flags.append("visibility:hidden")
+        if x["pe"] == "none":
+            flags.append("pointer-events:none")
+        if x["clipped"]:
+            flags.append(f"内容溢出 scrollW={x['scrollW']}>clientW={x['clientW']}")
+        print(f"  id={x['id']} cls={x['cls'][:46]} label={x['label']} rect={x['rect']} " + ("; ".join(flags) if flags else ""))
+    page.screenshot(path=f"/tmp/mob-{TAG}-{WIDTH}.png")
+    print(f"\n截图: /tmp/mob-{TAG}-{WIDTH}.png")
+    ctx.close()
+    b.close()

package/tests/dump-menu.py

@@ -0,0 +1,96 @@
+#!/usr/bin/env python3
+"""点开 ⋯ 后 dump 菜单的真实结构/类名/定位，用于对比插件选择器为何失配。"""
+import sys
+
+from playwright.sync_api import sync_playwright
+
+BASE, TOKF = sys.argv[1], sys.argv[2]
+TITLE = sys.argv[sys.argv.index("--title") + 1] if "--title" in sys.argv else None
+TOKEN = open(TOKF, encoding="utf-8").read().strip()
+
+DUMP = """
+() => {
+  const menus = [...document.querySelectorAll('[role=menu], [role=listbox]')].filter((m) => {
+    const r = m.getBoundingClientRect();
+    return r.width > 40 && r.height > 20;
+  });
+  if (!menus.length) return { none: true };
+  const m = menus[menus.length - 1];
+  const r = m.getBoundingClientRect();
+  const cs = getComputedStyle(m);
+  const chain = [];
+  let node = m.parentElement;
+  while (node && node !== document.body && chain.length < 6) {
+    const c = getComputedStyle(node);
+    const rr = node.getBoundingClientRect();
+    chain.push({
+      tag: node.tagName, cls: (node.className || "").toString().slice(0, 80),
+      pos: c.position, left: c.left, right: c.right, width: c.width,
+      transform: c.transform === "none" ? null : c.transform,
+      rect: [rr.left, rr.top, rr.width, rr.height].map(Math.round),
+    });
+    node = node.parentElement;
+  }
+  return {
+    cls: (m.className || "").toString(),
+    role: m.getAttribute("role"),
+    rect: [r.left, r.top, r.width, r.height].map(Math.round),
+    computed: { position: cs.position, left: cs.left, right: cs.right, top: cs.top,
+                width: cs.width, minWidth: cs.minWidth, maxWidth: cs.maxWidth,
+                transform: cs.transform, inset: cs.inset },
+    inlineStyle: m.getAttribute("style"),
+    firstItemCls: m.querySelector("[role=menuitem], button, a")?.className?.toString()?.slice(0, 60) || null,
+    htmlHead: m.outerHTML.slice(0, 260),
+    chain,
+  };
+}
+"""
+
+with sync_playwright() as p:
+    b = p.chromium.launch()
+    ctx = b.new_context(**p.devices.get("Pixel 7", p.devices["Pixel 5"]))
+    page = ctx.new_page()
+    page.goto(f"{BASE}/?token={TOKEN}", wait_until="domcontentloaded", timeout=60000)
+    page.wait_for_timeout(6000)
+    page.touchscreen.tap(*page.evaluate("() => { const r = document.querySelector('#dsh-mobile-menu-btn').getBoundingClientRect(); return [r.left+r.width/2, r.top+r.height/2]; }"))
+    page.wait_for_timeout(1500)
+    rows = page.query_selector_all("[role=treeitem][class*=sessionRow]") or page.query_selector_all("[role=treeitem]")
+    picked = t = None
+    for row in rows[:12]:
+        s = (row.inner_text() or "").strip().replace("\n", " ")
+        if TITLE and TITLE in s:
+            picked, t = row, s[:26]; break
+        if not TITLE and s and "新会话" not in s:
+            picked, t = row, s[:26]; break
+    picked.click()
+    page.wait_for_timeout(1500)
+    vw = page.viewport_size["width"]
+    for _ in range(6):
+        st = page.evaluate("() => ({s: !!document.querySelector('.dsh-mobile-scrim'), d: !!document.querySelector('.dsh-mobile-drawer')})")
+        if not st["s"] and not st["d"]:
+            break
+        page.touchscreen.tap(vw - 30, 500)
+        page.wait_for_timeout(800)
+    for _ in range(20):
+        page.wait_for_timeout(800)
+        if page.evaluate("() => !!document.querySelector('#dsh-mobile-more-proxy')"):
+            break
+    print(f"base={BASE}  会话={t}  视口宽={vw}\n")
+
+    c = page.evaluate("""() => { const el = document.querySelector('#dsh-mobile-more-proxy');
+        const r = el.getBoundingClientRect(); return [r.left+r.width/2, r.top+r.height/2]; }""")
+    page.touchscreen.tap(*c)
+    page.wait_for_timeout(1600)
+    d = page.evaluate(DUMP)
+    if d.get("none"):
+        print("没有菜单"); sys.exit(2)
+    print(f"菜单 cls = {d['cls']}")
+    print(f"菜单 role= {d['role']}  rect={d['rect']}")
+    print(f"computed = {d['computed']}")
+    print(f"inline   = {d['inlineStyle']}")
+    print(f"首条目 cls= {d['firstItemCls']}")
+    print(f"htmlHead = {d['htmlHead']}")
+    print("\n祖先链（自内向外）:")
+    for x in d["chain"]:
+        print(f"  {x['tag']:6s} cls={x['cls'][:56]:56s} pos={x['pos']:9s} L={x['left']:>8s} R={x['right']:>8s} w={x['width']:>8s} tf={x['transform']} rect={x['rect']}")
+    ctx.close(); b.close()

package/tests/dump-rightbar.py

@@ -0,0 +1,95 @@
+#!/usr/bin/env python3
+"""诊断右侧边栏（工作区文件面板）：frame grid / detailsCol / 相关按钮。
+
+用法: python3 dump-rightbar.py <base-url> <token-file> [--title 片段]
+"""
+import sys
+
+from playwright.sync_api import sync_playwright
+
+BASE, TOKF = sys.argv[1], sys.argv[2]
+TITLE = sys.argv[sys.argv.index("--title") + 1] if "--title" in sys.argv else None
+TOKEN = open(TOKF, encoding="utf-8").read().strip()
+
+JS = """
+() => {
+  const rect = (el) => { const r = el.getBoundingClientRect(); return [Math.round(r.left), Math.round(r.top), Math.round(r.width), Math.round(r.height)]; };
+  const out = { grid: null, cols: [], buttons: [] };
+
+  // 主布局 frame（display:grid 且子元素 ≥3）
+  const frames = [...document.querySelectorAll("div")].filter((e) => {
+    const cs = getComputedStyle(e);
+    return cs.display === "grid" && e.children.length >= 3;
+  });
+  if (frames.length) {
+    const f = frames[0], cs = getComputedStyle(f);
+    out.grid = { cls: (f.className || "").toString().slice(0, 70), cols: cs.gridTemplateColumns,
+                 rect: rect(f), inlineCols: f.style.gridTemplateColumns || null, vw: window.innerWidth };
+    for (const ch of f.children) {
+      const cs = getComputedStyle(ch);
+      out.cols.push({ cls: (ch.className || "").toString().slice(0, 70), display: cs.display,
+                      pos: cs.position, vis: cs.visibility, rect: rect(ch),
+                      overflow: cs.overflow, text: (ch.innerText || "").trim().slice(0, 40) });
+    }
+  }
+
+  // 含关键词的按钮（不论可见性）
+  document.querySelectorAll("button, [role=button]").forEach((el) => {
+    const label = ((el.getAttribute("aria-label") || "") + " " + (el.title || "") + " " + (el.innerText || "").slice(0, 14)).trim();
+    if (/侧边栏|右侧|文件|预览|面板|详情|工作区|sidebar|panel|detail|file/i.test(label)) {
+      const cs = getComputedStyle(el);
+      out.buttons.push({ label: label.slice(0, 44), cls: (el.className || "").toString().slice(0, 54),
+                         display: cs.display, vis: cs.visibility, rect: rect(el) });
+    }
+  });
+  return out;
+}
+"""
+
+with sync_playwright() as p:
+    b = p.chromium.launch()
+    ctx = b.new_context(**p.devices.get("Pixel 7", p.devices["Pixel 5"]))
+    page = ctx.new_page()
+    page.goto(f"{BASE}/?token={TOKEN}", wait_until="domcontentloaded", timeout=60000)
+    page.wait_for_timeout(6000)
+    page.touchscreen.tap(*page.evaluate("() => { const r = document.querySelector('#dsh-mobile-menu-btn').getBoundingClientRect(); return [r.left+r.width/2, r.top+r.height/2]; }"))
+    page.wait_for_timeout(1500)
+    rows = page.query_selector_all("[role=treeitem][class*=sessionRow]") or page.query_selector_all("[role=treeitem]")
+    picked = t = None
+    for row in rows[:12]:
+        s = (row.inner_text() or "").strip().replace("\n", " ")
+        if TITLE and TITLE in s:
+            picked, t = row, s[:26]; break
+        if not TITLE and s and "新会话" not in s:
+            picked, t = row, s[:26]; break
+    picked.click()
+    page.wait_for_timeout(1500)
+    vw = page.viewport_size["width"]
+    for _ in range(6):
+        st = page.evaluate("() => ({s: !!document.querySelector('.dsh-mobile-scrim'), d: !!document.querySelector('.dsh-mobile-drawer')})")
+        if not st["s"] and not st["d"]:
+            break
+        page.touchscreen.tap(vw - 30, 500)
+        page.wait_for_timeout(800)
+    for _ in range(20):
+        page.wait_for_timeout(800)
+        if page.evaluate("() => !!document.querySelector('#dsh-mobile-tab-tools')"):
+            break
+    print(f"base={BASE} 会话={t} 视口={page.viewport_size}\n")
+    d = page.evaluate(JS)
+
+    if d["grid"]:
+        g = d["grid"]
+        print(f"frame grid: cls={g['cls']}")
+        print(f"  cols(computed) = {g['cols']}")
+        print(f"  cols(inline)   = {g['inlineCols']}   ← 插件若改单列会写在这里")
+        print(f"  rect={g['rect']}\n  ── 三列 ──")
+        for c in d["cols"]:
+            print(f"    cls={c['cls'][:52]:52s} display={c['display']:12s} pos={c['pos']:9s} vis={c['vis']:8s} rect={c['rect']} text={c['text']!r}")
+    else:
+        print("（没找到 display:grid 且 ≥3 子元素的 frame）")
+
+    print(f"\n── 含侧栏/文件关键词的按钮（{len(d['buttons'])} 个）──")
+    for x in d["buttons"]:
+        print(f"  label={x['label']!r:46s} display={x['display']:10s} vis={x['vis']:8s} rect={x['rect']} cls={x['cls'][:40]}")
+    ctx.close(); b.close()