@qzsy/dsh-bridge 3.3.0 → 3.3.1

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # 更新日志
 
+## [v3.3.1] - 2026-11-02
+
+### 🐛 修复
+
+- **全面屏安全区**：菜单按钮、内容区、抽屉都按 `safe-area-inset-*` 让位，刘海 / 状态栏 / 底部 home indicator 不再遮挡；横屏左右安全区同样生效。
+- **首次加载闪动**：侧栏首帧先无动画隐藏，再启用 280ms 过渡，页面加载时不再看到侧栏从 0 滑出。
+
+### ✨ 改进
+
+- **手势滑动**：支持左缘右滑打开、抽屉内左滑关闭；拖动时抽屉跟手、遮罩同步渐变，松手按距离/速度吸附。
+- **手势防误触**：纵向滚动不触发抽屉；滑动后的合成点击会被吞掉，避免误开/误关会话。
+
+### 🧪 验证
+
+- 模拟 47px 顶部 / 34px 底部安全区：按钮 y=57、内容 padding-top=99px，抽屉 padding 47/34 全部生效。
+- 模拟触摸：拖动中 `translateX=-150px`、松手打开；抽屉内左滑关闭；纵向滑动不误开；9/9 通过。
+
+
 ## [v3.3.0] - 2026-11-02
 
 ### ✨ 新增

package/README.md

@@ -47,6 +47,8 @@ dsh plugin --profile <name> add @qzsy/dsh-bridge
 窄屏（≤ 767px）访问 DSH 时，插件会自动把左侧栏改成抽屉，不需要额外配置：
 
 - 内容区占满屏宽，左上角「菜单」按钮打开会话 / 工作区 / 插件入口；
+- 支持手势：左缘向右滑打开、抽屉内向左滑关闭，拖动时跟手，松手吸附；
+- 全面屏自动避开安全区：刘海 / 状态栏 / 底部 home indicator 不遮挡内容；
 - 点遮罩、点会话行、按 Esc 或转回桌面宽度都会自动收起；
 - 桌面端保持 DSH 原生布局，不受影响。
 

package/client/client.js

@@ -220,27 +220,62 @@ var MOBILE_MAX_WIDTH = 767;
 var MOBILE_DRAWER_CSS_ID = "qzsy-mobile-drawer-styles";
 var MOBILE_UI_FLAG = "data-qzsy-mobile-drawer";
 var OPEN_CLASS = "qzsy-drawer-open";
+var DRAGGING_CLASS = "qzsy-drawer-dragging";
+var HEADER_CLASS = "qzsy-mobile-header";
 var MENU_CLASS = "qzsy-mobile-menu-btn";
 var BACKDROP_CLASS = "qzsy-mobile-backdrop";
 var STYLE_PLUGIN = "@qzsy/dsh-bridge";
+var EDGE_START_ZONE = 28;
+var DRAG_THRESHOLD = 8;
 var MOBILE_DRAWER_CSS = `
-.qzsy-mobile-menu-btn,
+:root {
+  --qzsy-safe-top: env(safe-area-inset-top, 0px);
+  --qzsy-safe-bottom: env(safe-area-inset-bottom, 0px);
+  --qzsy-safe-left: env(safe-area-inset-left, 0px);
+  --qzsy-safe-right: env(safe-area-inset-right, 0px);
+}
+
+.qzsy-mobile-header,
 .qzsy-mobile-backdrop {
   display: none;
 }
 
+/* \u83DC\u5355\u6309\u94AE\u5BB9\u5668\uFF1A\u59CB\u7EC8\u5728\u5BBF\u4E3B\u4E4B\u4E0A\uFF1B\u5BB9\u5668\u81EA\u8EAB\u4E0D\u62E6\u622A\u70B9\u51FB */
+.qzsy-mobile-header {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  z-index: 65;
+  box-sizing: border-box;
+  align-items: flex-end;
+  padding-top: 10px;
+  padding-top: calc(10px + var(--qzsy-safe-top, 0px));
+  padding-right: 10px;
+  padding-right: calc(10px + var(--qzsy-safe-right, 0px));
+  padding-bottom: 2px;
+  padding-left: 10px;
+  padding-left: calc(10px + var(--qzsy-safe-left, 0px));
+  pointer-events: none;
+}
+
 @media (max-width: 767px) {
-  /* 1. \u5DE6\u4FA7\u680F\u8131\u79BB grid\uFF0C\u5185\u5BB9\u5360\u6EE1\uFF1B\u9876\u90E8\u7559\u51FA 52px \u7ED9\u83DC\u5355\u6309\u94AE */
+  .qzsy-mobile-header { display: flex; }
+
+  /* 1. \u5DE6\u4FA7\u680F\u8131\u79BB grid\uFF0C\u5185\u5BB9\u5360\u6EE1\uFF1B\u9876\u90E8\u7ED9\u83DC\u5355\u6309\u94AE\u7559\u51FA\u5B89\u5168\u533A\u9AD8\u5EA6 */
   [data-slot="root"] > div[class*="_frame"] {
     grid-template-columns: 0px minmax(0px, 1fr) minmax(0px, 0px) !important;
-    padding-top: 52px !important;
     box-sizing: border-box !important;
+    padding-top: 52px !important;
+    padding-top: calc(52px + var(--qzsy-safe-top, 0px)) !important;
+    padding-bottom: 0 !important;
+    padding-bottom: var(--qzsy-safe-bottom, 0px) !important;
   }
   div[class*="_centerCol"] { grid-column: 2 !important; }
   div[class*="_rightbarCol"] { grid-column: 3 !important; }
   div[class*="_overlayLayer"] { grid-column: 1 / -1 !important; }
 
-  /* 2. \u539F\u751F\u4FA7\u680F\u6539\u4E3A fixed \u62BD\u5C49\uFF08\u9ED8\u8BA4\u85CF\u5728\u5C4F\u5E55\u5DE6\u4FA7\uFF09 */
+  /* 2. \u539F\u751F\u4FA7\u680F\u6539\u4E3A fixed \u62BD\u5C49\uFF08\u9ED8\u8BA4\u85CF\u5728\u5C4F\u5E55\u5DE6\u4FA7\uFF1B\u5185\u90E8\u907F\u5F00\u5B89\u5168\u533A\uFF09 */
   div[class*="_sidebarCol"] {
     position: fixed !important;
     top: 0 !important;
@@ -250,16 +285,26 @@ var MOBILE_DRAWER_CSS = `
     max-width: 84vw !important;
     height: 100vh !important;
     height: 100dvh !important;
