@wenbin_wb/dsh-bridge 2.10.15 → 2.11.1

package/CHANGELOG.md

@@ -4,6 +4,46 @@
 
 ---
 
+## [v2.11.1] - 2026-10-02
+
+> 本版为修复版：解决 DSH 0.1.7 升级后暴露的移动端「看不到最新消息」、设置弹窗层级误抬，以及 linux 下托管误判导致的 systemd 掉线问题。
+
+### 🐞 修复
+
+- **手机上聊天区「看不到最新消息」（PR #48，感谢 imroc）**：移动端主框架规则原用 `div[class*="_frame"]` 跨包通配选择器，除了命中有意的布局外壳（`[data-slot="root"]` 直接子元素），还会误伤 DSH 0.1.7 新增的聊天记录容器（`dsh-client-ui-chat` 的 `.EvIC1a_frame`）——给它强加 `height:100dvh + overflow:hidden` 后被钳到视口高度、溢出内容被裁掉，而外层滚动区已到底，表现为「看到旧消息、看不到最新消息」。现选择器收窄为 `[data-slot="root"] > div[class*="_frame"]`，仅命中布局外壳；对 0.1.5 / 0.1.6 宿主无行为差异。
+- **linux 下托管误判与 systemd 掉线**：真实 `/proc/self/cgroup` 带末尾换行且 cgroup v1 为多行，原解析按单行整体切分，导致 `endsWith('.service')` 判定失败、托管器被误判为 `self`，`Restart=on-failure` 下 dsh 掉线不自动拉起。现逐行解析并 trim；同时重启前为 `systemctl` 补齐默认 PATH 与 `XDG_RUNTIME_DIR`（`--user` 场景）、加 5s 执行超时兜底、自动创建日志目录。
+- **设置弹窗自身被层级规则误抬（适配 DSH 0.1.7）**：0.1.7 把设置弹窗（`VOzbGW_overlay`）从 `#root` 内部移为 `<body>` 直接子级，满足「body 子级 + 含 `role=dialog` 子元素」的抬升特征，被一并抬到第三方模态同层，退化成按 DOM 顺序决胜，「安装确认框被盖住」可能复发。现抬升规则排除设置弹窗自身，仍只抬其它顶层模态。
+
+### 🧪 测试
+
+- 新增 `test/restart-dsh.test.mjs` cgroup 多行/换行回归断言；`test/mobile-fixed-panel-offset.test.mjs` 新增 frame 规则限定回归守卫；`test/mobile-settings-narrow-layout.test.mjs` 新增抬升规则排除断言。全量 338 项测试 100% 通过。
+
+> ⚠️ 生效说明：客户端样式刷新页面即生效；重启守护逻辑改动需重启 dsh 后生效。
+
+---
+
+## [v2.11.0] - 2026-09-28
+
+> 本版为客户端架构升级与环境解耦：支持桌面端宿主（如 Tauri）将设置面板作为独立组件嵌入并动态管理设置页入口；同时为 Android 移动壳及第三方自适应插件引入环境自适应让位与多级特性开关，消除界面冲突与遮挡。
+
+### ✨ 新功能
+
+- **客户端宿主接入面（对齐 #51）**：在客户端入口暴露 Cordis 反射服务 `ctx.provide('dsh-bridge', { version: 1, render, setSettingsVisible, settingsVisible, configureFeatures, getFeatures })`。桌面端宿主（如 DSH Desktop / Tauri）可调用 `render()` 将 `BridgePanel` 现构造嵌入自定义侧栏或扩展容器，支持 `preferredTab` 指定默认停靠页并保持动态响应；收编后可调用 `setSettingsVisible(false)` 动态撤下全局设置页中的重复条目。老宿主环境下平稳降级。
+- **设置页左侧导航栏图标定制**：新增 `client/settings-nav-icon.js`，通过 CSS mask 将设置中心原生回退的通用小齿轮（gear）替换为「远程访问 / 手机无线连接」专属矢量图标，颜色自动跟随 `currentColor` 保持原生悬停与激活态一致。
+- **移动端多级特性开关与排障支持（对齐 #52）**：新增 `client/mobile-yield.js`，支持通过 URL 查询参数（如 `?dsh_bridge_tweaks=0` 全局禁用、`?dsh_mobile_header=0` 仅禁用顶栏）、宿主全局配置（`window.__DSH_BRIDGE_CONFIG__`）、运行时反射服务或本地存储细粒度控制移动端 UI 特性。
+
+### 🐞 修复
+
+- **Android 移动壳/已有自适应插件下的界面冲突与顶栏遮挡（#52）**：在 Android 原生 WebView 壳（如 `com.dsharnessmobile.shell`）或已加载移动自适应插件（如 `@dsh-android/dsh-client-ui-responsive`）的环境下，插件主动避让自建 body 级顶栏与全局覆盖样式，杜绝双重顶栏重叠、设置页错位与触控遮挡失效。
+
+### 🧪 测试
+
+- 新增 `test/mobile-yield.test.mjs`（11 条）、`test/client-provide.test.mjs`（6 条）与 `test/settings-nav-icon.test.mjs`（3 条），全量 337 项测试 100% 通过。
+
+> ⚠️ 生效说明：纯前端改动，刷新页面即可生效，无需重启 dsh。
+
+---
+
 ## [v2.10.15] - 2026-09-25
 
 > 本版为设置页关闭按钮的可用性微调：手机上「✕」更容易点中。

