@wenbin_wb/dsh-bridge 2.10.9 → 2.10.11

package/client/mobile-styles.js

@@ -20,7 +20,10 @@ export const MOBILE_STYLES_CSS = `
       --dsh-mobile-safe-bottom: env(safe-area-inset-bottom, 0px);
     }
 
-    @media (max-width: 768px) {
+    /* 断点与宿主判据对齐：宿主用 viewportWidth < 768 决定右侧栏自动全屏
+       （dsh-client-ui-sidebar-right/lib/client.js），故移动端样式取 <=767px，
+       768px 起彻底交还桌面布局，避免"桥渲染顶栏、宿主却未全屏"的错位。 */
+    @media (max-width: 767px) {
       /* 1. 主框架为 Header 腾出顶部空间 */
       div[class*="_frame"] {
         display: flex !important;
@@ -35,6 +38,19 @@ export const MOBILE_STYLES_CSS = `
         box-sizing: border-box !important;
       }
 
+      /* 1.1 fixed 全屏面板单独让位：position:fixed 的包含块是 viewport（CSS 2.1 §10.1），
+         不跟随上面 frame 的 padding-top，因此顶部 52px 会落进顶栏覆盖区（#41）。
+         官方右侧栏在 <768px 自动全屏（fixed; inset:0; z-index:40），这里按 data 属性
+         直接位移容器本身，不依赖宿主 CSS-module 哈希类名。
+         真正起作用的是 top；height/max-height 与下面工作台面板那段保持同一写法：
+         宿主当前用 inset:0（无显式高度）时 top 单独即可，但宿主将来若给出显式高度，
+         显式 height 仍能把盒子收在顶栏之下。 */
+      [data-sidebar-right-panel="fullscreen"] {
+        top: var(--dsh-mobile-header-h, 52px) !important;
+        height: calc(100dvh - var(--dsh-mobile-header-h, 52px)) !important;
+        max-height: calc(100dvh - var(--dsh-mobile-header-h, 52px)) !important;
+      }
+
       /* 2. 顶部原生导航条：100% 还原 DeepSeek App (左侧双横线，右侧(+)，中间留白，无多余设置按钮) */
       .dsh-mobile-app-header {
         position: fixed !important;
@@ -892,7 +908,7 @@ export const MOBILE_STYLES_CSS = `
       --dsw-alias-label-primary-foreground: #0f1115;
     }
 
-    @media (min-width: 769px) {
+    @media (min-width: 768px) {
       .dsh-mobile-app-header,
       .dsh-mobile-backdrop,
       .dsh-mobile-panel-close-btn {

package/client/resource-url-compat.js

@@ -0,0 +1,90 @@
+// 资源地址方言兼容（鸿蒙 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/docs/telegram-usage.md

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

package/lib/bridge-rpc-constants.js

@@ -40,6 +40,8 @@ export const BRIDGE_ENDPOINTS = {
   platformStop: 'platformStop',
   platformStart: 'platformStart',
   platformUnbind: 'platformUnbind',
+  // 本机可用的 DSH agent preset（设置页下拉用；老版本 DSH 返回 available:false）
+  listAgentPresets: 'listAgentPresets',
   // 微信 Bot（v1.x 向后兼容别名，deprecated）
   wechatGetStatus: 'wechatGetStatus',
   wechatLogin: 'wechatLogin',

package/lib/bridge-rpc.js

@@ -378,6 +378,29 @@ export function installBridgeRpc(ctx, { service, authManager, platformManager, l
 
         // ---- 平台管理器（多 IM 平台）----
 
+        // 本机可用的 DSH agent preset（设置页下拉用）。
+        // 只读、不含敏感信息：DSH 未提供 agentPresets 服务（旧版本）或名册读取失败时
+        // 返回 available:false，前端退化为手填，不影响会话创建。
+        if (endpoint === BRIDGE_ENDPOINTS.listAgentPresets) {
+          try {
+            const presets = ctx.get?.('agentPresets');
+            if (!presets?.list) return ok({ available: false, default: null, presets: [] });
+            const rows = await presets.list();
+            return ok({
+              available: true,
+              default: typeof presets.defaultId === 'string' ? presets.defaultId : null,
+              presets: (Array.isArray(rows) ? rows : [])
+                // 坏掉的预设不列出来（DSH 自己也会在挂载前拒绝）
+                .filter((p) => p && typeof p.id === 'string' && p.broken === undefined)
+                .map((p) => ({ id: p.id, name: typeof p.name === 'string' ? p.name : p.id })),
+            });
+          } catch (err) {
+            // 服务被卸载 / 名册不可读：这是设置页的辅助信息，不该让整个请求失败
+            logger?.warn?.('dsh-bridge: listAgentPresets failed: %s', err?.message ?? err);
+            return ok({ available: false, default: null, presets: [] });
+          }
+        }
+
         if (endpoint === BRIDGE_ENDPOINTS.listPlatforms) {
           if (!platformManager) return ok({});
           // 每个平台的 login.qrPayload 渲染为 dataURL 后返回

package/lib/compat.js

@@ -1,129 +1,172 @@
-// 运行时兼容垫片（lib/compat.js）
-//
-// 背景：DSH 核心依赖链（@deepseek-ai/dsh-timeout ← dsh-llm）在每次 agent 请求上
-// 调用 AbortSignal.any([...])，该 API 仅存在于 Node 20.3+/22+。运行在低版本 Node
-// （如 Node 18）上时，通过桥接发送消息会直接抛
-//   "AbortSignal.any is not a function ... (internal)"
-// 本模块在缺失时安装规范兼容的垫片；环境本身支持时不做任何事（返回 false）。
-//
-// 浏览器侧（旧 Safari/WebView）由 lib/index.js 的 HTML_HEAD_INJECTIONS 注入同语义垫片。
-
-function abortWith(controller, reason) {
-  try {
-    controller.abort(reason)
-  } catch {
-    try { controller.abort() } catch { /* 不可中止的信号：忽略 */ }
-  }
-}
-
-/**
- * 在目标环境中安装 AbortSignal.any / AbortSignal.timeout 垫片（仅缺失时）。
- * @param {object} [target] 可注入的环境（默认 globalThis），便于测试
- * @returns {boolean} 是否实际安装了垫片
- */
-export function installAbortSignalCompat(target = globalThis) {
-  const Signal = target.AbortSignal
-  const Controller = target.AbortController
-  if (!Signal || !Controller) return false
-
-  let installed = false
-
-  // ---- AbortSignal.any ----
-  if (typeof Signal.any !== 'function') {
-    Signal.any = (signals) => {
-      const list = Array.from(signals ?? [])
-      const controller = new Controller()
-      // 规范语义：任一源信号已中止 → 立即以该原因中止
-      for (const s of list) {
-        if (s && s.aborted) {
-          abortWith(controller, s.reason)
-          return controller.signal
-        }
-      }
-      const onAbort = (eventOrSignal) => {
-        // 真实 EventTarget 的 abort 事件参数是 event（event.target = 信号），
-        // 部分非标准实现直接传信号本身——两者都兼容取 reason
-        const src = eventOrSignal && eventOrSignal.target ? eventOrSignal.target : eventOrSignal
-        cleanup()
-        abortWith(controller, src ? src.reason : undefined)
-      }
-      const cleanup = () => {
-        for (const s of list) {
-          try { s.removeEventListener('abort', onAbort) } catch { /* 非标准信号：忽略 */ }
-        }
-      }
-      for (const s of list) {
-        try { s.addEventListener('abort', onAbort, { once: true }) } catch { /* 非标准信号：忽略 */ }
-      }
-      return controller.signal
-    }
-    installed = true
-  }
-
-  // ---- AbortSignal.timeout（Node 17.3+ / 较新浏览器才有，顺手补齐）----
-  if (typeof Signal.timeout !== 'function') {
-    Signal.timeout = (delayMs) => {
-      const controller = new Controller()
-      const delay = Math.max(0, Number(delayMs) || 0)
-      const reason = typeof target.DOMException === 'function'
-        ? new target.DOMException('The operation timed out.', 'TimeoutError')
-        : new Error('The operation timed out.')
-      const timer = setTimeout(() => abortWith(controller, reason), delay)
-      // 规范语义：timeout 信号的超时定时器不阻止进程退出
-      if (typeof timer.unref === 'function') timer.unref()
-      return controller.signal
-    }
-    installed = true
-  }
-
-  return installed
-}
-
-/**
- * 浏览器侧垫片源码：由代理注入到 HTML <head>（在宿主所有脚本之前执行），
- * 为 iOS 16 / 旧 Safari / 旧 WebView（无 AbortSignal.any，Safari 17.4 才加入）
- * 上的 DSH 网页客户端补齐。多行可读源码，勿手工压缩成单行（配平易错）。
- */
-export const BROWSER_ABORT_SIGNAL_POLYFILL = `<script data-dsh-bridge-polyfill="2">
-!function () {
-  try {
-    var S = self.AbortSignal;
-    if (typeof S !== 'function') return;
-    if (typeof S.any !== 'function') {
-      S.any = function (signals) {
-        var list = Array.prototype.slice.call(signals || []);
-        var c = new self.AbortController();
-        var onAbort = function (ev) {
-          var src = ev && ev.target ? ev.target : ev;
-          cleanup();
-          try { c.abort(src ? src.reason : undefined); } catch (e) { c.abort(); }
-        };
-        var cleanup = function () {
-          for (var i = 0; i < list.length; i++) {
-            try { list[i].removeEventListener('abort', onAbort); } catch (e) {}
-          }
-        };
-        for (var i = 0; i < list.length; i++) {
-          if (list[i] && list[i].aborted) {
-            try { c.abort(list[i].reason); } catch (e) { c.abort(); }
-            return c.signal;
-          }
-        }
-        for (var i = 0; i < list.length; i++) {
-          try { list[i].addEventListener('abort', onAbort, { once: true }); } catch (e) {}
-        }
-        return c.signal;
-      };
-    }
-    if (typeof S.timeout !== 'function') {
-      S.timeout = function (ms) {
-        var c = new self.AbortController();
-        setTimeout(function () {
-          try { c.abort(new Error('The operation timed out.')); } catch (e) { c.abort(); }
-        }, Math.max(0, Number(ms) || 0));
-        return c.signal;
-      };
-    }
-  } catch (e) { /* 环境异常时不影响页面其余脚本 */ }
-}();
-</script>`
+// 运行时兼容垫片（lib/compat.js）
+//
+// 背景：DSH 核心依赖链（@deepseek-ai/dsh-timeout ← dsh-llm）在每次 agent 请求上
+// 调用 AbortSignal.any([...])，该 API 仅存在于 Node 20.3+/22+。运行在低版本 Node
+// （如 Node 18）上时，通过桥接发送消息会直接抛
+//   "AbortSignal.any is not a function ... (internal)"
+// 本模块在缺失时安装规范兼容的垫片；环境本身支持时不做任何事（返回 false）。
+//
+// 浏览器侧（旧 Safari/WebView）由 lib/index.js 的 HTML_HEAD_INJECTIONS 注入同语义垫片。
+
+function abortWith(controller, reason) {
+  try {
+    controller.abort(reason)
+  } catch {
+    try { controller.abort() } catch { /* 不可中止的信号：忽略 */ }
+  }
+}
+
+/**
+ * 在目标环境中安装 AbortSignal.any / AbortSignal.timeout 垫片（仅缺失时）。
+ * @param {object} [target] 可注入的环境（默认 globalThis），便于测试
+ * @returns {boolean} 是否实际安装了垫片
+ */
+export function installAbortSignalCompat(target = globalThis) {
+  const Signal = target.AbortSignal
+  const Controller = target.AbortController
+  if (!Signal || !Controller) return false
+
+  let installed = false
+
+  // ---- AbortSignal.any ----
+  if (typeof Signal.any !== 'function') {
+    Signal.any = (signals) => {
+      const list = Array.from(signals ?? [])
+      const controller = new Controller()
+      // 规范语义：任一源信号已中止 → 立即以该原因中止
+      for (const s of list) {
+        if (s && s.aborted) {
+          abortWith(controller, s.reason)
+          return controller.signal
+        }
+      }
+      const onAbort = (eventOrSignal) => {
+        // 真实 EventTarget 的 abort 事件参数是 event（event.target = 信号），
+        // 部分非标准实现直接传信号本身——两者都兼容取 reason
+        const src = eventOrSignal && eventOrSignal.target ? eventOrSignal.target : eventOrSignal
+        cleanup()
+        abortWith(controller, src ? src.reason : undefined)
+      }
+      const cleanup = () => {
+        for (const s of list) {
+          try { s.removeEventListener('abort', onAbort) } catch { /* 非标准信号：忽略 */ }
+        }
+      }
+      for (const s of list) {
+        try { s.addEventListener('abort', onAbort, { once: true }) } catch { /* 非标准信号：忽略 */ }
+      }
+      return controller.signal
+    }
+    installed = true
+  }
+
+  // ---- AbortSignal.timeout（Node 17.3+ / 较新浏览器才有，顺手补齐）----
+  if (typeof Signal.timeout !== 'function') {
+    Signal.timeout = (delayMs) => {
+      const controller = new Controller()
+      const delay = Math.max(0, Number(delayMs) || 0)
+      const reason = typeof target.DOMException === 'function'
+        ? new target.DOMException('The operation timed out.', 'TimeoutError')
+        : new Error('The operation timed out.')
+      const timer = setTimeout(() => abortWith(controller, reason), delay)
+      // 规范语义：timeout 信号的超时定时器不阻止进程退出
+      if (typeof timer.unref === 'function') timer.unref()
+      return controller.signal
+    }
+    installed = true
+  }
+
+  return installed
+}
+
+/**
+ * 浏览器侧垫片源码：由代理注入到 HTML <head>（在宿主所有脚本之前执行），
+ * 为 iOS 16 / 旧 Safari / 旧 WebView（无 AbortSignal.any，Safari 17.4 才加入）
+ * 上的 DSH 网页客户端补齐。多行可读源码，勿手工压缩成单行（配平易错）。
+ */
+export const BROWSER_ABORT_SIGNAL_POLYFILL = `<script data-dsh-bridge-polyfill="2">
+!function () {
+  try {
+    var S = self.AbortSignal;
+    if (typeof S !== 'function') return;
+    if (typeof S.any !== 'function') {
+      S.any = function (signals) {
+        var list = Array.prototype.slice.call(signals || []);
+        var c = new self.AbortController();
+        var onAbort = function (ev) {
+          var src = ev && ev.target ? ev.target : ev;
+          cleanup();
+          try { c.abort(src ? src.reason : undefined); } catch (e) { c.abort(); }
+        };
+        var cleanup = function () {
+          for (var i = 0; i < list.length; i++) {
+            try { list[i].removeEventListener('abort', onAbort); } catch (e) {}
+          }
+        };
+        for (var i = 0; i < list.length; i++) {
+          if (list[i] && list[i].aborted) {
+            try { c.abort(list[i].reason); } catch (e) { c.abort(); }
+            return c.signal;
+          }
+        }
+        for (var i = 0; i < list.length; i++) {
+          try { list[i].addEventListener('abort', onAbort, { once: true }); } catch (e) {}
+        }
+        return c.signal;
+      };
+    }
+    if (typeof S.timeout !== 'function') {
+      S.timeout = function (ms) {
+        var c = new self.AbortController();
+        setTimeout(function () {
+          try { c.abort(new Error('The operation timed out.')); } catch (e) { c.abort(); }
+        }, Math.max(0, Number(ms) || 0));
+        return c.signal;
+      };
+    }
+  } catch (e) { /* 环境异常时不影响页面其余脚本 */ }
+}();
+</script>`
+
+/**
+ * 浏览器侧垫片源码（二）：iOS 16 / 旧 Safari 缺失的 Promise.withResolvers 与 Iterator。
+ *
+ * 背景（两者都是"整个 app 起不来"级别）：
+ * 1. `Promise.withResolvers`：Safari 17.4+ / Chrome 119+ 才有。DSH 宿主 HTML 末尾的内联脚本
+ *    直接写 `(globalThis.__DSH_BOOT_READY__ ??= Promise.withResolvers()).resolve()`；
+ *    另有多个客户端插件在运行期使用（审批、用户提问、cordis 运行时 ctx.timeout/ctx.interval、
+ *    workspace-files 的文件变更订阅 Follower）。
+ * 2. `Iterator`：Safari 18.4+ 才有（迭代器辅助方法）。DSH 自带的 pdf.js 在**模块顶层**就执行
+ *      `if (typeof Iterator.prototype.join !== "function") Iterator.prototype.join = ...`
+ *    iOS 16 上没有 Iterator 全局，于是这一行抛 `Can't find variable: Iterator`，
+ *    导致 `@deepseek-ai/dsh-client-ui-sidebar-documentpreview` 导入失败 → 整个插件树加载失败，
+ *    页面直接显示 "Failed to load plugins"（实测于 iOS 16 真机 + 本机同构模拟）。
+ *    这里把真实的内置迭代器共享原型（%IteratorPrototype%）挂到 `Iterator.prototype` 上，
+ *    使 pdf.js 的补丁落到真实迭代器原型，而不是一个无用的空对象。
+ *
+ * 两者都在缺失时才安装；已有该能力的引擎不做任何事。多行可读源码，勿手工压缩成单行（配平易错）。
+ */
+export const BROWSER_PROMISE_ITERATOR_POLYFILL = `<script data-dsh-bridge-polyfill="3">
+!function () {
+  try {
+    if (typeof Promise !== 'undefined' && typeof Promise.withResolvers !== 'function') {
+      Promise.withResolvers = function () {
+        var resolve, reject;
+        var promise = new Promise(function (res, rej) { resolve = res; reject = rej; });
+        return { promise: promise, resolve: resolve, reject: reject };
+      };
+    }
+  } catch (e) { /* 环境异常时不影响页面其余脚本 */ }
+  try {
+    if (typeof self.Iterator === 'undefined') {
+      var proto = null;
+      try {
+        proto = Object.getPrototypeOf(Object.getPrototypeOf([][Symbol.iterator]()));
+      } catch (e2) { proto = null; }
+      var IteratorShim = function Iterator() {};
+      if (proto && typeof proto === 'object') IteratorShim.prototype = proto;
+      self.Iterator = IteratorShim;
+    }
+  } catch (e) { /* 环境异常时不影响页面其余脚本 */ }
+}();
+</script>`