@qzsy/dsh-bridge 2.18.0 → 3.0.0

package/client/picker-yield.js

@@ -1,77 +0,0 @@
-// DSH 官方目录选择器的「让位」判定（issue #28 第 2 条）
-//
-// 背景：DSH 0.1.5 起自带官方目录选择器，且注册到与 dsh-bridge 完全相同的两个 Slot：
-//   conversation.hero.workspace.directoryFlow
-//   sidebar.workspaces.directoryFlow
-// 后端由 @deepseek-ai/dsh-host-directory-picker-auto 按宿主事实分发：非回环绑定 /
-// SSH / Linux 无 zenity·kdialog 等图形 chooser → browse（网页树形选择器），
-// macOS·Windows 或 Linux 有 chooser → native（系统对话框）。
-//
-// 而 DSH 的 slots 是 shadow 语义：@deepseek-ai/dsh-cordis-client-runner 的注释明确
-//   "Page-local shadowing rank. A later registration receives a lower priority."
-//   "a dynamically registered entry is assigned a lower priority than the shipped
-//    one, which makes it the winner"
-// 即数值越小越优先、后注册者胜。动态加载的 dsh-bridge 因此天然覆盖内置 picker，
-// 叠加本插件显式写的 `priority: -10`，连本机（127.0.0.1 / Electron）也被插件自己的
-// 远程目录选择器接管：点「添加工作区」弹的是插件的远程抽屉而非 DSH 官方选择器。
-//
-// 让位条件（两者同时成立才让位）：
-//   1. 本机访问（isLocalEnvironment()）—— 本机有完整权限，官方 picker 直接可用；
-//   2. DSH 已自带官方 picker —— 旧版 DSH 没有，必须继续由插件兜底，
-//      否则本机点「添加工作区」将彻底没有反应。
-// 远程 / 移动访问一律继续由插件接管：那里需要管理密码解锁与 local_only 目录策略，
-// 不能换成官方 picker（会绕过插件的访问限制）。
-//
-// 为什么探测用 ctx.get() 而不是 ctx.uiWorkspace：
-//   cordis 本体对**未在插件 inject 中声明**的服务做属性访问会直接抛错：
-//     cannot get property "uiWorkspace" without inject   （cordis/lib/index.js）
-//   —— dsh-bridge 的 client half 是静态 client 插件，其 ctx 是真 cordis Context
-//   （不是动态包的 runner guard facade），所以拦在这里的是 cordis 本体的规则。
-//   而 `ctx.get(name)` 是允许的「可选查找」，不要求声明。
-//   又不能把 uiWorkspace 写进 inject：旧版 DSH（无该 seat）会因此把整个插件 park 掉
-//   （provider 缺失即不 apply），所以只能用 ctx.get() 探测。
-//
-// ⚠️ 已知时序依赖（独立验收记录，真机 6/6 冷启动实测未触发）：
-//   cordis 的 ctx.get() 在 provider fiber 尚未进入 ACTIVE 时会返回 undefined。理论上若
-//   本判定早于 ui-workspace 插件 apply 完成，就会把「有官方 picker」误判为「无」而仍然
-//   注册，让位失效。当前稳定是因为 dsh-bridge 自身 inject 的 workspaces / sessions 由
-//   roster 中排在 ui-workspace **之后**的插件提供，插件真正激活时 ui-workspace 早已
-//   apply 完成 —— 这是对 roster 顺序的**隐式耦合，不是显式保证**。若将来调整 roster
-//   顺序或去掉 workspaces 依赖，需重新评估（加固思路：注册后等 uiWorkspace 可用时
-//   再撤销自己的注册）。
-
-/** 官方 workspace seat 的服务名（DSH 0.1.5 起提供 pickDirectory） */
-export const OFFICIAL_WORKSPACE_SEAT = 'uiWorkspace';
-
-/**
- * 探测 DSH 是否已提供官方目录选择器。
- *
- * 用 `ctx.get()` 做可选查找：seat 不存在（旧版 DSH）、宿主未暴露 pickDirectory、
- * 查询或属性读取抛错时一律返回 false —— 探测本身绝不外抛影响插件加载。
- *
- * @param {{ get?: (name: string) => unknown }} [ctx] cordis 客户端 context
- * @returns {boolean} 官方 picker 是否可用
- */
-export function hasOfficialDirectoryPicker(ctx) {
-  try {
-    if (typeof ctx?.get !== 'function') return false;
-    const seat = ctx.get(OFFICIAL_WORKSPACE_SEAT);
-    // typeof 也放在 try 内：seat 可能是带异常 getter 的对象或 Proxy，
-    // 读 pickDirectory 本身就可能抛错。
-    return typeof seat?.pickDirectory === 'function';
-  } catch {
-    // ctx.get 抛错（宿主异常），或属性读取抛错（异常 getter / Proxy）：
-    // 一律按「无官方 picker」处理，保持插件原有兜底行为，探测绝不外抛。
-    return false;
-  }
-}
-
-/**
- * 是否应让位给 DSH 官方目录选择器。
- *
- * @param {{ local?: boolean, officialPicker?: boolean }} [facts]
- * @returns {boolean} true = 不注册插件选择器，本机交给 DSH 官方处理
- */
-export function shouldYieldToOfficialPicker(facts) {
-  return Boolean(facts?.local) && Boolean(facts?.officialPicker);
-}

