dsh-mobile-ui 0.2.8 → 0.2.9

package/tests/probe-actions.py

@@ -0,0 +1,176 @@
+#!/usr/bin/env python3
+"""真机化交互验证：用真实设备描述符 + 触摸点击，验三个工具按钮的**行为**（不只是存在）。
+
+判据（对照 docs/dsh-mobile-ui.md §3.3 / §6）：
+  ⋯ → 必须弹出 [role=menu]，菜单在视口内、有条目、且**不被祖先透明/遮罩吃掉**
+  ▤ → 输入区高度必须明显变化（折叠/展开）
+  ☰ → 抽屉必须打开（.dsh-mobile-drawer 可见）
+用法: python3 probe-actions.py <base-url> <token-file> [--device "Pixel 7"] [--title 片段]
+"""
+import sys
+
+from playwright.sync_api import sync_playwright
+
+BASE = sys.argv[1]
+TOKF = sys.argv[2]
+DEVICE = sys.argv[sys.argv.index("--device") + 1] if "--device" in sys.argv else "Pixel 7"
+TITLE = sys.argv[sys.argv.index("--title") + 1] if "--title" in sys.argv else None
+TAG = sys.argv[sys.argv.index("--tag") + 1] if "--tag" in sys.argv else "act"
+TOKEN = open(TOKF, encoding="utf-8").read().strip()
+
+DRAWER = """
+() => {
+  const vis = (el) => {
+    if (!el) return false;
+    const cs = getComputedStyle(el), r = el.getBoundingClientRect();
+    return cs.visibility !== "hidden" && parseFloat(cs.opacity || "1") > 0.5 && r.width > 1 && r.height > 1;
+  };
+  return { scrim: vis(document.querySelector(".dsh-mobile-scrim")),
+           drawer: vis(document.querySelector(".dsh-mobile-drawer")) };
+}
+"""
+
+MENU = """
+() => {
+  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 { count: 0 };
+  const m = menus[menus.length - 1];
+  const r = m.getBoundingClientRect();
+  // visibility 是继承属性：getComputedStyle(自身) 已含继承结果，只判它即可
+  //（逐级判祖先会把「祖先 hidden 但自己 visible」误报成不可见，2026-09-28 踩过）。
+  // opacity 是「组不透明度」、pointer-events 也是继承 ⇒ 这两项必须逐级。
+  const vis = getComputedStyle(m).visibility;
+  let op = 1, pe = "auto", node = m.parentElement;
+  while (node && node !== document.documentElement) {
+    const s = getComputedStyle(node);
+    op *= parseFloat(s.opacity || "1");
+    if (s.pointerEvents === "none") pe = "none";
+    node = node.parentElement;
+  }
+  const cx = Math.min(Math.max(r.left + r.width / 2, 1), window.innerWidth - 1);
+  const cy = Math.min(Math.max(r.top + r.height / 2, 1), window.innerHeight - 1);
+  const hit = document.elementFromPoint(cx, cy);
+  const items = m.querySelectorAll('[role=menuitem], button, a').length;
+  return {
+    count: menus.length,
+    rect: [r.left, r.top, r.width, r.height].map(Math.round),
+    inViewport: r.left >= -1 && r.right <= window.innerWidth + 1 && r.top >= -1 && r.bottom <= window.innerHeight + 1,
+    effOpacity: +op.toFixed(2), visibility: vis, pointerEvents: pe,
+    hitInside: !!(hit && m.contains(hit)),
+    items,
+    text: (m.innerText || "").replace(/\\n/g, " | ").slice(0, 90),
+  };
+}
+"""
+
+COMPOSER = """
+() => {
+  const c = document.querySelector('[class*=composerSeat]') || document.querySelector('[class*=composer]');
+  if (!c) return null;
+  const r = c.getBoundingClientRect();
+  return [Math.round(r.left), Math.round(r.top), Math.round(r.width), Math.round(r.height)];
+}
+"""
+
+
+def tap(page, sel):
+    box = page.evaluate("""(sel) => { const el = document.querySelector(sel); if (!el) return null;
+        const r = el.getBoundingClientRect(); return [r.left + r.width/2, r.top + r.height/2]; }""", sel)
+    if box is None:
+        return False
+    page.touchscreen.tap(box[0], box[1])
+    return True
+
+
+fails = []
+with sync_playwright() as p:
+    b = p.chromium.launch()
+    dev = p.devices.get(DEVICE) or p.devices["Pixel 5"]
+    ctx = b.new_context(**dev)
+    page = ctx.new_page()
+    page.goto(f"{BASE}/?token={TOKEN}", wait_until="domcontentloaded", timeout=60000)
+    page.wait_for_timeout(6000)
+    print(f"base={BASE}  device={DEVICE} viewport={page.viewport_size}")
+
+    tap(page, "#dsh-mobile-menu-btn")
+    page.wait_for_timeout(1500)
+    rows = page.query_selector_all("[role=treeitem][class*=sessionRow]") or page.query_selector_all("[role=treeitem]")
+    picked = title = None
+    for row in rows[:12]:
+        t = (row.inner_text() or "").strip().replace("\n", " ")
+        if TITLE and TITLE in t:
+            picked, title = row, t[:28]
+            break
+        if not TITLE and t and "新会话" not in t:
+            picked, title = row, t[:28]
+            break
+    if picked is None:
+        print("找不到会话"); sys.exit(2)
+    picked.click()
+    page.wait_for_timeout(1500)
+    for _ in range(6):
+        if page.evaluate(DRAWER)["drawer"] is False and page.evaluate(DRAWER)["scrim"] is False:
+            break
+        page.touchscreen.tap(page.viewport_size["width"] - 30, 500)
+        page.wait_for_timeout(900)
+    print(f"会话：{title}\n")
+
+    # ── ⋯ 更多操作 ──
+    print("── ⋯ (dsh-mobile-more-proxy) ──")
+    tap(page, "#dsh-mobile-more-proxy")
+    page.wait_for_timeout(1500)
+    m = page.evaluate(MENU)
+    if not m.get("count"):
+        print("  ✗ 点击后没有出现 [role=menu]")
+        fails.append("⋯ 点击无菜单")
+    else:
+        print(f"  菜单 rect={m['rect']} items={m['items']} inViewport={m['inViewport']} "
+              f"op={m['effOpacity']} vis={m['visibility']} pe={m['pointerEvents']} hitInside={m['hitInside']}")
+        print(f"  文本: {m['text']}")
+        if not m["inViewport"]:
+            fails.append(f"⋯ 菜单出视口 {m['rect']}")
+        if m["effOpacity"] < 0.9 or m["visibility"] != "visible" or m["pointerEvents"] == "none":
+            fails.append(f"⋯ 菜单不可见（op={m['effOpacity']} vis={m['visibility']} pe={m['pointerEvents']}）")
+        if not m["hitInside"]:
+            fails.append("⋯ 菜单中心点不到（被盖）")
+        if m["items"] == 0:
+            fails.append("⋯ 菜单没有条目")
+    page.screenshot(path=f"/tmp/{TAG}-menu.png")
+    page.keyboard.press("Escape")
+    page.wait_for_timeout(800)
+
+    # ── ▤ 折叠输入区 ──
+    print("\n── ▤ (dsh-mobile-fold-composer) ──")
+    c0 = page.evaluate(COMPOSER)
+    tap(page, "#dsh-mobile-fold-composer")
+    page.wait_for_timeout(1200)
+    c1 = page.evaluate(COMPOSER)
+    print(f"  输入区高度 {c0[3] if c0 else None} → {c1[3] if c1 else None}")
+    if c0 and c1 and abs(c0[3] - c1[3]) < 20:
+        fails.append(f"▤ 点击后输入区高度没变化（{c0[3]} → {c1[3]}）")
+    page.screenshot(path=f"/tmp/{TAG}-fold.png")
+    tap(page, "#dsh-mobile-fold-composer")   # 复原
+    page.wait_for_timeout(1000)
+
+    # ── ☰ 打开抽屉 ──
+    print("\n── ☰ (dsh-mobile-tab-menu) ──")
+    before = page.evaluate(DRAWER)
+    tap(page, "#dsh-mobile-tab-menu")
+    page.wait_for_timeout(1500)
+    after = page.evaluate(DRAWER)
+    print(f"  点击前 {before}  →  点击后 {after}")
+    if not after["drawer"]:
+        fails.append(f"☰ 点击后抽屉没打开（{after}）")
+    page.screenshot(path=f"/tmp/{TAG}-drawer.png")
+
+    print()
+    if fails:
+        print(f"❌ {len(fails)} 项异常：")
+        for f in fails:
+            print("   - " + f)
+        sys.exit(1)
+    print("✅ 三个按钮行为均正常")
+    ctx.close(); b.close()

