@wenbin_wb/dsh-bridge 2.10.7 → 2.10.9

package/client/index.js

@@ -2397,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;
@@ -2420,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,
@@ -2478,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,
@@ -2491,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', {
@@ -2672,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 || '正在处理…',
+            ),
+          ),
+        ),
+      ),
   );
 }
 
@@ -4567,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) =>
@@ -4575,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/telegram-usage.md

@@ -90,4 +90,4 @@
 2. **安全白名单拦截**：
    - 仅白名单内的用户消息会被放行给 Agent；非白名单用户发送的消息会被直接忽略，绝不消耗 Token 或喂给模型。
 3. **敏感操作审批**：
-   - 当 Agent 尝试执行系统命令或敏感文件读写时，Telegram 会自动下发 `[✓ 批准执行]` / `[✕ 拒绝执行]` 交互按键，10 分钟未处理自动超时拒绝。
+   - 当 Agent 尝试执行系统命令或敏感文件读写时，Telegram 会自动下发 `[✓ 批准执行]` / `[✕ 拒绝执行]` 交互按键，10 分钟未处理自动超时拒绝。

package/lib/auth/dsh-native-cookie.js

@@ -0,0 +1,148 @@
+// DSH 原生浏览器鉴权的兼容层（lib/auth/dsh-native-cookie.js）
+//
+// 背景
+// ---------------------------------------------------------------
+// DSH 从 0.1.2 起为 `dsh web` 引入了"原生浏览器鉴权"：
+//   1. 启动时打印带一次性 launch token 的地址：http://127.0.0.1:<port>/?token=…
+//   2. `GET /?token=<token>` 校验通过后 303 重定向到 `/`，并下发签名会话 cookie
+//   3. 此后所有受保护路由（`/`、`/api`、以及任何经
+//      `ctx.connection.rpc.handle()` 注册的通道）都要求该 cookie，否则 401
+//
+// cookie 的构造（见 @deepseek-ai/dsh-client-connection 的 BrowserAuth）：
+//   名称：`dsh-auth-` + base64url(sha256(authority))，authority = `127.0.0.1:<port>`
+//   值  ：`v1.<base64url(JSON payload)>.<base64url(HMAC-SHA256(secret, body))>`
+//   载荷：`{ version: 1, authority, issuedAt, expiresAt }`（均为安全整数）
+//   密钥：`<DSH_HOME>/.credentials.yaml` 里 record
+//         `client-connection/browser-session` 的 `payload.secret`（base64url 32 字节）
+//
+// 为什么本插件需要它
+// ---------------------------------------------------------------
+// 本插件的自建反向代理监听自己的端口（默认 3082），对外提供局域网/隧道访问，
+// 再把请求转发到 DSH 回环地址。浏览器持有的是"代理 origin"的 cookie，
+// 而 DSH 的 cookie 绑定的是 `127.0.0.1:<dshPort>` 这个 authority，两者不是同一个，
+// 因此代理必须自行注入一枚合法的 loopback 会话 cookie，否则远程访问会一律 401。
+//
+// 本模块只做"按 DSH 的格式生成一枚回环会话 cookie"，不引入任何三方依赖。
+
+import { createHash, createHmac } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+/** DSH 会话 cookie 的名称前缀（与 dsh-client-connection 的 COOKIE_PREFIX 一致）。 */
+export const DSH_AUTH_COOKIE_PREFIX = 'dsh-auth-';
+
+/** cookie 载荷版本（与 dsh-client-connection 的 COOKIE_PAYLOAD_VERSION 一致）。 */
+export const DSH_AUTH_COOKIE_VERSION = 1;
+
+/** 会话 cookie 有效期（毫秒）。与 DSH 默认的 cookieMaxAgeDays=30 对齐。 */
+export const DSH_AUTH_COOKIE_MAX_AGE_MS = 30 * 24 * 3600 * 1000;
+
+/** 承载签名密钥的 DSH 凭据记录键。 */
+export const DSH_BROWSER_SESSION_RECORD = 'client-connection/browser-session';
+
+function base64Url(value) {
+  return Buffer.from(value).toString('base64url');
+}
+
+/**
+ * 计算 DSH 会话 cookie 的名称（authority 绑定）。
+ * @param {number|string} targetPort DSH 回环端口
+ * @param {string} [host] 默认 127.0.0.1
+ * @returns {string} 形如 `dsh-auth-<base64url(sha256("127.0.0.1:3080"))>`
+ */
+export function dshAuthCookieName(targetPort, host = '127.0.0.1') {
+  const authority = `${host}:${targetPort}`;
+  return DSH_AUTH_COOKIE_PREFIX + base64Url(createHash('sha256').update(authority).digest());
+}
+
+/**
+ * 从 DSH 凭据文件内容中取出 browser-session 记录的签名密钥。
+ *
+ * 必须精确定位 `client-connection/browser-session` 这条 record：
+ * 凭据文件里还有 `refs:` 段（各家模型 API key）以及可能存在其它插件写入的
+ * record，一旦取到别处的 `secret:`，签名就会无效 —— 现象是"远程访问一律 401"，
+ * 且极难定位。因此先锚定 record 键，再在其后的小范围内取 secret；
+ * 仅当锚点缺失（异常/未来格式）时才退回"全文件第一个 secret:"的旧行为。
+ *
+ * @param {string} content 凭据文件文本
+ * @returns {string} base64url 编码的密钥；取不到时返回空串
+ */
+export function readBrowserSessionSecret(content) {
+  if (typeof content !== 'string' || content === '') return '';
+
+  // 锚定 record 键所在行，随后只在该行往后的一小段内查找 secret
+  const anchorMatch = /^[ \t]*client-connection\/browser-session:[ \t]*$/m.exec(content);
+  if (anchorMatch) {
+    const tail = content.slice(anchorMatch.index);
+    const scoped = /secret:[ \t]*([A-Za-z0-9_-]+)/.exec(tail);
+    if (scoped) return scoped[1];
+  }
+
+  // 兜底：老格式/异常格式下沿用全文件首个 secret:
+  const fallback = /secret:[ \t]*([A-Za-z0-9_-]+)/.exec(content);
+  return fallback ? fallback[1] : '';
+}
+
+/**
+ * 生成一枚绑定到 loopback authority 的 DSH 原生会话 cookie。
+ *
+ * @param {object} opts
+ * @param {number|string} opts.targetPort DSH 回环端口
+ * @param {string} opts.secret base64url 编码的签名密钥
+ * @param {string} [opts.host] 默认 127.0.0.1
+ * @param {number} [opts.now] 当前时间戳（测试注入用）
+ * @param {number} [opts.maxAgeMs] 有效期
+ * @returns {string} `name=value`；密钥缺失时返回空串
+ */
+export function buildDshLoopbackCookie({
+  targetPort,
+  secret,
+  host = '127.0.0.1',
+  now = Date.now(),
+  maxAgeMs = DSH_AUTH_COOKIE_MAX_AGE_MS,
+}) {
+  if (!secret || !targetPort) return '';
+
+  const authority = `${host}:${targetPort}`;
+  const name = dshAuthCookieName(targetPort, host);
+  // 与 DSH 一致：issuedAt 略微回拨，避免与宿主的同秒比较产生边界问题
+  const issuedAt = now - 1000;
+  const expiresAt = issuedAt + maxAgeMs;
+
+  const body = base64Url(Buffer.from(JSON.stringify({
+    version: DSH_AUTH_COOKIE_VERSION,
+    authority,
+    issuedAt,
+    expiresAt,
+  }), 'utf8'));
+  const key = Buffer.from(secret, 'base64url');
+  const sig = base64Url(createHmac('sha256', key).update(body).digest());
+  return `${name}=v${DSH_AUTH_COOKIE_VERSION}.${body}.${sig}`;
+}
+
+/**
+ * 读取本机 DSH 凭据并生成回环会话 cookie（失败时返回空串，绝不抛出）。
+ *
+ * @param {number|string} targetPort DSH 回环端口
+ * @param {object} [env] 便于测试注入的环境
+ * @param {string} [env.dshHome] DSH 主目录（默认 $DSH_HOME 或 ~/.dsh）
+ * @param {Function} [env.readFileSync] 文件读取实现（默认 node:fs）
+ * @param {Function} [env.existsSync] 存在性判断实现
+ * @param {number} [env.now] 当前时间戳
+ * @returns {string} `name=value`，或空串
+ */
+export function getDshLoopbackCookie(targetPort, env = {}) {
+  const readFile = env.readFileSync ?? readFileSync;
+  const exists = env.existsSync ?? existsSync;
+  try {
+    const dshHome = env.dshHome ?? process.env.DSH_HOME ?? join(homedir(), '.dsh');
+    const credPath = join(dshHome, '.credentials.yaml');
+    if (!exists(credPath)) return '';
+    const secret = readBrowserSessionSecret(readFile(credPath, 'utf8'));
+    if (!secret) return '';
+    return buildDshLoopbackCookie({ targetPort, secret, now: env.now });
+  } catch {
+    return '';
+  }
+}