package/client/resource-url-compat.js

@@ -1,90 +0,0 @@
-// 资源地址方言兼容（鸿蒙 ArkWeb / HuaweiBrowser 等内核对非特殊 scheme 的 URL 解析差异）
-//
-// 现象：某些内核里 `new URL('dsh-resource://file/session/<id>/<path>').hostname` 返回空串，
-// 而 Chrome/Safari 返回 "file"。DSH 的客户端资源注册表 `@deepseek-ai/dsh-client-resources`
-// 恰好用 URL 的 hostname 当"协议键"（protocolOf），取不到就把该资源的记录判定成"没有 provider"：
-//   - 记录创建时 protocol 为 undefined → 状态永远停在 "none"；
-//   - 注册表只在 provider 注册时把已有记录重新挂载一次，之后不会重试 → 刷新也不会恢复；
-// 表现即：右侧栏文件 / 对话里生成的文档预览永远显示「文件资源服务不可用。」，而
-// `resources.providers` 里其实是有 "file" 的（宿主 @deepseek-ai/dsh-api-workspace-files 的
-// provider 注册成功，坏掉的只是地址解析这一步）。鸿蒙（HuaweiBrowser / ArkWeb 7.0）实测复现。
-//
-// 处理：**先做特性探测**，只有在该引擎确有差异时才包一层 `window.URL`，并且只对
-// `dsh-resource:` 协议、且原生 hostname 为空、且原始串能解析出 host 的实例补一个兜底
-// hostname/host（写成实例自有访问器，setter 仍委托原生原型，避免影响赋值语义）。
-// 引擎正常时完全不改动 URL（返回 'not-needed'）。
-//
-// 说明：根因在宿主侧（DSH 用 URL.hostname 当协议键），此处是桥侧最小兜底；
-// 宿主上游若改为从原始串解析协议，本模块会自动进入 'not-needed' 分支、不再介入。
-
-/**
- * 安装 `dsh-resource:` 地址的 URL 兼容层。
- *
- * @param {object} [win] 便于测试注入的 window（默认取全局 window）
- * @returns {'not-needed'|'installed'|'no-url'|'probe-throw'} 本次的处理结果
- *   - `not-needed`：引擎解析正常，未做任何改动
- *   - `installed`：引擎有差异，已包装 window.URL
- *   - `no-url` / `probe-throw`：环境不适用（无 window.URL / 构造探测失败）
- */
-export function installResourceUrlCompat(win = typeof window === 'undefined' ? undefined : window) {
-  if (!win || typeof win.URL !== 'function') return 'no-url';
-  const NativeURL = win.URL;
-  let probe;
-  try {
-    probe = new NativeURL('dsh-resource://file/__dsh_probe__/x');
-  } catch {
-    return 'probe-throw';
-  }
-  if (probe.hostname === 'file') return 'not-needed';
-
-  const hostOf = (raw) => {
-    const m = /^dsh-resource:\/\/([^/?#]*)/i.exec(String(raw || ''));
-    return m && m[1] ? m[1].toLowerCase() : '';
-  };
-
-  function CompatURL(...args) {
-    const url = new NativeURL(...args);
-    try {
-      if (String(url.protocol) === 'dsh-resource:' && !url.hostname) {
-        const proto = NativeURL.prototype;
-        const hostnameDesc = Object.getOwnPropertyDescriptor(proto, 'hostname');
-        const hostDesc = Object.getOwnPropertyDescriptor(proto, 'host');
-        // 读取顺序：原生解析结果优先（赋值/改 href 后立即反映新值），为空才回退到"从当前 href 现解析"。
-        // 不能缓存成常量，否则 u.hostname='x' 或 u.href=... 之后读回仍是陈旧值（getter/setter 不自洽）。
-        const hostOfUrl = (u) => {
-          let native;
-          try { native = hostnameDesc && hostnameDesc.get ? hostnameDesc.get.call(u) : (u.hostname || ''); } catch { native = ''; }
-          if (native) return native;
-          let href;
-          try { href = String(u.href); } catch { href = ''; }
-          return hostOf(href);
-        };
-        if (hostOfUrl(url)) {
-          Object.defineProperty(url, 'hostname', {
-            configurable: true,
-            enumerable: hostnameDesc ? hostnameDesc.enumerable : true,
-            get: () => hostOfUrl(url),
-            set: (v) => { if (hostnameDesc && hostnameDesc.set) hostnameDesc.set.call(url, v); },
-          });
-          if (hostDesc) {
-            Object.defineProperty(url, 'host', {
-              configurable: true,
-              enumerable: hostDesc.enumerable,
-              get: () => hostOfUrl(url),
-              set: (v) => { if (hostDesc.set) hostDesc.set.call(url, v); },
-            });
-          }
-        }
-      }
-    } catch { /* 兜底失败就保持原生行为 */ }
-    return url;
-  }
-
-  CompatURL.prototype = NativeURL.prototype;
-  for (const key of Object.getOwnPropertyNames(NativeURL)) {
-    if (key === 'length' || key === 'name' || key === 'prototype') continue;
-    try { CompatURL[key] = NativeURL[key]; } catch { /* 只读静态属性忽略 */ }
-  }
-  win.URL = CompatURL;
-  return 'installed';
-}

package/client/settings-nav-icon.js

@@ -1,105 +0,0 @@
-// dsh-bridge 设置页左侧导航栏图标定制 (替换默认小齿轮)
-//
-// 背景：
-// DSH 0.1.x 的设置弹窗外壳（@deepseek-ai/dsh-client-ui-settings-general）仅内置了原生
-// 三个 section 的图标（models, agent-presets, plugins），对第三方插件注册的 settings.section，
-// 外壳一律 fallback 显示其默认的小齿轮图标（gear）。
-//
-// 解决方案（对齐 dshmarket 与 dsh-better-sidebar）：
-// 监听设置弹窗挂载，定位到文本匹配「远程访问」的 nav 按钮，通过 CSS mask 将原生齿轮
-// 替换为专属的「手机 + 远程无线连接」矢量图标，颜色跟随 currentColor 保持原生悬停与激活态一致。
-//
-// 选择器策略（Issue #72）：以结构锚点 `[role="dialog"] nav button` 为主——它不依赖任何
-// CSS-module 哈希，0.1.x 与 0.2.0 实测都命中；宿主前缀（VOzbGW_ / wCInkW_）改由
-// client/host-families.js 运行时解析，仅在解析成功时作为补充选择器。
-import { ABSENT_FAMILY } from './host-families.js';
-import { t } from './locales.mjs';
-
-export const SETTINGS_NAV_MARKER = 'data-dsh-bridge-settings-nav';
-
-/**
- * 远程访问专属图标：手机 + 无线连接电波 (24x24 viewBox)
- */
-export const 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>`;
-
-/**
- * 生成导航栏图标样式
- * @param {string} [customSvg] 可选自定义 SVG 字符串
- * @returns {string}
- */
-export 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;
-}
-`;
-}
-
-/**
- * 注册设置页导航图标适配器
- *
- * @param {() => string} [resolveLabel] 获取当前标签文本的回调
- * @param {() => Record<string,string>} [resolveFamilies] 取运行时解析出的宿主 CSS-module
- *   前缀表（见 client/host-families.js）。拿不到时退回纯结构锚点 `[role="dialog"] nav button`
- *   —— 该锚点在 0.1.x 与 0.2.0 实测都命中，故即使前缀完全解析失败，本功能也不受影响。
- * @returns {() => void} 清理函数
- */
-export function registerSettingsNavIcon(resolveLabel = () => t('远程访问'), resolveFamilies = null) {
-  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() : t('远程访问');
-    // 结构锚点优先（版本无关）；解析到前缀时再补一条同族选择器，覆盖 nav 结构变化的宿主
-    const families = typeof resolveFamilies === 'function' ? (resolveFamilies() || {}) : {};
-    const settingsFamily = families.SETTINGS;
-    const selector = settingsFamily && settingsFamily !== ABSENT_FAMILY
-      ? `[role="dialog"] nav button, div[class*="${settingsFamily}_nav"] button`
-      : '[role="dialog"] nav button';
-    const buttons = document.querySelectorAll(selector);
-    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();
-  };
-}

