dsh-mobile-ui 0.1.1 → 0.1.2

package/README.md

@@ -42,7 +42,8 @@ Fast local iteration: copy to `~/.dsh/profiles/node_modules/dsh-mobile-ui/` and
 
 - **CSS layer**: injects `style[data-plugin-css=dsh-mobile-ui]`, all rules wrapped in `@media (max-width:768px)` — desktop loads none of it
 - **JS layer**: `matchMedia`-driven; on narrow screens the main grid goes single-column, the sidebar is hidden and becomes a fixed overlay drawer with scrim
-- **QA card** (`ask_user_question`, Mbwy4a component): JS detects the card and pins it as a floating panel (`position:fixed; top:100px`) — no `:has()` dependency (works in WeChat/X5-style engines); the footer button row wraps when narrow, so the submit button is always visible; conversation stays visible below
+- **QA card** (`ask_user_question`, Mbwy4a component): JS detects the card and turns its composer seat into a full-height floating panel — no `:has()` dependency (works in WeChat/X5-style engines). The card's own `max-height` is lifted and its body stays the single scroll container, so long option lists scroll with a finger on every device; the footer button row wraps when narrow, so the submit button is always visible
+- **Regression probe**: `python3 tests/mobile-layout-probe.py` drives a real headless Chromium (upstream CSS + real DOM nesting + the actual plugin bundle) across viewports and option counts, asserting "option list scrolls / last option reachable after a real touch swipe / submit always visible / the fixed top-right menu button does not overlap the card". Exit code 1 on regression. Two rules it guards: never override the card body's `overflow` (that is exactly what broke scrolling before), and hide the floating menu button whenever the question card is open (it sits at `top:48px; right:12px`, right on top of the card title).
 
 ## Maintenance notes (important)
 

package/README.zh.md

@@ -28,8 +28,24 @@ bash install.sh --uninstall  # 卸载
 ```bash
 bash scripts/build.sh                       # 语法 + 契约预检（含 classic-script 校验）
 bash scripts/package.sh                     # 打包 dist/dsh-mobile-ui-install.tar.gz
+python3 tests/mobile-layout-probe.py        # 移动端布局回归探针（提问卡片可滚动/选项可达）
 ```
 
+**提问卡片回归探针**（`tests/mobile-layout-probe.py`）：用真实上游 CSS + 真实 DOM 嵌套 +
+真实插件代码，在 headless Chromium 里按视口 × 选项数跑矩阵，断言「正文可滚 / 真实手指
+滑动后最后一个选项可见 / 提交按钮始终可见 / 右上角菜单按钮不遮挡卡片」，回归时退出码 1。
+它守的是两条硬纪律——
+
+1. **绝不要覆盖提问卡片正文（`Mbwy4a_body` / `data-question-scroll`）的 overflow**：
+   上游卡片是 `max-height:min(60vh,520px)+overflow:hidden`，正文才是它唯一的滚动容器，
+   把它改成 `visible` 会让放不下的选项被卡片直接裁掉、且再也滚不出来（2026-09-11 修复的真实故障）。
+2. **浮层打开时必须隐藏右上角菜单按钮**：它固定在 `top:48px; right:12px`，
+   正好压在提问卡片标题右侧（截图实证），所以菜单按钮的显隐要按
+   「抽屉 / 设置面板 / 提问卡片」三态判定，而不是只看抽屉。
+
+探针已做**双向对照**验证：最老版本（滚动缺陷）与仅修滚动的版本都返回 1，
+完整修复版返回 0 —— 即它抓得住这两类缺陷，不是"永远绿灯"的假探针。
+
 本地快速迭代：复制到 `~/.dsh/profiles/node_modules/dsh-mobile-ui/` 后刷新页面
 （客户端插件有 HMR 通道，改 client.js 后页面自动更新）。
 
@@ -41,6 +57,10 @@ bash scripts/package.sh                     # 打包 dist/dsh-mobile-ui-install.
   注入右上角菜单按钮 + 遮罩；菜单把侧边栏临时变为 fixed 抽屉（overlay）。
 - **hero 标题置顶**：纯 CSS 实现——composerHero 栈在 hero 态撑满视口
   （flex:1），输入卡 margin-top:auto 沉底，标题/工作区行自然留在顶部。
+- **提问卡片**：JS 检测到卡片后把它的 composerSeat 变成铺满可视高度的浮层，
+  卡片自身的 max-height 放开、正文保持为唯一滚动容器（卡片内 `data-question-scroll`），
+  footer 钉在浮层底部。选择器优先用上游稳定属性（`data-question-key` /
+  `data-question-scroll` / `data-composer-seat`），hash 类名只作兜底。
 
 ## 维护须知（重要）
 
@@ -54,6 +74,16 @@ bash scripts/package.sh                     # 打包 dist/dsh-mobile-ui-install.
   pXSMma_root 等）：React fiber 树仍记录旧父节点，重渲染时 removeChild 抛
   NotFoundError，整个会话视图被卸载 → 页面空白。布局需求一律用 CSS
   （flex/order/:has）表达；hero 标题置顶即纯 CSS 实现。