package/tests/probe-pc-rightbar.py

@@ -0,0 +1,105 @@
+#!/usr/bin/env python3
+"""PC（桌面视口）验证：mobile-ui 插件**绝不能**触碰右侧栏。
+
+背景（2026-09-28 事故）：非移动端分支误调 closeRightbar() ⇒ 它点上游「收起右侧边栏」，
+每次 sync（MutationObserver）都把用户的右侧栏收起 ⇒ 用户看到「不停打开/关闭右侧栏」。
+
+判据：连续采样 N 秒，右侧栏的宽度 / grid 列 / 开关按钮 state 必须**保持不变**，
+且 body 不得出现 dsh-mobile-rightbar（插件的移动端浮层 class）。
+
+用法: python3 probe-pc-rightbar.py <base-url> <token-file> [--title 片段] [--seconds 8]
+"""
+import sys
+import time
+
+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
+SECONDS = int(sys.argv[sys.argv.index("--seconds") + 1]) if "--seconds" in sys.argv else 8
+TOKEN = open(TOKF, encoding="utf-8").read().strip()
+
+STATE = """
+() => {
+  const frame = [...document.querySelectorAll("div")].find((e) => {
+    const cs = getComputedStyle(e);
+    return cs.display === "grid" && e.children.length >= 3;
+  });
+  const rb = document.querySelector("[class*=rightbarCol]");
+  const r = rb ? rb.getBoundingClientRect() : null;
+  return {
+    vw: window.innerWidth,
+    grid: frame ? getComputedStyle(frame).gridTemplateColumns : null,
+    gridInline: frame ? (frame.style.gridTemplateColumns || "(none)") : null,
+    rb: r ? [Math.round(r.left), Math.round(r.top), Math.round(r.width), Math.round(r.height)] : null,
+    openBtn: !!document.querySelector('button[aria-label="打开右侧边栏"]'),
+    closeBtn: !!document.querySelector('button[aria-label="收起右侧边栏"]'),
+    mobileCls: document.body.classList.contains("dsh-mobile-ui"),
+    overlayCls: document.body.classList.contains("dsh-mobile-rightbar"),
+  };
+}
+"""
+
+fails = []
+with sync_playwright() as p:
+    b = p.chromium.launch()
+    # 桌面视口：1376x900（不 is_mobile，不 has_touch —— 与真 PC 一致）
+    ctx = b.new_context(viewport={"width": 1376, "height": 900})
+    page = ctx.new_page()
+    page.goto(f"{BASE}/?token={TOKEN}", wait_until="domcontentloaded", timeout=60000)
+    page.wait_for_timeout(6000)
+
+    # PC 端：左侧栏直接可见，点第一个会话
+    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
+    if picked is None:
+        print("找不到会话"); sys.exit(2)
+    picked.click()
+    page.wait_for_timeout(3000)
+    print(f"base={BASE} 会话={t}")
+
+    d0 = page.evaluate(STATE)
+    print(f"视口宽={d0['vw']}（桌面档）  mobile class={d0['mobileCls']}")
+    # 确保右侧栏处于「打开」状态（PC 上它就是上游原生三列之一）
+    if d0["openBtn"]:
+        page.evaluate("() => document.querySelector('button[aria-label=\"打开右侧边栏\"]').click()")
+        page.wait_for_timeout(1500)
+        d0 = page.evaluate(STATE)
+        print("（先手动打开右侧栏，模拟用户在用的状态）")
+
+    print(f"\n初始: grid={d0['grid']} inline={d0['gridInline']} rb={d0['rb']} "
+          f"开按钮={d0['openBtn']} 收按钮={d0['closeBtn']}")
+    base_rb, base_grid, base_inline = d0["rb"], d0["grid"], d0["gridInline"]
+
+    print(f"\n连续采样 {SECONDS} 秒（每次 1s）:")
+    samples = []
+    for i in range(SECONDS):
+        time.sleep(1)
+        d = page.evaluate(STATE)
+        samples.append(d)
+        print(f"  t={i+1}s  rb={d['rb']}  grid={d['grid']}  inline={d['gridInline']}  "
+              f"overlayCls={d['overlayCls']}  开={d['openBtn']} 收={d['closeBtn']}")
+
+    changed = [s for s in samples if s["rb"] != base_rb or s["grid"] != base_grid or s["gridInline"] != base_inline]
+    if changed:
+        fails.append(f"右侧栏状态在 {len(changed)}/{SECONDS} 次采样中发生了变化（应为恒定）")
+    if any(s["overlayCls"] for s in samples):
+        fails.append("PC 端出现了 dsh-mobile-rightbar 浮层 class")
+    if any(s["mobileCls"] for s in samples):
+        fails.append("PC 端出现了 dsh-mobile-ui class")
+
+    print()
+    if fails:
+        print(f"❌ {len(fails)} 项异常：")
+        for f in fails:
+            print("   - " + f)
+        sys.exit(1)
+    print(f"✅ PC 端右侧栏在 {SECONDS} 秒内保持不变（插件未触碰上游右侧栏）")
+    page.screenshot(path="/tmp/pc-rightbar.png")
+    ctx.close(); b.close()