package/client/theme-tokens.js

@@ -1,49 +0,0 @@
-// dsh-bridge 主题令牌补齐 —— **无条件注入**（不经过移动端让位判断）
-//
-// 为什么必须独立成块：
-//   这些深色补丁原先写在 MOBILE_STYLES_CSS 里，而 injectMobileStyles() 在
-//   __TAURI__ / __DSH_DESKTOP__ / 外部响应式插件存在时会直接 return
-//   （shouldYieldMobileStyles）——深色适配被"移动端让位"一起让掉了，
-//   桌面端 Shell 下浅色 fallback 永远生效（浅底 + 浅字）。
-//
-// 覆盖范围：只补 **DSH 主题系统没有定义**的令牌（全树 grep 0 命中，不会改坏宿主配色）：
-//   DSH 只提供 state-*-{primary,secondary,tertiary,label}，
-//   没有 *-bg / *-border、没有 info-* 与 danger-*、也没有 border-secondary。
-//   浅色沿用各处 var() 的 fallback（本来就是浅色值，无需另行定义），这里补暗色值。
-//
-// 注：DSH 自己定义的 state-{warn,error,success}-primary 是**强调填充色**（浅色
-// amber-500 / red-600 / green-500），当告警面上的正文只有 1.95~4.11:1（不达 AA）。
-// 文字一律改用 DSH 的 label-primary（中性正文色，随主题翻转），状态感由底色与边框承担，
-// 见 client/index.js 各处 color: 的用法与 test/dark-mode-contrast.test.mjs 的不变式。
-export const THEME_TOKENS_CSS = `
-  /* 深色：告警面 / 边框 / info 与 danger 补色（DSH 未定义，靠 fallback 会永远拿到浅色） */
-  body[data-ds-dark-theme] {
-    --dsw-alias-state-info-bg: rgba(65, 118, 230, 0.12);
-    --dsw-alias-state-info-border: rgba(65, 118, 230, 0.25);
-    --dsw-alias-state-success-bg: rgba(34, 197, 94, 0.12);
-    --dsw-alias-state-success-border: rgba(34, 197, 94, 0.25);
-    --dsw-alias-state-warn-bg: rgba(245, 158, 11, 0.12);
-    --dsw-alias-state-warn-border: rgba(245, 158, 11, 0.25);
-    --dsw-alias-state-error-bg: rgba(239, 68, 68, 0.12);
-    --dsw-alias-state-error-border: rgba(239, 68, 68, 0.25);
-    --dsw-alias-state-info-primary: #60a5fa;
-    --dsw-alias-state-danger-bg: rgba(239, 68, 68, 0.12);
-    --dsw-alias-state-danger-primary: #f87171;
-    --dsw-alias-border-secondary: #3c3c3d;
-  }
-
-  /* 深色模式：直接覆盖弹窗内所有使用 #fff/#ffffff fallback 的内联背景，
-     确保即使 CSS 变量未正确继承，弹窗也不会显示白色背景 */
-  body[data-ds-dark-theme] #dsh-remote-workspace-modal .dsh-ws-dialog-card,
-  body[data-ds-dark-theme] #dsh-remote-workspace-modal .dsh-ws-dialog-card * {
-    --dsw-alias-bg-layer-1: #1b1b1c;
-    --dsw-alias-bg-layer-2: #2c2c2e;
-    --dsw-alias-bg-layer-3: #353638;
-    --dsw-alias-border-l2: #3c3c3d;
-    --dsw-alias-label-primary: #f9fafb;
-    --dsw-alias-label-secondary: #adb2b8;
-    --dsw-alias-label-tertiary: #81858c;
-    --dsw-alias-brand-primary: #f9fafb;
-    --dsw-alias-label-primary-foreground: #0f1115;
-  }
-`;