+    box-sizing: border-box !important;
+    padding-top: 0 !important;
+    padding-top: var(--qzsy-safe-top, 0px) !important;
+    padding-bottom: 0 !important;
+    padding-bottom: var(--qzsy-safe-bottom, 0px) !important;
+    padding-left: 0 !important;
+    padding-left: var(--qzsy-safe-left, 0px) !important;
     z-index: 60 !important;
     background: var(--dsw-alias-bg-layer-1, #ffffff) !important;
     border-right: 1px solid var(--dsw-alias-border-l2, rgba(0, 0, 0, 0.08)) !important;
     box-shadow: none !important;
     transform: translateX(-102%) !important;
-    transition: transform 280ms cubic-bezier(0.16, 1, 0.3, 1) !important;
     overflow: hidden !important;
     overscroll-behavior: contain;
     will-change: transform;
   }
+  /* \u9996\u5E27\u5148\u5C31\u4F4D\u3001\u4E0D\u64AD\u653E\u5165\u573A\u52A8\u753B\uFF0C\u907F\u514D\u9875\u9762\u52A0\u8F7D\u65F6\u4FA7\u680F\u4ECE 0 \u6ED1\u51FA */
+  body.qzsy-drawer-ready div[class*="_sidebarCol"] {
+    transition: transform 280ms cubic-bezier(0.16, 1, 0.3, 1) !important;
+  }
   body.qzsy-drawer-open div[class*="_sidebarCol"] {
     transform: translateX(0) !important;
     box-shadow: 8px 0 32px rgba(0, 0, 0, 0.18) !important;
@@ -268,6 +313,17 @@ var MOBILE_DRAWER_CSS = `
     width: 100% !important;
   }
 
+  /* \u62D6\u52A8\u4E2D\uFF1A\u5173\u95ED\u8FC7\u6E21\uFF0Ctransform/\u906E\u7F69\u76F4\u63A5\u8DDF\u624B */
+  body.qzsy-drawer-dragging div[class*="_sidebarCol"] {
+    transition: none !important;
+    transform: translateX(var(--qzsy-drawer-x, -102%)) !important;
+  }
+  body.qzsy-drawer-dragging .qzsy-mobile-backdrop {
+    transition: none !important;
+    opacity: var(--qzsy-drawer-progress, 0) !important;
+    pointer-events: auto !important;
+  }
+
   /* 3. \u534A\u900F\u660E\u906E\u7F69\uFF1A\u70B9\u51FB\u6536\u8D77 */
   .qzsy-mobile-backdrop {
     display: block;
@@ -286,17 +342,13 @@ var MOBILE_DRAWER_CSS = `
     pointer-events: auto;
   }
 
