dsh-mobile-ui 0.2.2 → 0.2.3

package/client.js

@@ -211,8 +211,47 @@ window.__ModuleLoader__.load({
 			"  body.dsh-mobile-ui [class*=avatar]{width:28px !important;height:28px !important}",
 			/* AI 正文与工具行视觉分隔 */
 			"  body.dsh-mobile-ui [class*=markdown]{margin-top:6px}",
-			/* 头部标题允许换行（防截断） */
-			"  body.dsh-mobile-ui [class*=header] [class*=title],body.dsh-mobile-ui [class*=crumbs]{white-space:normal;overflow-wrap:anywhere}",
+			/* 头部标题允许换行（防截断）。
+			   ⚠️ 2026-09-14 修复（第 5 处词根选择器泄漏）：原规则同时给 [class*=crumbs] 设了
+			   white-space:normal + overflow-wrap:anywhere —— **两者都是继承属性**，而上游
+			   .wSkVaW_crumbs 自身是 nowrap（面包屑内所有元素都靠这条继承保持单行），
+			   于是 crumbs 内**没有自己 white-space 规则**的元素被连带改成逐字换行：
+			   子代理切换器 ZKlsPq_root 里的无类名文本 span（"N 个子代理"）实测
+			   从 80×28 变成 48×96 的一列竖排，header 被撑到 142px（用户截图实证）。
+			   crumbs 里的标题按钮 .wSkVaW_crumb 自身就是 nowrap + ellipsis，
+			   容器规则对它的"防截断"毫无作用（实测 ws 仍为 nowrap）
+			   ⇒ [class*=crumbs] 这半条只有副作用，删除；header 标题照旧。 */
+			"  body.dsh-mobile-ui [class*=header] [class*=title]{white-space:normal;overflow-wrap:anywhere}",
+			/* ── 会话头部「面包屑 + 子代理切换器」在窄屏被裁（2026-09-14 修复）──────
+			   上游把「面包屑(会话标题 + 子代理切换器) + 4 个操作按钮」全塞在 titleRow 一行：
+			   390px 实测 titleRow 342px，titleCluster 只分到 214px，其中 headerActions
+			   固定占 68px ⇒ crumbs 只剩 136px，而内容需要 标题(最多 220) + 切换器(94) ≈ 318px。
+			   两者按 flex 比例收缩后总宽仍 189px > 136px，超出部分被 crumbs 的
+			   overflow:hidden 裁掉 —— 手机上显示成「[方块] 8」，“个子代理”四个字全不见；
+			   更糟的是被裁区域上的点击落在 headerActions 的按钮上（实测 elementFromPoint
+			   命中的是“标准模式”），用户点切换器**打不开子代理列表**。
+			   修法三件事（缺一不可）：
+			     ① crumbs 内的切换器 flex:none —— 空间不足时让**标题**先收缩（标题自带
+			        ellipsis），而不是两者一起被裁掉尾部；
+			     ② titleCluster 独占整行（flex-basis:100%）+ titleRow 允许换行 —— 把 4 个
+			        操作按钮（终端/打开方式/更多/右侧边栏）挤到第二行，面包屑拿到整行宽；
+			     ③ 实测结果：390px 标题 152px + 切换器 94px 完整可点、菜单能打开；
+			        360/320/414px 同样成立（标题 122/82/176px，切换器恒为 94px 完整）；
+			        header 76 → 106px（+30px，换信息完整与可点，hero 页无 titleRow 不受影响）。
+			   ⚠️ 别改用 crumbs/titleCluster 的 min-width:max-content：实测会把宽度锁死成
+			   332px，320px 视口下切换器直接出屏（inView=false）。
+			   ⚠️ 两个 hash 前缀（wSkVaW_ / ZKlsPq_）会随 dsh 升级漂移，失效是静默的
+			   （退回“切换器被裁”），升级后跑 tests/mobile-layout-probe.py 的 subagent 段复核。 */
+			"  body.dsh-mobile-ui [class*=wSkVaW_crumbSeg] [class*=ZKlsPq_root]{flex:0 0 auto !important}",
+			"  body.dsh-mobile-ui [class*=wSkVaW_titleRow]{flex-wrap:wrap !important;row-gap:4px !important}",
+			"  body.dsh-mobile-ui [class*=wSkVaW_titleCluster]{flex:1 1 100% !important}",
+			/* 极窄屏（≤360px）面包屑只留当前段：子代理会话页的面包屑是
+			   「父会话 / 子代理名 / N 个子代理」，320px 实测当前段标题被挤到 36px
+			   （只剩两三个字符，探针会判 ❌），隐藏父级段与分隔符后回到 96px。
+			   手机上回父会话另有入口（子代理菜单），可读性优先级更高。 */
+			"  @media (max-width:360px){",
+			"    body.dsh-mobile-ui [class*=wSkVaW_crumbSeg] > [class*=wSkVaW_crumb]:not([class*=wSkVaW_crumbCurrent]),body.dsh-mobile-ui [class*=wSkVaW_crumbSeg] > [class*=wSkVaW_crumbSep]{display:none !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))}",
 			/* 消息流操作按钮（复制/反馈/分享）触摸目标提升。
@@ -316,6 +355,52 @@ window.__ModuleLoader__.load({
 				var qaOpen = false;         /* 提问卡片打开标志（卡片浮层打开时隐藏右上角菜单，防遮挡标题） */
 				var savedGrid = null;   /* 窄屏前的 frame 原始 grid（宽屏恢复用） */
 
+				/* ── 子代理切换器「点一下开、再点收回」补丁（2026-09-14）─────────────
+				   上游 dsh-client-ui-subagent 的切换器在**触摸设备上只能开、不能收**：
+				     · trigger 的 onClick 是条件绑定 ——
+				       onClick: openTitle === void 0 ? void 0 : () => {…}，
+				       会话头部这个纯切换器没有 openTitle ⇒ 按钮**本体没有任何点击逻辑**；
+				     · “打开”实际靠容器 rootRef 的 onMouseEnter → scheduleHoverOpen(150ms)，
+				       手机 tap 会合成**一次** mouseenter，所以第一下能开；
+				     · 再点同一处不再产生 mouseenter（指针从未离开），onClick 又是 undefined
+				       ⇒ 既关不掉也开不回来，用户只能点空白或按 Esc 才收得回去
+				       （用户报障：“点击箭头展开后再点击不能收回”）。
+				   上游自带两条键盘路径可复用（不改它的状态机，只喂官方事件）：
+				     · trigger onKeyDown 的 ArrowDown → changeOpen(true)（打开）
+				     · rootRef onKeyDown → navigate 的 Escape → changeOpen(false, true)（关闭+回焦）
+				   ⚠️ 只在移动端（mq.matches）补：桌面 hover 开合语义完整，不该被改写。
+				   ⚠️ 展开状态每次从 DOM 的 aria-expanded 现读（React 渲染的实时值），不缓存。
+				   ⚠️ 捕获阶段拦截并吞掉 click：否则会冒泡到 React root，触发上游（可能有 openTitle
+				      的变体）自己的 onClick 逻辑。 */
+				function onSwitcherToggle(event) {
+					try {
+						if (!mq.matches) return;
+						var target = event.target;
+						var btn = target && target.closest
+							? target.closest("button[class*=ZKlsPq_trigger]") : null;
+						if (!btn) return;
+						var key = btn.getAttribute("aria-expanded") === "true" ? "Escape" : "ArrowDown";
+						event.stopPropagation();
+						if (event.stopImmediatePropagation) event.stopImmediatePropagation();
+						event.preventDefault();
+						var ev;
+						try {
+							ev = new KeyboardEvent("keydown", { key: key, bubbles: true, cancelable: true });
+						} catch (e) {
+							/* 旧内核（微信 X5 等）无 KeyboardEvent 构造器：退回 initEvent + 手赋 key */
+							ev = document.createEvent("Event");
+							ev.initEvent("keydown", true, true);
+							ev.key = key;
+						}
+						btn.dispatchEvent(ev);
+					} catch (e) { /* 补丁失败静默降级（点击仍走上游原逻辑） */ }
+				}
+				/* 幂等绑定：本函数只依赖 DOM 与 matchMedia，无闭包状态，重挂载无需解绑 */
+				if (!document.__dshMobileSwitcherToggle) {
+					document.__dshMobileSwitcherToggle = true;
+					document.addEventListener("click", onSwitcherToggle, true);
+				}
+
 				/* 主布局 frame：display:grid 的顶层容器（CSS 生效前 3 列 / 生效后 1 列均可） */
 				function findFrame() {
 					var els = document.querySelectorAll("[class*=frame]");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mobile-ui",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "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",
@@ -10,7 +10,9 @@
     "./package.json": "./package.json"
   },
   "dsh": {
-    "bundle": { "patch": "./cordis.patch.yml" },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
     "client": {
       "inject": [],
       "platform": "web",

package/tests/live-probe.py

@@ -0,0 +1,191 @@
+#!/usr/bin/env python3
+"""dsh-mobile-ui 真实页面（live）交互探针：头部切换器几何 + 子代理菜单 toggle + 抽屉回归。
+
+和 `mobile-layout-probe.py`（静态复现页 + 真实上游 CSS）互补：那套测**几何**，
+这套测**交互**——2026-09-14 的两个问题都只在真实 dsh 页面上出现：
+
+  ① 头部子代理切换器被 crumbs 裁掉：宽度只露 27px（「[方块] 8」），
+     且中心点的点击落在右侧 headerActions 的“标准模式”上 ⇒ 打不开子代理列表；
+  ② 上游切换器在**触摸设备上只能开不能收**：trigger 的 onClick 是条件绑定
+     （`onClick: openTitle === void 0 ? void 0 : …`，头部这个变体没有 openTitle
+     ⇒ 本体无点击逻辑），“打开”实际靠容器 onMouseEnter(150ms)，
+     而再点同一处不会再产生 mouseenter ⇒ 既关不掉也开不回来。
+     插件用官方键盘路径补的 toggle：展开时点→Escape，收起时点→ArrowDown。
+
+用法（需要目标机 dsh web 在跑，且会话列表里有**含子代理**的会话）：
+
+    python3 tests/live-probe.py
+    python3 tests/live-probe.py --base-url http://192.168.0.205:3080 --session miniqmt
+    python3 tests/live-probe.py --token-file ~/.dsh/lan-access-token --viewport 390x844
+
+退出码非 0 = 回归。桌面（>768px）语义不在本探针范围：上游 hover 开合，插件不介入。
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import pathlib
+import sys
+
+MENUS = "() => document.querySelectorAll('[class*=ZKlsPq_menu]').length"
+ROWS = """() => [...document.querySelectorAll('[class*=ZKlsPq_row]')]
+  .map(e => { const r = e.getBoundingClientRect(); return [Math.round(r.x + 40), Math.round(r.y + 20)]; })"""
+GEOM = """() => {
+  const sw = [...document.querySelectorAll('button[class*=ZKlsPq_trigger]')].pop();
+  const crumbs = document.querySelector('[class*=wSkVaW_crumbs]') || document.querySelector('[class*=crumbs]');
+  if (!sw || !crumbs) return { err: sw ? 'no crumbs' : 'no switcher (该会话没有子代理？)' };
+  const b = sw.getBoundingClientRect(), c = crumbs.getBoundingClientRect();
+  const t = document.elementFromPoint(b.x + b.width / 2, b.y + b.height / 2);
+  return {
+    text: (sw.textContent || '').trim(), w: Math.round(b.width), h: Math.round(b.height),
+    clipped: b.right > c.right + 0.5, tall: b.height > 40,
+    clickable: !!(t && t.closest && t.closest('button[class*=ZKlsPq_trigger]')),
+    crumbsText: (crumbs.innerText || '').replace(/\\n/g, ' ').slice(0, 60),
+  };
+}"""
+DRAWER = """() => { const s = document.querySelector('[class*=sidebarCol]');
+  return s ? (getComputedStyle(s).display + ':' + Math.round(s.getBoundingClientRect().width)) : 'none'; }"""
+
+# ⚠️ [role=treeitem] 里**混着工作区节点**（点它会切换工作区 → 整批换掉会话列表，
+#   2026-09-14 实测按索引点会点到工作区）；会话行才带 sessionRow 类名，必须用它过滤。
+SESSION_ROWS_JS = "[...document.querySelectorAll('[role=treeitem][class*=sessionRow]')]"
+SESSION_LABELS = """(needle) => %s
+  .map(r => (r.textContent || '').trim())
+  .filter(t => !needle || t.includes(needle))""" % SESSION_ROWS_JS
+SESSION_CLICK = """(t) => { for (const r of %s)
+  if ((r.textContent || '').trim() === t) { r.click(); return true; } return false; }""" % SESSION_ROWS_JS
+
+
+def run(args) -> int:
+    from playwright.sync_api import sync_playwright
+
+    token_file = pathlib.Path(args.token_file).expanduser()
+    if not token_file.exists():
+        print(f"找不到 token 文件：{token_file}")
+        return 2
+    token = token_file.read_text(encoding="utf-8").strip()
+    w, h = (int(x) for x in args.viewport.lower().split("x"))
+    base = args.base_url.rstrip("/")
+    fails: list[str] = []
+
+    with sync_playwright() as p:
+        browser = p.chromium.launch()
+        ctx = browser.new_context(viewport={"width": w, "height": h}, device_scale_factor=2,
+                                  is_mobile=True, has_touch=True)
+        page = ctx.new_page()
+        page.goto(f"{base}/?token={token}", wait_until="domcontentloaded", timeout=30000)
+        page.wait_for_timeout(3000)
+
+        # ① 逐个试开会话，直到找到一个**有子代理**的（列表里多数会话没有切换器）
+        page.touchscreen.tap(w - 33, 69)
+        page.wait_for_timeout(1300)
+        labels = page.evaluate(SESSION_LABELS, args.session or "")
+        page.touchscreen.tap(w - 30, 500)          # 关抽屉
+        page.wait_for_timeout(1000)
+        if not labels:
+            print(f"❌ 会话列表里没有可打开的会话（--session={args.session!r}）")
+            return 2
+        geom, opened = {"err": "未找到含子代理的会话"}, None
+        for i in range(args.session_tries):
+            page.touchscreen.tap(w - 33, 69)       # 开抽屉
+            page.wait_for_timeout(1200)
+            # ⚠️ 每次都要重新读列表：点开其它工作区的会话会切换工作区，会话列表随之整批变化
+            #   （按索引点会点错行 —— 必须"读当下这一行的文本 → 再按该文本点")
+            rows_now = page.evaluate(SESSION_LABELS, args.session or "")
+            if i >= len(rows_now):
+                break
+            label = rows_now[i]
+            clicked = page.evaluate(SESSION_CLICK, label)
+            if not clicked:
+                continue
+            page.wait_for_timeout(1500)
+            page.touchscreen.tap(w - 30, 500)      # 点 scrim 关抽屉（点会话项不会自动关）
+            page.wait_for_timeout(800)
+            # 会话历史可能很大（实测 1.1MB，首次渲染要数秒）⇒ 轮询等切换器出现，别固定睡眠
+            geom, opened = {"err": "未找到含子代理的会话"}, label
+            for _ in range(12):
+                geom = page.evaluate(GEOM)
+                if not geom.get("err"):
+                    break
+                page.wait_for_timeout(1000)
+            if not geom.get("err"):
+                break
+            print(f"  跳过（无子代理切换器）：{label[:40]}")
+        if opened:
+            print(f"打开会话：{opened[:40]}")
+
+        # ② 头部切换器几何
+        print(f"切换器：{json.dumps(geom, ensure_ascii=False)}")
+        if geom.get("err"):
+            fails.append(geom["err"])
+        else:
+            if geom["clipped"]:
+                fails.append(f"切换器被 crumbs 裁掉（宽仅 {geom['w']}px，right 超出 crumbs）")
+            if geom["tall"]:
+                fails.append(f"切换器非单行（高 {geom['h']}px > 40px）")
+            if not geom["clickable"]:
+                fails.append("切换器中心点不到它（被其它元素覆盖）")
+
+        # ③ toggle：连点 4 次应为 开/关/开/关
+        if not geom.get("err"):
+            sw = page.evaluate("""() => { const b = [...document.querySelectorAll('button[class*=ZKlsPq_trigger]')].pop();
+                const r = b.getBoundingClientRect(); return { x: r.x + r.width / 2, y: r.y + r.height / 2 }; }""")
+            seq = []
+            for _ in range(4):
+                page.touchscreen.tap(sw["x"], sw["y"])
+                page.wait_for_timeout(800)
+                seq.append(page.evaluate(MENUS))
+            print(f"toggle 序列：{seq}（期望 [1,0,1,0]）")
+            if seq != [1, 0, 1, 0]:
+                fails.append(f"点击无法临时开合：{seq}（期望 [1,0,1,0]）")
+
+            # ④ 菜单行可进入子代理（面包屑应变成两段）
+            page.touchscreen.tap(sw["x"], sw["y"])
+            page.wait_for_timeout(800)
+            rows = page.evaluate(ROWS)
+            if not rows:
+                fails.append("菜单里没有 ZKlsPq_row（上游结构可能已变）")
+            else:
+                page.touchscreen.tap(rows[0][0], rows[0][1])
+                page.wait_for_timeout(3000)
+                after = page.evaluate("""() => { const c = document.querySelector('[class*=crumbs]');
+                    return c ? (c.innerText || '').replace(/\\n/g, ' ').slice(0, 60) : ''; }""")
+                print(f"点子代理行后面包屑：{after}")
+                if "/" not in after or len(after) <= len((geom.get("crumbsText") or "")):
+                    fails.append(f"点子代理行没有进入子代理会话（面包屑未变化：{after!r}）")
+
+        # ⑤ 抽屉回归（补丁不得吞掉其它点击）
+        page.touchscreen.tap(w - 33, 69)
+        page.wait_for_timeout(1200)
+        drawer_open = page.evaluate(DRAWER)
+        page.touchscreen.tap(w - 30, 500)
+        page.wait_for_timeout(1000)
+        drawer_closed = page.evaluate(DRAWER)
+        print(f"抽屉：开={drawer_open} 关={drawer_closed}")
+        if drawer_open.startswith("none") or not drawer_closed.startswith("none"):
+            fails.append(f"抽屉开合回归（开={drawer_open} 关={drawer_closed}）")
+
+        browser.close()
+
+    print()
+    if fails:
+        print(f"❌ 真实页面回归：{len(fails)} 项不达标")
+        for f in fails:
+            print(f"   - {f}")
+        return 1
+    print("✅ 真实页面交互全部通过（切换器完整可点、点击可开可收、菜单可进入子代理、抽屉正常）")
+    return 0
+
+
+def main() -> int:
+    ap = argparse.ArgumentParser(description="dsh-mobile-ui 真实页面交互探针")
+    ap.add_argument("--base-url", default="http://127.0.0.1:3080", help="dsh web 地址")
+    ap.add_argument("--token-file", default="~/.dsh/lan-access-token", help="门卫/访问令牌文件")
+    ap.add_argument("--session", default=None, help="会话标题片段（默认按列表顺序逐个试）")
+    ap.add_argument("--session-tries", type=int, default=6, help="最多试开几个会话以找到含子代理的")
+    ap.add_argument("--viewport", default="390x844", help="WxH（默认 390x844，手机档）")
+    return run(ap.parse_args())
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/tests/mobile-layout-probe.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""dsh-mobile-ui 移动端布局探针：两处可读性/几何回归测试。
+"""dsh-mobile-ui 移动端布局探针：三处可读性/几何回归测试（提问卡片 · 输入区操作行 · 会话头部）。
 
 ## 一、提问卡片（ask_user_question）
 
@@ -28,6 +28,23 @@
 多一个上下文按钮就重叠），肉眼审查 CSS 极难穷举，所以固化成几何测量：
 真实上游 CSS + 真实 DOM 嵌套 + 真实插件代码，断言「任意两个控件都不重叠」。
 
+## 三、会话头部（面包屑 + 子代理切换器）
+
+crumbs 是 `overflow:hidden` 的窄条，里面塞着「会话标题 + 子代理切换器」，插件任何作用在
+header/title/crumbs 上的规则都会在这里静默改变结果（2026-09-14 用户报「子代理 UI 文字显示
+不全 / 上下排列」，一次踩中两个坑）：
+
+    white-space/overflow-wrap 是**继承属性**，crumbs 上游是 nowrap
+    旧插件规则  [class*=crumbs]{white-space:normal;overflow-wrap:anywhere}
+    ⇒ 切换器里那个**无类名**文本 span 继承成 normal → 逐字换行（实测 28px → 96px 竖排一列）
+
+    上游把标题+切换器+4 个操作按钮塞在一行，390px 下 crumbs 只分到 136px
+    ⇒ 标题(最多 220) + 切换器(94) 按比例收缩后被 crumbs 裁掉尾部
+    ⇒ 手机上是「[方块] 8」，"个子代理"看不见；被裁区上的点击还落在 headerActions 上
+      （实测 elementFromPoint 命中"标准模式"）⇒ 点切换器**打不开子代理列表**
+
+断言：切换器完整落在 crumbs 内、单行、中心点真能点到它、与操作区不重叠、按钮不出屏、标题不被压没。
+
 ## 用法
 
     python3 tests/mobile-layout-probe.py                 # 默认测当前安装副本
@@ -35,6 +52,7 @@
     python3 tests/mobile-layout-probe.py --viewport 320x568 --options 12
     python3 tests/mobile-layout-probe.py --only composer  # 只跑操作行
     python3 tests/mobile-layout-probe.py --only qa        # 只跑提问卡片
+    python3 tests/mobile-layout-probe.py --only header    # 只跑会话头部（子代理切换器）
 
 依赖：playwright（python）+ 已安装的 dsh（用于抽取上游 CSS）。退出码非 0 表示回归。
 """
@@ -60,6 +78,8 @@ CONV_CSS_RE = r'const css\$4 = ("(?:[^"\\]|\\.)*");'
 QQ_CSS_RE = r'const css = ("(?:[^"\\]|\\.)*");'
 # 输入区（InputBar）上游 CSS：uV2eYG 词根
 INPUTBAR_CSS_RE = r'const css\$1 = ("(?:[^"\\]|\\.)*");'
+# 子代理切换器上游 CSS：ZKlsPq 词根（在 dsh-client-ui-subagent 里是 css$1）
+SUBAGENT_CSS_RE = r'const css\$1 = ("(?:[^"\\]|\\.)*");'
 
 
 def extract_css(path: pathlib.Path, pattern: str, what: str) -> str:
@@ -460,6 +480,170 @@ def probe_composer(plugin, viewport, with_context, with_effort, workdir,
     }
 
 
+HEADER_MEASURE_JS = """() => {
+  const R = e => { if (!e) return null; const r = e.getBoundingClientRect();
+    return {x: r.x, y: r.y, w: r.width, h: r.height, right: r.right}; };
+  const sw = [...document.querySelectorAll('button[class*=ZKlsPq_trigger]')].pop();
+  const crumbs = document.querySelector('[class*=wSkVaW_crumbs]');
+  // 当前段优先：窄屏下父级段会被插件隐藏（display:none → 宽 0），取它会把标题误判成"被压没"
+  const title = document.querySelector('button[class*=wSkVaW_crumbCurrent]')
+             || document.querySelector('button[class*=wSkVaW_crumb]');
+  const actions = document.querySelector('[class*=wSkVaW_headerActions]');
+  const box = sw ? R(sw) : null;
+  const hit = [];
+  if (box) {
+    let e = document.elementFromPoint(box.x + box.w / 2, box.y + box.h / 2);
+    while (e && e !== document.body) { hit.push(String(e.className)); if (e === sw) break; e = e.parentElement; }
+  }
+  const btns = [...document.querySelectorAll('[class*=wSkVaW_titleRow] button')]
+    .map(b => Object.assign({label: (b.getAttribute('aria-label') || (b.textContent || '').trim()).slice(0, 14)}, R(b)));
+  const cr = R(crumbs), ac = R(actions);
+  return {
+    switcher: box, crumbs: cr, title: R(title), actions: ac, hitChain: hit,
+    // 切换器必须完整落在 crumbs 内（crumbs 是 overflow:hidden —— 超出即被裁成半截）
+    clipped: !!(box && cr && box.right > cr.right + 0.5),
+    // 中心点必须真的能点到切换器本身（曾因被 headerActions 覆盖而点到"标准模式"）
+    clickable: hit.some(c => c.indexOf('ZKlsPq_trigger') >= 0),
+    // 切换器与右侧操作区不得重叠
+    overlap: !!(box && ac && box.x < ac.right && ac.x < box.right),
+    // 切换器必须单行：white-space/overflow-wrap 是**继承属性**，crumbs 上游是 nowrap，
+    // 插件任何把 normal/anywhere 设到 header/title/crumbs 容器上的规则都会让无类名文本
+    // span 逐字换行 —— 实测高度 28 → 96px（用户看到的"竖排一列"）。
+    tall: !!(box && box.h > 40),
+    spill: btns.filter(b => b.right > window.innerWidth + 0.5).map(b => b.label),
+    offscreenSwitcher: !!(box && box.w > 0 && (box.x < 0 || box.right > window.innerWidth + 0.5)),
+    // 标题至少要留得下可辨认的字符（方案里标题让位给切换器，但不能被压成 0）
+    titleW: title ? Math.round(title.getBoundingClientRect().width) : 0,
+    btnCount: btns.length,
+  };
+}"""
+
+
+def build_header_page(plugin: pathlib.Path, segments: int = 1) -> str:
+    """复现页：真实上游会话头部 CSS + 真实 DOM 嵌套（header > titleRow > titleCluster > crumbs）。
+
+    segments=1 会话页（面包屑只有当前会话标题）；
+    segments=2 子代理会话页（父会话 / 子代理名 —— 面包屑更长，空间更紧）。
+
+    为什么需要这组：crumbs 是 overflow:hidden 的窄条，里面塞着「会话标题 + 子代理切换器」，
+    插件任何作用在 header/title/crumbs 上的 white-space（继承属性）或宽度规则都会在这里
+    静默改变结果 —— 2026-09-14 实际出过两次：
+      ① white-space:normal + overflow-wrap:anywhere 被 crumbs 继承 ⇒ 切换器文字逐字换行成 96px 竖排；
+      ② crumbs 被压到 136px，标题+切换器按比例收缩后尾部被裁 ⇒ 手机上是「[方块] 8」，
+         且点击落在右侧 headerActions 上（打不开子代理列表）。
+    """
+    conv_css = extract_css(DSH_NODE_MODULES / "dsh-client-ui-conversation/lib/client.js", CONV_CSS_RE, "ConversationRoot")
+    sub_css = extract_css(DSH_NODE_MODULES / "dsh-client-ui-subagent/lib/client.js", SUBAGENT_CSS_RE, "SubagentSwitcher")
+
+    long_title = "miniqmt月底要禁用了，可以通过改造大qmt来平替原先在trade pc上的quant qmt proxy服务吗"
+    first_seg = (
+        f'<button type="button" class="wSkVaW_crumb">{long_title[:14]}</button>'
+        f'<span class="wSkVaW_crumbSep">/</span>'
+        if segments > 1 else ""
+    )
+    current = long_title if segments == 1 else "Proxy改造点研究"
+
+    return f"""<!doctype html>
+<html lang="zh-CN"><head><meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1,viewport-fit=cover">
+<title>header-probe</title>
+<style>
+:root{{
+  --dsw-alias-bg-base:#16171b; --dsw-alias-bg-layer-1:#1e1f24; --dsw-specific-menu:#2a2b31;
+  --dsw-specific-selector:#33343a; --dsw-alias-label-primary:rgba(255,255,255,.9);
+  --dsw-alias-label-secondary:rgba(255,255,255,.7); --dsw-alias-label-tertiary:rgba(255,255,255,.5);
+  --dsw-alias-label-caption:rgba(255,255,255,.4); --dsw-alias-label-dimmed:rgba(255,255,255,.3);
+  --dsw-alias-border-l2:rgba(255,255,255,.14); --dsw-alias-border-l3:rgba(255,255,255,.2);
+  --dsw-alias-interactive-bg-hover:rgba(255,255,255,.08);
+  --dsw-alias-state-error-primary:#ff6b6b; --dsw-alias-brand-primary:#4f7cff;
+  --dsh-conversation-column-width:100%;
+}}
+html,body{{margin:0;padding:0;height:100%;background:var(--dsw-alias-bg-base);color:#eee;
+  font-family:-apple-system,"PingFang SC",system-ui,sans-serif}}
+{conv_css}
+{sub_css}
+#app{{height:100%;display:grid;grid-template-columns:260px minmax(0,1fr) 0px}}
+.sidebarCol{{background:#1a1b1f}}
+.wSkVaW_body{{flex:1 1 auto}}
+.hdrBtn{{height:28px;padding:0;border:none;border-radius:8px;background:rgba(255,255,255,.06);color:inherit}}
+</style></head>
+<body>
+<div id="app" class="frame">
+  <div class="sidebarCol" data-testid="sidebar">sidebar</div>
+  <div class="wSkVaW_root">
+    <header class="wSkVaW_header">
+      <div class="wSkVaW_titleRow">
+        <div class="wSkVaW_titleCluster">
+          <nav class="wSkVaW_crumbs" aria-label="会话层级">
+            <span class="wSkVaW_crumbSeg">
+              {first_seg}
+              <button type="button" class="wSkVaW_crumb wSkVaW_crumbCurrent">{current}</button>
+              <div style="display:contents">
+                <div class="ZKlsPq_root">
+                  <span class="ZKlsPq_separator">/</span>
+                  <button type="button" class="ZKlsPq_trigger" aria-haspopup="tree" aria-expanded="false"
+                          aria-label="8 个子代理，正在运行">
+                    <span class="ZKlsPq_activitySlot"></span>
+                    <span>8 个子代理</span>
+                    <svg width="14" height="14" viewBox="0 0 14 14" aria-hidden="true">
+                      <path d="M3 5l4 4 4-4" fill="none" stroke="currentColor"></path></svg>
+                  </button>
+                </div>
+              </div>
+            </span>
+          </nav>
+          <div class="wSkVaW_headerActions">
+            <button type="button" class="hdrBtn" style="width:68px" aria-label="标准模式">标准模式</button>
+          </div>
+        </div>
+        <div class="wSkVaW_headerUtilities">
+          <button type="button" class="hdrBtn" style="width:52px" aria-label="在 GNOME Terminal 中打开工作目录">T</button>
+          <button type="button" class="hdrBtn" style="width:28px" aria-label="更多操作">M</button>
+        </div>
+        <div class="wSkVaW_headerCorner">
+          <button type="button" class="hdrBtn" style="width:28px" aria-label="打开右侧边栏">C</button>
+        </div>
+      </div>
+      <div class="wSkVaW_tabs">
+        <button type="button" class="wSkVaW_tab wSkVaW_tabActive">对话</button>
+        <button type="button" class="wSkVaW_tab">轨迹</button>
+      </div>
+    </header>
+    <div class="wSkVaW_body"></div>
+  </div>
+</div>
+<script>window.__ModuleLoader__={{mode:"queue",load:function(reg){{window.__reg=reg}}}};</script>
+</body></html>"""
+
+
+def probe_header(plugin, viewport, segments, workdir):
+    """会话头部几何：切换器必须完整、可点、不与操作区重叠。"""
+    from playwright.sync_api import sync_playwright
+
+    w, h = viewport
+    html = build_header_page(plugin, segments)
+    page_path = workdir / f"probe-header-{segments}-{w}x{h}.html"
+    page_path.write_text(html, encoding="utf-8")
+
+    with sync_playwright() as p:
+        browser = p.chromium.launch()
+        ctx = browser.new_context(
+            viewport={"width": w, "height": h}, device_scale_factor=2, is_mobile=True, has_touch=True
+        )
+        page = ctx.new_page()
+        page.goto(page_path.as_uri())
+        apply_plugin(page, plugin)
+        page.wait_for_timeout(400)
+        m = page.evaluate(HEADER_MEASURE_JS)
+        browser.close()
+
+    m.update({
+        "viewport": f"{w}x{h}",
+        "variant": "会话页" if segments == 1 else "子代理会话页",
+    })
+    return m
+
+
 def probe(plugin, viewport, options, detail_paras, workdir):
     from playwright.sync_api import sync_playwright
 
@@ -525,7 +709,7 @@ def main() -> int:
     ap.add_argument("--viewport", action="append", default=None, help="WxH，可重复（默认覆盖常见机型）")
     ap.add_argument("--options", type=int, action="append", default=None, help="选项数量，可重复")
     ap.add_argument("--detail-paras", type=int, default=2, help="detail 长文本段落数")
-    ap.add_argument("--only", choices=["qa", "composer"], default=None, help="只跑其中一组")
+    ap.add_argument("--only", choices=["qa", "composer", "header"], default=None, help="只跑其中一组")
     ap.add_argument("--json", action="store_true", help="输出 JSON")
     args = ap.parse_args()
 
@@ -536,7 +720,7 @@ def main() -> int:
     viewports = [tuple(int(x) for x in v.lower().split("x")) for v in (args.viewport or ["320x568", "360x640", "390x844", "414x896"])]
     options_list = args.options or [1, 3, 6, 12]
 
-    qa_results, composer_results = [], []
+    qa_results, composer_results, header_results = [], [], []
     with tempfile.TemporaryDirectory(prefix="dsh-mobile-probe-") as tmp:
         wd = pathlib.Path(tmp)
         if args.only in (None, "qa"):
@@ -552,6 +736,11 @@ def main() -> int:
             for vp in viewports[:2]:
                 composer_results.append(probe_composer(
                     plugin, vp, True, True, wd, model_label="DeepSeek V4.1 Flash"))
+        if args.only in (None, "header"):
+            # 会话头部：面包屑里的子代理切换器必须完整可见且可点（两种面包屑长度）
+            for vp in viewports:
+                for seg in (1, 2):
+                    header_results.append(probe_header(plugin, vp, seg, wd))
 
     qa_failures = [
         r for r in qa_results
@@ -590,13 +779,20 @@ def main() -> int:
         # 行内垂直中心离散 ≤1.5px（发送键上游 translateY(-2px) 曾致偏移）
         or any(s > 1.5 for s in (r.get("lineSpreads") or [0]))
     ]
+    # 会话头部：切换器被裁 / 点不到 / 与操作区重叠 / 按钮出屏 / 标题被压没
+    header_failures = [
+        r for r in header_results
+        if not r.get("switcher") or r.get("clipped") or not r.get("clickable")
+        or r.get("overlap") or r.get("spill") or r.get("offscreenSwitcher") or r.get("tall")
+        or (r.get("titleW") or 0) < 60
+    ]
 
     if args.json:
         print(json.dumps({
-            "ok": not qa_failures and not composer_failures,
-            "qa": qa_results, "composer": composer_results,
+            "ok": not qa_failures and not composer_failures and not header_failures,
+            "qa": qa_results, "composer": composer_results, "header": header_results,
         }, ensure_ascii=False, indent=2))
-        return 1 if (qa_failures or composer_failures) else 0
+        return 1 if (qa_failures or composer_failures or header_failures) else 0
 
     print(f"被测插件: {plugin}")
 
@@ -629,8 +825,24 @@ def main() -> int:
                   f"{'✓' if r.get('accessIconShown') else '✗':<10} {perm_txt:<10} {ell:<9} "
                   f"{'✓' if not r.get('misaligned') else '✗':<6}")
 
+    if header_results:
+        print()
+        print("── 会话头部（面包屑 + 子代理切换器）──")
+        print(f"{'视口':<10} {'形态':<14} {'切换器完整':<11} {'单行':<6} {'可点':<6} {'不重叠':<7} "
+              f"{'不出屏':<7} {'标题宽':<7} {'切换器宽':<8}")
+        print("-" * 82)
+        for r in header_results:
+            sw = r.get("switcher") or {}
+            print(f"{r['viewport']:<10} {r['variant']:<14} "
+                  f"{'✓' if not r.get('clipped') else '✗':<12} "
+                  f"{'✓' if not r.get('tall') else '✗':<7} "
+                  f"{'✓' if r.get('clickable') else '✗':<7} "
+                  f"{'✓' if not r.get('overlap') else '✗':<8} "
+                  f"{'✓' if not r.get('spill') else '✗':<8} "
+                  f"{r.get('titleW', 0):<8} {round(sw.get('w', 0)):<8}")
+
     print()
-    if qa_failures or composer_failures:
+    if qa_failures or composer_failures or header_failures:
         if qa_failures:
             print(f"❌ 提问卡片回归：{len(qa_failures)} 个用例不达标（选项被裁 / 滚动失效 / 提交按钮不可见）")
             for r in qa_failures:
@@ -674,6 +886,29 @@ def main() -> int:
                 if r.get("count", 0) < 2:
                     why.append(f"控件数异常={r.get('count')}")
                 print(f"   - {r['viewport']} {r.get('variant')}: " + "；".join(why or ["未知"]))
+        if header_failures:
+            print(f"❌ 会话头部回归：{len(header_failures)} 个用例不达标（子代理切换器被裁/点不到）")
+            for r in header_failures:
+                why = []
+                if not r.get("switcher"):
+                    why.append("页面里找不到 ZKlsPq_trigger（上游类名或结构已变，选择器需复核）")
+                if r.get("clipped"):
+                    why.append(f"切换器被 crumbs 裁掉（ crumbs 右 {round((r.get('crumbs') or {}).get('right', 0))}"
+                               f" < 切换器右 {round((r.get('switcher') or {}).get('right', 0))}）")
+                if not r.get("clickable"):
+                    why.append(f"切换器中心点不到它（命中链={r.get('hitChain')}）")
+                if r.get("tall"):
+                    why.append(f"切换器不是单行（高 {round((r.get('switcher') or {}).get('h', 0))}px > 40px，"
+                               f"white-space 被继承污染 → 文字逐字换行）")
+                if r.get("overlap"):
+                    why.append("切换器与 headerActions 重叠")
+                if r.get("spill"):
+                    why.append(f"按钮越出视口={r['spill']}")
+                if r.get("offscreenSwitcher"):
+                    why.append("切换器整体出屏")
+                if (r.get("titleW") or 0) < 60:
+                    why.append(f"会话标题被压没（{r.get('titleW')}px < 60px）")
+                print(f"   - {r['viewport']} {r.get('variant')}: " + "；".join(why or ["未知"]))
         return 1
 
     parts = []
@@ -682,6 +917,9 @@ def main() -> int:
     if composer_results:
         parts.append(f"操作行 {len(composer_results)} 个（互不重叠/不越界/可点击、"
                      f"权限图标常显、被裁模型名走省略号、图标文字垂直对齐）")
+    if header_results:
+        parts.append(f"会话头部 {len(header_results)} 个（子代理切换器完整可见且单行、"
+                     f"中心点可点、与操作区不重叠、按钮不出屏、标题不被压没）")
     print("✅ 全部通过：" + "；".join(parts))
     return 0