package/client/tunnel-guard.js

@@ -1,46 +0,0 @@
-// 隧道类操作的前置条件判断（issue #75）——纯函数，便于单测。
-//
-// 背景：可信隧道相关的高危 RPC（startCloudflared / startCustomTunnel /
-// saveCloudflaredConfig / saveCustomTunnelConfig / saveExternalTunnel /
-// setTunnelAutoStart）在服务端都带 `requireConfigured: true` 守卫：
-//
-// 【例外】resetCloudflared 在服务端只是普通 checkAdminAuth（无 requireConfigured），
-// 客户端对它也做同一预检，是因为它是 stop+start 复合操作：无密码时 stop 会成功、
-// start 被拒，把隧道留在"已停用"状态。故按 start 的前置条件提前拦截——这条属产品
-// 取舍，不是与服务端逐端点同源。
-// 当「管理保护未关闭」(adminProtection !== false)、「策略非宽松」(adminPolicy !== 'open')
-// 且「从未设置任何访问密码/管理密码」时，服务端会直接拒绝并返回可读错误
-// （bridge-rpc.js 的 checkAdminAuth）。
-//
-// 问题在于提示位置：旧实现只在点击后把错误写到**面板顶部横幅**，而隧道卡片往往在
-// 长页面下方，用户看不到任何反馈，误以为"点了没反应"（issue #75 的现场观感）。
-// 因此客户端需要**与服务端同源**地判断该前置条件，用于「按钮旁常驻提示 + 点击前预检」，
-// 而不是自己发明一套规则：条件不一致会出现"提示说不行、点了却能成功"或反之。
-//
-// 注意判定必须与 bridge-rpc.js checkAdminAuth 的分支顺序一致：
-//   1) adminPolicy === 'local_only'  → 另走 adminToken 校验，不受本条件约束（返回 false）
-//   2) adminProtection === false     → 服务端直接放行
-//   3) adminPolicy === 'open'        → 服务端直接放行
-//   4) 其余：无任何密码时 requireConfigured 拦截
-
-/**
- * 是否已设置过任意一种密码（访客访问密码或独立管理密码）。
- * @param {{hasPassword?: boolean, hasAdminPassword?: boolean}} [auth]
- */
-export function hasAnyPassword(auth) {
-  return Boolean(auth?.hasPassword || auth?.hasAdminPassword)
-}
-
-/**
- * 隧道类操作是否会被服务端的前置条件拦下（缺访问密码）。
- * @param {object} [auth] 状态快照里的 auth 段（authManager.getStatus()）
- * @returns {boolean} true = 需要先设置访问密码
- */
-export function needsTunnelPassword(auth) {
-  // 没有 auth 快照（状态未加载）时不做判断，避免误导
-  if (!auth || typeof auth !== 'object') return false
-  if (auth.adminPolicy === 'local_only') return false
-  if (auth.adminProtection === false) return false
-  if (auth.adminPolicy === 'open') return false
-  return !hasAnyPassword(auth)
-}

