@qzsy/dsh-bridge 2.18.0 → 3.0.1

package/lib/cloudflared-network-args.js

@@ -1,99 +0,0 @@
-// cloudflared 网络参数白名单（issue #71 P1-B）
-//
-// 取值的一手来源（访问 2026-10-10）：Cloudflare 官方 Tunnel run parameters 文档
-// https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/configure-tunnels/tunnel-run-parameters/
-//   --protocol         auto | http2 | quic（默认 auto）
-//   --edge-ip-version  auto | 4 | 6（默认 4）
-//   --region           官方当前仅收录 us（空/缺省 = 全球默认）
-// --ha-connections 被 issue #71 提及，但**官方文档未收录、无官方取值依据**——
-// 给用户挖坑的开关不做，故刻意不在本清单内。
-//
-// 设计约束（三条同时满足才允许把参数拼进启动命令）：
-//   1. 默认零变化：三项全空 → 不追加任何参数，启动命令与旧版逐字一致；
-//   2. 值白名单校验：非法值在保存入口就被拒绝（execFile 数组传参，天然无注入面）；
-//   3. 能力门控：系统二进制版本不受控，实际二进制不认识的 flag 必须跳过并告警
-//      ——cloudflared 对未知 flag 是 "Incorrect Usage" 致命错误，绝不带病启动。
-
-/** 可配置字段（键名进入 cloudflaredConfig 持久化） */
-export const CLOUDFLARED_NETWORK_FIELDS = ['protocol', 'edgeIpVersion', 'region'];
-
-/** 字段 → CLI flag 与官方白名单取值 */
-export const CLOUDFLARED_NETWORK_FLAGS = {
-  protocol: { flag: '--protocol', values: ['auto', 'http2', 'quic'] },
-  edgeIpVersion: { flag: '--edge-ip-version', values: ['auto', '4', '6'] },
-  region: { flag: '--region', values: ['us'] },
-};
-
-/**
- * 校验网络参数（保存入口用）。
- * 语义：undefined = 不修改（不进入 values）；空串/纯空白 = 清除（恢复默认）；
- * 其余必须命中白名单，否则给出可读错误。
- *
- * @param {Record<string, unknown>} input 形如 { protocol, edgeIpVersion, region }
- * @returns {{ ok: boolean, values: Record<string, string>, errors: Record<string, string> }}
- */
-export function validateCloudflaredNetworkOptions(input = {}) {
-  const values = {};
-  const errors = {};
-  for (const field of CLOUDFLARED_NETWORK_FIELDS) {
-    const v = input[field];
-    if (v === undefined) continue;
-    if (typeof v !== 'string') {
-      errors[field] = field + ' 必须是文本';
-      continue;
-    }
-    const trimmed = v.trim();
-    if (trimmed === '') {
-      values[field] = '';
-      continue;
-    }
-    const spec = CLOUDFLARED_NETWORK_FLAGS[field];
-    if (!spec.values.includes(trimmed)) {
-      errors[field] = field + ' 仅支持：' + spec.values.join(' / ');
-      continue;
-    }
-    values[field] = trimmed;
-  }
-  return { ok: Object.keys(errors).length === 0, values, errors };
-}
-
-/**
- * 按"已配置值 + 实际二进制能力"构造要追加的启动参数。
- *
- * @param {Record<string, string>} values 已通过 validate 的值（缺省/空 = 不追加）
- * @param {Record<string, boolean>|null} supported 能力探测结果；null = 探测失败
- *   （保守策略：全部跳过并标注原因，隧道照常以默认参数启动）
- * @returns {{ args: string[], skipped: { field: string, reason: string }[] }}
- */
-export function buildCloudflaredNetworkArgs(values = {}, supported = null) {
-  const args = [];
-  const skipped = [];
-  for (const field of CLOUDFLARED_NETWORK_FIELDS) {
-    const v = values?.[field];
-    if (typeof v !== 'string' || v === '') continue; // 未配置 = 零变化
-    const spec = CLOUDFLARED_NETWORK_FLAGS[field];
-    if (supported === null) {
-      skipped.push({ field, reason: '能力探测失败，保守跳过（保持默认参数启动）' });
-      continue;
-    }
-    if (supported[field] !== true) {
-      skipped.push({ field, reason: '当前二进制不支持 ' + spec.flag + '，已跳过' });
-      continue;
-    }
-    args.push(spec.flag, v);
-  }
-  return { args, skipped };
-}
-
-/**
- * 能力探测判据（纯函数）：cloudflared 对未知 flag 的输出是
- * "flag provided but not defined"（本机 2024.10.0 实测基线）；
- * 其余一切输出（接受、枚举校验失败、token 校验失败…）都证明 flag 存在。
- * @param {string} commandOutput 探测命令的 stdout+stderr
- * @returns {boolean} true = 该二进制认识这个 flag
- */
-export function parseFlagSupport(commandOutput) {
-  const out = String(commandOutput ?? '').trim();
-  if (!out) return false; // 空输出（没跑起来/被吞）→ 保守判为不支持，绝不带病传参
-  return !/flag provided but not defined/i.test(out);
-}

