dsh-bridge-gateway 0.2.2 → 0.3.0

package/CHANGELOG.md

@@ -2,6 +2,80 @@
 
 本项目 `dsh-bridge-gateway` 是基于 [dsh-bridge](https://github.com/wenbin-wb/dsh-bridge) 的移植增强分支，在保留原版能力之外，重点新增「公网直连网关」。
 
+## [0.3.0] - 2026-10-17
+
+### 新增：PWA 主屏图标（真 PNG + DSH 业务蓝）
+
+此前 manifest 只声明了 `image/svg+xml` 图标，且 `/apple-touch-icon.png` 也返回 SVG。
+**华为 HarmonyOS 与多数 Android 启动器不支持 SVG 图标**，于是「添加到桌面」后得到的是一块
+空白图标。底色也由近黑 `#151517` 改为 DSH 业务蓝 `#4176e6` —— 近黑底在深色桌面上会糊成
+一块「光板」，这也是「图标是空白的」观感来源之一。
+
+- 新增 `scripts/generate-icons.mjs`：用无头 Chrome 渲染 192/512 的 `any` 与 `maskable` 两版，
+  外加 iOS 的 180；产物入库 `assets/`
+- manifest 声明 4 个 PNG；`/apple-touch-icon.png` 改为返回真 PNG
+- `maskable` 版满幅不留圆角 —— 启动器会按自己的形状裁切，自带圆角会被裁掉一半
+
+### 新增：远程登录页改版（DSH 元素）
+
+登录页重做为门厅式设计，与 DSH 本体同源同一枚鲸鱼。
+
+- `lib/auth/brand-assets.js`：品牌资产单一来源，附 sha256 前缀校验
+- `lib/auth/theme-tokens.js`：18 个 `--dsw-*` token 的静态十六进制回落 —— 登录页在 DSH
+  之前渲染、加载不到 token，**每个 token 都必须有回落**
+- 响应头：`no-store` + CSP。其中 `connect-src 'self'` 是登录 `fetch` 的必需项，漏掉会登录失败
+
+### 修复：移动端 8 项问题
+
+| # | 症状 | 根因 |
+|---|---|---|
+| 1 | 主屏图标空白 | 见上：HarmonyOS 不支持 SVG 图标 |
+| 2 | 打开渠道中心时面板标题被顶栏盖住 | 插件顶栏 `position:fixed` + `z-index:9998` 不感知面板状态（面板 `z-index:80`，其标题落在 y19，正被顶栏的 y0-40 覆盖） |
+| 3 | 会话名恒为「新会话」 | DSH 0.1.7 起 sessions list 快照不再提供 `current` 字段，旧实现读它 → 恒 `undefined` → **静默回落**默认文案（不报错，很难发现）。改读 `retainedBy.mainView > 0` 的那一个（与 `dsh-client-ui-session` 的判据一致） |
+| 4 | 轨迹视图内容被裁 | `table` 元素的 `overflow` 在 CSS 里**是被忽略的**，只写 `overflow-x:auto` 无效，必须配 `display:block`。另：工具调用参数列内容宽 3049px 而可见仅 180px（17×），横滑读不了，改为换行 |
+| 5 | 输入框压住内容 | 见下「已知问题」（两次尝试均已回退） |
+| 6 | 顶部两层头过高、挤压对话区 | **DSH 自带 `min-height:76px`**，只改 padding 压不下去；显式清零后内容区 +51px |
+| 7 | 「对话」视图下拉被内容盖住 | 祖先链 `titleRow` 与 `wSkVaW_root` 都是 `overflow:hidden`，下拉落在头部下方被**整块裁掉**（z-index 再高也没用，裁剪发生在层叠之前）。改为 body 级 portal |
+| 8 | **滚不到最新会话**（只渲染约 4 条消息） | 插件给 `_frame` 注入的 `height:100dvh` + `overflow:hidden` 组合使 DSH 的布局测量算错，驻留窗口塌缩成 4 条。去掉这两个属性组后 `scrollHeight` 由 996 恢复到 11295 |
+
+### 已知问题：#5 输入框压住内容（未修）
+
+`composerSeat` 是 `position:sticky` 且为 `scrollBody` 的直接 flex 子项，吸住时会盖在滚动内容
+之上。**两次尝试修复（改 `fixed` + 补 padding；再用 `visualViewport` 算键盘高度）都破坏了 DSH
+的滚动锚定，均已回退。**
+
+DSH 另有「覆盖层模式」（`:has([data-conversation-composer-overlay])`：`composerSeat` 转
+`absolute`、`viewArea` 自己滚），但那是 `dsh-client-ui-trajectory`（轨迹视图）在用的，对话
+视图没有开。**要根治得走 DSH 侧，插件 CSS 补不了。**
+
+### 新增：真机诊断能力（长期保留）
+
+真机上稳定复现、桌面视口复现不出的问题，可以不改代码直接二分：
+
+| 参数 | 作用 |
+|---|---|
+| `?dsh-diag=1` | 只读指标叠加层（滚动容器几何、`scrollHeight` / `clientHeight`、输入框位置、视口三件套）。与 `dsh-mobile` 独立，因此可对比「移动层开/关」两态 |
+| `?dsh-mobile=off` | 完全禁用移动端增强层（CSS + JS） |
+| `?dsh-mobile=no-new` | 保留承重布局，只关掉最近新增的那批规则 |
+| `?dsh-mobile=no-<分组>` | 关掉某一组规则（`no-frameLayout` / `no-centercol` / `no-pad` / `no-observer`），逗号分隔可叠加 |
+| `?dsh-mobile=on` | 恢复正常 |
+
+选择记进 `localStorage`，因此在没有地址栏的 PWA 里同样生效。
+
+### 变更：品牌名统一为 dsh-bridge-gateway
+
+插件自身标识、日志前缀、数据目录、cloudflared 缓存目录全部改名，并对旧名做**两级链自动迁移**
+（`~/.dsh-bridge/` → `~/.dsh-bridge-cloudflared/` → `~/.dsh-bridge-gateway-cloudflared/`），
+用户无需重下 cloudflared。
+
+上游仓库名 `wenbin-wb/dsh-bridge` 与兼容性标识（`LEGACY_DATA_DIR_NAME`、
+`BRIDGE_RPC_CHANNEL_LEGACY`、CHANGELOG 历史）按约定保留。
+
+### 测试
+
+269 项全绿；新增 12 条护栏，逐条用注入 bug 验证过会变红。每条护栏都写了「为什么」（踩过的坑）。
+中英 README 同步（章节数 / 标题层级 / 逐章节条目数 / 表格行数零差异）。
+
 ## [0.2.2] - 2026-10-11
 
 ### 修复：旧内核浏览器打开后工作区永远加载不了

package/README.md

@@ -14,7 +14,7 @@ This project's **upstream is [wenbin-wb/dsh-bridge](https://github.com/wenbin-wb
 
 ### Who upstream is
 
-| | |
+| Field | Value |
 |---|---|
 | Repository | [wenbin-wb/dsh-bridge](https://github.com/wenbin-wb/dsh-bridge) |
 | Role | Multi-channel remote access and security plugin for DSH |
@@ -74,7 +74,7 @@ The plugin was renamed from `dsh-bridge` to **`dsh-bridge-gateway`** (reflecting
 | Path | Change |
 |---|---|
 | `<DSH_HOME>/dsh-bridge/` | → `<DSH_HOME>/dsh-bridge-gateway/` (migrated automatically at startup) |
-| `~/.dsh-bridge/` | → `~/.dsh-bridge-cloudflared/` (cloudflared cache; migrated automatically, no re-download) |
+| `~/.dsh-bridge/` | → `~/.dsh-bridge-gateway-cloudflared/` (cloudflared cache; **two-hop auto-migration**, no 39MB re-download) |
 | RPC channel `/dsh-bridge` | → `/dsh-bridge-gateway`, with **both channels served**, so stale cached pages keep working |
 
 ## Features
@@ -89,7 +89,7 @@ The plugin was renamed from `dsh-bridge` to **`dsh-bridge-gateway`** (reflecting
 - **Visitor management.** See live who is currently connected (LAN / direct gateway / tunnel, with the real source IP behind a tunnel) plus an IP blacklist. **Viewing is open to every visitor**; disconnecting and blacklisting require admin rights.
 - **IM bots.** WeChat / QQ / Feishu / Telegram bots connect through their own gateway links — no public IP needed. Per-platform workspace / agent preset / model selection is configurable. Guides live in [docs/](./docs).
 - **Collapsible cards.** Cards in the Access and Security tabs collapse; only the first in each group is expanded by default, and a collapsed card keeps its status tag plus one line of key information.
-- **Mobile-friendly web.** The remote web UI is deeply adapted for phone screens (drawer sidebar, ~44px touch targets, bottom-stuck composer, and more).
+- **Mobile-friendly web.** The remote web UI is deeply adapted for phone screens (drawer sidebar, ~44px touch targets, bottom-stuck composer, and more). The gateway also serves real **PNG** home-screen icons (DSH business blue + white whale, in both `any` and `maskable` variants) together with a Web App Manifest, so "Add to Home Screen" yields a proper icon rather than a blank tile.
 - **All configuration in the UI.** Every feature above is configured from DSH Web's remote-access panel; nothing is edited by hand.
 
 ## Interface
@@ -216,6 +216,20 @@ dsh plugin --profile web add .
 
 Tests point `DSH_HOME` at a throwaway temporary directory via `test/isolate-home.mjs`, so they never touch your real environment.
 
+### Diagnosing phone-only layout problems
+
+Bugs that reproduce on a phone but never in a desktop viewport can be bisected without touching code. Append a query parameter to the remote URL; the choice is remembered in `localStorage`, so it also works inside an installed PWA (which has no address bar).
+
+| Parameter | Effect |
+|---|---|
+| `?dsh-diag=1` | Overlays a read-only metrics panel (scroll-container geometry, `scrollHeight` / `clientHeight`, composer position, viewport triple). It is independent of `dsh-mobile`, so the layer can be compared on against off. |
+| `?dsh-mobile=off` | Disables the whole mobile enhancement layer (CSS and JS). |
+| `?dsh-mobile=no-new` | Keeps the load-bearing layout and drops only the most recently added rules. |
+| `?dsh-mobile=no-<group>` | Drops one rule group: `no-frameLayout`, `no-centercol`, `no-pad`, `no-observer`. Comma-separate to combine. |
+| `?dsh-mobile=on` | Restores normal behaviour. |
+
+Start by capturing `?dsh-diag=1` twice — once as-is and once with `?dsh-mobile=off` — because the delta between those two states is usually enough to name the culprit.
+
 This project is forked from [wenbin-wb/dsh-bridge](https://github.com/wenbin-wb/dsh-bridge). Report general issues upstream and direct-gateway issues to this repository.
 
 ## Release notes

package/README.zh.md

@@ -97,7 +97,7 @@ resolve、远程流层直接抛错 —— 于是外壳渲染得出来，工作
 | 路径 | 变化 |
 |---|---|
 | `<DSH_HOME>/dsh-bridge/` | → `<DSH_HOME>/dsh-bridge-gateway/`（启动时自动迁移） |
-| `~/.dsh-bridge/` | → `~/.dsh-bridge-cloudflared/`（cloudflared 缓存，自动迁移，免重下） |
+| `~/.dsh-bridge/` | → `~/.dsh-bridge-gateway-cloudflared/`（cloudflared 缓存，**两级链自动迁移**，免重下 39MB） |
 | RPC 通道 `/dsh-bridge` | → `/dsh-bridge-gateway`，**新旧双通道并存**，旧缓存页面仍可用 |
 
 ## 功能
@@ -123,7 +123,8 @@ resolve、远程流层直接抛错 —— 于是外壳渲染得出来，工作
 - **卡片折叠。** 访问配置与安全认证两个 Tab 的卡片都可折叠，默认只展开首张，
   折叠后仍保留状态标签与一行关键信息。
 - **移动端适配。** 远程网页 UI 针对手机屏幕深度适配（抽屉化侧边栏、点击热区扩至约 44px、
-  输入框贴底等）。
+  输入框贴底等）。网关另外提供真实的 **PNG** 主屏图标（DSH 业务蓝 + 白色鲸鱼，含 `any`
+  与 `maskable` 两版）与 Web App Manifest，"添加到桌面"得到的是正常图标而非空白方块。
 - **全界面配置。** 以上全部功能都在 DSH Web 远程访问面板里配置，无需手改任何文件。
 
 ## 界面
@@ -277,6 +278,21 @@ dsh plugin --profile web add .
 测试会通过 `test/isolate-home.mjs` 把 `DSH_HOME` 指向一次性临时目录，不会污染你本机的
 真实环境。
 
+### 排查只在手机上出现的问题
+
+桌面视口复现不出、真机稳定复现的问题，可以不改代码直接二分。在远程地址后加查询参数即可；
+选择会记进 `localStorage`，所以在没有地址栏的 PWA 里同样生效。
+
+| 参数 | 作用 |
+|---|---|
+| `?dsh-diag=1` | 叠加只读指标面板（滚动容器几何、`scrollHeight` / `clientHeight`、输入框位置、视口三件套）。它与 `dsh-mobile` 相互独立，因此能对比移动层「开」与「关」两种状态。 |
+| `?dsh-mobile=off` | 完全禁用移动端增强层（CSS 与 JS）。 |
+| `?dsh-mobile=no-new` | 保留承重布局，只关掉最近新增的那批规则。 |
+| `?dsh-mobile=no-<分组>` | 关掉某一组规则：`no-frameLayout`、`no-centercol`、`no-pad`、`no-observer`，逗号分隔可叠加。 |
+| `?dsh-mobile=on` | 恢复正常。 |
+
+第一步先取两次 `?dsh-diag=1` —— 一次原样、一次带 `?dsh-mobile=off` —— 两者差值通常就足以定位元凶。
+
 本项目 fork 自 [wenbin-wb/dsh-bridge](https://github.com/wenbin-wb/dsh-bridge)。
 向上游反馈通用问题、向本仓库反馈直连网关相关问题。
 

package/client/client.js

@@ -2639,7 +2639,7 @@ function BackupRestoreWidget({ rpcCall, onUpdate }) {
         const now = /* @__PURE__ */ new Date();
         const dateStr = `${now.getFullYear()}${String(now.getMonth() + 1).padStart(2, "0")}${String(now.getDate()).padStart(2, "0")}`;
         a.href = url;
-        a.download = `dsh-bridge-backup-${dateStr}.json`;
+        a.download = `dsh-bridge-gateway-backup-${dateStr}.json`;
         document.body.appendChild(a);
         a.click();
         document.body.removeChild(a);
@@ -3935,11 +3935,165 @@ function BridgePanel({ rpcCall }) {
     )
   );
 }
+function setupMobileDiag() {
+  if (document.getElementById("dsh-mobile-diag")) return;
+  const box = document.createElement("div");
+  box.id = "dsh-mobile-diag";
+  box.style.cssText = [
+    "position:fixed",
+    "left:0",
+    "right:0",
+    "top:0",
+    "z-index:2147483647",
+    "background:rgba(0,0,0,.86)",
+    "color:#0f0",
+    "pointer-events:none",
+    "font:11px/1.5 ui-monospace,SFMono-Regular,Menlo,monospace",
+    "padding:5px 7px",
+    "white-space:pre-wrap",
+    "word-break:break-all"
+  ].join(";");
+  document.body.appendChild(box);
+  const tick = () => {
+    const sb = document.querySelector('[class*="wSkVaW_scrollBody"]');
+    const seat = document.querySelector('[class*="wSkVaW_composerSeat"]');
+    const vv = window.visualViewport;
+    const L = [];
+    if (sb) {
+      const r = sb.getBoundingClientRect();
+      const max = sb.scrollHeight - sb.clientHeight;
+      L.push("scrollBody top=" + Math.round(r.top) + " h=" + Math.round(r.height) + " pad=" + getComputedStyle(sb).paddingBottom);
+      L.push("  scrollTop=" + Math.round(sb.scrollTop) + " max=" + max + " atBottom=" + (sb.scrollTop >= max - 2));
+      L.push("  scrollH=" + sb.scrollHeight + " clientH=" + sb.clientHeight + " children=" + sb.children.length);
+      const idx = sb.querySelectorAll("[data-index]");
+      L.push("  virtItems=" + idx.length);
+    } else {
+      L.push("scrollBody: NOT FOUND");
+    }
+    if (seat) {
+      const r = seat.getBoundingClientRect();
+      L.push("composer pos=" + getComputedStyle(seat).position + " top=" + Math.round(r.top) + " h=" + Math.round(r.height));
+    }
+    L.push("inner=" + window.innerHeight + " vv=" + (vv ? Math.round(vv.height) : "-") + " vvTop=" + (vv ? Math.round(vv.offsetTop) : "-") + " dpr=" + window.devicePixelRatio + " w=" + window.innerWidth);
+    L.push("body=" + Array.from(document.body.classList).join("."));
+    box.textContent = L.join("\n");
+  };
+  tick();
+  window.setInterval(tick, 500);
+  window.addEventListener("scroll", tick, true);
+  window.addEventListener("resize", tick);
+}
+var SUSPECT_CSS = {
+  // _frame 规则 —— 真机二分结论（2026-10-17）：
+  //   ?dsh-mobile=no-frameSize    （去掉 width:100vw + height:100dvh）→ scrollH 恢复正常
+  //   ?dsh-mobile=no-frameOverflow（去掉 overflow:hidden）            → scrollH 恢复正常
+  //   两个属性各自都能触发，说明是「固定高度 + 裁剪」这个组合在作怪：
+  //   height:100dvh 把主框架钉成固定高、overflow:hidden 又让它成为裁剪容器，
+  //   DSH 的布局测量因此算错，导致只渲染约 4 条消息（scrollH≈795，正常应 10 万+）。
+  //   故**这两个属性组已删除**，不再注入。只保留 padding-top（本规则的目的：
+  //   为固定顶栏腾出空间）与 display/flex-direction/position（抽屉化的前提）。
+  //   注意 grid-template-columns:1fr 也已去掉 —— 它是 grid 属性，在 flex 容器里无效。
+  //   padding-top / box-sizing 是这条规则的**目的**（为固定顶栏腾空间），任何分组都保留
+  frameBase: `
+    div[class*="_frame"] {
+      padding-top: var(--dsh-mobile-header-h) !important;
+      margin: 0 !important;
+      box-sizing: border-box !important;
+    }`,
+  frameLayout: `
+    div[class*="_frame"] {
+      display: flex !important;
+      flex-direction: column !important;
+      position: relative !important;
+    }`,
+  centercol: `      div[class*="_centerCol"] {
+        flex: 1 1 100% !important;
+        width: 100% !important;
+        min-width: 0 !important;
+        max-width: 100% !important;
+        display: flex !important;
+        height: 100% !important;
+      }`,
+  pad: `      div[class*="wSkVaW_scrollBody"] {
+        padding-bottom: max(16px, env(safe-area-inset-bottom)) !important;
+      }
+      div[class*="wSkVaW_scrollBody"] {
+        padding-bottom: calc(6px + env(safe-area-inset-bottom, 0px)) !important;
+      }`
+};
+function injectSuspectStyles(disabled) {
+  const parts = Object.entries(SUSPECT_CSS).filter(([k]) => !disabled.has(k)).map(([, v]) => v);
+  if (parts.length === 0) return;
+  if (document.getElementById("dsh-bridge-gateway-mobile-styles-suspect")) return;
+  const style = document.createElement("style");
+  style.id = "dsh-bridge-gateway-mobile-styles-suspect";
+  style.textContent = "@media (max-width: 768px) {\n" + parts.join("\n") + "\n}";
+  document.head.appendChild(style);
+}
+var NEW_MOBILE_CSS = `
+      /* #2 \u9762\u677F\u6253\u5F00\u65F6\u9876\u680F\u8BA9\u4F4D\uFF08body.dsh-panel-open \u7531 setupPanelAwareness \u6253\u4E0A\uFF09\u3002
+         \u5B9E\u6D4B\uFF1A\u6E20\u9053\u4E2D\u5FC3\u9762\u677F\u6807\u9898\u5728 y19\uFF0C\u800C\u9876\u680F\u5360 y0-40 \u2192 \u4E0D\u6539\u5C31\u662F\u6807\u9898\u88AB\u76D6\u4F4F\u3002
+         \u4E0D\u7528 :has() \u662F\u56E0\u4E3A\u6784\u5EFA\u76EE\u6807\u662F chrome100\uFF08:has() \u8981 105+\uFF09\u3002 */
+      body.dsh-panel-open .dsh-mobile-app-header {
+        display: none !important;
+      }
+
+      /* #6 \u53CC\u5C42\u5934\u538B\u7F29\uFF1ADSH \u81EA\u5E26 min-height:76px\uFF0C\u53EA\u6539 padding \u538B\u4E0D\u4E0B\u53BB \u2014\u2014 \u5B9E\u6D4B
+         76px \u4E00\u76F4\u751F\u6548\u3001titleRow \u88AB\u62C9\u4F38\u586B\u6EE1\uFF0869px\uFF09\uFF0C\u4E24\u5C42\u5934\u5408\u8BA1\u5403\u6389 128px\uFF08\u5C4F\u5E55 15%\uFF09\u3002
+         \u663E\u5F0F\u6E05\u96F6 + \u628A padding \u6536\u5230 2px\uFF0C\u5B9E\u6D4B\u5185\u5BB9\u533A +51px\u3002 */
+      div[class*="_centerCol"] header,
+      header[class*="wSkVaW_header"] {
+        min-height: 0 !important;
+        padding: 2px 16px !important;
+      }
+      div[class*="wSkVaW_titleRow"] {
+        min-height: 0 !important;
+        height: 32px !important;
+      }
+
+      /* #4-C \u8868\u683C\u6A2A\u5411\u6EDA\u52A8\uFF1Atable \u5143\u7D20\u7684 overflow \u5728 CSS \u91CC\u662F**\u88AB\u5FFD\u7565**\u7684\uFF0C\u5FC5\u987B\u914D
+         display:block \u624D\u4F1A\u53D8\u6210\u53EF\u6EDA\u5757\u76D2\uFF08\u63D2\u4EF6\u539F\u6765\u53EA\u5199\u4E86 overflow-x:auto\uFF0C\u6240\u4EE5\u65E0\u6548\uFF09\u3002 */
+      div[class*="wSkVaW_scrollBody"] table {
+        display: block !important;
+        max-width: 100% !important;
+        width: 100% !important;
+        overflow-x: auto !important;
+        -webkit-overflow-scrolling: touch !important;
+      }
+
+      /* #4-E \u8F68\u8FF9\u91CC\u7684\u5DE5\u5177\u8C03\u7528\u53C2\u6570\u6362\u884C\uFF1A\u8BE5\u5217\u5185\u5BB9\u5BBD 3049px \u5374\u53EA\u6709 180px \u53EF\u89C1\uFF0817\xD7\uFF09\uFF0C
+         \u6A2A\u6ED1\u8981\u5212 17 \u5C4F\u3001\u5B9E\u9645\u8BFB\u4E0D\u4E86\u3002overflow-wrap:anywhere \u662F\u5FC5\u987B\u7684 \u2014\u2014 bash \u547D\u4EE4\u91CC
+         \u5E38\u6709\u8D85\u957F\u65E0\u7A7A\u683C token\u3002 */
+      div[class*="wSkVaW_scrollBody"] [class*="resultRequest"] {
+        white-space: normal !important;
+        overflow-wrap: anywhere !important;
+        word-break: break-word !important;
+        text-overflow: clip !important;
+        overflow: visible !important;
+      }
+
+      /* #7 \u4E0B\u62C9\u6539 body \u7EA7 portal\uFF08position:fixed\uFF09\u3002\u4E3A\u4EC0\u4E48\u4E0D\u80FD absolute \u6302\u5728\u6309\u94AE\u91CC\uFF1A
+         \u7956\u5148\u94FE titleRow \u4E0E wSkVaW_root \u90FD\u662F overflow:hidden\uFF08titleRow \u90A3\u6761\u8FD8\u662F\u63D2\u4EF6
+         \u81EA\u5DF1\u4E3A\u4E86\u7701\u7565\u53F7\u8BBE\u7684\uFF09\u2192 \u4E0B\u62C9\u843D\u5728\u5934\u90E8\u4E0B\u65B9 y78 \u4F1A\u88AB**\u6574\u5757\u88C1\u6389**\uFF0C\u5B9E\u6D4B\u4E2D\u5FC3\u70B9\u547D\u4E2D
+         \u7684\u662F\u6D88\u606F\u6587\u672C\u3002z-index \u518D\u9AD8\u4E5F\u6CA1\u7528\uFF0C\u88C1\u526A\u53D1\u751F\u5728\u5C42\u53E0\u4E4B\u524D\u3002
+         \u6CE8\u610F\uFF1A**\u4E0D\u80FD**\u5199 top/left \u7684 !important \u2014\u2014 \u90A3\u4F1A\u538B\u8FC7 positionTabDropdown()
+         \u5199\u7684\u5185\u8054\u5750\u6807\uFF0C\u628A\u4E0B\u62C9\u9489\u5728\u5DE6\u4E0A\u89D2\u3002 */
+      .dsh-mobile-tab-dropdown {
+        position: fixed !important;
+      }
+`;
+function injectNewMobileStyles() {
+  if (document.getElementById("dsh-bridge-gateway-mobile-styles-new")) return;
+  const style = document.createElement("style");
+  style.id = "dsh-bridge-gateway-mobile-styles-new";
+  style.textContent = "@media (max-width: 768px) {\n" + NEW_MOBILE_CSS + "\n}";
+  document.head.appendChild(style);
+}
 function injectMobileStyles() {
   if (typeof document === "undefined") return;
-  if (document.getElementById("dsh-bridge-mobile-styles")) return;
+  if (document.getElementById("dsh-bridge-gateway-mobile-styles")) return;
   const style = document.createElement("style");
-  style.id = "dsh-bridge-mobile-styles";
+  style.id = "dsh-bridge-gateway-mobile-styles";
   style.textContent = `
     /* DSH Bridge \u9690\u85CF Tab \u680F\u539F\u751F\u6EDA\u52A8\u6761\u5E76\u4FDD\u6301\u5E73\u6ED1\u6ED1\u52A8 */
     .dsh-tabbar-container {
@@ -3954,25 +4108,16 @@ function injectMobileStyles() {
 
     /* DSH Bridge \u79FB\u52A8\u7AEF\u81EA\u9002\u5E94\u4E0E\u89E6\u63A7\u4EA4\u4E92\u589E\u5F3A\u6837\u5F0F */
     :root {
-      --dsh-mobile-header-h: 52px;
+      /* \u9876\u680F\u9AD8\u5EA6 52 -> 40\uFF082026-10-16 \u771F\u673A\u53CD\u9988\uFF1A"\u4E0A\u9762\u9AD8\u5EA6\u592A\u9AD8\u4E86\uFF0C\u628A\u5BF9\u8BDD\u6846\u7684\u7A7A\u95F4\u538B\u7F29\u4E86"\uFF09\u3002
+         40px \u4ECD\u80FD\u5BB9\u7EB3 32px \u7684 \u2630/\u2295 \u6309\u94AE\u4E0E\u4E00\u884C\u4F1A\u8BDD\u540D\u3002 */
+      --dsh-mobile-header-h: 40px;
       --dsh-mobile-safe-top: env(safe-area-inset-top, 0px);
       --dsh-mobile-safe-bottom: env(safe-area-inset-bottom, 0px);
     }
 
     @media (max-width: 768px) {
       /* 1. \u4E3B\u6846\u67B6\u4E3A Header \u817E\u51FA\u9876\u90E8\u7A7A\u95F4 */
-      div[class*="_frame"] {
-        display: flex !important;
-        flex-direction: column !important;
-        width: 100vw !important;
-        height: 100dvh !important;
-        margin: 0 !important;
-        padding-top: var(--dsh-mobile-header-h) !important;
-        position: relative !important;
-        grid-template-columns: 1fr !important;
-        overflow: hidden !important;
-        box-sizing: border-box !important;
-      }
+
 
       /* 2. \u9876\u90E8\u539F\u751F\u5BFC\u822A\u6761\uFF1A100% \u8FD8\u539F DeepSeek App (\u5DE6\u4FA7\u53CC\u6A2A\u7EBF\uFF0C\u53F3\u4FA7(+)\uFF0C\u4E2D\u95F4\u7559\u767D\uFF0C\u65E0\u591A\u4F59\u8BBE\u7F6E\u6309\u94AE) */
       .dsh-mobile-app-header {
@@ -4052,14 +4197,7 @@ function injectMobileStyles() {
       }
 
       /* 3. \u4E2D\u95F4\u4E3B\u5185\u5BB9\u533A\u4E0E\u8F93\u5165\u6846 */
-      div[class*="_centerCol"] {
-        flex: 1 1 100% !important;
-        width: 100% !important;
-        min-width: 0 !important;
-        max-width: 100% !important;
-        display: flex !important;
-        height: 100% !important;
-      }
+
 
       div[class*="_detailsCol"],
       div[class*="toggleCluster"],
@@ -4450,9 +4588,7 @@ function injectMobileStyles() {
       }
 
       /* \u8F93\u5165\u6846\u5E95\u5EA7\uFF1ADeepSeek App \u5C45\u4E2D\u53CA\u5E95\u90E8\u56FA\u5B9A */
-      div[class*="wSkVaW_scrollBody"] {
-        padding-bottom: max(16px, env(safe-area-inset-bottom)) !important;
-      }
+
 
       /* \u8F93\u5165\u5361\u7247\uFF1ADeepSeek App \u5706\u89D2\u5927\u80F6\u56CA\u9020\u578B */
       div[class*="uV2eYG_card"] {
@@ -4646,11 +4782,20 @@ function injectMobileStyles() {
       }
 
       /* \u8F93\u5165\u6846\u8D34\u5E95\uFF1AscrollBody \u7684 16px \u5E95\u90E8\u886C\u8DDD\u662F\u7A7A\u9699\u6765\u6E90\uFF0C\u6536\u6389\u53EA\u7559\u5B89\u5168\u533A\uFF1B
-         \u518D\u57AB 6px \u8BA9\u7EDF\u8BA1\u836F\u4E38\u5B8C\u6574\u53EF\u89C1 */
-      div[class*="wSkVaW_scrollBody"] {
-        padding-bottom: calc(6px + env(safe-area-inset-bottom, 0px)) !important;
-      }
-      div[class*="wSkVaW_composerStack"] {
+         \u518D\u57AB 6px \u8BA9\u7EDF\u8BA1\u836F\u4E38\u5B8C\u6574\u53EF\u89C1\u3002
+
+         \u26A0\uFE0F **\u4E0D\u8981**\u518D\u8BD5\u56FE\u5728\u8FD9\u91CC\u52A0 --dsh-composer-height\u3001\u4E5F\u4E0D\u8981\u7ED9 composerSeat \u52A0
+         position:fixed\uFF082026-10-16 \u4E24\u6B21\u5C1D\u8BD5\uFF0C\u5747\u5DF2\u56DE\u9000\uFF09\u3002\u539F\u56E0\uFF1ADSH \u7684\u6EDA\u52A8\u951A\u5B9A
+         \uFF08dsh-client-ui-conversation\uFF09\u662F**\u6309 DOM \u6D41\u5185\u4F4D\u7F6E**\u904D\u5386\u7956\u5148\u7B97\u504F\u79FB\u6765\u4FEE\u6B63
+         scrollTop \u7684\uFF1B\u628A composer \u6458\u51FA\u6587\u6863\u6D41\u3001\u6216\u7ED9\u6EDA\u52A8\u5185\u5BB9\u52A0 padding\uFF0C\u951A\u5B9A\u5C31\u7B97\u9519\uFF0C
+         \u771F\u673A\u75C7\u72B6\u662F\u300C\u8FDB\u53BB\u505C\u5728\u5F88\u4E45\u4EE5\u524D\u7684\u67D0\u6761\uFF0C\u70B9\u300E\u52A0\u8F7D\u66F4\u65E9\u300F\u540E\u518D\u4E5F\u56DE\u4E0D\u5230\u6700\u65B0\u300D\u3002
+         \u8FD9\u4E2A\u906E\u6321\u662F DSH \u5BF9\u8BDD\u89C6\u56FE sticky \u5438\u5E95\u8BBE\u8BA1\u7684\u56FA\u6709\u4EE3\u4EF7\uFF1BDSH \u53E6\u6709"\u8986\u76D6\u5C42\u6A21\u5F0F"
+         \uFF08:has([data-conversation-composer-overlay])\uFF1AcomposerSeat \u8F6C absolute\u3001
+         viewArea \u81EA\u5DF1\u6EDA\uFF09\uFF0C\u4F46\u90A3\u662F **dsh-client-ui-trajectory\uFF08\u8F68\u8FF9\u89C6\u56FE\uFF09** \u5728\u7528\u7684\uFF0C
+         \u5BF9\u8BDD\u89C6\u56FE\u6CA1\u6709\u5F00\u3002\u8981\u6839\u6CBB\u5F97\u8D70 DSH \u4FA7\uFF0C\u4E0D\u662F\u63D2\u4EF6 CSS \u80FD\u8865\u7684\u3002 */
+
+
+            div[class*="wSkVaW_composerStack"] {
         padding-bottom: env(safe-area-inset-bottom, 0px) !important;
       }
 
@@ -4957,15 +5102,15 @@ function injectMobileStyles() {
         box-sizing: border-box !important;
       }
 
-      /* 7. \u4EE3\u7801\u5757\u3001\u8868\u683C\u4E0E\u5FBD\u6807\u81EA\u9002\u5E94 */
-      pre, code, pre > code, table {
+      /* 7. \u4EE3\u7801\u5757\u4E0E\u5FBD\u6807\u81EA\u9002\u5E94 */
+      pre, code, pre > code {
         max-width: 100% !important;
         overflow-x: auto !important;
         -webkit-overflow-scrolling: touch !important;
         font-size: 12.5px !important;
       }
 
-      /* \u72B6\u6001\u5FBD\u6807\u4E0E\u836F\u4E38\u6309\u94AE\u6C38\u4E0D\u6298\u5B57 */
+                  /* \u72B6\u6001\u5FBD\u6807\u4E0E\u836F\u4E38\u6309\u94AE\u6C38\u4E0D\u6298\u5B57 */
       span[style*="border-radius: 999"],
       span[style*="border-radius:999"] {
         white-space: nowrap !important;
@@ -5181,10 +5326,82 @@ function createUpstreamBridge(ctx) {
     }
   };
 }
+function setupPanelAwareness(ctx) {
+  if (typeof document === "undefined") return () => {
+  };
+  const PANEL_SELECTORS = [
+    ".dshc-center-backdrop",
+    // dsh-chanhub 渠道中心
+    "[data-dsh-panel-host]",
+    // dsh-better-sidebar（注意：常驻 DOM，需判可见）
+    "[data-dsh-better-sidebar]"
+  ];
+  const isPanelOpen = () => PANEL_SELECTORS.some((sel) => {
+    const el = document.querySelector(sel);
+    if (!el) return false;
+    const cs = getComputedStyle(el);
+    if (cs.display === "none" || cs.visibility === "hidden") return false;
+    const r = el.getBoundingClientRect();
+    return r.width > 0 && r.height > 0;
+  });
+  const sync = () => {
+    const open = isPanelOpen();
+    if (document.body.classList.contains("dsh-panel-open") !== open) {
+      document.body.classList.toggle("dsh-panel-open", open);
+    }
+  };
+  sync();
+  const observer = new MutationObserver(sync);
+  observer.observe(document.body, { childList: true });
+  const timer = setInterval(sync, 1e3);
+  const dispose = () => {
+    observer.disconnect();
+    clearInterval(timer);
+  };
+  ctx?.effect?.(() => dispose);
+  return dispose;
+}
 function setupMobileExperience(rpcCall, ctx) {
   if (typeof document === "undefined" || typeof window === "undefined") return;
-  injectMobileStyles();
+  const MOBILE_FLAG_KEY = "dsh-bridge-gateway:mobile";
+  const flag = new URLSearchParams(window.location.search).get("dsh-mobile");
+  if (flag !== null) {
+    try {
+      window.localStorage.setItem(MOBILE_FLAG_KEY, flag);
+    } catch {
+    }
+  }
+  let mobileFlag = "on";
+  try {
+    mobileFlag = window.localStorage.getItem(MOBILE_FLAG_KEY) || "on";
+  } catch {
+  }
+  document.documentElement.dataset.dshMobile = mobileFlag;
+  const diagOn = new URLSearchParams(window.location.search).get("dsh-diag") === "1";
+  if (diagOn) window.setTimeout(setupMobileDiag, 1500);
+  const flagSet = new Set(String(mobileFlag).split(",").map((x) => x.trim()).filter(Boolean));
+  const disabledSuspects = new Set(
+    [...flagSet].filter((f) => f.startsWith("no-")).map((f) => f.slice(3))
+  );
+  if (disabledSuspects.has("frame")) {
+    for (const k of ["frameLayout", "frameSize", "frameOverflow"]) disabledSuspects.add(k);
+  }
+  const withCss = !flagSet.has("off") && !flagSet.has("no-css");
+  const withJs = !flagSet.has("off") && !flagSet.has("no-js");
+  const withNew = withCss && !flagSet.has("no-new");
+  const MOBILE_NO_OBSERVER = flagSet.has("no-observer");
+  if (!withCss && !withJs) {
+    if (diagOn) window.setTimeout(setupMobileDiag, 1500);
+    return;
+  }
+  if (withCss) {
+    injectMobileStyles();
+    injectSuspectStyles(disabledSuspects);
+  }
+  if (withNew) injectNewMobileStyles();
+  if (!withJs) return;
   const U = createUpstreamBridge(ctx);
+  setupPanelAwareness(ctx);
   let header = document.querySelector(".dsh-mobile-app-header");
   let titleEl = document.querySelector(".dsh-mobile-header-title");
   if (!header) {
@@ -5229,17 +5446,39 @@ function setupMobileExperience(rpcCall, ctx) {
     header.appendChild(rightBtn);
     document.body.appendChild(header);
   }
+  if (header && !header.dataset.dshVisibilityBound) {
+    header.dataset.dshVisibilityBound = "1";
+    header.style.display = "none";
+    try {
+      const mq = window.matchMedia("(max-width: 768px)");
+      const syncHeaderVisibility = () => {
+        header.style.display = mq.matches ? "" : "none";
+      };
+      syncHeaderVisibility();
+      if (typeof mq.addEventListener === "function") mq.addEventListener("change", syncHeaderVisibility);
+      else if (typeof mq.addListener === "function") mq.addListener(syncHeaderVisibility);
+    } catch {
+    }
+  }
+  const pickCurrentSession = (snap) => {
+    const list = snap?.byId ? Object.values(snap.byId) : [];
+    if (!list.length) return null;
+    const retained = list.find((x) => (x?.retainedBy?.mainView ?? 0) > 0);
+    if (retained) return retained;
+    return list.find((x) => !x?.blank) || null;
+  };
   const syncMobileTitle = () => {
     if (!titleEl) titleEl = document.querySelector(".dsh-mobile-header-title");
     if (!titleEl) return;
     const snap = ctx?.sessions?.list?.getSnapshot?.();
     if (!snap) return;
-    const cur = snap.current ? snap.byId?.[snap.current] : null;
+    const cur = pickCurrentSession(snap);
     if (!cur || cur.blank) {
       titleEl.innerText = "\u65B0\u4F1A\u8BDD";
     } else {
       titleEl.innerText = cur.displayTitle || cur.title || "\u4F1A\u8BDD";
     }
+    titleEl.title = titleEl.innerText;
   };
   syncMobileTitle();
   if (typeof ctx?.sessions?.list?.subscribe === "function") {
@@ -5279,9 +5518,21 @@ function setupMobileExperience(rpcCall, ctx) {
       }
     });
   };
-  const panelObserver = new MutationObserver(ensurePanelCloseButton);
-  panelObserver.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ["class"] });
-  window.addEventListener("resize", ensurePanelCloseButton);
+  let panelCloseRaf = 0;
+  const schedulePanelCloseButton = () => {
+    if (panelCloseRaf) return;
+    panelCloseRaf = window.requestAnimationFrame(() => {
+      panelCloseRaf = 0;
+      ensurePanelCloseButton();
+    });
+  };
+  if (MOBILE_NO_OBSERVER) {
+    document.documentElement.dataset.dshMobileObserver = "off";
+  } else {
+    const panelObserver = new MutationObserver(schedulePanelCloseButton);
+    panelObserver.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ["class"] });
+  }
+  window.addEventListener("resize", schedulePanelCloseButton);
   const mobileTabState = { btn: null, dropdown: null };
   const nativeTabs = () => [...document.querySelectorAll('[role="tablist"] [role="tab"]')];
   const closeTabDropdown = () => {
@@ -5290,6 +5541,14 @@ function setupMobileExperience(rpcCall, ctx) {
       mobileTabState.dropdown = null;
     }
   };
+  const positionTabDropdown = () => {
+    const dd = mobileTabState.dropdown;
+    const btn = mobileTabState.btn;
+    if (!dd || !btn || !btn.isConnected) return;
+    const r = btn.getBoundingClientRect();
+    dd.style.top = Math.round(r.bottom + 6) + "px";
+    dd.style.left = Math.round(r.left) + "px";
+  };
   const renderTabDropdown = () => {
     closeTabDropdown();
     if (!mobileTabState.btn) return;
@@ -5326,8 +5585,9 @@ function setupMobileExperience(rpcCall, ctx) {
       };
       dropdown.appendChild(option);
     });
-    mobileTabState.btn.appendChild(dropdown);
+    document.body.appendChild(dropdown);
     mobileTabState.dropdown = dropdown;
+    positionTabDropdown();
   };
   const syncTabButtonLabel = () => {
     if (!mobileTabState.btn || !mobileTabState.btn.isConnected) return;
@@ -5390,6 +5650,7 @@ function setupMobileExperience(rpcCall, ctx) {
   titleExtrasObserver.observe(document.body, { childList: true, subtree: true });
   window.addEventListener("resize", () => {
     if (window.innerWidth > 768) closeTabDropdown();
+    else positionTabDropdown();
   });
   document.addEventListener(
     "click",