-  /* 4. \u9876\u90E8\u83DC\u5355\u6309\u94AE\uFF08\u4F4D\u4E8E 52px \u7559\u767D\u6761\u5185\uFF0C\u907F\u514D\u906E\u6321\u4F1A\u8BDD\u6807\u9898\uFF09 */
+  /* 4. \u83DC\u5355\u6309\u94AE\uFF1A\u4F4D\u4E8E\u5B89\u5168\u533A\u4E0B\u65B9\u7684 52px \u7559\u767D\u6761\u5185 */
   .qzsy-mobile-menu-btn {
     display: inline-flex;
-    position: fixed;
-    top: 10px;
-    left: 10px;
-    width: 40px;
-    height: 40px;
-    z-index: 65;
     align-items: center;
     justify-content: center;
+    width: 40px;
+    height: 40px;
     padding: 0;
     border: 1px solid var(--dsw-alias-border-l2, rgba(0, 0, 0, 0.1));
     border-radius: 12px;
@@ -304,6 +356,7 @@ var MOBILE_DRAWER_CSS = `
     color: var(--dsw-alias-label-primary, #111827);
     box-shadow: 0 2px 10px rgba(0, 0, 0, 0.08);
     cursor: pointer;
+    pointer-events: auto;
     -webkit-tap-highlight-color: transparent;
     transition: opacity 180ms ease, transform 180ms ease;
   }
@@ -336,6 +389,10 @@ function injectStyles() {
   }
   if (style.textContent !== MOBILE_DRAWER_CSS) style.textContent = MOBILE_DRAWER_CSS;
 }
+function drawerWidth() {
+  if (typeof window === "undefined") return 300;
+  return Math.min(300, Math.round(window.innerWidth * 0.84));
+}
 function setupMobileDrawer() {
   if (typeof document === "undefined" || typeof window === "undefined") return () => {
   };
@@ -346,16 +403,24 @@ function setupMobileDrawer() {
   let menuBtn = null;
   let observer = null;
   let disposed = false;
+  let gesture = null;
+  let suppressClickUntil = 0;
   const ensureElements = () => {
     if (disposed || !document.body) return;
     injectStyles();
-    let btn = document.querySelector(`.${MENU_CLASS}`);
+    let header = document.querySelector(`.${HEADER_CLASS}`);
+    if (!header) {
+      header = document.createElement("div");
+      header.className = HEADER_CLASS;
+      document.body.appendChild(header);
+    }
+    let btn = header.querySelector(`.${MENU_CLASS}`);
     if (!btn) {
       btn = document.createElement("button");
       btn.type = "button";
       btn.className = MENU_CLASS;
       btn.innerHTML = '<svg width="22" height="22" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" aria-hidden="true"><line x1="3" y1="8" x2="21" y2="8"></line><line x1="3" y1="15" x2="15" y2="15"></line></svg>';
-      document.body.appendChild(btn);
+      header.appendChild(btn);
     }
     let mask = document.querySelector(`.${BACKDROP_CLASS}`);
     if (!mask) {
@@ -386,6 +451,15 @@ function setupMobileDrawer() {
       }
     }
   };
+  const setDragProgress = (x, width) => {
+    document.body.style.setProperty("--qzsy-drawer-x", `${x}px`);
+    document.body.style.setProperty("--qzsy-drawer-progress", String(Math.max(0, Math.min(1, 1 - Math.abs(x) / width))));
+  };
+  const clearDrag = () => {
+    document.body.classList.remove(DRAGGING_CLASS);
+    document.body.style.removeProperty("--qzsy-drawer-x");
+    document.body.style.removeProperty("--qzsy-drawer-progress");
+  };
   const openDrawer = () => {
     if (disposed || !isMobileViewport() || !document.body) return;
     ensureElements();
@@ -411,6 +485,11 @@ function setupMobileDrawer() {
     }, 60);
   };
   const onClick = (event) => {
+    if (Date.now() < suppressClickUntil) {
+      event.preventDefault();
+      event.stopPropagation();
+      return;
+    }
     const target = event.target;
     if (!isElement(target)) return;
     if (target.closest(`.${MENU_CLASS}`)) {
@@ -447,10 +526,106 @@ function setupMobileDrawer() {
     if (event.key === "Escape" && isOpen()) closeDrawer();
   };
   const onResize = () => {
-    if (!isMobileViewport() && isOpen()) closeDrawer({ restoreFocus: false });
+    if (!isMobileViewport() && isOpen()) {
+      gesture = null;
+      clearDrag();
+      closeDrawer({ restoreFocus: false });
+    }
   };
   const onVisibilityChange = () => {
-    if (document.visibilityState === "hidden" && isOpen()) closeDrawer({ restoreFocus: false });
+    if (document.visibilityState === "hidden" && isOpen()) {
+      gesture = null;
+      clearDrag();
+      closeDrawer({ restoreFocus: false });
+    }
+  };
+  const onTouchStart = (event) => {
+    if (disposed || !isMobileViewport() || event.touches?.length !== 1) return;
+    const touch = event.touches[0];
+    const sidebar = document.querySelector('div[class*="_sidebarCol"]');
+    if (!sidebar) return;
+    const open = isOpen();
+    if (!open) {
+      if (touch.clientX > EDGE_START_ZONE) return;
+      ensureSidebarExpanded();
+      gesture = {
+        mode: "open",
+        startX: touch.clientX,
+        startY: touch.clientY,
+        startT: Date.now(),
+        width: drawerWidth(),
+        active: false,
+        dx: 0
+      };
+      return;
+    }
+    if (!sidebar.contains(event.target)) return;
+    if (event.target.closest?.('input, textarea, select, [contenteditable="true"]')) return;
+    gesture = {
+      mode: "close",
+      startX: touch.clientX,
+      startY: touch.clientY,
+      startT: Date.now(),
+      width: drawerWidth(),
+      active: false,
+      dx: 0
+    };
+  };
+  const onTouchMove = (event) => {
+    if (!gesture || disposed) return;
+    const touch = event.touches?.[0];
+    if (!touch) return;
+    const dx = touch.clientX - gesture.startX;
+    const dy = touch.clientY - gesture.startY;
+    if (!gesture.active) {
+      if (Math.abs(dx) < DRAG_THRESHOLD) return;
+      if (Math.abs(dx) < Math.abs(dy) * 1.2) {
+        gesture = null;
+        return;
+      }
+      if (gesture.mode === "open" && dx <= 0) {
+        gesture = null;
+        return;
+      }
+      if (gesture.mode === "close" && dx >= 0) {
+        gesture = null;
+        return;
+      }
+      gesture.active = true;
+      suppressClickUntil = Date.now() + 450;
+      document.body.classList.add(DRAGGING_CLASS);
+    }
+    const width = Math.max(1, gesture.width);
+    let x;
+    if (gesture.mode === "open") x = Math.max(-width, Math.min(0, -width + dx));
+    else x = Math.max(-width, Math.min(0, dx));
+    gesture.dx = dx;
+    setDragProgress(x, width);
+  };
+  const finishGesture = (touch) => {
+    if (!gesture) return;
+    const current = gesture;
+    gesture = null;
+    if (!current.active) return;
+    const endX = touch ? touch.clientX : current.startX + current.dx;
+    const dx = endX - current.startX;
+    const elapsed = Math.max(1, Date.now() - current.startT);
+    const velocity = dx / elapsed;
+    const threshold = Math.min(90, Math.max(60, current.width * 0.3));
+    const openNow = current.mode === "open" ? dx > threshold || velocity > 0.45 : !(dx < -Math.max(50, threshold * 0.7) || velocity < -0.35);
+    document.body.classList.toggle(OPEN_CLASS, openNow);
+    if (openNow) ensureSidebarExpanded();
+    syncAria();
+    suppressClickUntil = Date.now() + 250;
+    window.requestAnimationFrame(clearDrag);
+  };
+  const onTouchEnd = (event) => {
+    if (!gesture) return;
+    finishGesture(event.changedTouches?.[0]);
+  };
+  const onTouchCancel = () => {
+    if (!gesture) return;
+    finishGesture(null);
   };
   injectStyles();
   ensureElements();
@@ -458,9 +633,16 @@ function setupMobileDrawer() {
   document.addEventListener("keydown", onKeyDown, true);
   document.addEventListener("visibilitychange", onVisibilityChange);
   window.addEventListener("resize", onResize);
+  window.addEventListener("touchstart", onTouchStart, { passive: true });
+  window.addEventListener("touchmove", onTouchMove, { passive: true });
+  window.addEventListener("touchend", onTouchEnd, { passive: true });
+  window.addEventListener("touchcancel", onTouchCancel, { passive: true });
+  window.requestAnimationFrame(() => {
+    if (!disposed && document.body) document.body.classList.add("qzsy-drawer-ready");
+  });
   if (typeof MutationObserver === "function" && document.body) {
     observer = new MutationObserver(() => {
-      if (!document.querySelector(`.${MENU_CLASS}`) || !document.querySelector(`.${BACKDROP_CLASS}`) || !document.getElementById(MOBILE_DRAWER_CSS_ID)) {
+      if (!document.querySelector(`.${HEADER_CLASS}`) || !document.querySelector(`.${MENU_CLASS}`) || !document.querySelector(`.${BACKDROP_CLASS}`) || !document.getElementById(MOBILE_DRAWER_CSS_ID)) {
         ensureElements();
       }
     });
@@ -469,6 +651,7 @@ function setupMobileDrawer() {
   syncAria();
   return () => {
     disposed = true;
+    gesture = null;
     try {
       observer?.disconnect();
     } catch {
@@ -477,8 +660,14 @@ function setupMobileDrawer() {
     document.removeEventListener("keydown", onKeyDown, true);
     document.removeEventListener("visibilitychange", onVisibilityChange);
     window.removeEventListener("resize", onResize);
+    window.removeEventListener("touchstart", onTouchStart);
+    window.removeEventListener("touchmove", onTouchMove);
+    window.removeEventListener("touchend", onTouchEnd);
+    window.removeEventListener("touchcancel", onTouchCancel);
+    clearDrag();
     document.body?.classList.remove(OPEN_CLASS);
-    document.querySelector(`.${MENU_CLASS}`)?.remove();
+    document.body?.classList.remove("qzsy-drawer-ready");
+    document.querySelector(`.${HEADER_CLASS}`)?.remove();
     document.querySelector(`.${BACKDROP_CLASS}`)?.remove();
     document.getElementById(MOBILE_DRAWER_CSS_ID)?.remove();
     root.removeAttribute(MOBILE_UI_FLAG);

package/client/mobile.js

@@ -1,42 +1,78 @@
 // 移动端抽屉导航：把宿主左侧栏（会话/工作区菜单）改成从左侧滑出的 sheet。
 //
-// 背景：DSH 宿主在窄屏下仍把左侧栏压成 56px 图标轨道，展开后会把内容区挤到
-// 110px（实测 390×844）。这里只做一件事：窄屏时内容占满，左侧栏变成带遮罩的
-// 抽屉，由顶部菜单按钮打开；桌面端完全不受影响。
+// 设计目标（对齐 tmp/dsh-bridge 的移动端体验，但只保留本项目需要的部分）：
+// - 窄屏内容占满屏宽，左侧栏变成带遮罩的抽屉；
+// - 支持全面屏安全区（刘海/状态栏/home indicator），菜单按钮和抽屉内容都不被遮挡；
+// - 支持手势：左缘右滑打开、抽屉内左滑关闭，拖动时抽屉跟随手指，松手吸附；
+// - 桌面端完全不受影响。
 //
 // 宿主 DOM 是 CSS Modules 哈希类名，本模块只依赖稳定结构/ARIA：
 //   div[class*="_frame"] / _sidebarCol / _centerCol / _rightbarCol / _overlayLayer
 //   button[aria-label*="打开侧边栏"]（英文 Open sidebar）
 //   div[class*="sessionRow"]（会话行；projectRow 是工作区分组，不能误关）
-// 不写死任何宿主哈希，宿主升级换前缀时选择器仍有效。
 import { createTranslator } from './locales.mjs';
 
 export const MOBILE_MAX_WIDTH = 767;
 export const MOBILE_DRAWER_CSS_ID = 'qzsy-mobile-drawer-styles';
 export const MOBILE_UI_FLAG = 'data-qzsy-mobile-drawer';
 const OPEN_CLASS = 'qzsy-drawer-open';
+const DRAGGING_CLASS = 'qzsy-drawer-dragging';
+const HEADER_CLASS = 'qzsy-mobile-header';
 const MENU_CLASS = 'qzsy-mobile-menu-btn';
 const BACKDROP_CLASS = 'qzsy-mobile-backdrop';
 const STYLE_PLUGIN = '@qzsy/dsh-bridge';
+const EDGE_START_ZONE = 28;
+const DRAG_THRESHOLD = 8;
 
 export const MOBILE_DRAWER_CSS = `
-.qzsy-mobile-menu-btn,
+:root {
+  --qzsy-safe-top: env(safe-area-inset-top, 0px);
+  --qzsy-safe-bottom: env(safe-area-inset-bottom, 0px);
+  --qzsy-safe-left: env(safe-area-inset-left, 0px);
+  --qzsy-safe-right: env(safe-area-inset-right, 0px);
+}
+
+.qzsy-mobile-header,
 .qzsy-mobile-backdrop {
   display: none;
 }
 
+/* 菜单按钮容器：始终在宿主之上；容器自身不拦截点击 */
+.qzsy-mobile-header {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  z-index: 65;
+  box-sizing: border-box;
+  align-items: flex-end;
+  padding-top: 10px;
+  padding-top: calc(10px + var(--qzsy-safe-top, 0px));
+  padding-right: 10px;
+  padding-right: calc(10px + var(--qzsy-safe-right, 0px));
+  padding-bottom: 2px;
+  padding-left: 10px;
+  padding-left: calc(10px + var(--qzsy-safe-left, 0px));
+  pointer-events: none;
+}
+
 @media (max-width: 767px) {
-  /* 1. 左侧栏脱离 grid，内容占满；顶部留出 52px 给菜单按钮 */
+  .qzsy-mobile-header { display: flex; }
+
+  /* 1. 左侧栏脱离 grid，内容占满；顶部给菜单按钮留出安全区高度 */
   [data-slot="root"] > div[class*="_frame"] {
     grid-template-columns: 0px minmax(0px, 1fr) minmax(0px, 0px) !important;
-    padding-top: 52px !important;
     box-sizing: border-box !important;
+    padding-top: 52px !important;
+    padding-top: calc(52px + var(--qzsy-safe-top, 0px)) !important;
+    padding-bottom: 0 !important;
+    padding-bottom: var(--qzsy-safe-bottom, 0px) !important;
   }
   div[class*="_centerCol"] { grid-column: 2 !important; }
   div[class*="_rightbarCol"] { grid-column: 3 !important; }
   div[class*="_overlayLayer"] { grid-column: 1 / -1 !important; }
 
-  /* 2. 原生侧栏改为 fixed 抽屉（默认藏在屏幕左侧） */
+  /* 2. 原生侧栏改为 fixed 抽屉（默认藏在屏幕左侧；内部避开安全区） */
   div[class*="_sidebarCol"] {
     position: fixed !important;
     top: 0 !important;
@@ -46,16 +82,26 @@ export const MOBILE_DRAWER_CSS = `
     max-width: 84vw !important;
     height: 100vh !important;
     height: 100dvh !important;
+    box-sizing: border-box !important;
+    padding-top: 0 !important;
+    padding-top: var(--qzsy-safe-top, 0px) !important;
+    padding-bottom: 0 !important;
+    padding-bottom: var(--qzsy-safe-bottom, 0px) !important;
+    padding-left: 0 !important;
+    padding-left: var(--qzsy-safe-left, 0px) !important;
     z-index: 60 !important;
     background: var(--dsw-alias-bg-layer-1, #ffffff) !important;
     border-right: 1px solid var(--dsw-alias-border-l2, rgba(0, 0, 0, 0.08)) !important;
     box-shadow: none !important;
     transform: translateX(-102%) !important;
-    transition: transform 280ms cubic-bezier(0.16, 1, 0.3, 1) !important;
     overflow: hidden !important;
     overscroll-behavior: contain;
     will-change: transform;
   }
+  /* 首帧先就位、不播放入场动画，避免页面加载时侧栏从 0 滑出 */
+  body.qzsy-drawer-ready div[class*="_sidebarCol"] {
+    transition: transform 280ms cubic-bezier(0.16, 1, 0.3, 1) !important;
+  }
   body.qzsy-drawer-open div[class*="_sidebarCol"] {
     transform: translateX(0) !important;
     box-shadow: 8px 0 32px rgba(0, 0, 0, 0.18) !important;
@@ -64,6 +110,17 @@ export const MOBILE_DRAWER_CSS = `
     width: 100% !important;
   }
 
+  /* 拖动中：关闭过渡，transform/遮罩直接跟手 */
+  body.qzsy-drawer-dragging div[class*="_sidebarCol"] {
+    transition: none !important;
+    transform: translateX(var(--qzsy-drawer-x, -102%)) !important;
+  }
+  body.qzsy-drawer-dragging .qzsy-mobile-backdrop {
+    transition: none !important;
+    opacity: var(--qzsy-drawer-progress, 0) !important;
+    pointer-events: auto !important;
+  }
+
   /* 3. 半透明遮罩：点击收起 */
   .qzsy-mobile-backdrop {
     display: block;
@@ -82,17 +139,13 @@ export const MOBILE_DRAWER_CSS = `
     pointer-events: auto;
   }
 
-  /* 4. 顶部菜单按钮（位于 52px 留白条内，避免遮挡会话标题） */
+  /* 4. 菜单按钮：位于安全区下方的 52px 留白条内 */
   .qzsy-mobile-menu-btn {
     display: inline-flex;
-    position: fixed;
-    top: 10px;
-    left: 10px;
-    width: 40px;
-    height: 40px;
-    z-index: 65;
     align-items: center;
     justify-content: center;
+    width: 40px;
+    height: 40px;
     padding: 0;
     border: 1px solid var(--dsw-alias-border-l2, rgba(0, 0, 0, 0.1));
     border-radius: 12px;
@@ -100,6 +153,7 @@ export const MOBILE_DRAWER_CSS = `
     color: var(--dsw-alias-label-primary, #111827);
     box-shadow: 0 2px 10px rgba(0, 0, 0, 0.08);
     cursor: pointer;
+    pointer-events: auto;
     -webkit-tap-highlight-color: transparent;
     transition: opacity 180ms ease, transform 180ms ease;
   }
@@ -137,6 +191,11 @@ function injectStyles() {
   if (style.textContent !== MOBILE_DRAWER_CSS) style.textContent = MOBILE_DRAWER_CSS;
 }
 
+function drawerWidth() {
+  if (typeof window === 'undefined') return 300;
+  return Math.min(300, Math.round(window.innerWidth * 0.84));
+}
+
 /**
  * 安装移动端抽屉导航。无 DOM 环境（单测/SSR）安全退化为 no-op。
  * 返回 disposer；宿主若支持 ctx.effect，可注册为插件副作用。
@@ -150,18 +209,26 @@ export function setupMobileDrawer() {
   let menuBtn = null;
   let observer = null;
   let disposed = false;
+  let gesture = null;
+  let suppressClickUntil = 0;
 
   const ensureElements = () => {
     if (disposed || !document.body) return;
     injectStyles();
 
-    let btn = document.querySelector(`.${MENU_CLASS}`);
+    let header = document.querySelector(`.${HEADER_CLASS}`);
+    if (!header) {
+      header = document.createElement('div');
+      header.className = HEADER_CLASS;
+      document.body.appendChild(header);
+    }
+    let btn = header.querySelector(`.${MENU_CLASS}`);
     if (!btn) {
       btn = document.createElement('button');
       btn.type = 'button';
       btn.className = MENU_CLASS;
       btn.innerHTML = '<svg width="22" height="22" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.2" stroke-linecap="round" aria-hidden="true"><line x1="3" y1="8" x2="21" y2="8"></line><line x1="3" y1="15" x2="15" y2="15"></line></svg>';
-      document.body.appendChild(btn);
+      header.appendChild(btn);
     }
     let mask = document.querySelector(`.${BACKDROP_CLASS}`);
     if (!mask) {
@@ -194,6 +261,17 @@ export function setupMobileDrawer() {
     }
   };
 
+  const setDragProgress = (x, width) => {
+    document.body.style.setProperty('--qzsy-drawer-x', `${x}px`);
+    document.body.style.setProperty('--qzsy-drawer-progress', String(Math.max(0, Math.min(1, 1 - Math.abs(x) / width))));
+  };
+
+  const clearDrag = () => {
+    document.body.classList.remove(DRAGGING_CLASS);
+    document.body.style.removeProperty('--qzsy-drawer-x');
+    document.body.style.removeProperty('--qzsy-drawer-progress');
+  };
+
   const openDrawer = () => {
     if (disposed || !isMobileViewport() || !document.body) return;
     ensureElements();
@@ -219,6 +297,11 @@ export function setupMobileDrawer() {
   };
 
   const onClick = (event) => {
+    if (Date.now() < suppressClickUntil) {
+      event.preventDefault();
+      event.stopPropagation();
+      return;
+    }
     const target = event.target;
     if (!isElement(target)) return;
 
@@ -265,11 +348,115 @@ export function setupMobileDrawer() {
   };
 
   const onResize = () => {
-    if (!isMobileViewport() && isOpen()) closeDrawer({ restoreFocus: false });
+    if (!isMobileViewport() && isOpen()) {
+      gesture = null;
+      clearDrag();
+      closeDrawer({ restoreFocus: false });
+    }
   };
 
   const onVisibilityChange = () => {
-    if (document.visibilityState === 'hidden' && isOpen()) closeDrawer({ restoreFocus: false });
+    if (document.visibilityState === 'hidden' && isOpen()) {
+      gesture = null;
+      clearDrag();
+      closeDrawer({ restoreFocus: false });
+    }
+  };
+
+  // ---- 手势：左缘右滑打开；抽屉内左滑关闭；拖动跟手 ----
+  const onTouchStart = (event) => {
+    if (disposed || !isMobileViewport() || event.touches?.length !== 1) return;
+    const touch = event.touches[0];
+    const sidebar = document.querySelector('div[class*="_sidebarCol"]');
+    if (!sidebar) return;
+    const open = isOpen();
+
+    if (!open) {
+      if (touch.clientX > EDGE_START_ZONE) return;
+      // 先把宿主侧栏展开，保证拖动时抽屉里有完整会话列表
+      ensureSidebarExpanded();
+      gesture = {
+        mode: 'open',
+        startX: touch.clientX,
+        startY: touch.clientY,
+        startT: Date.now(),
+        width: drawerWidth(),
+        active: false,
+        dx: 0,
+      };
+      return;
+    }
+
+    if (!sidebar.contains(event.target)) return;
+    if (event.target.closest?.('input, textarea, select, [contenteditable="true"]')) return;
+    gesture = {
+      mode: 'close',
+      startX: touch.clientX,
+      startY: touch.clientY,
+      startT: Date.now(),
+      width: drawerWidth(),
+      active: false,
+      dx: 0,
+    };
+  };
+
+  const onTouchMove = (event) => {
+    if (!gesture || disposed) return;
+    const touch = event.touches?.[0];
+    if (!touch) return;
+    const dx = touch.clientX - gesture.startX;
+    const dy = touch.clientY - gesture.startY;
+
+    if (!gesture.active) {
+      if (Math.abs(dx) < DRAG_THRESHOLD) return;
+      // 纵向为主：交还给宿主滚动，本次不拦截
+      if (Math.abs(dx) < Math.abs(dy) * 1.2) { gesture = null; return; }
+      if (gesture.mode === 'open' && dx <= 0) { gesture = null; return; }
+      if (gesture.mode === 'close' && dx >= 0) { gesture = null; return; }
+      gesture.active = true;
+      suppressClickUntil = Date.now() + 450;
+      document.body.classList.add(DRAGGING_CLASS);
+    }
+
+    const width = Math.max(1, gesture.width);
+    let x;
+    if (gesture.mode === 'open') x = Math.max(-width, Math.min(0, -width + dx));
+    else x = Math.max(-width, Math.min(0, dx));
+    gesture.dx = dx;
+    setDragProgress(x, width);
+  };
+
+  const finishGesture = (touch) => {
+    if (!gesture) return;
+    const current = gesture;
+    gesture = null;
+    if (!current.active) return;
+
+    const endX = touch ? touch.clientX : current.startX + current.dx;
+    const dx = endX - current.startX;
+    const elapsed = Math.max(1, Date.now() - current.startT);
+    const velocity = dx / elapsed;
+    const threshold = Math.min(90, Math.max(60, current.width * 0.3));
+    const openNow = current.mode === 'open'
+      ? dx > threshold || velocity > 0.45
+      : !(dx < -Math.max(50, threshold * 0.7) || velocity < -0.35);
+
+    document.body.classList.toggle(OPEN_CLASS, openNow);
+    if (openNow) ensureSidebarExpanded();
+    syncAria();
+    suppressClickUntil = Date.now() + 250;
+    // 等一帧让浏览器接住当前拖动位置，再撤掉拖动样式做吸附动画
+    window.requestAnimationFrame(clearDrag);
+  };
+
+  const onTouchEnd = (event) => {
+    if (!gesture) return;
+    finishGesture(event.changedTouches?.[0]);
+  };
+
+  const onTouchCancel = () => {
+    if (!gesture) return;
+    finishGesture(null);
   };
 
   injectStyles();
@@ -278,10 +465,19 @@ export function setupMobileDrawer() {
   document.addEventListener('keydown', onKeyDown, true);
   document.addEventListener('visibilitychange', onVisibilityChange);
   window.addEventListener('resize', onResize);
+  window.addEventListener('touchstart', onTouchStart, { passive: true });
+  window.addEventListener('touchmove', onTouchMove, { passive: true });
+  window.addEventListener('touchend', onTouchEnd, { passive: true });
+  window.addEventListener('touchcancel', onTouchCancel, { passive: true });
+
+  // 等侧栏先无动画地藏到屏幕外，再启用过渡（否则首次加载会看到 280ms 滑出）
+  window.requestAnimationFrame(() => {
+    if (!disposed && document.body) document.body.classList.add('qzsy-drawer-ready');
+  });
 
   if (typeof MutationObserver === 'function' && document.body) {
     observer = new MutationObserver(() => {
-      if (!document.querySelector(`.${MENU_CLASS}`) || !document.querySelector(`.${BACKDROP_CLASS}`) || !document.getElementById(MOBILE_DRAWER_CSS_ID)) {
+      if (!document.querySelector(`.${HEADER_CLASS}`) || !document.querySelector(`.${MENU_CLASS}`) || !document.querySelector(`.${BACKDROP_CLASS}`) || !document.getElementById(MOBILE_DRAWER_CSS_ID)) {
         ensureElements();
       }
     });
@@ -292,13 +488,20 @@ export function setupMobileDrawer() {
 
   return () => {
     disposed = true;
+    gesture = null;
     try { observer?.disconnect(); } catch { /* 忽略 */ }
     document.removeEventListener('click', onClick, true);
     document.removeEventListener('keydown', onKeyDown, true);
     document.removeEventListener('visibilitychange', onVisibilityChange);
     window.removeEventListener('resize', onResize);
+    window.removeEventListener('touchstart', onTouchStart);
+    window.removeEventListener('touchmove', onTouchMove);
+    window.removeEventListener('touchend', onTouchEnd);
+    window.removeEventListener('touchcancel', onTouchCancel);
+    clearDrag();
     document.body?.classList.remove(OPEN_CLASS);
-    document.querySelector(`.${MENU_CLASS}`)?.remove();
+    document.body?.classList.remove('qzsy-drawer-ready');
+    document.querySelector(`.${HEADER_CLASS}`)?.remove();
     document.querySelector(`.${BACKDROP_CLASS}`)?.remove();
     document.getElementById(MOBILE_DRAWER_CSS_ID)?.remove();
     root.removeAttribute(MOBILE_UI_FLAG);

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@qzsy/dsh-bridge",
-  "version": "3.3.0",
+  "version": "3.3.1",
   "description": "DSH 远程隧道云官方客户端插件：一条命令把本机 DeepSeek Harness 接入云端隧道（设备码绑定、短期令牌、本地门禁代理、HTTP/SSE/WebSocket 反向隧道）。",
-  "releaseNotes": "【v3.3.0】移动端抽屉导航\\n• 手机访问时左侧栏改为从左侧滑出的 sheet，内容区占满屏幕，不再被 56px 图标栏挤窄\\n• 左上角新增菜单按钮：打开会话/工作区/插件入口，点遮罩、会话、Esc 或转回桌面自动收起\\n• 抽屉带 52px 顶部安全留白与 280ms 缓动，桌面端完全不受影响\\n• 宿主重渲染移除节点时自动补回",
+  "releaseNotes": "【v3.3.1】移动端安全区与手势修复\\n• 全面屏：菜单按钮/内容/抽屉按 safe-area-inset 让位，刘海、状态栏、home indicator 不再遮挡\\n• 手势：左缘右滑打开、抽屉内左滑关闭；拖动跟手、遮罩渐变，松手按距离/速度吸附\\n• 纵向滚动不误触抽屉；滑动后的合成点击会被吞掉\\n• 首次加载不再播放侧栏滑出动画",
   "type": "module",
   "main": "lib/index.js",
   "exports": {