package/client/unlock-manager.js

@@ -1,144 +0,0 @@
-import { t } from './locales.mjs';
-
-// 统一管理员解锁管理器（client/unlock-manager.js）
-//
-// 背景：多个 RPC 封装（BridgePanel 的 authRpcCall、目录选择器的 authRpc）都会遇到
-// "需要管理员权限" 的拦截，此前各自处理、目录选择器甚至没有解锁入口导致流程卡死。
-// 本模块把"token 管理 + 权限拦截检测 + 解锁动作 + 被拦截操作自动重放"统一收敛。
-//
-// 设计要点：
-//   - token 与 sessionStorage 同步，是本插件唯一的 adminToken 缓存来源
-//   - 权限失败 -> 解锁成功 -> 自动重放被拦截的 RPC（pending 队列）
-//   - 与具体 UI 框架解耦，纯 JS 单例
-
-const SESSION_KEY = 'dsh_admin_token';
-
-let _token = '';
-let _pendingOps = [];           // 被拦截待重放的操作队列（解锁后按序重放）
-let _onUnlocked = null;         // 解锁成功后的全局回调（可多个）
-
-// 读写 sessionStorage
-function _readStorage() {
-  try { return typeof window !== 'undefined' ? window.sessionStorage.getItem(SESSION_KEY) : ''; } catch { return ''; }
-}
-function _writeStorage(t) {
-  try {
-    if (typeof window === 'undefined') return;
-    if (t) window.sessionStorage.setItem(SESSION_KEY, t);
-    else window.sessionStorage.removeItem(SESSION_KEY);
-  } catch {}
-}
-
-export function getAdminToken() {
-  if (_token) return _token;
-  const saved = _readStorage();
-  if (saved) { _token = saved; return saved; }
-  return '';
-}
-
-export function setAdminToken(t) {
-  _token = t || '';
-  _writeStorage(_token);
-}
-
-export function clearAdminToken() {
-  setAdminToken('');
-}
-
-/**
- * 本机（回环）场景：从多候选 URL 获取 loopback adminToken（免输密码直通管理）。
- * 支持 3080 原生端口与 3082 代理端口；不信任 sessionStorage 里的旧 token
- * ——DSH 重启后 adminSessions 清空，旧 token 失效，因此强制每次获取新的。
- * 返回 null 表示获取失败（非本机 / 端点不可达）。
- * @param {boolean} [force] true 时忽略已缓存 token 强制重取（默认 true）
- */
-export async function fetchLoopbackTokenOnce(force = true) {
-  if (typeof window === 'undefined') return null;
-  if (!force) {
-    const existing = getAdminToken();
-    if (existing) return existing;
-  }
-  const candidates = [
-    '/__dsh_bridge__/loopback-token',
-    'http://127.0.0.1:3082/__dsh_bridge__/loopback-token',
-    'http://localhost:3082/__dsh_bridge__/loopback-token',
-  ];
-  for (const url of [...new Set(candidates)]) {
-    try {
-      const res = await fetch(url, { method: 'POST' });
-      if (res.ok) {
-        const data = await res.json();
-        if (data?.ok && data.adminToken) {
-          setAdminToken(data.adminToken);
-          return data.adminToken;
-        }
-      }
-    } catch {}
-  }
-  return null;
-}
-
-/**
- * 暂存被拦截的操作，解锁成功后自动重放（队列：多个被拦操作按序重放）。
- * @param {function} retry 返回 Promise 的重试函数（带新 token 重新发起）
- */
-export function queuePendingOperation(retry) {
-  _pendingOps.push(retry);
-}
-
-/** 解锁成功后重放所有 pending 操作（若有） */
-export async function replayPending() {
-  if (_pendingOps.length === 0) return;
-  const ops = _pendingOps;
-  _pendingOps = [];
-  for (const retry of ops) {
-    try { await retry(); } catch {}
-  }
-}
-
-/** 监听解锁成功（可多个）；返回注销函数 */
-export function onUnlocked(cb) {
-  if (!_onUnlocked) _onUnlocked = [];
-  _onUnlocked.push(cb);
-  return () => { _onUnlocked = _onUnlocked.filter((f) => f !== cb); };
-}
-
-/** 内部：解锁成功后触发 */
-function _emitUnlocked() {
-  if (_onUnlocked) {
-    for (const cb of _onUnlocked) { try { cb(); } catch {} }
-  }
-}
-
-/**
- * 统一解锁动作：调 authAdminUnlock，成功存 token 并触发回调/重放。
- * @param {function} rpcCall 底层 rpcCall（用于调 authAdminUnlock）
- * @param {string} password 管理密码
- * @returns {Promise<{ok:boolean, error?:string}>}
- */
-export async function unlockAdmin(rpcCall, password) {
-  try {
-    const res = await rpcCall('authAdminUnlock', { password });
-    if (res?.ok) {
-      const token = res.value?.adminToken || '';
-      setAdminToken(token);
-      _emitUnlocked();
-      await replayPending();
-      return { ok: true };
-    }
-    return { ok: false, error: res?.error?.message || t('管理员密码错误') };
-  } catch (err) {
-    // 访问会话失效（HTTP 401）：authAdminUnlock 即使豁免，主面板后续请求也会 401，
-    // 解锁成功也进不去。此时应整页重载回绿色登录页重新获取访问会话。
-    const msg = String(err?.message || err || '');
-    if (msg.includes('401') || msg.includes('transport failure') || msg.includes('unauthorized')) {
-      if (typeof window !== 'undefined' && typeof window.location?.reload === 'function') {
-        try {
-          window.sessionStorage.setItem('dsh_access_expired_reloaded', '1');
-        } catch {}
-        window.location.reload();
-      }
-    }
-    return { ok: false, error: err?.message || t('解锁请求失败') };
-  }
-}

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

@@ -1,148 +0,0 @@
-// 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 '';
-  }
-}