+- **严禁覆盖提问卡片正文的 overflow**（2026-09-11 故障根因，已由探针看住）：
+  上游 `.card{max-height:min(60vh,520px);overflow:hidden}` 且 `.body{overflow-y:auto}`
+  ——正文是卡片内唯一滚动容器。改成 `overflow:visible` 会造成
+  「选项看不全 + 手指滑动毫无反应」：卡片把放不下的选项裁掉，正文又不再滚动，
+  浮层里也没有可滚内容（实测 6 选项时 body 内容 1047px / 可见 319px，滑动后几何零变化）。
+  正确做法是**给正文更多高度**（浮层撑满视口 + 卡片 max-height:100%），而不是动它的 overflow。
+- **右上角菜单按钮的显隐必须是三态判定**（抽屉 / 设置面板 / 提问卡片）：
+  该按钮固定在 `top:calc(48px + safe-area); right:12px`，提问卡片打开时正好压在
+  卡片标题右侧（2026-09-11 由真实页面截图发现）。旧写法只看 `drawerOpen`，
+  既会在提问卡片上造成遮挡，也会把设置面板打开时隐藏的菜单在下次 sync 又显示回来。
 
 ## 回滚
 

package/client.js

@@ -71,13 +71,26 @@ window.__ModuleLoader__.load({
 			"  body.dsh-mobile-ui [class*=composerHero] > [class*=heroWorkspaceRow]{flex:0 0 auto !important;height:auto !important}",
 			/* 工作区行内按钮豁免 44px 触摸高（保持 28px 原高） */
 			"  body.dsh-mobile-ui [class*=heroWorkspaceRow] button{min-height:28px !important;min-width:0 !important;height:auto !important}",
-		/* QA 问答卡片（Mbwy4a）移动端适配：全屏弹层（与设置面板同构）——
-		   seat 固定铺满视口 + 内部滚动，footer（跳过/提交）sticky 钉屏幕底部。
-		   任何设备/视口/系统字体下提交按钮都必然可见；QA 关闭后自动恢复 */
-		"  body.dsh-mobile-ui [class*=composerSeat].dsh-mobile-qa{position:fixed !important;top:100px !important;left:8px !important;right:8px !important;bottom:auto !important;margin:0 !important;z-index:2147482999 !important;padding:12px !important;max-height:calc(100vh - 150px) !important;max-height:calc(100dvh - 150px) !important;overflow-y:auto !important;background:transparent !important}",
-			"  body.dsh-mobile-ui [class*=Mbwy4a_card]{width:100% !important;max-width:none !important}",
-			"  body.dsh-mobile-ui [class*=Mbwy4a_body]{overflow:visible !important}",
-			"  body.dsh-mobile-ui [class*=Mbwy4a_footer]{position:sticky !important;bottom:0 !important;background:var(--dsw-alias-bg-layer-1,rgb(44,44,46)) !important}",
+		/* ── QA 问答卡片（ask_user_question）移动端适配 ─────────────────────
+		   ⚠️ 2026-09-11 复现定案的坑（现象：选项看不全、手指滑动也翻不出来）：
+		   上游卡片自带 max-height:min(60vh,520px) + overflow:hidden，真正的滚动容器
+		   是它内部的 body（上游 overflow-y:auto）。旧规则把 body 的 overflow 覆盖成
+		   visible → ①超出卡片的选项被卡片直接裁掉；②body 不再是滚动容器；
+		   ③覆盖层因卡片被 60vh 卡死而没有可滚内容 → 滑动毫无反应、选项永久不可见。
+		   （实测 6 选项：body scrollHeight 1047 / clientHeight 319，滑动后几何零变化）
+		   修法三原则：①绝不覆盖 body 的 overflow（保留上游唯一滚动容器）；
+		     ②覆盖层撑满可视高度、卡片 max-height:100%（不再被 60vh 卡死）；
+		     ③覆盖层自身 overflow:hidden，杜绝双层滚动互抢手势。
+		   选择器优先用上游稳定属性 data-question-key（frame）/ data-question-scroll（body）
+		   / data-composer-seat（seat），hash 类名只作兜底，降低 dsh 升级后的漂移风险。 */
+		"  body.dsh-mobile-ui [class*=composerSeat].dsh-mobile-qa,body.dsh-mobile-ui [data-composer-seat].dsh-mobile-qa{position:fixed !important;top:calc(12px + env(safe-area-inset-top,0px)) !important;left:8px !important;right:8px !important;bottom:calc(12px + env(safe-area-inset-bottom,0px)) !important;margin:0 !important;z-index:2147482999 !important;padding:0 !important;max-height:none !important;overflow:hidden !important;background:transparent !important;display:flex !important;flex-direction:column !important}",
+		"  body.dsh-mobile-ui [data-question-key] > section,body.dsh-mobile-ui [class*=Mbwy4a_card]{width:100% !important;max-width:none !important;border:1px solid var(--dsw-alias-border-l2,rgba(255,255,255,.14)) !important;box-shadow:0 10px 34px rgba(0,0,0,.45) !important}",
+		"  body.dsh-mobile-ui [class*=composerSeat].dsh-mobile-qa [data-question-key],body.dsh-mobile-ui [data-composer-seat].dsh-mobile-qa [data-question-key],body.dsh-mobile-ui [class*=composerSeat].dsh-mobile-qa [class*=Mbwy4a_frame]{flex:1 1 auto !important;min-height:0 !important;padding:0 !important;align-items:flex-start !important}",
+		"  body.dsh-mobile-ui [class*=composerSeat].dsh-mobile-qa [data-question-key] > section,body.dsh-mobile-ui [data-composer-seat].dsh-mobile-qa [data-question-key] > section,body.dsh-mobile-ui [class*=composerSeat].dsh-mobile-qa [class*=Mbwy4a_card]{max-height:100% !important;min-height:0 !important}",
+		/* 正文：唯一滚动容器（覆盖层态与普通流态都生效——JS 标记失败也不会再被裁掉）；
+		   overscroll-behavior 防滑动穿透到会话消息流 */
+		"  body.dsh-mobile-ui [data-question-scroll],body.dsh-mobile-ui [class*=Mbwy4a_body]{flex:1 1 auto !important;min-height:0 !important;overflow-y:auto !important;-webkit-overflow-scrolling:touch !important;overscroll-behavior:contain !important;touch-action:pan-y !important}",
+		"  body.dsh-mobile-ui [class*=Mbwy4a_footer]{position:sticky !important;bottom:0 !important;background:var(--dsw-alias-bg-layer-1,rgb(44,44,46)) !important}",
 			/* QA footer 防溢出：内容超宽时换行（跳过/提交换行后仍可见，提交永不被裁） */
 			"  body.dsh-mobile-ui [class*=Mbwy4a_footer]{flex-wrap:wrap !important;row-gap:4px !important}",
 			"  body.dsh-mobile-ui [class*=Mbwy4a_footer] [class*=footerActions]{flex-wrap:wrap !important;min-width:0 !important}",
@@ -146,9 +159,16 @@ window.__ModuleLoader__.load({
 			"body.dsh-mobile-ui [class*=uV2eYG_trailing]{gap:2px !important}",
 			/* 会话页（有上下文按钮）：上下文 margin-left 右移 12px（只扩模型↔上下文间距） */
 			"body.dsh-mobile-ui [class*=uV2eYG_trailing]:has(button[aria-label*=上下文]) button[aria-label*=上下文]{margin-left:12px !important}",
-			"body.dsh-mobile-ui [class*=VOzbGW_nav]{width:110px !important;flex:0 0 110px !important;min-width:110px !important;overflow:visible !important}",
+			"body.dsh-mobile-ui [class*=VOzbGW_nav]{width:68px !important;flex:0 0 68px !important;min-width:68px !important;overflow:visible !important}",
 			"body.dsh-mobile-ui [class*=VOzbGW_nav] [class*=navList]{flex:1 1 auto !important;height:auto !important;max-height:none !important;overflow-y:auto !important}",
-			"body.dsh-mobile-ui [class*=VOzbGW_content]{flex:1 1 auto !important;min-width:0 !important;max-width:calc(100% - 110px) !important;padding:0 12px !important;overflow:hidden !important}",
+			"body.dsh-mobile-ui [class*=VOzbGW_nav] button,body.dsh-mobile-ui [class*=VOzbGW_nav] [role=button]{white-space:nowrap !important;overflow:hidden !important;text-overflow:ellipsis !important}",
+			/* 选项卡改竖排（icon 上/文字下居中）：dsh 默认横排 icon+88px 标签总宽 112px，
+			   88px 窄栏放不下会裁掉文字；竖排后 88px 宽容纳 4 字标签 */
+			"body.dsh-mobile-ui [class*=VOzbGW_nav] [class*=navCell]{flex-direction:column !important;justify-content:center !important;align-items:center !important;gap:4px !important;padding:4px 0 !important}",
+			"body.dsh-mobile-ui [class*=VOzbGW_nav] [class*=navCell] svg{width:20px !important;height:20px !important;flex:0 0 auto !important}",
+			"body.dsh-mobile-ui [class*=VOzbGW_nav] [class*=navLabel]{flex:0 0 auto !important;width:auto !important;max-width:100% !important;min-width:0 !important;text-align:center !important;font-size:12px !important;line-height:1.2 !important}",
+			"body.dsh-mobile-ui [class*=VOzbGW_nav] [class*=navTitle]{width:100% !important;box-sizing:border-box !important;padding:0 8px !important;white-space:nowrap !important;overflow:hidden !important;text-overflow:ellipsis !important}",
+			"body.dsh-mobile-ui [class*=VOzbGW_content]{flex:1 1 auto !important;min-width:0 !important;max-width:calc(100% - 68px) !important;padding:0 12px !important;overflow:hidden !important}",
 			/* 头部防重叠加固：关闭按钮固定右侧 + 打开配置文件允许收缩 */
 			"body.dsh-mobile-ui [class*=VOzbGW_header]{display:flex !important;align-items:center !important;justify-content:flex-end !important;gap:8px !important;padding:0 12px !important}",
 			"body.dsh-mobile-ui [class*=VOzbGW_close]{flex:0 0 28px !important;margin-left:0 !important}",
@@ -161,6 +181,14 @@ window.__ModuleLoader__.load({
 			"body.dsh-mobile-ui [class*=VOzbGW_content] [class*=title],body.dsh-mobile-ui [class*=VOzbGW_content] [class*=rowText]{width:100% !important;max-width:100% !important;white-space:normal !important;overflow-wrap:anywhere !important}",
 			"body.dsh-mobile-ui [class*=VOzbGW_content] [class*=title]{display:block !important;flex:1 1 auto !important;align-self:stretch !important}",
 			"body.dsh-mobile-ui [class*=VOzbGW_content] [class*=rowText]{flex:1 1 auto !important;min-width:0 !important}",
+			/* 会话行操作菜单（dsh portal 弹层，原 z-index:1100）提升层级：
+			   抽屉(2147482995)/遮罩(2147482990)层级过高会把菜单盖住（归档等操作不可见）。
+			   仅移动端提升，菜单 fixed 定位不受抽屉 overflow 裁剪；QA 卡片(2147482999)仍居最上 */
+			"body.dsh-mobile-ui [class*=_portal_]{z-index:2147482996 !important}",
+			/* dsh 模态弹层容器提升：目录选择(添加工作区)/Modal 的 portal root 是 fixed z-index:1000，
+			   会被抽屉(2147482995)/遮罩(2147482990)盖住 → 弹框不可见。
+			   [role=dialog] 定位容器统一提升到 2996 与菜单同级(< QA 2999) */
+			"body.dsh-mobile-ui div:has(> [role=dialog]){z-index:2147482996 !important}",
 		].join("\n");
 
 		function injectStyle() {
@@ -189,6 +217,7 @@ window.__ModuleLoader__.load({
 				var scrim = null;
 				var drawerOpen = false;
 				var settingsOpen = false;   /* 设置弹层打开标志（弹层关闭时恢复导航栏） */
+				var qaOpen = false;         /* 提问卡片打开标志（卡片浮层打开时隐藏右上角菜单，防遮挡标题） */
 				var savedGrid = null;   /* 窄屏前的 frame 原始 grid（宽屏恢复用） */
 
 				/* 主布局 frame：display:grid 的顶层容器（CSS 生效前 3 列 / 生效后 1 列均可） */
@@ -300,17 +329,23 @@ window.__ModuleLoader__.load({
 								}
 							}
 							document.body.classList.add("dsh-mobile-ui");
-							/* QA 弹层标记：JS 检测 Mbwy4a 卡片（不依赖 :has，兼容微信 X5 等旧内核）。
-							   加 class 到 composerSeat，CSS 据此全屏化；卡片消失即移除 */
+							/* QA 弹层标记：JS 检测提问卡片（不依赖 :has，兼容微信 X5 等旧内核）。
+							   加 class 到 composerSeat，CSS 据此覆盖层化；卡片消失即移除。
+							   定位优先用上游稳定属性 data-question-key / data-composer-seat
+							   （hash 类名在 dsh 升级后会漂移，只作兜底） */
 							try {
-								var qaFrame = document.querySelector("[class*=Mbwy4a_frame]");
+								var qaFrame = document.querySelector("[data-question-key],[class*=Mbwy4a_frame]");
 								var qaSeat = null;
 								if (qaFrame) {
-									var qn = qaFrame.parentElement;
-									while (qn) { if ((typeof qn.className === "string" ? qn.className : "").indexOf("composerSeat") >= 0) { qaSeat = qn; break; } qn = qn.parentElement; }
+									if (typeof qaFrame.closest === "function") qaSeat = qaFrame.closest("[data-composer-seat],[class*=composerSeat]");
+									if (!qaSeat) {
+										var qn = qaFrame.parentElement;
+										while (qn) { if ((typeof qn.className === "string" ? qn.className : "").indexOf("composerSeat") >= 0) { qaSeat = qn; break; } qn = qn.parentElement; }
+									}
 								}
+								qaOpen = !!qaSeat;
 								if (qaSeat) qaSeat.classList.add("dsh-mobile-qa");
-								else { var qOld = document.querySelector("[class*=composerSeat].dsh-mobile-qa"); if (qOld) qOld.classList.remove("dsh-mobile-qa"); }
+								else { var qOld = document.querySelector(".dsh-mobile-qa"); if (qOld) qOld.classList.remove("dsh-mobile-qa"); }
 							} catch (e) { /* QA 标记失败静默 */ }
 							/* hero 标题置顶改由纯 CSS 实现（composerHero 撑满视口 + 输入卡沉底），
 							   不再用 insertBefore 搬动 React 节点——移动节点会导致 React 重渲染
@@ -324,9 +359,13 @@ window.__ModuleLoader__.load({
 							/* 抽屉态下 sidebar 保持可见，否则隐藏 */
 							side.style.display = drawerOpen ? "" : "none";
 							ensureChrome();
-							if (tabbar) tabbar.style.display = drawerOpen ? "none" : "";
+							/* 菜单按钮三态判定：抽屉 / 设置面板 / 提问卡片浮层打开时都隐藏。
+							   （旧写法只看 drawerOpen，会把设置面板打开时隐藏的菜单在下次 sync 又显示回来；
+							   提问卡片时则会浮在卡片右上角遮住问题标题） */
+							if (tabbar) tabbar.style.display = (drawerOpen || settingsOpen || qaOpen) ? "none" : "";
 						} else {
 							document.body.classList.remove("dsh-mobile-ui");
+							qaOpen = false;
 							var frame2 = findFrame();
 							if (frame2) {
 								if (savedGrid) frame2.style.gridTemplateColumns = savedGrid;

package/install.sh

@@ -46,6 +46,10 @@ done
 [ -n "$PLUGIN" ] || { echo "错误: 缺少 --plugin <name>"; exit 1; }
 HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 [ -n "$SRC" ] || SRC="$HERE"
+# tarball 分发布局：install.sh 在根、插件源码在同名子目录（如 <name>-install/<name>/）
+if [ ! -f "$SRC/package.json" ] && [ -f "$SRC/$PLUGIN/package.json" ]; then
+  SRC="$SRC/$PLUGIN"
+fi
 # 契约预检脚本位置：优先所在仓库（packages/<name>/install.sh → ../../scripts），
 # 其次环境变量 DSH_PLUGINS_REPO，最后 $HOME/dsh-plugins
 for CAND in "$HERE/../../scripts" "${DSH_PLUGINS_REPO:-$HOME/dsh-plugins}/scripts"; do
@@ -221,14 +225,48 @@ fi
 
 if [ "$MODE" = "restart" ]; then
   echo "== 4/4 重启 dsh =="
-  pkill -TERM -f 'node_modules/.bin/dsh web' 2>/dev/null
-  pkill -TERM -f 'npm exec @deepseek-ai/dsh web' 2>/dev/null
-  sleep 3
-  if [ -n "$ROOT" ] && [ -x "$ROOT/node_modules/.bin/dsh" ]; then
-    cd "$ROOT" || exit 1
-    setsid nohup ./node_modules/.bin/dsh web >> /tmp/dsh-web.log 2>&1 < /dev/null &
-    echo "  新进程 PID=$!"
-    sleep 8
+  # 统一重启逻辑：systemd 托管优先，回退 pkill（MR-026）
+  if [ -f "$HERE/_dsh-common/dsh-restart.sh" ]; then
+    # tarball 内自带共享重启脚本（package.sh 打入 _dsh-common/）
+    . "$HERE/_dsh-common/dsh-restart.sh"
+    restart_dsh "$ROOT"
+  elif [ -n "$COMMON" ] && [ -f "$COMMON/dsh-restart.sh" ]; then
+    # 开发环境：dsh-plugins 仓库 scripts/
+    . "$COMMON/dsh-restart.sh"
+    restart_dsh "$ROOT"
+  else
+    # 极端场景（无共享脚本）：内联完整重启逻辑（systemd → pkill 回退）
+    SVC=""
+    if command -v systemctl >/dev/null 2>&1; then
+      for SVC in dsh.service dsh-web.service; do
+        systemctl --user is-active --quiet "$SVC" 2>/dev/null && break
+      done
+    fi
+    if [ -n "$SVC" ]; then
+      echo "  [systemd] $SVC 托管中 → systemctl --user restart $SVC"
+      systemctl --user restart "$SVC"
+      sleep 6
+      curl -s --noproxy '*' -o /dev/null -w "  127.0.0.1:3080 页面 -> %{http_code}\n" http://127.0.0.1:3080/ || echo "  [警告] 页面未就绪"
+    else
+      echo "  [回退] 无 systemd 托管，pkill + 手动拉起"
+      pkill -TERM -f "dsh web" 2>/dev/null
+      pkill -TERM -f 'node_modules/.bin/dsh web' 2>/dev/null
+      pkill -TERM -f 'npm exec @deepseek-ai/dsh web' 2>/dev/null
+      pkill -TERM -f 'sh -c dsh web' 2>/dev/null
+      pkill -TERM -f 'dsh/lib/bin.js web' 2>/dev/null
+      sleep 3
+      if [ -n "$ROOT" ] && [ -x "$ROOT/node_modules/.bin/dsh" ]; then
+        cd "$ROOT" || exit 1
+        setsid nohup ./node_modules/.bin/dsh web >> /tmp/dsh-web.log 2>&1 < /dev/null &
+        echo "  新进程 PID=$!"
+        sleep 8
+        curl -s --noproxy '*' -o /dev/null -w "  127.0.0.1:3080 页面 -> %{http_code}\n" http://127.0.0.1:3080/ || echo "  [警告] 页面未就绪"
+      else
+        echo "  [警告] 无法定位 dsh 可执行文件，请手动重启 dsh web"
+      fi
+    fi
+  fi
+  if [ -x "$ROOT/node_modules/.bin/dsh" ]; then
     curl -s -o /dev/null -w "  127.0.0.1:3080 页面 -> %{http_code}\n" http://127.0.0.1:3080/ || echo "  [警告] 页面未就绪，请稍后手动刷新"
     curl -s -o /dev/null -w "  $PLUGIN bundle -> %{http_code}\n" "http://127.0.0.1:3080/plugins/$PLUGIN/client.js"
   else

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mobile-ui",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "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/mobile-layout-probe.py

@@ -0,0 +1,312 @@
+#!/usr/bin/env python3
+"""dsh-mobile-ui 移动端布局探针：提问卡片（ask_user_question）可读性回归测试。
+
+## 为什么需要这个探针
+
+提问卡片曾在手机上出现「选项看不全 + 手指滑动也没反应」的故障（2026-09-11 定位修复）。
+根因不是样式不生效，而是**覆盖了上游唯一的滚动容器**：
+
+    上游 .card  { max-height: min(60vh,520px); overflow: hidden }
+    上游 .body  { overflow-y: auto }          ← 卡片内唯一的滚动容器
+    旧插件规则  .body { overflow: visible }    ← 把滚动容器废掉
+    ⇒ ① 超出卡片的选项被 card 的 overflow:hidden 直接裁掉
+      ② body 不再是滚动容器，③ 覆盖层里也没有可滚内容
+      ⇒ 手指滑动零反应，后面的选项永久不可见
+
+这类故障**静默且只在内容溢出时出现**（1~3 个选项时一切正常），靠肉眼审查 CSS 极难发现，
+所以固化成几何测量：在真实上游 CSS + 真实 DOM 嵌套 + 真实插件代码下，
+用 Playwright 断言「正文可滚 / 滚到底末项可见 / 真实触摸滑动后末项可见 / 提交按钮始终可见」。
+
+## 用法
+
+    python3 tests/mobile-layout-probe.py                 # 默认测当前安装副本
+    python3 tests/mobile-layout-probe.py --plugin ./client.js
+    python3 tests/mobile-layout-probe.py --viewport 320x568 --options 12
+
+依赖：playwright（python）+ 已安装的 dsh（用于抽取上游 CSS）。退出码非 0 表示回归。
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import pathlib
+import re
+import sys
+import tempfile
+
+DSH_NODE_MODULES = pathlib.Path(
+    os.environ.get(
+        "DSH_NODE_MODULES",
+        "/home/wbaifan/.npm-global/lib/node_modules/@deepseek-ai/dsh/node_modules/@deepseek-ai",
+    )
+)
+DEFAULT_PLUGIN = pathlib.Path.home() / ".dsh/plugins/dsh-mobile-ui/client.js"
+
+CONV_CSS_RE = r'const css\$4 = ("(?:[^"\\]|\\.)*");'
+QQ_CSS_RE = r'const css = ("(?:[^"\\]|\\.)*");'
+
+
+def extract_css(path: pathlib.Path, pattern: str, what: str) -> str:
+    """从已安装的 dsh 客户端包里抽出上游 CSS（保证复现页与线上像素级同源）。"""
+    if not path.exists():
+        raise SystemExit(f"找不到 {path}（用 DSH_NODE_MODULES 指定 dsh 安装位置）")
+    m = re.search(pattern, path.read_text(encoding="utf-8"))
+    if not m:
+        raise SystemExit(f"未能从 {path} 抽取 {what} 的 CSS（上游结构可能已变化）")
+    return eval(m.group(1))
+
+
+def build_page(plugin: pathlib.Path, options: int, detail_paras: int) -> str:
+    conv_css = extract_css(DSH_NODE_MODULES / "dsh-client-ui-conversation/lib/client.js", CONV_CSS_RE, "ConversationRoot")
+    qq_css = extract_css(DSH_NODE_MODULES / "dsh-client-ui-user-questions/lib/client.js", QQ_CSS_RE, "QuestionComposer")
+
+    detail = "".join(
+        f"<p>背景说明段落 {i + 1}：用于模拟真实场景中 detail 字段的长文本，"
+        f"它会明显占据垂直空间。</p>"
+        for i in range(detail_paras)
+    )
+    opts = "".join(
+        f"""
+        <button type="button" class="Mbwy4a_option" role="radio" aria-checked="false" aria-label="选项 {i + 1}">
+          <span class="Mbwy4a_number">{i + 1}</span>
+          <span class="Mbwy4a_optionCopy"><span class="Mbwy4a_optionLine">
+            <span class="Mbwy4a_optionLabel">选项 {i + 1}：第 {i + 1} 个候选方案的简短标题</span>
+            <span class="Mbwy4a_description">— 该方案的补充说明，用于占位真实文本长度。</span>
+          </span></span>
+        </button>"""
+        for i in range(options)
+    )
+
+    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>mobile-layout-probe</title>
+<style>
+:root{{
+  --dsw-alias-bg-base:#16171b; --dsw-alias-bg-layer-1:#1e1f24; --dsw-specific-input-major:#26272d;
+  --dsw-alias-label-primary:rgba(255,255,255,.9); --dsw-alias-border-l2:rgba(255,255,255,.14);
+  --dsw-alias-scrollbar-bg-l2:rgba(255,255,255,.2); --dsw-alias-scrollbar-hover-l2:rgba(255,255,255,.3);
+  --dsh-composer-side-clearance:12px; --dsh-composer-card-max-width:720px;
+  --dsh-chat-user-width:clamp(680px, 60vw, 860px); --dsh-scrollbar-width:0px;
+  --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}
+{qq_css}
+/* 顶层容器必须带 frame 词根：插件靠 [class*=frame] 找主布局（真实 dsh 同构） */
+#app{{height:100%;display:grid;grid-template-columns:260px minmax(0,1fr) 0px}}
+.sidebarCol{{background:#1a1b1f;border-right:1px solid rgba(255,255,255,.08)}}
+.detailsCol{{background:#1a1b1f}}
+.msg{{padding:10px 14px;margin:8px 12px;border-radius:12px;background:#22232a;line-height:1.5}}
+</style></head>
+<body>
+<div id="app" class="frame">
+  <div class="sidebarCol" data-testid="sidebar">sidebar</div>
+  <div class="wSkVaW_root" data-phase="active">
+    <div class="wSkVaW_header" style="padding:8px 12px;border-bottom:1px solid rgba(255,255,255,.08)">会话标题</div>
+    <div class="wSkVaW_body">
+      <div class="wSkVaW_scrollBody" data-conversation-scroll>
+        <div data-slot="conversation.session"><div class="wSkVaW_viewArea">
+          <div class="msg">用户：帮我看下这个方案。</div>
+          <div class="msg">助手：好的，我需要你确认几个问题。</div>
+        </div></div>
+        <div class="wSkVaW_composerSeat" data-composer-seat>
+          <div class="Mbwy4a_frame" data-question-key="probe">
+            <section class="Mbwy4a_card" aria-labelledby="q1">
+              <header class="Mbwy4a_header">
+                <div class="Mbwy4a_headingBlock">
+                  <div class="Mbwy4a_eyebrow">需要你的确认</div>
+                  <h2 class="Mbwy4a_title" id="q1">这个任务应该按哪种方式继续？请在下面选择一项。</h2>
+                </div>
+                <div class="Mbwy4a_headerActions">
+                  <button type="button" class="Mbwy4a_iconButton" aria-label="最小化">⌄</button>
+                  <button type="button" class="Mbwy4a_iconButton" aria-label="取消">✕</button>
+                </div>
+              </header>
+              <div class="Mbwy4a_body" data-question-scroll>
+                <div class="Mbwy4a_detail">{detail}</div>
+                <div class="Mbwy4a_options" role="radiogroup">{opts}
+                  <div class="Mbwy4a_customRow">
+                    <span class="Mbwy4a_number" aria-hidden="true">+</span>
+                    <input class="Mbwy4a_fieldInput" placeholder="其他（自定义回答）">
+                  </div>
+                </div>
+              </div>
+              <div class="Mbwy4a_footer">
+                <div class="Mbwy4a_footerActions"><button class="Mbwy4a_iconButton">跳过</button></div>
+                <div class="Mbwy4a_footerActions">
+                  <span class="Mbwy4a_progress">1/1</span>
+                  <button class="Mbwy4a_primary">提交</button>
+                </div>
+              </div>
+            </section>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+  <div class="detailsCol" data-testid="details">details</div>
+</div>
+<script>window.__ModuleLoader__={{mode:"queue",load:function(reg){{window.__reg=reg}}}};</script>
+<script src="file://{plugin}"></script>
+<script>window.__reg.factory(function(){{throw new Error("no require")}});window.__reg.factory;window.__plug=window.__reg;window.__plug.factory(function(){{}});</script>
+<script>try{{window.__plug.factory(function(){{}});}}catch(e){{}}</script>
+</body></html>"""
+
+
+MEASURE_JS = r"""
+() => {
+  const q = (s) => document.querySelector(s);
+  const seat = q('[data-composer-seat]');
+  const body = q('[data-question-scroll]');
+  const opts = [...document.querySelectorAll('button[class*=Mbwy4a_option]')];
+  const vis = (el) => {
+    if (!el) return {ok:false, why:'missing'};
+    const r = el.getBoundingClientRect();
+    if (!r.width || !r.height) return {ok:false, why:'zero-size'};
+    const cx = r.left + r.width/2, cy = r.top + r.height/2;
+    if (cy < 0 || cy > innerHeight) return {ok:false, why:'offscreen'};
+    const hit = document.elementFromPoint(cx, cy);
+    return {ok: !!hit && (hit === el || el.contains(hit) || hit.contains(el)), why: hit ? String(hit.className||hit.tagName) : 'null'};
+  };
+  return {
+    vp: {w: innerWidth, h: innerHeight},
+    seatQa: !!(seat && /dsh-mobile-qa/.test(seat.className)),
+    bodyOverflow: body ? getComputedStyle(body).overflowY : null,
+    bodyScroll: body ? body.scrollHeight - body.clientHeight : 0,
+    last: vis(opts[opts.length-1]),
+    submit: vis(q('[class*=Mbwy4a_primary]')),
+    // 右上角菜单按钮在提问卡片打开时必须隐藏，否则会浮在卡片右上角遮住问题标题
+    menuBtnDisplay: (() => { const m = document.getElementById('dsh-mobile-menu-btn'); return m ? getComputedStyle(m).display : null; })(),
+  };
+}
+"""
+
+
+def apply_plugin(page, plugin: pathlib.Path) -> None:
+    """在页面里按真实加载路径执行插件：注册 → factory → apply(ctx)。"""
+    page.add_script_tag(path=str(plugin))
+    page.evaluate(
+        """() => {
+          const reg = window.__reg;
+          window.__plug = reg.factory(function () { throw new Error('no require'); });
+          window.__plug.apply({ logger: { info() {} } });
+        }"""
+    )
+
+
+def probe(plugin, viewport, options, detail_paras, workdir):
+    from playwright.sync_api import sync_playwright
+
+    w, h = viewport
+    html = build_page(plugin, options, detail_paras)
+    page_path = workdir / f"probe-{options}-{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(500)
+
+        before = page.evaluate(MEASURE_JS)
+
+        # 真实手指滑动（touch 事件；滚轮不等价：移动端页面常只响应 touch）。
+        # 反复滑动直到末项可见（模拟用户持续上滑），最多 8 次；
+        # 滚不动的情况下滑多少次都不会可见 —— 因此不会掩盖真问题。
+        body = page.query_selector("[data-question-scroll]")
+        box = body.bounding_box()
+        swipes = 0
+        after_swipe = before
+        if box:
+            cx, y0, y1 = box["x"] + box["width"] / 2, box["y"] + box["height"] - 24, box["y"] + 24
+            cdp = ctx.new_cdp_session(page)
+            while swipes < 8:
+                cdp.send("Input.dispatchTouchEvent", {"type": "touchStart", "touchPoints": [{"x": cx, "y": y0}]})
+                for i in range(1, 11):
+                    cdp.send("Input.dispatchTouchEvent", {
+                        "type": "touchMove", "touchPoints": [{"x": cx, "y": y0 + (y1 - y0) * i / 10}]})
+                    page.wait_for_timeout(16)
+                cdp.send("Input.dispatchTouchEvent", {"type": "touchEnd", "touchPoints": []})
+                page.wait_for_timeout(200)
+                swipes += 1
+                after_swipe = page.evaluate(MEASURE_JS)
+                if after_swipe["last"]["ok"]:
+                    break
+        browser.close()
+
+    return {
+        "viewport": f"{w}x{h}",
+        "options": options,
+        "detail_paras": detail_paras,
+        "scrollable": (before["bodyScroll"] or 0) > 1 and before["bodyOverflow"] in ("auto", "scroll"),
+        "needs_scroll": (before["bodyScroll"] or 0) > 1,
+        "last_visible_after_swipe": after_swipe["last"]["ok"],
+        "submit_visible": before["submit"]["ok"],
+        "menu_btn_hidden_while_qa": before["menuBtnDisplay"] == "none",
+        "swipes_to_reach_last": swipes,
+        "seat_qa": before["seatQa"],
+        "detail": {"before": before, "after_swipe": after_swipe},
+    }
+
+
+def main() -> int:
+    ap = argparse.ArgumentParser(description="dsh-mobile-ui 提问卡片移动端布局探针")
+    ap.add_argument("--plugin", default=str(DEFAULT_PLUGIN), help="被测 client.js 路径")
+    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("--json", action="store_true", help="输出 JSON")
+    args = ap.parse_args()
+
+    plugin = pathlib.Path(args.plugin).expanduser()
+    if not plugin.exists():
+        raise SystemExit(f"被测插件不存在：{plugin}")
+
+    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]
+
+    results = []
+    with tempfile.TemporaryDirectory(prefix="dsh-mobile-probe-") as tmp:
+        for vp in viewports:
+            for n in options_list:
+                results.append(probe(plugin, vp, n, args.detail_paras, pathlib.Path(tmp)))
+
+    failures = [
+        r for r in results
+        if not r["last_visible_after_swipe"] or not r["submit_visible"]
+        or not r["menu_btn_hidden_while_qa"] or (r["needs_scroll"] and not r["scrollable"])
+    ]
+
+    if args.json:
+        # 纯 JSON 输出（供 CI/脚本消费）；结论用退出码表达
+        print(json.dumps({"ok": not failures, "results": results}, ensure_ascii=False, indent=2))
+        return 1 if failures else 0
+    else:
+        print(f"被测插件: {plugin}")
+        print(f"{'视口':<10} {'选项数':<7} {'内容溢出':<9} {'正文可滚':<9} {'滑动后末项可见':<15} {'提交可见':<9} {'菜单不遮挡':<10}")
+        print("-" * 78)
+        for r in results:
+            print(f"{r['viewport']:<10} {r['options']:<8} {'是' if r['needs_scroll'] else '否':<10} "
+                  f"{'✓' if r['scrollable'] else ('—' if not r['needs_scroll'] else '✗'):<10} "
+                  f"{'✓' if r['last_visible_after_swipe'] else '✗':<16} {'✓' if r['submit_visible'] else '✗':<10} "
+                  f"{'✓' if r['menu_btn_hidden_while_qa'] else '✗':<10}")
+
+    print()
+    if failures:
+        print(f"❌ 回归：{len(failures)} 个用例不达标（选项被裁 / 滚动失效 / 提交按钮不可见）")
+        for r in failures:
+            print(f"   - {r['viewport']} options={r['options']}: {r['detail']['before']}")
+        return 1
+    print(f"✅ 全部 {len(results)} 个用例通过：选项可滚可见、提交按钮始终可见、菜单按钮不遮挡卡片")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())