package/client/client.js

@@ -78,7 +78,12 @@ var MOBILE_STYLES_CSS = `
        \u5F39\u7A97\u4E4B\u4E0A\u5E76\u76D6\u4F4F\u8BBE\u7F6E\u9875\u3002\u8FD9\u662F\u300C\u6A21\u6001\u5C31\u8BE5\u76D6\u5728\u8BBE\u7F6E\u5F39\u7A97\u4E4B\u4E0A\u300D\u7684\u65E2\u5B9A\u53D6\u820D\uFF1A\u5B81\u53EF\u8BA9\u771F\u6A21\u6001
        \u53EF\u89C1\uFF0C\u4E5F\u4E0D\u63A5\u53D7"\u5F39\u4E86\u5374\u70B9\u4E0D\u5230"\u3002\u72EC\u7ACB\u9A8C\u6536\u5DF2\u5B9E\u6D4B\u8BE5\u6784\u9020\u4F1A\u547D\u4E2D\uFF1B\u82E5\u5C06\u6765\u771F\u8E29\u5230\uFF0C
        \u5E94\u6539\u4E3A\u6309\u300C\u8BE5\u6D6E\u5C42\u662F\u5426\u53EF\u5173\u95ED\u300D\u8FDB\u4E00\u6B65\u6536\u7A84\uFF0C\u800C\u4E0D\u662F\u56DE\u9000\u8FD9\u6761\u89C4\u5219\u3002 */
-    body:has(div[class*="VOzbGW_overlay"]) > div:has(> div[class*="mask"], > div[role="dialog"]) {
+    /* \u26A0\uFE0F \u5FC5\u987B\u6392\u9664\u8BBE\u7F6E\u5F39\u7A97\u81EA\u8EAB\uFF1ADSH 0.1.7 \u628A VOzbGW_overlay \u53D8\u6210\u4E86 <body> \u7684\u76F4\u63A5\u5B50\u7EA7
+       \uFF080.1.5 \u91CC\u5B83\u5D4C\u5728 #root \u5185\u90E8\uFF09\uFF0C\u5B83\u540C\u6837\u6EE1\u8DB3\u300Cbody \u5B50\u7EA7 + \u542B role=dialog \u5B50\u5143\u7D20\u300D\uFF0C
+       \u4F1A\u88AB\u672C\u6761\u4E00\u5E76\u62AC\u5230 10050 \u2014\u2014 \u4E8E\u662F\u4E0E\u7B2C\u4E09\u65B9\u6A21\u6001\u6839\u540C\u5C42\u3001\u9000\u5316\u6210\u6309 DOM \u987A\u5E8F\u51B3\u80DC\uFF0C
+       \u521A\u4FEE\u597D\u7684\u300C\u5B89\u88C5\u786E\u8BA4\u6846\u88AB\u76D6\u4F4F\u300D\u5C31\u53EF\u80FD\u590D\u53D1\u3002:not(...) \u628A\u5B83\u6392\u9664\uFF0C\u8BA9\u8BBE\u7F6E\u5F39\u7A97\u7EE7\u7EED\u7531
+       \u5B83\u81EA\u5DF1\u7684 10002 \u89C4\u5219\u5B9A\u4F4D\uFF0C\u672C\u6761\u53EA\u62AC**\u5176\u5B83**\u9876\u5C42\u6A21\u6001\u3002 */
+    body:has(div[class*="VOzbGW_overlay"]) > div:has(> div[class*="mask"], > div[role="dialog"]):not([class*="VOzbGW_overlay"]) {
       z-index: 10050 !important;
     }
 
@@ -104,8 +109,17 @@ var MOBILE_STYLES_CSS = `
        \uFF08dsh-client-ui-sidebar-right/lib/client.js\uFF09\uFF0C\u6545\u79FB\u52A8\u7AEF\u6837\u5F0F\u53D6 <=767px\uFF0C
        768px \u8D77\u5F7B\u5E95\u4EA4\u8FD8\u684C\u9762\u5E03\u5C40\uFF0C\u907F\u514D"\u6865\u6E32\u67D3\u9876\u680F\u3001\u5BBF\u4E3B\u5374\u672A\u5168\u5C4F"\u7684\u9519\u4F4D\u3002 */
     @media (max-width: 767px) {
-      /* 1. \u4E3B\u6846\u67B6\u4E3A Header \u817E\u51FA\u9876\u90E8\u7A7A\u95F4 */
-      div[class*="_frame"] {
+      /* 1. \u4E3B\u6846\u67B6\u4E3A Header \u817E\u51FA\u9876\u90E8\u7A7A\u95F4\u3002
+
+         \u9009\u62E9\u5668\u5FC5\u987B\u9650\u5B9A\u5728\u5E03\u5C40\u5916\u58F3\uFF08dsh-client-ui-layout \u7684 AppFrame\uFF0C\u5373
+         [data-slot="root"] \u7684\u76F4\u63A5\u5B50\u5143\u7D20\uFF09\u3002\u5BBF\u4E3B\u7684 CSS-module \u54C8\u5E0C\u53EA\u4FDD\u8BC1\u540C\u6587\u4EF6
+         \u5185\u552F\u4E00\uFF0C*="_frame" \u662F\u8DE8\u5305\u901A\u914D\uFF1A\u804A\u5929\u8BB0\u5F55\u5BB9\u5668\uFF08dsh-client-ui-chat \u7684
+         .EvIC1a_frame\uFF0C\u540C\u6837\u4EE5 _frame \u7ED3\u5C3E\uFF09\u4E5F\u4F1A\u88AB\u547D\u4E2D\u3002\u4E00\u65E6\u547D\u4E2D\uFF0C\u5B83\u88AB\u5F3A\u52A0
+         height:100dvh + overflow:hidden\uFF0C\u5728\u624B\u673A\u4E0A\u88AB\u94B3\u5230\u89C6\u53E3\u9AD8\u5EA6\u5E76\u88C1\u6389\u6EA2\u51FA\u5185\u5BB9\uFF1A
+         \u5916\u5C42 [data-conversation-scroll] \u5DF2\u6EDA\u5230\u5E95\u3001\u5185\u90E8\u5374\u8FD8\u6709\u6570\u5343 px \u8BFB\u4E0D\u5230\uFF0C
+         \u8868\u73B0\u4E3A\u300C\u770B\u4E0D\u5230\u6700\u65B0\u6D88\u606F\u300D\u3002\u5B98\u65B9\u7ED9\u8BE5\u5BB9\u5668\u7684\u89C4\u5219\u662F flex:none;height:auto
+         \uFF08\u8BA9\u8BB0\u5F55\u968F\u5185\u5BB9\u81EA\u7136\u589E\u9AD8\u3001\u7531\u5916\u5C42\u7EDF\u4E00\u6EDA\u52A8\uFF09\uFF0C\u4E0E\u8FD9\u91CC\u51B2\u7A81\uFF0C\u6545\u5FC5\u987B\u6392\u9664\u3002 */
+      [data-slot="root"] > div[class*="_frame"] {
         display: flex !important;
         flex-direction: column !important;
         width: 100vw !important;
@@ -1374,6 +1388,166 @@ function shouldYieldToOfficialPicker(facts) {
   return Boolean(facts?.local) && Boolean(facts?.officialPicker);
 }
 
+// client/mobile-yield.js
+var FEATURES = {
+  MOBILE_HEADER: "mobileHeader",
+  MOBILE_STYLES: "mobileStyles",
+  COMPOSER_COLLAPSE: "composerCollapse"
+};
+var runtimeFeatureOverrides = {};
+function setRuntimeFeatureOverrides(overrides) {
+  if (overrides && typeof overrides === "object") {
+    runtimeFeatureOverrides = { ...runtimeFeatureOverrides, ...overrides };
+  }
+}
+function getRuntimeFeatureOverrides() {
+  return { ...runtimeFeatureOverrides };
+}
+function detectMobileShellOrResponsivePlugin() {
+  if (typeof window === "undefined") return false;
+  if (window.__DSH_MOBILE_SHELL__ || window.__TAURI__ || window.__DSH_DESKTOP__) {
+    return true;
+  }
+  if (window.__DSH_CLIENT_UI_RESPONSIVE__) {
+    return true;
+  }
+  if (typeof document !== "undefined") {
+    if (document.querySelector("[data-dsh-responsive-mobile]") || document.querySelector("[data-dsh-mobile-shell]")) {
+      return true;
+    }
+  }
+  return false;
+}
+function isFeatureEnabled(featureName, defaultDetector) {
+  if (typeof window === "undefined") {
+    return typeof defaultDetector === "function" ? defaultDetector() : true;
+  }
+  try {
+    if (window.location && window.location.search) {
+      const params = new URLSearchParams(window.location.search);
+      const tweaksVal = params.get("dsh_bridge_tweaks") ?? params.get("dsh_mobile_tweaks");
+      if (tweaksVal === "0" || tweaksVal === "false" || tweaksVal === "off") {
+        return false;
+      }
+      if (tweaksVal === "1" || tweaksVal === "true" || tweaksVal === "on") {
+        return true;
+      }
+      const kebabName = featureName.replace(/[A-Z]/g, (m) => `_${m.toLowerCase()}`);
+      const specificVal = params.get(`dsh_${kebabName}`) ?? params.get(`dsh_${featureName}`);
+      if (specificVal === "0" || specificVal === "false" || specificVal === "off") {
+        return false;
+      }
+      if (specificVal === "1" || specificVal === "true" || specificVal === "on") {
+        return true;
+      }
+    }
+  } catch {
+  }
+  try {
+    const hostConfig = window.__DSH_BRIDGE_CONFIG__;
+    if (hostConfig && typeof hostConfig === "object") {
+      if (hostConfig.disablePageTweaks === true || hostConfig.disableMobileTweaks === true) {
+        return false;
+      }
+      if (typeof hostConfig[featureName] === "boolean") {
+        return hostConfig[featureName];
+      }
+    }
+  } catch {
+  }
+  if (typeof runtimeFeatureOverrides[featureName] === "boolean") {
+    return runtimeFeatureOverrides[featureName];
+  }
+  try {
+    if (window.localStorage) {
+      const stored = window.localStorage.getItem(`dsh_bridge:feature:${featureName}`);
+      if (stored === "0" || stored === "false") return false;
+      if (stored === "1" || stored === "true") return true;
+    }
+  } catch {
+  }
+  if (typeof defaultDetector === "function") {
+    return defaultDetector();
+  }
+  return true;
+}
+function shouldYieldMobileHeader() {
+  return !isFeatureEnabled(FEATURES.MOBILE_HEADER, () => {
+    return !detectMobileShellOrResponsivePlugin();
+  });
+}
+function shouldYieldMobileStyles() {
+  return !isFeatureEnabled(FEATURES.MOBILE_STYLES, () => {
+    return !detectMobileShellOrResponsivePlugin();
+  });
+}
+function shouldYieldComposerCollapse() {
+  return !isFeatureEnabled(FEATURES.COMPOSER_COLLAPSE, () => {
+    return !detectMobileShellOrResponsivePlugin();
+  });
+}
+
+// client/settings-nav-icon.js
+var SETTINGS_NAV_MARKER = "data-dsh-bridge-settings-nav";
+var REMOTE_NAV_SVG = `<svg xmlns='http://www.w3.org/2000/svg' width='24' height='24' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'><rect width='10' height='16' x='3' y='4' rx='2'/><path d='M7 16h2'/><path d='M17 8a4 4 0 0 1 0 8'/><path d='M20 5a8 8 0 0 1 0 14'/></svg>`;
+function getNavIconCss(customSvg = REMOTE_NAV_SVG) {
+  const maskUrl = `data:image/svg+xml,${encodeURIComponent(customSvg)}`;
+  return `
+[${SETTINGS_NAV_MARKER}] > svg:first-child {
+  display: none !important;
+}
+[${SETTINGS_NAV_MARKER}]::before {
+  content: '';
+  flex: none;
+  width: 16px;
+  height: 16px;
+  background-color: currentColor;
+  -webkit-mask: url("${maskUrl}") center / contain no-repeat;
+  mask: url("${maskUrl}") center / contain no-repeat;
+}
+`;
+}
+function registerSettingsNavIcon(resolveLabel = () => "\u8FDC\u7A0B\u8BBF\u95EE") {
+  if (typeof document === "undefined") return () => {
+  };
+  const styleId = "dsh-bridge-settings-nav-icon-style";
+  if (!document.getElementById(styleId)) {
+    const style = document.createElement("style");
+    style.id = styleId;
+    style.dataset.plugin = "@wenbin_wb/dsh-bridge";
+    style.dataset.pluginCss = "@wenbin_wb/dsh-bridge/settings-nav-icon";
+    style.textContent = getNavIconCss();
+    document.head.appendChild(style);
+  }
+  let disposed = false;
+  const sync = () => {
+    if (disposed) return;
+    const currentLabel = typeof resolveLabel === "function" ? resolveLabel().trim() : "\u8FDC\u7A0B\u8BBF\u95EE";
+    const buttons = document.querySelectorAll('[role="dialog"] nav button, div[class*="VOzbGW_nav"] button');
+    for (const button of buttons) {
+      const text = button.textContent?.trim() || "";
+      if (currentLabel.length > 0 && (text === currentLabel || text.includes(currentLabel))) {
+        button.setAttribute(SETTINGS_NAV_MARKER, "");
+      } else if (button.hasAttribute(SETTINGS_NAV_MARKER)) {
+        button.removeAttribute(SETTINGS_NAV_MARKER);
+      }
+    }
+  };
+  sync();
+  let observer = null;
+  if (typeof MutationObserver !== "undefined") {
+    observer = new MutationObserver(sync);
+    observer.observe(document.body, { childList: true, subtree: true, characterData: true });
+  }
+  return () => {
+    disposed = true;
+    if (observer) observer.disconnect();
+    document.querySelectorAll(`[${SETTINGS_NAV_MARKER}]`).forEach((el) => el.removeAttribute(SETTINGS_NAV_MARKER));
+    const styleEl = document.getElementById(styleId);
+    if (styleEl) styleEl.remove();
+  };
+}
+
 // lib/bridge-rpc-constants.js
 var BRIDGE_RPC_CHANNEL = "/dsh-bridge";
 var BRIDGE_ENDPOINTS = {
@@ -4860,10 +5034,13 @@ function TabBar({ active, onChange, dots }) {
     })
   );
 }
-function BridgePanel({ rpcCall }) {
+function BridgePanel({ rpcCall, preferredTab }) {
   const [status, setStatus] = React.useState(null);
   const [err, setErr] = React.useState(null);
-  const [activeTab, setActiveTab] = React.useState("lan");
+  const [activeTab, setActiveTab] = React.useState(preferredTab || "lan");
+  React.useEffect(() => {
+    if (preferredTab) setActiveTab(preferredTab);
+  }, [preferredTab]);
   const [platforms, setPlatforms] = React.useState(null);
   const [selectedPlatform, setSelectedPlatform] = React.useState("wechat");
   const [copiedUrl, setCopiedUrl] = React.useState("");
@@ -5645,6 +5822,7 @@ function BridgePanel({ rpcCall }) {
 }
 function injectMobileStyles() {
   if (typeof document === "undefined") return;
+  if (shouldYieldMobileStyles()) return;
   if (document.getElementById("dsh-bridge-mobile-styles")) return;
   const style = document.createElement("style");
   style.id = "dsh-bridge-mobile-styles";
@@ -5703,6 +5881,7 @@ function setupSettingsDrilldown() {
 function setupMobileExperience(rpcCall, ctx) {
   if (typeof document === "undefined" || typeof window === "undefined") return;
   injectMobileStyles();
+  if (shouldYieldMobileHeader()) return;
   let header = document.querySelector(".dsh-mobile-app-header");
   let titleEl = document.querySelector(".dsh-mobile-header-title");
   if (!header) {
@@ -6659,8 +6838,9 @@ function setupIosKeyboardAdapter() {
   });
 }
 function setupComposerCollapse() {
-  if (typeof window === "undefined" || typeof document === "undefined") return;
+  if (typeof window === "undefined" || typeof document === "undefined" || typeof MutationObserver === "undefined") return;
   if (window.innerWidth > MOBILE_MAX_WIDTH) return;
+  if (shouldYieldComposerCollapse()) return;
   const LS_KEY = "dsh-composer-fold";
   let bar = null;
   let busy = false;
@@ -6793,6 +6973,11 @@ function setupComposerCollapse() {
 function apply(ctx) {
   window.__dshClientCtx = ctx;
   setupSettingsDrilldown();
+  if (typeof ctx.effect === "function") {
+    ctx.effect(() => registerSettingsNavIcon(() => "\u8FDC\u7A0B\u8BBF\u95EE"), "dsh-bridge: settings nav icon");
+  } else {
+    registerSettingsNavIcon(() => "\u8FDC\u7A0B\u8BBF\u95EE");
+  }
   const rpcCall = (endpoint, payload, signal) => ctx.connection.rpc.call(BRIDGE_RPC_CHANNEL, endpoint, payload, signal);
   window.__dshOpenRemoteWorkspaceModal = (onAdded, onPickDirect, onCancel) => showRemoteWorkspaceDialog(rpcCall, onAdded, ctx, onPickDirect, onCancel);
   setupIosKeyboardAdapter();
@@ -6824,19 +7009,74 @@ function apply(ctx) {
       );
     })
   );
-  ctx.slots.inject(
-    "settings.section",
-    () => ctx.slots.register(
-      {
-        name: "settings.section",
-        id: "dsh-bridge",
-        order: 10,
-        label: () => "\u8FDC\u7A0B\u8BBF\u95EE",
-        inject: () => ({ rpcCall })
-      },
-      BridgePanel
-    )
-  );
+  let settingsVisible = true;
+  let sectionRegistration = null;
+  const ensureSectionRegistered = () => {
+    if (!settingsVisible || sectionRegistration) return;
+    try {
+      sectionRegistration = ctx.slots.register(
+        {
+          name: "settings.section",
+          id: "dsh-bridge",
+          order: 10,
+          label: () => "\u8FDC\u7A0B\u8BBF\u95EE",
+          inject: () => ({ rpcCall })
+        },
+        BridgePanel
+      );
+    } catch {
+    }
+  };
+  const ensureSectionUnregistered = () => {
+    if (!sectionRegistration) return;
+    try {
+      if (typeof sectionRegistration === "function") {
+        sectionRegistration();
+      } else if (typeof sectionRegistration.dispose === "function") {
+        sectionRegistration.dispose();
+      }
+    } catch {
+    }
+    sectionRegistration = null;
+  };
+  const sectionGate = {
+    visible: () => settingsVisible,
+    setVisible: (visible) => {
+      const next = !!visible;
+      if (settingsVisible === next) return;
+      settingsVisible = next;
+      if (next) {
+        ensureSectionRegistered();
+      } else {
+        ensureSectionUnregistered();
+      }
+    }
+  };
+  ctx.slots.inject("settings.section", () => {
+    if (settingsVisible) {
+      ensureSectionRegistered();
+    }
+  });
+  const bridgeControl = {
+    version: 1,
+    /** 把插件自己的面板交给宿主渲染（返回 React element） */
+    render: (props = {}) => {
+      return React.createElement(BridgePanel, {
+        rpcCall,
+        preferredTab: props.preferredTab,
+        ...props
+      });
+    },
+    /** 宿主收编面板后，撤下设置页那条重复入口 */
+    setSettingsVisible: (visible) => sectionGate.setVisible(visible),
+    settingsVisible: () => sectionGate.visible(),
+    /** 运行时动态特性开关配置 (Issue #52) */
+    configureFeatures: (flags) => setRuntimeFeatureOverrides(flags),
+    getFeatures: () => getRuntimeFeatureOverrides()
+  };
+  if (typeof ctx.provide === "function") {
+    ctx.provide("dsh-bridge", bridgeControl);
+  }
 }
 
     return module.exports;

package/client/index.js

@@ -5,6 +5,14 @@ import {
   fetchLoopbackTokenOnce,
 } from './unlock-manager.js'
 import { hasOfficialDirectoryPicker, shouldYieldToOfficialPicker } from './picker-yield.js'
+import {
+  shouldYieldMobileHeader,
+  shouldYieldMobileStyles,
+  shouldYieldComposerCollapse,
+  setRuntimeFeatureOverrides,
+  getRuntimeFeatureOverrides,
+} from './mobile-yield.js'
+import { registerSettingsNavIcon } from './settings-nav-icon.js'
 // dsh-bridge 客户端插件：设置页「远程访问」面板
 
 // 兼容非 HTTPS 环境（如手机局域网 HTTP 访问）：为非安全上下文补齐 crypto.randomUUID
@@ -3081,10 +3089,13 @@ function TabBar({ active, onChange, dots }) {
 
 // ---- 主面板 ----
 
-function BridgePanel({ rpcCall }) {
+function BridgePanel({ rpcCall, preferredTab }) {
   const [status, setStatus]       = React.useState(null);
   const [err, setErr]             = React.useState(null);
-  const [activeTab, setActiveTab] = React.useState('lan');
+  const [activeTab, setActiveTab] = React.useState(preferredTab || 'lan');
+  React.useEffect(() => {
+    if (preferredTab) setActiveTab(preferredTab);
+  }, [preferredTab]);
   // 平台列表和连接状态
   const [platforms, setPlatforms] = React.useState(null);
   const [selectedPlatform, setSelectedPlatform] = React.useState('wechat');
@@ -3819,6 +3830,7 @@ function BridgePanel({ rpcCall }) {
 
 function injectMobileStyles() {
   if (typeof document === 'undefined') return;
+  if (shouldYieldMobileStyles()) return;
   if (document.getElementById('dsh-bridge-mobile-styles')) return;
 
   const style = document.createElement('style');
@@ -3915,6 +3927,7 @@ function setupSettingsDrilldown() {
 function setupMobileExperience(rpcCall, ctx) {
   if (typeof document === 'undefined' || typeof window === 'undefined') return;
   injectMobileStyles();
+  if (shouldYieldMobileHeader()) return;
 
   // 1. 创建顶部 DeepSeek App 风格导航条 (Header: 左侧双横线，中间当前会话标题，右侧(+))
   let header = document.querySelector('.dsh-mobile-app-header');
@@ -5067,8 +5080,9 @@ function setupIosKeyboardAdapter() {
 // 中间消息可视区很小。折叠后 composer 隐藏、消息 viewArea 自动伸展全高，阅读区显著增大。
 // 折叠态记忆到 localStorage（dsh-composer-fold），跨会话保持用户偏好。
 function setupComposerCollapse() {
-  if (typeof window === 'undefined' || typeof document === 'undefined') return;
+  if (typeof window === 'undefined' || typeof document === 'undefined' || typeof MutationObserver === 'undefined') return;
   if (window.innerWidth > MOBILE_MAX_WIDTH) return; // 仅移动端
+  if (shouldYieldComposerCollapse()) return;
   const LS_KEY = 'dsh-composer-fold';
 
   let bar = null;          // 折叠态底部"点击输入"细条
@@ -5197,6 +5211,12 @@ function apply(ctx) {
   // 放在最前：交互层先就绪，后续任何初始化抛异常都不会留下「CSS 生效但监听器缺失」
   // 的状态（CSS 6.2 块另有 <html> 就绪开关双重兜底）。
   setupSettingsDrilldown();
+  // 设置页左侧导航栏图标定制：将原生通用齿轮替换为远程访问专属图标
+  if (typeof ctx.effect === 'function') {
+    ctx.effect(() => registerSettingsNavIcon(() => '远程访问'), 'dsh-bridge: settings nav icon');
+  } else {
+    registerSettingsNavIcon(() => '远程访问');
+  }
   const rpcCall = (endpoint, payload, signal) =>
     ctx.connection.rpc.call(BRIDGE_RPC_CHANNEL, endpoint, payload, signal);
 
@@ -5245,18 +5265,80 @@ function apply(ctx) {
     }),
   );
 
-  ctx.slots.inject('settings.section', () =>
-    ctx.slots.register(
-      {
-        name: 'settings.section',
-        id: 'dsh-bridge',
-        order: 10,
-        label: () => '远程访问',
-        inject: () => ({ rpcCall }),
-      },
-      BridgePanel,
-    ),
-  );
+  // 设置页条目动态门控与可见性管理 (Issue #51)
+  let settingsVisible = true;
+  let sectionRegistration = null;
+
+  const ensureSectionRegistered = () => {
+    if (!settingsVisible || sectionRegistration) return;
+    try {
+      sectionRegistration = ctx.slots.register(
+        {
+          name: 'settings.section',
+          id: 'dsh-bridge',
+          order: 10,
+          label: () => '远程访问',
+          inject: () => ({ rpcCall }),
+        },
+        BridgePanel,
+      );
+    } catch {}
+  };
+
+  const ensureSectionUnregistered = () => {
+    if (!sectionRegistration) return;
+    try {
+      if (typeof sectionRegistration === 'function') {
+        sectionRegistration();
+      } else if (typeof sectionRegistration.dispose === 'function') {
+        sectionRegistration.dispose();
+      }
+    } catch {}
+    sectionRegistration = null;
+  };
+
+  const sectionGate = {
+    visible: () => settingsVisible,
+    setVisible: (visible) => {
+      const next = !!visible;
+      if (settingsVisible === next) return;
+      settingsVisible = next;
+      if (next) {
+        ensureSectionRegistered();
+      } else {
+        ensureSectionUnregistered();
+      }
+    },
+  };
+
+  ctx.slots.inject('settings.section', () => {
+    if (settingsVisible) {
+      ensureSectionRegistered();
+    }
+  });
+
+  // 暴露客户端反射控制面 (Issue #51)
+  const bridgeControl = {
+    version: 1,
+    /** 把插件自己的面板交给宿主渲染（返回 React element） */
+    render: (props = {}) => {
+      return React.createElement(BridgePanel, {
+        rpcCall,
+        preferredTab: props.preferredTab,
+        ...props,
+      });
+    },
+    /** 宿主收编面板后，撤下设置页那条重复入口 */
+    setSettingsVisible: (visible) => sectionGate.setVisible(visible),
+    settingsVisible: () => sectionGate.visible(),
+    /** 运行时动态特性开关配置 (Issue #52) */
+    configureFeatures: (flags) => setRuntimeFeatureOverrides(flags),
+    getFeatures: () => getRuntimeFeatureOverrides(),
+  };
+
+  if (typeof ctx.provide === 'function') {
+    ctx.provide('dsh-bridge', bridgeControl);
+  }
 }
 
 export { name, inject, apply };

package/client/mobile-styles.js

@@ -47,7 +47,12 @@ export const MOBILE_STYLES_CSS = `
        弹窗之上并盖住设置页。这是「模态就该盖在设置弹窗之上」的既定取舍：宁可让真模态
        可见，也不接受"弹了却点不到"。独立验收已实测该构造会命中；若将来真踩到，
        应改为按「该浮层是否可关闭」进一步收窄，而不是回退这条规则。 */
-    body:has(div[class*="VOzbGW_overlay"]) > div:has(> div[class*="mask"], > div[role="dialog"]) {
+    /* ⚠️ 必须排除设置弹窗自身：DSH 0.1.7 把 VOzbGW_overlay 变成了 <body> 的直接子级
+       （0.1.5 里它嵌在 #root 内部），它同样满足「body 子级 + 含 role=dialog 子元素」，
+       会被本条一并抬到 10050 —— 于是与第三方模态根同层、退化成按 DOM 顺序决胜，
+       刚修好的「安装确认框被盖住」就可能复发。:not(...) 把它排除，让设置弹窗继续由
+       它自己的 10002 规则定位，本条只抬**其它**顶层模态。 */
+    body:has(div[class*="VOzbGW_overlay"]) > div:has(> div[class*="mask"], > div[role="dialog"]):not([class*="VOzbGW_overlay"]) {
       z-index: 10050 !important;
     }
 
@@ -73,8 +78,17 @@ export const MOBILE_STYLES_CSS = `
        （dsh-client-ui-sidebar-right/lib/client.js），故移动端样式取 <=767px，
        768px 起彻底交还桌面布局，避免"桥渲染顶栏、宿主却未全屏"的错位。 */
     @media (max-width: 767px) {
-      /* 1. 主框架为 Header 腾出顶部空间 */
-      div[class*="_frame"] {
+      /* 1. 主框架为 Header 腾出顶部空间。
+
+         选择器必须限定在布局外壳（dsh-client-ui-layout 的 AppFrame，即
+         [data-slot="root"] 的直接子元素）。宿主的 CSS-module 哈希只保证同文件
+         内唯一，*="_frame" 是跨包通配：聊天记录容器（dsh-client-ui-chat 的
+         .EvIC1a_frame，同样以 _frame 结尾）也会被命中。一旦命中，它被强加
+         height:100dvh + overflow:hidden，在手机上被钳到视口高度并裁掉溢出内容：
+         外层 [data-conversation-scroll] 已滚到底、内部却还有数千 px 读不到，
+         表现为「看不到最新消息」。官方给该容器的规则是 flex:none;height:auto
+         （让记录随内容自然增高、由外层统一滚动），与这里冲突，故必须排除。 */
+      [data-slot="root"] > div[class*="_frame"] {
         display: flex !important;
         flex-direction: column !important;
         width: 100vw !important;