package/tests/probe-rightbar.py

@@ -0,0 +1,164 @@
+#!/usr/bin/env python3
+"""验证右侧边栏（工作区文件）入口按钮：点开 → 面板全屏可见可点 → 关闭。
+
+用法: python3 probe-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
+TAG = sys.argv[sys.argv.index("--tag") + 1] if "--tag" in sys.argv else "rb"
+TOKEN = open(TOKF, encoding="utf-8").read().strip()
+
+STATE = """
+() => {
+  const rb = document.querySelector("[class*=rightbarCol]");
+  const r = rb ? rb.getBoundingClientRect() : null;
+  let op = 1, pe = "auto", node = rb ? rb.parentElement : null;
+  while (node && node !== document.documentElement) {
+    const s = getComputedStyle(node);
+    op *= parseFloat(s.opacity || "1");
+    if (s.pointerEvents === "none") pe = "none";
+    node = node.parentElement;
+  }
+  const hit = r ? document.elementFromPoint(Math.min(Math.max(r.left + r.width/2, 1), innerWidth-1),
+                                            Math.min(Math.max(r.top + r.height/2, 1), innerHeight-1)) : null;
+  return {
+    cls: document.body.className.includes("dsh-mobile-rightbar"),
+    rect: r ? [r.left, r.top, r.width, r.height].map(Math.round) : null,
+    pos: rb ? getComputedStyle(rb).position : null,
+    vis: rb ? getComputedStyle(rb).visibility : null,
+    effOpacity: +op.toFixed(2), pointerEvents: pe,
+    inViewport: !!(r && r.left >= -1 && r.top >= -1 && r.right <= innerWidth+1 && r.bottom <= innerHeight+1),
+    /* ⚠️ 收起态的 rightbarCol 是 [0, innerHeight, w, 0]：top/bottom 都等于视口高，
+       单看 inViewport 会误判成「可见」（2026-09-28 踩过）⇒ 必须叠加尺寸判据。 */
+    visible: !!(r && r.width > 100 && r.height > 100 && r.top < innerHeight),
+    text: rb ? (rb.innerText || "").trim().replace(/\\n+/g, " | ").slice(0, 120) : null,
+    hitInside: !!(hit && rb && rb.contains(hit)),
+    clickables: rb ? rb.querySelectorAll("button, [role=button], [role=treeitem]").length : 0,
+    btnOn: !!document.querySelector("#dsh-mobile-rightbar-toggle.dsh-mobile-on"),
+  };
+}
+"""
+
+
+def tap(page, sel):
+    box = page.evaluate("""(sel) => { const el = document.querySelector(sel); if (!el) return null;
+        const r = el.getBoundingClientRect();
+        return (r.width > 0 && r.height > 0) ? [r.left + r.width/2, r.top + r.height/2] : null; }""", sel)
+    if box is None:
+        return False
+    page.touchscreen.tap(box[0], box[1])
+    return True
+
+
+fails = []
+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)
+    tap(page, "#dsh-mobile-menu-btn")
+    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-rightbar-toggle')"):
+            break
+    print(f"base={BASE} 会话={t} 视口={page.viewport_size}\n")
+
+    d0 = page.evaluate(STATE)
+    print(f"初始: 按钮激活={d0['btnOn']} 面板 rect={d0['rect']}")
+
+    if not tap(page, "#dsh-mobile-rightbar-toggle"):
+        print("✗ 找不到 #dsh-mobile-rightbar-toggle 按钮"); sys.exit(2)
+    page.wait_for_timeout(2200)
+    d1 = page.evaluate(STATE)
+    print("\n点击「工作区文件」按钮后:")
+    for k in ("cls", "rect", "pos", "vis", "effOpacity", "pointerEvents", "inViewport", "visible", "hitInside", "clickables", "btnOn"):
+        print(f"  {k:12s} = {d1.get(k)}")
+    print(f"  text = {d1.get('text')!r}")
+    if not d1["visible"]:
+        fails.append(f"面板未全屏可见 rect={d1['rect']}")
+    if d1["vis"] != "visible" or d1["effOpacity"] < 0.9 or d1["pointerEvents"] == "none":
+        fails.append(f"面板不可见 vis={d1['vis']} op={d1['effOpacity']} pe={d1['pointerEvents']}")
+    if not d1["hitInside"]:
+        fails.append("面板中心点不到（被覆盖）")
+    if d1["clickables"] < 3:
+        fails.append(f"面板内可点元素过少（{d1['clickables']}）")
+    # ⚠️ 面板首屏内容随上游版本不同：0.1.7 是「开始/工作区文件/新建终端」菜单，
+    #    0.1.5 直接是文件树 ⇒ 只要求有实质内容，别锁死文案。
+    if len((d1["text"] or "").strip()) < 10:
+        fails.append(f"面板内容为空或过短：{d1['text']!r}")
+    page.screenshot(path=f"/tmp/{TAG}-open.png")
+
+    # 用上游自带按钮关闭
+    closed = page.evaluate("""() => {
+      const b = document.querySelector('button[aria-label="收起右侧边栏"]');
+      if (!b) return false;
+      b.click(); return true;
+    }""")
+    page.wait_for_timeout(1200)
+    d2 = page.evaluate(STATE)
+    print(f"\n点上游「收起右侧边栏」({closed}) 后: 按钮激活={d2['btnOn']} 面板 rect={d2['rect']} visible={d2['visible']}")
+    if d2["visible"]:
+        fails.append(f"关闭后面板仍全屏可见 rect={d2['rect']}")
+    if d2["btnOn"]:
+        fails.append("关闭后工具按钮仍处于激活态")
+
+    # 再打开一次；随后**用面板内上游自带的收起按钮**关闭
+    # （面板是全屏浮层、z-index 远高于工具组 ⇒ 打开期间工具按钮被盖住，关闭入口在面板右上角）
+    tap(page, "#dsh-mobile-rightbar-toggle")
+    page.wait_for_timeout(1800)
+    d3 = page.evaluate(STATE)
+    print(f"再次打开: visible={d3['visible']}")
+    if not d3["visible"]:
+        fails.append("工具按钮第二次打开失败")
+    covered = page.evaluate("""() => {
+      const b = document.querySelector('#dsh-mobile-rightbar-toggle');
+      if (!b) return null;
+      const r = b.getBoundingClientRect();
+      const hit = document.elementFromPoint(r.left + r.width/2, r.top + r.height/2);
+      return !(hit && (hit === b || b.contains(hit)));
+    }""")
+    print(f"打开期间工具组被面板覆盖: {covered}（预期 true —— 关闭走面板内按钮）")
+    closed2 = page.evaluate("""() => {
+      const b = document.querySelector('button[aria-label="收起右侧边栏"]');
+      if (!b) return false;
+      b.click(); return true;
+    }""")
+    page.wait_for_timeout(1300)
+    d4 = page.evaluate(STATE)
+    print(f"从面板内收起({closed2}): visible={d4['visible']} 按钮激活={d4['btnOn']}")
+    if d4["visible"]:
+        fails.append("面板内收起按钮没能关闭")
+    if d4["btnOn"]:
+        fails.append("关闭后工具按钮仍处激活态")
+
+    print()
+    if fails:
+        print(f"❌ {len(fails)} 项异常：")
+        for f in fails:
+            print("   - " + f)
+        sys.exit(1)
+    print("✅ 右侧边栏入口：可打开、全屏可见可点、能关闭")
+    ctx.close(); b.close()

package/tests/try-menu-fix.py

@@ -0,0 +1,125 @@
+#!/usr/bin/env python3
+"""验证「用语义锚点 [class*=headerUtilities] [role=menu] 替代 hash」能否把 ⋯ 菜单拉回视口。
+
+在浏览器里注入候选 CSS（不改插件文件），对比注入前后菜单 rect。
+"""
+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()
+
+CANDIDATE = """
+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:122px !important;
+  visibility:visible !important; pointer-events:auto !important;
+}
+"""
+
+MEASURE = """
+() => {
+  const menus = [...document.querySelectorAll('[role=menu]')].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);
+  // ⚠️ visibility 是继承属性：getComputedStyle(元素) 已含继承结果，
+  //    只看自身即可。逐级判祖先会把「祖先 hidden 但自己 visible」误报成不可见
+  //    （2026-09-28 实测踩过：候选 CSS 明明生效却被判失败）。
+  const visSelf = cs.visibility;
+  let op = 1, pe = "auto", hiddenAncestor = null, node = m.parentElement;
+  while (node && node !== document.documentElement) {
+    const s = getComputedStyle(node);
+    op *= parseFloat(s.opacity || "1");          // opacity 是组不透明度，必须逐级相乘
+    if (s.visibility === "hidden") hiddenAncestor = (node.className || node.tagName).toString().slice(0, 50);
+    if (s.pointerEvents === "none") pe = "none"; // pointer-events 继承
+    node = node.parentElement;
+  }
+  const cx = Math.min(Math.max(r.left + r.width/2, 1), window.innerWidth - 1);
+  const cy = Math.min(Math.max(r.top + r.height/2, 1), window.innerHeight - 1);
+  const hit = document.elementFromPoint(cx, cy);
+  return {
+    cls: (m.className || "").toString().slice(0, 70),
+    rect: [r.left, r.top, r.width, r.height].map(Math.round),
+    pos: cs.position, left: cs.left, right: cs.right,
+    inViewport: r.left >= -1 && r.right <= window.innerWidth + 1 && r.top >= -1 && r.bottom <= window.innerHeight + 1,
+    effOpacity: +op.toFixed(2), visibility: visSelf, hiddenAncestor, pointerEvents: pe,
+    hitInside: !!(hit && m.contains(hit)),
+    items: m.querySelectorAll('[role=menuitem], button, a').length,
+  };
+}
+"""
+
+
+def open_session(page, vw):
+    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)
+    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
+    return t
+
+
+def tap_more(page):
+    page.touchscreen.tap(*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.wait_for_timeout(1600)
+
+
+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()
+    vw = page.viewport_size["width"]
+    title = open_session(page, vw)
+    print(f"base={BASE} 会话={title} 视口宽={vw}\n")
+
+    tap_more(page)
+    before = page.evaluate(MEASURE)
+    print("【注入前】")
+    for k in ("cls", "rect", "pos", "left", "right", "inViewport", "effOpacity", "visibility", "hiddenAt", "pointerEvents", "hitInside", "items"):
+        print(f"  {k:12s} = {before.get(k)}")
+    page.keyboard.press("Escape")
+    page.wait_for_timeout(800)
+
+    page.add_style_tag(content=CANDIDATE)
+    page.wait_for_timeout(400)
+    tap_more(page)
+    after = page.evaluate(MEASURE)
+    print("\n【注入候选 CSS 后】")
+    for k in ("cls", "rect", "pos", "left", "right", "inViewport", "effOpacity", "visibility", "hiddenAt", "pointerEvents", "hitInside", "items"):
+        print(f"  {k:12s} = {after.get(k)}")
+
+    ok = (after.get("inViewport") and after.get("effOpacity", 0) >= 0.9
+          and after.get("visibility") == "visible" and after.get("pointerEvents") != "none"
+          and after.get("hitInside") and after.get("items"))
+    print("\n" + ("✅ 候选 CSS 有效：菜单回到视口内且可见可点" if ok else "❌ 候选 CSS 不足以修复"))
+    page.screenshot(path="/tmp/menu-after.png")
+    ctx.close(); b.close()
+    sys.exit(0 if ok else 1)