package/lib/cloudflared-process-scan.js

@@ -1,153 +0,0 @@
-// "同 token 的另一个 cloudflared" 检测（issue #71 第 4 条）
-//
-// 场景：用户的系统服务（Windows 服务 / systemd unit）与插件用同一个 tunnel token
-// 同时运行——两边互相看不见，面板只显示"半张图"（对方假死/503 时插件无从得知）。
-// issue 实测：系统服务 Cloudflared 已 503/readyConnections=0 持续 50 分钟，插件毫不知情。
-//
-// 设计原则：
-//   1. 只在隧道启动时扫一次，异步执行，绝不阻塞启动；
-//   2. 比对逻辑全部是纯函数（进程列表与文件读取都可注入，便于单测）；
-//   3. 全链路 fail-open：进程表读不到、token-file 读不到 → 返回"未确认"而不是报错
-//      （在部分环境进程扫描会被权限/安全软件拦截，这是预期降级而非故障）；
-//   4. 绝不打印 token 本体：结果只含 PID 与来源 flag。
-
-import { readFileSync, readdirSync } from 'node:fs';
-import { execFileSync } from 'node:child_process';
-
-/**
- * 从一条进程命令行提取 cloudflared 的鉴权凭据。
- * 支持：--token X / --token=X / --token-file X / --token-file=X（值可带引号）。
- * @param {string} cmdline
- * @returns {{ via: 'token'|'token-file', value: string }|null} 非 cloudflared 或未带凭据 → null
- */
-export function extractCloudflaredAuth(cmdline) {
-  const s = String(cmdline ?? '');
-  if (!s.includes('cloudflared')) return null;
-  const tokens = s.match(/(?:[^\s"]+|"[^"]*")+/g) ?? [];
-  const clean = tokens.map((t) => t.replace(/^"|"$/g, ''));
-  for (let i = 0; i < clean.length; i++) {
-    const t = clean[i];
-    if (t === '--token' || t === '--token-file') {
-      const v = clean[i + 1];
-      if (v) return { via: t === '--token' ? 'token' : 'token-file', value: v };
-      return null;
-    }
-    if (t.startsWith('--token=')) {
-      const v = t.slice('--token='.length);
-      return v ? { via: 'token', value: v } : null;
-    }
-    if (t.startsWith('--token-file=')) {
-      const v = t.slice('--token-file='.length);
-      return v ? { via: 'token-file', value: v } : null;
-    }
-  }
-  return null;
-}
-
-/**
- * 在候选进程里找与自己 token 相同的 cloudflared。
- * @param {object} opts
- * @param {string} opts.myToken 本插件正在使用的 tunnel token
- * @param {{pid:number, cmdline:string}[]} opts.processes 候选进程（调用方已预筛或不过滤均可）
- * @param {number[]} [opts.excludePids] 排除的 PID（自己拉起的 cloudflared）
- * @param {(path:string)=>string} [opts.readFileFn] 读 token-file 的注入点
- * @returns {{pid:number, via:string}|null} 命中 → 返回；token-file 读不到 → 视为无法确认，不告警
- */
-export function findSameTokenRunner({ myToken, processes, excludePids = [], readFileFn }) {
-  const my = String(myToken ?? '').trim();
-  if (!my || !Array.isArray(processes)) return null;
-  const read = readFileFn ?? ((p) => readFileSync(p, 'utf8'));
-  const excluded = new Set(excludePids.map(Number));
-  for (const p of processes) {
-    if (!p || excluded.has(Number(p.pid))) continue;
-    const auth = extractCloudflaredAuth(p.cmdline);
-    if (!auth) continue;
-    if (auth.via === 'token') {
-      if (String(auth.value).trim() === my) return { pid: Number(p.pid), via: 'token' };
-    } else {
-      let fileToken;
-      try { fileToken = String(read(auth.value)).trim(); } catch { fileToken = null; }
-      // 文件读不到（权限/路径失效）→ 无法确认，fail-open 不告警
-      if (fileToken && fileToken === my) return { pid: Number(p.pid), via: 'token-file' };
-    }
-  }
-  return null;
-}
-
-/** 解析 `ps -Ao pid=,command=` 输出（macOS 用） */
-export function parsePsProcesses(output) {
-  const out = [];
-  for (const line of String(output ?? '').split('\n')) {
-    const m = /^\s*(\d+)\s+(.*)$/.exec(line);
-    if (m) out.push({ pid: Number(m[1]), cmdline: m[2] });
-  }
-  return out;
-}
-
-/** 解析 PowerShell "PID CMDLINE" 行输出（Windows 用） */
-export function parsePowerShellProcesses(output) {
-  const out = [];
-  for (const line of String(output ?? '').split('\n')) {
-    const m = /^\s*(\d+)\s+(.*)$/.exec(line);
-    if (m) out.push({ pid: Number(m[1]), cmdline: m[2] });
-  }
-  return out;
-}
-
-/** Linux：直接读 /proc（同机进程 cmdline 通常可读；个别 pid 读失败就跳过） */
-export function listLinuxProcesses({ readdirFn = readdirSync, readFileFn = readFileSync } = {}) {
-  const out = [];
-  let entries;
-  try { entries = readdirFn('/proc'); } catch { return out; }
-  for (const name of entries) {
-    if (!/^\d+$/.test(name)) continue;
-    try {
-      const cmdline = String(readFileFn('/proc/' + name + '/cmdline', 'utf8')).replace(/\0/g, ' ').trim();
-      if (cmdline.includes('cloudflared')) out.push({ pid: Number(name), cmdline });
-    } catch { /* 个别进程无权限/已退出：跳过 */ }
-  }
-  return out;
-}
-
-/** 平台无关的默认进程枚举：Linux=/proc，macOS=ps，Windows=PowerShell；任何失败 → []（fail-open） */
-export function listCloudflaredProcesses({ platformName = process.platform, execFn = execFileSync } = {}) {
-  try {
-    if (platformName === 'linux') return listLinuxProcesses();
-    if (platformName === 'darwin') {
-      const out = execFn('ps', ['-Ao', 'pid=,command='], { encoding: 'utf8', timeout: 3000 });
-      return parsePsProcesses(out).filter((p) => p.cmdline.includes('cloudflared'));
-    }
-    if (platformName === 'win32') {
-      const script = '$ErrorActionPreference="SilentlyContinue";'
-        + 'Get-CimInstance Win32_Process |'
-        + 'Where-Object { $_.CommandLine -like "*cloudflared*" } |'
-        + 'ForEach-Object { "$($_.ProcessId) $($_.CommandLine)" }';
-      const out = execFn('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', script],
-        { encoding: 'utf8', timeout: 5000 });
-      return parsePowerShellProcesses(out);
-    }
-    return [];
-  } catch {
-    return []; // 权限不足 / 安全软件拦截 / 超时：一律静默降级为"未检出"，绝不影响隧道启动
-  }
-}
-
-/**
- * 扫描"与本插件同 token 的另一个 cloudflared"（启动时调用一次）。
- * @param {object} opts
- * @param {string} opts.myToken
- * @param {() => number[]} [opts.getExcludePids] 结果计算前才求值（拿到自己子进程的 PID）
- * @param {() => {pid:number,cmdline:string}[]} [opts.listProcesses]
- * @param {(path:string)=>string} [opts.readFileFn]
- * @returns {Promise<{pid:number, via:string}|null>}
- */
-export async function scanSameTokenRunner({ myToken, getExcludePids, listProcesses, readFileFn } = {}) {
-  try {
-    if (!myToken || !String(myToken).trim()) return null;
-    const processes = (listProcesses ?? listCloudflaredProcesses)();
-    const excludePids = typeof getExcludePids === 'function' ? (getExcludePids() ?? []) : [];
-    return findSameTokenRunner({ myToken, processes, excludePids, readFileFn });
-  } catch {
-    return null; // fail-open：探测失败等价于"未检出"
-  }
-}

package/lib/compat.js

@@ -1,172 +0,0 @@
-// 运行时兼容垫片（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>`

package/lib/connection-compat.js

@@ -1,115 +0,0 @@
-// 运行时兼容垫片：DSH ≥ 0.1.5-alpha.1 的 connection RPC 通道注册回归
-// （lib/connection-compat.js）
-//
-// 背景（上游回归，非本插件声明问题）
-// ---------------------------------------------------------------
-// @deepseek-ai/dsh-client-connection 在 0.1.5-alpha.1 改了插件级服务声明：
-//     ≤ 0.1.3-alpha.2    const inject = ["webServer", "credentials"];
-//     ≥ 0.1.5-alpha.1    const inject = ["credentials"];      // webServer 改为可选
-// 同时把 /api 路由改用作用域注入 ctx.inject(["webServer"], (webCtx) => …)。
-// 但 HostConnectionService.register() 里那一句没有同步改（各版本行号均为 618）：
-//     return owner.effect(() => owner.webServer.register(route),
-//                         `client-connection: ${channel} rpc channel`);
-// 其中 owner === this.ctx，即 connection 插件自己的 ctx。该 ctx 的 fiber 不再把
-// webServer 记入 inject，于是 cordis 4 的服务守卫直接抛：
-//     cannot get property "webServer" without inject
-// 注册发生在插件树加载期，异常向上冒泡 → 整棵插件树加载失败，`dsh web` 起不来：
-//     Error: dsh: plugin tree failed to load: failed to apply loader entry
-//            dsh-bridge (@wenbin_wb/dsh-bridge): cannot get property "webServer" without inject
-//
-// 影响面：任何调用 ctx.connection.rpc.handle() 的插件都会踩中（dsh-bridge 只是第一个撞上的）。
-// 已逐一核对 npm 上的版本：0.1.5-alpha.1 / alpha.2 / rc.1 / rc.2 全部未修
-// （0.1.5-rc.2 为当前已发布的最新版），0.1.3-alpha.2 及更早正常。
-//
-// 本垫片的做法
-// ---------------------------------------------------------------
-// 不改上游代码、不猜内部私有方法，只走两个公开面：
-//   1. 正常路径：ctx.connection.rpc.handle(channel, handler)（公开 API，未来上游修好即恢复）；
-//   2. 兜底路径：仅当该调用抛出 "webServer … without inject" 时，在 root 的
-//      `internal/get` 瀑布事件上临时挂一个监听器 —— 先让默认解析跑，默认解析失败
-//      （抛出的正是同一个 error 对象）才补上本插件已通过 inject 拿到的 webServer 引用。
-//      webServer 是单例服务，语义等价；默认解析成功时零干预。
-// 监听器只在这一次同步注册调用期间存在，返回后立即摘除（cordis 的 effect 同步执行，
-// 注册完成后 owner.webServer 不再被访问），因此对宿主其余部分完全无副作用。
-//
-// 上游修好后本模块自动空转：首次调用不再抛错，兜底分支根本不会进入。
-
-const MISSING_INJECT = /without inject/;
-
-/**
- * 判断错误是否为"跨服务取属性缺 inject 作用域"的守卫错误，且对象是 webServer。
- * @param {unknown} err 捕获到的异常
- * @returns {boolean} 是否命中该回归
- */
-export function isMissingWebServerInjectError(err) {
-  if (!(err instanceof Error)) return false;
-  return MISSING_INJECT.test(err.message) && /webServer/.test(err.message);
-}
-
-/**
- * 在 root 的 `internal/get` 瀑布事件上挂一个临时兜底：默认解析失败时提供 webServer。
- *
- * cordis 4 的 `ctx.events` 是所有子 ctx 共享的同一个实例，且 `internal/get` 派发时
- * 不带 context 过滤条件（thisArg 为 null），因此在本插件 ctx 上注册的监听器同样会对
- * connection 插件 ctx 的查找生效。监听器由 root fiber 持有，须手工摘除。
- *
- * @param {object} ctx 本插件的 ctx
- * @returns {() => void} 摘除函数
- */
-export function installWebServerResolutionFallback(ctx) {
-  const webServer = ctx?.webServer;
-  if (webServer === undefined) return () => {};
-
-  const listener = function (lookupCtx, prop, error, next) {
-    if (prop !== 'webServer') return next();
-    try {
-      return next();
-    } catch (err) {
-      // 默认解析抛的不是本次守卫错误 → 原样上抛，绝不掩盖真实故障
-      if (err !== error) throw err;
-    }
-    // 默认解析确认失败：补上本插件已 inject 的单例引用（语义等价）
-    return webServer;
-  };
-
-  const off = ctx.on?.('internal/get', listener, { global: true });
-  return typeof off === 'function' ? off : () => {};
-}
-
-/**
- * 注册 connection RPC 通道，并兼容 DSH ≥ 0.1.5-alpha.1 的 webServer 注入回归。
- *
- * @param {object} ctx 本插件的 ctx（须已 inject `connection` 与 `webServer`）
- * @param {string} channel RPC 通道名（如 `/dsh-bridge`）
- * @param {Function} handler 通道处理器
- * @param {object} [rpcOptions] 透传给 connection 的通道选项。
- *        DSH 0.1.0/0.1.1 的 `rpc.handle(channel, handler, options)` 支持
- *        `{ authority: 'loopback' }`（仅回环可达，非回环请求 403）；
- *        0.1.2-rc.1 起该第三参数已被移除（更高版本忽略它，传入无副作用）。
- *        本插件依赖它来做回环加固，因此必须原样透传、不得丢失。
- * @param {{warn?: Function}} [logger] 可选日志器
- * @returns {Function} 由 connection 服务返回的处置函数
- */
-export function registerRpcChannel(ctx, channel, handler, rpcOptions, logger) {
-  try {
-    return ctx.connection.rpc.handle(channel, handler, rpcOptions);
-  } catch (err) {
-    if (!isMissingWebServerInjectError(err)) throw err;
-
-    // 上游回归：owner（connection 插件自己的 ctx）解析不到 webServer。
-    // 该调用在 owner.webServer 处、于 webServer.register() 之前就抛，未产生任何副作用，
-    // 因此可以安全地补上兜底后重试一次。
-    const dispose = installWebServerResolutionFallback(ctx);
-    try {
-      const registered = ctx.connection.rpc.handle(channel, handler, rpcOptions);
-      logger?.warn?.(
-        'dsh-bridge: 检测到宿主 DSH 的 connection RPC 注册回归（cannot get property "webServer" without inject，'
-        + '见 dsh-client-connection 的 register()）；已用 webServer 解析兜底完成通道注册。'
-        + '此为宿主侧问题（DSH 0.1.5-alpha.1 起），插件侧垫片会在上游修复后自动空转。'
-      );
-      return registered;
-    } finally {
-      dispose();
-    }
-  }
-}

package/lib/feishu/comment.js

@@ -1,50 +0,0 @@
-// 飞书云文档评论（@机器人）相关纯函数
-//
-// 官方依据：docs/dev/lark-sdk/README.zh.md「云文档评论 — channel.comments」与 0.7.1 类型定义
-//   CommentEvent { fileToken, fileType, commentId, replyId?, operator{openId}, mentionedBot, timestamp }
-//   FetchedComment { commentId, replies[{ reply_id?, content?.elements[] }], quote?, isWhole }
-//   CommentReplyContentElement = text_run | docs_link | person
-//
-// 评论回复是**纯文本**（没有卡片/流式/按钮），所以这里把结构化评论拍平成文本，交给会话桥当一轮输入。
-
-/** 合成评论会话 peer id（与聊天 peer `oc_…` 明显区分，出站据此改走评论回复） */
-export function buildCommentPeerId({ fileToken, commentId } = {}) {
-  return `comment:${fileToken ?? ''}:${commentId ?? ''}`
-}
-
-export function isCommentPeerId(peerId) {
-  return typeof peerId === 'string' && peerId.startsWith('comment:')
-}
-
-/** 拍平一条评论回复的富文本元素为纯文本（text_run / docs_link / person） */
-export function flattenCommentElements(elements) {
-  if (!Array.isArray(elements)) return ''
-  return elements
-    .map((el) => {
-      if (el?.type === 'text_run') return el.text_run?.text ?? ''
-      if (el?.type === 'docs_link') return el.docs_link?.url ?? ''
-      if (el?.type === 'person') return `@${el.person?.user_id ?? ''}`
-      return ''
-    })
-    .join('')
-    .trim()
-}
-
-/**
- * 从 FetchedComment 提取"用户这次说了什么"：
- *   - text：最后一条回复的正文（评论线程里最新那条就是本次触发内容）
- *   - quote：行内评论选中的文档原文（有则作为上下文）
- *   - isWhole：整篇文档评论（无行内线程）——回复要直接发顶层评论，避免 SDK 先探一次 in-thread 失败
- *   - replyId：最后一条回复的 id（当前未用，留给后续"评论打字中"表情等）
- */
-export function extractCommentInput(fetched) {
-  const replies = Array.isArray(fetched?.replies) ? fetched.replies : []
-  const last = replies[replies.length - 1]
-  return {
-    text: flattenCommentElements(last?.content?.elements),
-    quote: String(fetched?.quote ?? '').trim(),
-    isWhole: Boolean(fetched?.isWhole),
-    replyId: last?.reply_id ?? '',
-    replyCount: replies.length,
-  }
-}