@wenbin_wb/dsh-bridge 2.10.6 → 2.10.8

package/client/index.js

@@ -84,6 +84,7 @@ const GITHUB_URL = 'https://github.com/wenbin-wb/dsh-bridge';
 const RELEASES_URL = 'https://github.com/wenbin-wb/dsh-bridge/releases';
 const ISSUES_URL = 'https://github.com/wenbin-wb/dsh-bridge/issues/new';
 const TUNNEL_DOCS_URL = 'https://github.com/wenbin-wb/dsh-bridge/blob/main/docs/custom-tunnel.md';
+const CLOUDFLARE_TUTORIAL_URL = 'https://github.com/wenbin-wb/dsh-bridge/blob/main/docs/cloudflare-fixed-domain.md';
 
 // 生成升级命令（拼接具体版本号；用 add 而非 update，update --latest 受已安装依赖版本约束可能无法升级到最新版）
 function upgradeCommands(latest) {
@@ -753,6 +754,12 @@ const CloudflareConfigForm = React.memo(function CloudflareConfigForm({ token, h
       React.createElement('div', { style: { fontSize: 12, color: 'var(--dsw-alias-label-secondary, #6b7280)', marginBottom: 8, lineHeight: 1.5 } },
         '在 Cloudflare Zero Trust 控制台创建 Tunnel 即可获取专属 Token 并绑定自己的域名（如 dsh.yourname.com），每次重启 URL 永不变更。不填则使用默认免登录临时随机域名。'
       ),
+      React.createElement('a', {
+        href: CLOUDFLARE_TUTORIAL_URL,
+        target: '_blank',
+        rel: 'noreferrer',
+        style: { ...s.btnLink, marginBottom: 10 },
+      }, '📖 查看「Cloudflare 固定域名」申请与配置教程'),
       React.createElement('div', { style: { marginBottom: 8 } },
         React.createElement('input', {
           style: s.input,
@@ -2390,6 +2397,8 @@ function VersionBanner({ rpcCall }) {
 
   const hasUpdate = info?.latest && info?.current && !info.error && semverGt(info.latest, info.current);
   const isLatest = info?.latest && info?.current && !info.error && !semverGt(info.latest, info.current);
+  // DSH 宿主更新状态：有线上新版 + 当前版本可比较
+  const dshHasUpdate = !!(info?.dshLatest && info?.dshVersion && !info.error && semverGt(info.dshLatest, info.dshVersion));
 
   const handleUpgrade = React.useCallback(async () => {
     if (!info?.latest || upgrading) return;
@@ -2413,6 +2422,30 @@ function VersionBanner({ rpcCall }) {
     }
   }, [info?.latest, upgrading, rpcCall]);
 
+  // DSH 宿主一键升级：仅当服务端判定可自动升级（npm 全局安装）时按钮才会出现
+  const [dshUpgrading, setDshUpgrading] = React.useState(false);
+  const [dshUpgradeResult, setDshUpgradeResult] = React.useState(null);
+  const handleUpgradeDsh = React.useCallback(async () => {
+    if (!info?.dshLatest || dshUpgrading) return;
+    setDshUpgrading(true);
+    setDshUpgradeResult(null);
+    setDismissRestart(false);
+    resetRestartStatus();
+    try {
+      const r = await rpcCall(BRIDGE_ENDPOINTS.upgradeDsh, { version: info.dshLatest });
+      if (r?.ok && r.value?.ok) {
+        setDshUpgradeResult({ ok: true, message: `DSH 已成功升级到 v${info.dshLatest}！` });
+      } else {
+        const msg = r?.value?.error || r?.error?.message || '升级失败';
+        setDshUpgradeResult({ ok: false, message: msg, manual: true });
+      }
+    } catch (e) {
+      setDshUpgradeResult({ ok: false, message: e.message || '升级请求失败', manual: true });
+    } finally {
+      setDshUpgrading(false);
+    }
+  }, [info?.dshLatest, dshUpgrading, rpcCall]);
+
   const links = React.createElement('div', { style: { display: 'flex', gap: 10, alignItems: 'center', flexWrap: 'wrap' } },
     React.createElement('a', {
       href: GITHUB_URL, target: '_blank', rel: 'noreferrer', style: s.btnLink,
@@ -2471,12 +2504,16 @@ function VersionBanner({ rpcCall }) {
           hasUpdate && React.createElement('span', { style: { fontWeight: 600, fontSize: 11 } }, `➔ v${info.latest}`),
           info?.error && React.createElement('span', { style: { color: 'var(--dsw-alias-state-warn-primary,#d97706)', fontSize: 11 } }, '(网络超时)'),
         ),
-        // DSH 宿主版本标签
+        // DSH 宿主版本标签（有新版时黄色高亮）
         info?.dshVersion && React.createElement('span', {
           style: {
             ...s.tag,
-            background: 'var(--dsw-alias-bg-layer-2,#f3f4f6)',
-            color: 'var(--dsw-alias-label-tertiary,#6b7280)',
+            background: dshHasUpdate
+              ? 'var(--dsw-alias-state-warn-bg,#fffbeb)'
+              : 'var(--dsw-alias-bg-layer-2,#f3f4f6)',
+            color: dshHasUpdate
+              ? 'var(--dsw-alias-state-warn-primary,#d97706)'
+              : 'var(--dsw-alias-label-tertiary,#6b7280)',
             padding: '3px 10px',
             fontSize: 12,
             fontWeight: 500,
@@ -2484,9 +2521,11 @@ function VersionBanner({ rpcCall }) {
             alignItems: 'center',
             gap: 5,
           },
+          title: dshHasUpdate ? `发现 DSH 新版本 v${info.dshLatest}` : undefined,
         },
           React.createElement('span', { style: { opacity: 0.75, fontSize: 11, fontWeight: 400 } }, 'DSH'),
           `v${info.dshVersion}`,
+          dshHasUpdate && React.createElement('span', { style: { fontWeight: 600, fontSize: 11 } }, `➔ v${info.dshLatest}`),
         ),
         // 刷新检查按钮
         React.createElement('button', {
@@ -2665,6 +2704,102 @@ function VersionBanner({ rpcCall }) {
         ),
       ),
     ),
+
+      // ── DSH 宿主有新版本时的提示 / 一键升级卡片 ──
+      dshHasUpdate && React.createElement('div', {
+        style: {
+          ...s.card,
+          background: 'var(--dsw-alias-state-warn-bg,#fffbeb)',
+          border: '1px solid var(--dsw-alias-state-warn-border,#fde68a)',
+          padding: '14px 16px',
+          marginTop: 10,
+          marginBottom: 0,
+        },
+      },
+        React.createElement('div', { style: { display: 'flex', alignItems: 'flex-start', gap: 12 } },
+          React.createElement('span', { style: { fontSize: 22 } }, '🛠️'),
+          React.createElement('div', { style: { flex: 1, minWidth: 0 } },
+            React.createElement('div', { style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between', flexWrap: 'wrap', gap: 8, marginBottom: 8 } },
+              React.createElement('div', {
+                style: { fontSize: 13, fontWeight: 600, color: 'var(--dsw-alias-state-warn-primary,#92400e)' },
+              }, `DSH 有新版本 v${info.dshLatest}（当前 v${info.dshVersion}）`),
+              info?.dshUpgradable
+                ? React.createElement('button', {
+                    style: {
+                      ...s.btnPri,
+                      height: 28,
+                      fontSize: 12,
+                      padding: '0 14px',
+                      background: dshUpgradeResult?.ok
+                        ? 'var(--dsw-alias-state-success-primary,#059669)'
+                        : 'var(--dsw-alias-brand-primary,#4f6ef7)',
+                      opacity: (dshUpgrading || restarting) ? 0.6 : 1,
+                    },
+                    onClick: handleUpgradeDsh,
+                    disabled: dshUpgrading || restarting || dshUpgradeResult?.ok,
+                  },
+                  dshUpgrading
+                    ? React.createElement('span', { style: { display: 'inline-flex', alignItems: 'center', gap: 6 } },
+                        React.createElement('span', { style: { animation: 'spin 1s linear infinite', display: 'inline-flex' } }, React.createElement(Icons.refresh)),
+                        '正在升级 DSH…',
+                      )
+                    : dshUpgradeResult?.ok
+                      ? '✓ DSH 升级完成'
+                      : `一键升级 DSH 到 v${info.dshLatest}`,
+                )
+                : React.createElement('a', {
+                    href: GITHUB_URL, target: '_blank', rel: 'noreferrer',
+                    style: { ...s.btnLink, fontSize: 12, fontWeight: 600 },
+                  }, '查看官方升级方式 ↗'),
+            ),
+            React.createElement('div', {
+              style: { fontSize: 12, color: 'var(--dsw-alias-label-secondary,#6b7280)', lineHeight: 1.6 },
+            },
+              info?.dshUpgradable
+                ? '升级 DSH 命令行工具后需重启 DSH 服务生效。'
+                : (info?.dshUpgradeReason || '当前 DSH 非 npm 全局安装，无法一键自动升级，请按官方渠道手动更新。'),
+            ),
+            dshUpgradeResult && React.createElement('div', {
+              style: {
+                marginTop: 10,
+                fontSize: 12,
+                lineHeight: 1.6,
+                color: dshUpgradeResult.ok
+                  ? 'var(--dsw-alias-state-success-primary,#059669)'
+                  : 'var(--dsw-alias-state-error-primary,#dc2626)',
+              },
+            }, dshUpgradeResult.message),
+            dshUpgradeResult?.ok && !dismissRestart && React.createElement('div', {
+              style: { display: 'flex', gap: 8, alignItems: 'center', flexWrap: 'wrap', marginTop: 10 },
+            },
+              React.createElement('button', {
+                style: { ...s.btnPri, height: 30, fontSize: 12, padding: '0 14px', background: 'var(--dsw-alias-state-success-primary,#059669)' },
+                onClick: handleRestart,
+              }, '🔄 立即重启 DSH 服务'),
+              React.createElement('button', {
+                style: { ...s.btnGhost, height: 30, fontSize: 12, padding: '0 12px' },
+                onClick: () => setDismissRestart(true),
+              }, '稍后手动重启'),
+            ),
+            (restarting || restartStatus) && React.createElement('div', {
+              style: {
+                display: 'flex', alignItems: 'center', gap: 8, fontSize: 12, marginTop: 8,
+                color: restartStatus?.phase === 'success'
+                  ? 'var(--dsw-alias-state-success-primary,#059669)'
+                  : restartStatus?.phase === 'timeout'
+                    ? 'var(--dsw-alias-state-error-primary,#dc2626)'
+                    : 'var(--dsw-alias-state-info-primary,#2563eb)',
+                fontWeight: 500,
+              },
+            },
+              restartStatus?.phase !== 'success' && restartStatus?.phase !== 'timeout' && React.createElement('span', {
+                style: { animation: 'spin 1s linear infinite', display: 'inline-flex' },
+              }, React.createElement(Icons.refresh)),
+              restartStatus?.text || '正在处理…',
+            ),
+          ),
+        ),
+      ),
   );
 }
 
@@ -4560,6 +4695,199 @@ function RemoteDirectoryFlow(props) {
 
 // ---- 插件入口 ----
 
+// iOS Safari 键盘弹起时输入框上下跳动适配。
+//
+// 根因（实测 2026-09）：聊天输入区容器（宿主 wSkVaW_composerSeat）为
+// position:sticky; bottom:0，其滚动容器高度由 100% 链决定。iOS 键盘弹起时
+// visual viewport 收缩，sticky 基准随视口变化 + iOS 反复 scroll 调整 → 每敲一字跳动。
+//
+// 通用解法（不依赖宿主类名）：键盘弹起瞬间找到焦点输入框所属的滚动容器，
+// 把它当前高度用 px 固定（避免随视口继续收缩/重排），键盘收起后还原；
+// 并顺带做一次精确 scrollIntoView，阻止 iOS 二次乱滚。
+function setupIosKeyboardAdapter() {
+  if (typeof window === 'undefined' || !window.visualViewport) return;
+  if (!/iPhone|iPad|iPod/.test(navigator.userAgent || '')) return;
+
+  const vv = window.visualViewport;
+  const isEditable = (el) => el && (el.isContentEditable || el.tagName === 'TEXTAREA' || el.tagName === 'INPUT');
+  let keyboardOpen = false;
+  let pinnedEl = null;   // 被固定高度的滚动容器
+  let pinnedH = null;    // 原始 height（还原用）
+  let pinnedInline = null;
+
+  const findScrollContainer = (el) => {
+    let n = el;
+    while (n && n !== document.body) {
+      const cs = getComputedStyle(n);
+      if ((cs.overflowY === 'auto' || cs.overflowY === 'scroll') && n.scrollHeight > n.clientHeight) {
+        return n;
+      }
+      n = n.parentElement;
+    }
+    return null;
+  };
+
+  vv.addEventListener('resize', () => {
+    const ratio = vv.height / window.innerHeight;
+    const nowOpen = ratio < 0.75;
+    if (nowOpen === keyboardOpen) return;
+    keyboardOpen = nowOpen;
+    const el = document.activeElement;
+
+    if (nowOpen) {
+      // 键盘弹起：固定滚动容器高度，防随视口继续收缩导致 sticky 输入框跳动
+      const scroller = isEditable(el) ? findScrollContainer(el) : null;
+      if (scroller) {
+        pinnedEl = scroller;
+        pinnedInline = scroller.style.height || '';
+        pinnedH = scroller.getBoundingClientRect().height;
+        scroller.style.height = `${Math.round(pinnedH)}px`;
+      }
+      requestAnimationFrame(() => {
+        if (isEditable(el)) {
+          try { el.scrollIntoView({ block: 'nearest' }); } catch { /* 忽略 */ }
+        }
+      });
+    } else {
+      // 键盘收起：还原滚动容器高度，让布局回到正常
+      if (pinnedEl) {
+        pinnedEl.style.height = pinnedInline;
+        pinnedEl = null; pinnedH = null; pinnedInline = null;
+      }
+    }
+  });
+}
+
+// 移动端输入框折叠/展开（body.dsh-composer-collapsed）。
+// 底部输入区（composer）占用 ~116px，顶部菜单 + header 又占 ~120px，屏幕有限时
+// 中间消息可视区很小。折叠后 composer 隐藏、消息 viewArea 自动伸展全高，阅读区显著增大。
+// 折叠态记忆到 localStorage（dsh-composer-fold），跨会话保持用户偏好。
+function setupComposerCollapse() {
+  if (typeof window === 'undefined' || typeof document === 'undefined') return;
+  if (window.innerWidth > 768) return; // 仅移动端
+  const LS_KEY = 'dsh-composer-fold';
+
+  let bar = null;          // 折叠态底部"点击输入"细条
+  let busy = false;        // 防重入锁（observer 由我们自己改动触发时跳过）
+  let lastHadSeat = null;  // 上次检测是否有输入区（避免重复处理）
+
+  // 折叠按钮：注入到聊天头部工具栏（headerUtilities）的 Session 下载按钮旁，
+  // 与 DSH 原生按钮同规格（28px 圆形），视觉与原生一致。返回 null 表示工具栏未就绪。
+  const getFoldBtn = () => {
+    const existing = document.querySelector('.dsh-header-fold-btn');
+    if (existing) return existing;
+    const utils = document.querySelector('div[class*="wSkVaW_headerUtilities"], div[class*="headerUtilities"]');
+    const logBtn = document.querySelector('button[class*="sessionLogButton"], button[class*="nL4_yW_sessionLogButton"]');
+    if (!utils) return null;
+    const btn = document.createElement('button');
+    btn.className = 'dsh-header-fold-btn';
+    btn.setAttribute('aria-label', '收起/展开输入框');
+    btn.innerHTML = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><line x1="3" y1="18" x2="21" y2="18"></line><polyline points="6 9 12 15 18 9"></polyline></svg>';
+    // 插到 session 下载按钮左侧（紧邻原生工具钮）
+    if (logBtn && logBtn.parentElement === utils) utils.insertBefore(btn, logBtn);
+    else utils.appendChild(btn);
+    return btn;
+  };
+  const isCollapsed = () => document.body.classList.contains('dsh-composer-collapsed');
+  const readPref = () => { try { return localStorage.getItem(LS_KEY) === '1'; } catch { return false; } };
+
+  const ensureBar = () => {
+    if (bar && document.body.contains(bar)) return bar;
+    const seat = document.querySelector('div[class*="composerSeat"]');
+    const scrollBody = seat ? seat.parentElement : null;
+    if (!scrollBody) return null;
+    bar = document.createElement('div');
+    bar.className = 'dsh-composer-collapsed-bar';
+    bar.textContent = '\u270f\ufe0f 点击输入消息…';
+    scrollBody.insertBefore(bar, seat);
+    bar.addEventListener('click', () => setCollapsed(false));
+    return bar;
+  };
+  const removeBar = () => { if (bar) { try { bar.remove(); } catch {} bar = null; } };
+
+  // 折叠态切换：改 class + 记忆 + 图标 + 细条显隐
+  const setCollapsed = (collapsed) => {
+    if (busy) return;
+    busy = true;
+    try {
+      if (isCollapsed() !== collapsed) {
+        document.body.classList.toggle('dsh-composer-collapsed', collapsed);
+        try { localStorage.setItem(LS_KEY, collapsed ? '1' : '0'); } catch {}
+        updateButton(collapsed);
+      }
+      if (collapsed) ensureBar(); else removeBar();
+    } finally { busy = false; }
+  };
+
+  // 更新顶部折叠钮图标（仅内容变化时写入，避免无谓 DOM 抖动）
+  const updateButton = (collapsed) => {
+    const btn = getFoldBtn();
+    if (!btn) return;
+    btn.title = collapsed ? '展开输入框' : '收起输入框，最大化对话阅读区';
+    const icon = collapsed
+      ? '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="2" y="6" width="20" height="12" rx="2"></rect><line x1="6" y1="10" x2="6.01" y2="10"></line><line x1="10" y1="10" x2="10.01" y2="10"></line><line x1="14" y1="10" x2="14.01" y2="10"></line><line x1="6" y1="14" x2="10" y2="14"></line><line x1="14" y1="14" x2="18" y2="14"></line></svg>'
+      : '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><line x1="3" y1="18" x2="21" y2="18"></line><polyline points="6 9 12 15 18 9"></polyline></svg>';
+    const existing = btn.querySelector('svg');
+    if (!existing || existing.outerHTML !== icon) btn.innerHTML = icon;
+  };
+
+  // 有输入区（对话页）：确保按钮可用 + 按记忆恢复折叠态
+  const handleSeatPresent = () => {
+    const btn = getFoldBtn();
+    if (!btn) return false;
+    btn.style.display = 'inline-flex';
+    if (!btn._dshFoldWired) {
+      btn._dshFoldWired = true;
+      btn.onclick = (e) => { e.stopPropagation(); setCollapsed(!isCollapsed()); };
+    }
+    document.body.classList.add('dsh-composer-active');
+    const want = readPref();
+    if (want !== isCollapsed()) {
+      setCollapsed(want);
+    } else {
+      updateButton(isCollapsed());
+    }
+    return true;
+  };
+
+  // 无输入区：隐藏折叠钮与细条（保留记忆）
+  const handleSeatAbsent = () => {
+    const btn = getFoldBtn();
+    if (btn) { btn.style.display = 'none'; }
+    document.body.classList.remove('dsh-composer-active');
+    removeBar();
+  };
+
+  // 单次检测（observer 回调 / 初始）。
+  // 仅当"是否有输入区"或"折叠钮是否已注入"发生变化时才全量处理，
+  // 避免消息流式输出等高频 DOM 变化下 observer 反复执行注入/状态恢复。
+  // busy 锁 + 注入幂等共同防止自触发循环。
+  const onComposerChange = () => {
+    const hasSeat = !!document.querySelector('div[class*="composerSeat"]');
+    const hasBtn = !!document.querySelector('.dsh-header-fold-btn');
+    if (busy) return;
+    if (hasSeat === lastHadSeat && hasSeat === hasBtn) return; // 状态与注入都没变：忽略
+    busy = true;
+    try {
+      if (hasSeat) {
+        lastHadSeat = handleSeatPresent(); // 内部幂等；工具栏未就绪返回 false，等下次再试
+      } else {
+        handleSeatAbsent();
+        lastHadSeat = false;
+      }
+    } finally { busy = false; }
+  };
+
+  // observer：断开→处理→重连，杜绝"处理里改 DOM 再触发自己"的死循环
+  const observer = new MutationObserver(() => {
+    observer.disconnect();
+    try { onComposerChange(); } finally { observer.observe(document.body, { childList: true, subtree: true }); }
+  });
+  observer.observe(document.body, { childList: true, subtree: true });
+  onComposerChange(); // 初始检查
+}
+
+
 function apply(ctx) {
   window.__dshClientCtx = ctx;
   const rpcCall = (endpoint, payload, signal) =>
@@ -4568,6 +4896,9 @@ function apply(ctx) {
   window.__dshOpenRemoteWorkspaceModal = (onAdded, onPickDirect, onCancel) =>
     showRemoteWorkspaceDialog(rpcCall, onAdded, ctx, onPickDirect, onCancel);
 
+  setupIosKeyboardAdapter();
+  setupComposerCollapse();
+
   setupMobileExperience(rpcCall, ctx);
 
   const injected = () => ({ pick: () => ctx.workspaces?.pickDirectory?.() });

package/client/mobile-styles.js

@@ -394,6 +394,74 @@ export const MOBILE_STYLES_CSS = `
         padding-bottom: max(16px, env(safe-area-inset-bottom)) !important;
       }
 
+      /* ── 移动端输入框折叠模式（body.dsh-composer-collapsed）──────────────
+         折叠后隐藏吸底输入区，让消息 viewArea 自动伸展到全高，最大化阅读区。
+         入口：聊天头部工具栏（Session 下载钮旁）的折叠按钮，或折叠态底部细输入条点它唤回。
+         状态持久化到 localStorage。 */
+      body.dsh-composer-collapsed div[class*="wSkVaW_composerSeat"] {
+        display: none !important;
+      }
+      body.dsh-composer-collapsed div[class*="wSkVaW_viewArea"] {
+        flex: 1 1 auto !important;
+        height: auto !important;
+        min-height: 0 !important;
+      }
+      /* 折叠时滚动区底部对齐 safe-area，避免内容被 iPhone 底部横条遮挡 */
+      body.dsh-composer-collapsed div[class*="wSkVaW_scrollBody"] {
+        padding-bottom: max(16px, env(safe-area-inset-bottom)) !important;
+      }
+
+      /* 折叠输入框按钮：注入在聊天头部工具栏（Session 下载钮旁），
+         与 DSH sessionLogButton 同规格（28px 圆形图标钮），视觉与原生一致 */
+      .dsh-header-fold-btn {
+        min-width: 28px !important;
+        width: 28px !important;
+        height: 28px !important;
+        padding: 0 !important;
+        border-radius: 50% !important;
+        display: inline-flex !important;
+        align-items: center !important;
+        justify-content: center !important;
+        flex-shrink: 0 !important;
+        border: 1px solid var(--dsw-alias-border-l2, rgba(0, 0, 0, 0.1)) !important;
+        background: var(--dsw-alias-bg-layer-2, rgba(0, 0, 0, 0.03)) !important;
+        color: var(--dsw-alias-label-secondary, #6b7280) !important;
+        cursor: pointer !important;
+        transition: opacity 0.15s !important;
+        box-shadow: 0 1px 2px rgba(0, 0, 0, 0.03) !important;
+        -webkit-tap-highlight-color: transparent !important;
+      }
+      .dsh-header-fold-btn:active {
+        opacity: 0.6 !important;
+      }
+      .dsh-header-fold-btn svg {
+        width: 15px !important;
+        height: 15px !important;
+      }
+
+      /* 折叠态底部细输入条：点击唤起输入框（位于原输入区位置，sticky 底部） */
+      .dsh-composer-collapsed-bar {
+        display: none !important;
+        position: sticky !important;
+        bottom: 0 !important;
+        margin: 8px 12px max(8px, env(safe-area-inset-bottom, 0px)) 12px !important;
+        padding: 11px 16px !important;
+        border-radius: 22px !important;
+        background: var(--dsw-alias-bg-layer-2, #f4f4f7) !important;
+        border: 1px solid rgba(0, 0, 0, 0.07) !important;
+        color: var(--dsw-alias-label-tertiary, #8b93a1) !important;
+        font-size: 13.5px !important;
+        line-height: 1.4 !important;
+        cursor: pointer !important;
+        box-shadow: 0 2px 10px rgba(0, 0, 0, 0.04) !important;
+        -webkit-tap-highlight-color: transparent !important;
+        z-index: 40 !important;
+        box-sizing: border-box !important;
+      }
+      body.dsh-composer-collapsed .dsh-composer-collapsed-bar {
+        display: block !important;
+      }
+
       /* 输入卡片：DeepSeek App 圆角大胶囊造型 */
       div[class*="uV2eYG_card"] {
         border-radius: 26px !important;

package/docs/cloudflare-fixed-domain.md

@@ -0,0 +1,158 @@
+# Cloudflare 固定域名（Token 模式）申请与配置教程
+
+> 适用：想让 dsh-bridge 的公网入口**固定不变**（如 `dsh.yourdomain.com`），而不是每次开启都换新的
+> `trycloudflare.com` 随机地址。全程免费（Cloudflare 免费套餐即可），无需公网 IP、无需备案（境外流量）。
+
+- 预计耗时：20–40 分钟（含域名生效等待）
+- 费用：Cloudflare 免费套餐 $0；域名需自购（约 ¥30–80/年，.com/.net/.xyz 等均可）
+- 💡 **界面语言**：Cloudflare 控制台支持中文。切换方式：页面右上角头像/语言菜单选择「中文（简体）」。本教程同时给出**中英文菜单对照**（如「添加站点 / Add a site」——斜杠前是中文界面名称，斜杠后是英文原名），用哪个界面都能对上。
+
+---
+
+## 原理一句话
+
+你在 Cloudflare 建一条 **Named Tunnel（固定隧道）**，把 `dsh.yourdomain.com` 这个子域名的流量经 Cloudflare 边缘转发到
+你电脑上 dsh-bridge 的本地端口（默认 `3082`）。dsh-bridge 只需要拿到这条隧道的 **Token** 就能替你后台运行
+`cloudflared tunnel run --token <TOKEN>`，隧道进程由 dsh-bridge 托管（崩溃自动重启、随 DSH 启动自愈），域名永不改变。
+
+```
+手机/浏览器 → https://dsh.yourdomain.com → Cloudflare 边缘 → 加密隧道 → 你的电脑:3082 → DSH
+```
+
+---
+
+## 第 1 步：注册 Cloudflare 账号
+
+1. 打开 <https://dash.cloudflare.com/sign-up>，用邮箱注册（或 Google 账号登录）。
+2. 登录后进入 Dashboard。
+
+## 第 2 步：准备一个域名
+
+两种方式任选：
+
+- **已有域名**：确保域名的 DNS 托管在 Cloudflare（见第 3 步）。
+- **没有域名**：
+  1. 在任意注册商购买一个（.com / .net / .xyz / .top 均可，便宜的先练手也行）；
+  2. 拿到域名的 **NS 记录**（或注册商 API 权限），准备迁到 Cloudflare。
+
+## 第 3 步：把域名接入 Cloudflare（DNS 托管）
+
+> 固定域名隧道要求域名由 Cloudflare 托管（DNS 生效才能签发证书、路由流量）。若域名已在 Cloudflare 可跳过本步。
+
+1. Cloudflare Dashboard（控制台）→「**添加站点 / Add a site**」→ 输入你的域名 → 选 **Free（免费）** 套餐 → Continue（继续）。
+2. Cloudflare 会扫描现有 DNS 记录并导入（自动保留）。
+3. 按提示到**域名注册商**处，把域名的 NS（Name Server/名称服务器）改成 Cloudflare 给的两条（形如 `xxx.ns.cloudflare.com`）。
+4. 回 Cloudflare 点「**检查名称服务器 / Check nameservers**」，等待生效（通常几分钟到 24 小时，多数 1 小时内）。
+5. 状态变 **Active（有效）** 即托管完成。
+
+## 第 4 步：进入 Zero Trust 创建固定隧道
+
+1. 打开 Zero Trust 控制台：<https://one.dash.cloudflare.com/>
+   （或 Cloudflare Dashboard 左侧 → **Zero Trust**）。
+2. 首次使用会让你选团队名、套餐——选 **Free（免费）** 计划即可。
+3. 左侧菜单：**Networks（网络）→ Tunnels（隧道）**。
+4. 点 **Create a tunnel（创建隧道）**：
+   - 连接器类型选 **Cloudflared**；
+   - Tunnel name（隧道名称）：起个名，如 `dsh-home`；
+   - 点 **Save tunnel（保存隧道）**。
+5. **⚠️ 立即复制并保存 Token（这一步最要紧！）**
+   保存后页面会给出**安装并运行连接器**的命令，里面带一长串 Token：
+
+   ```bash
+   cloudflared tunnel run --token eyJhIjoi...（极长的一串）
+   ```
+
+   **请现在就把 `--token` 后面那一长串完整复制出来**，粘贴到记事本/密码管理器存好（可以顺手存好 `dsh.yourdomain.com` 这个域名一起备忘）。**复制完再点任何下一步/关闭页面**——万一丢了，见本步下方"Token 找不回来了怎么办"。
+
+   > 🤖 **这段命令不用你自己在电脑上运行**（无论 Windows / macOS / Linux 都不需要）——dsh-bridge 会在后台替你执行
+   > `cloudflared tunnel run --token ...`。这里展示命令只是为了让你看清 Token 长在哪、方便复制那一长串。
+
+> 💡 **Token 找不回来了怎么办**（不用重建隧道，随时可取）：
+>
+> 回到 **Networks（网络）→ Tunnels（隧道）** 列表 → 点你的**隧道名称**进入详情页 → 找 **Configure（配置）**按钮或右上角 **⋯** 菜单（不同时期界面略有差异），点击后页面会显示该隧道的 **Token**，或重新给出 `cloudflared tunnel run --token ...` 的安装命令——复制其中那一长串即可。
+>
+> 取 token 时**无需在电脑上运行任何命令**，Token 就在网页里，直接复制即可。
+
+## 第 5 步：给隧道绑定你的固定子域名（Public Hostname / 公共主机名）
+
+> ⚠️ **关键**：隧道本身不含"域名→本地端口"的路由规则，必须在这里配。而且这个子域名要和你之后在
+> dsh-bridge 面板里填的「自定义固定域名」**完全一致**。
+
+1. 隧道创建后进入隧道详情页 → 切到 **Public Hostname（公共主机名）** 标签 → **Add a public hostname（添加公共主机名）**。
+2. 填写（中英文界面字段对照）：
+   - **Subdomain（子域）**：如 `dsh`
+   - **Domain（域）**：下拉选你的域名（如 `yourdomain.com`）
+   - 即最终 = `dsh.yourdomain.com`
+   - **Service（服务）→ Type（类型）**：`HTTP`
+   - **URL**：`localhost:3082`（dsh-bridge 代理端口；如果你改过 dsh-bridge 端口则填对应端口）
+3. 保存（**Save / 保存**）。Cloudflare 会自动为你签发该域名的免费 TLS 证书并创建 DNS 记录（Tunnel 类型，CNAME 指向 `*.cfargotunnel.com`），无需手动配 DNS。
+4. 状态稍后变为 **Healthy（运行正常）**（见隧道详情的 Connectors（连接器）与 Public Hostname（公共主机名）状态）。
+
+> 端口说明：dsh-bridge 默认把面板代理在 `3082`（`proxyPort`），DSH 原生在 `3080`。**必须指向 3082**（走 dsh-bridge 的
+> 认证/会话/二维码/隧道控制逻辑），不要直接指 3080。
+
+> 端口说明：dsh-bridge 默认把面板代理在 `3082`（`proxyPort`），DSH 原生在 `3080`。**必须指向 3082**（走 dsh-bridge 的
+> 认证/会话/二维码/隧道控制逻辑），不要直接指 3080。
+
+## 第 6 步：把 Token 和域名填回 dsh-bridge
+
+1. 打开 dsh-bridge 面板 → **公网隧道** tab。
+2. 展开底部「**⚙️ 隧道配置**」→「**Cloudflare 隧道**」卡 → 展开「**高级配置：固定域名 (Cloudflare Token)**」。
+3. 填写两项并「保存固定域名配置」：
+   - **自定义固定域名**：`dsh.yourdomain.com`（与第 5 步 Public Hostname **完全一致**，不要带 `https://`）
+   - **Tunnel Token**：第 4/5 步复制的 `cloudflared tunnel run --token` 后的那一长串
+4. 回到顶部「**公网访问入口**」卡 → 点「**开启**」（token 模式下该卡显示固定域名模式）。
+5. 几秒后状态变 **固定隧道已建立 (https://dsh.yourdomain.com)**。
+
+## 第 7 步：验证
+
+1. 浏览器打开 `https://dsh.yourdomain.com` → 应出现 DSH 登录页/面板（取决于你的访问认证设置）。
+2. Cloudflare Zero Trust → **Networks（网络）→ Tunnels（隧道）** → 该隧道 → **Healthy（运行正常）**，Connectors（连接器）有连接。
+3. 重启 DSH 服务或重启电脑，勾选「随 DSH 启动自动开启」后域名保持不变、自动恢复。
+
+---
+
+## 常见问题
+
+### Q1：面板显示"已建立"但浏览器打不开？
+几乎都是 **Public Hostname 与面板填的域名不一致**，或 Service URL 端口写错（应为 `localhost:3082` 而非 3080）。
+逐项核对第 5、6 步。
+
+### Q2：提示"cloudflared 启动失败: Incorrect Usage / flag provided but not defined"？
+请确认 dsh-bridge ≥ **v2.10.7**（v2.10.6 曾因 `--no-autoupdate` 参数位置导致固定域名隧道秒退，已修复）。
+
+### Q3：隧道一直"自动重连中"然后 error？
+先看面板 error 文案：
+- 含 **Incorrect Usage / 配置错误** → Token 复制不完整或参数问题，重新复制整串 Token；
+- 含 **退出 code≠0 / 连接失败** → 多为网络到 Cloudflare 边缘不通或 Token 无效，检查网络后点「开启」重试（自愈已内置退避重试）。
+
+### Q4：需要买最贵的套餐吗？
+不用。Cloudflare **Free** 套餐即可创建固定隧道、绑定子域名、免费 TLS。仅当你想在同一域名下加很多复杂规则或团队审计时才需付费。
+
+### Q5：域名必须在 Cloudflare 托管吗？
+**固定域名隧道是的**（要在 Cloudflare DNS 建 `CNAME → *.cfargotunnel.com` 的记录）。不想迁移主域名的话，
+可以买一个便宜小域名专门做隧道入口，把主域名留在原注册商。
+
+### Q6：为什么面板里"复制 Token"和 Cloudflare 命令里看到的不一样长？
+Token 就是 `cloudflared tunnel run --token` 后面那一长串（不含引号、不含 `--token` 字样本身）。
+若你在别处看到的 token 是用于 `cloudflared tunnel login` 的，那是不同的东西——固定域名模式要的是 **run --token** 那个。
+
+### Q7：创建隧道时忘了复制 Token，页面也关了，去哪找？
+**不需要重建隧道**，Token 随时能在网页里取回：
+
+1. 打开 Zero Trust 控制台 → 左侧 **Networks（网络）→ Tunnels（隧道）**；
+2. 在隧道列表里**点击你那条隧道的名称**（不是行尾的按钮，是名称本身）进入详情；
+3. 详情页找 **Configure（配置）** 按钮，或页面右上角的 **⋯ / 更多** 菜单（不同时期的界面位置可能略有差异，但一定在隧道详情页里）；
+4. 点击后页面会显示该隧道的 **Token**，或者重新给出带 Token 的安装命令（`cloudflared tunnel run --token ...`）；
+5. 复制命令中 `--token` 后面那一长串即可。
+
+> 提示：如果你在列表页只看到 **⋯** 下拉里有 **Edit / 编辑 / Delete / 删除** 而没有 Token，就点**隧道名称先进详情**，
+> Token 在详情页内。整个过程都在浏览器网页里完成，**不需要在电脑上装 cloudflared 或执行任何命令**。
+
+---
+
+## 相关链接
+
+- [Cloudflare Zero Trust 控制台](https://one.dash.cloudflare.com/)
+- [Cloudflare 官方：Create a tunnel (dashboard)](https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/get-started/create-remote-tunnel/)
+- [Cloudflare 官方：Tunnel run 参数（--token / --no-autoupdate）](https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/configure-tunnels/run-parameters/)