@qzsy/dsh-bridge 3.0.1 → 3.0.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # 更新日志
 
+## [v3.0.2] - 2026-11-01
+
+### 🐛 修复
+
+- 兼容部分 DSH 版本 connection 服务注册 RPC 通道时的 `webServer without inject` 异常（lib/rpc-compat.js）；此前通道注册失败会让面板所有操作返回 HTTP 405。
+
 ## [v3.0.1] - 2026-11-01
 
 ### 🔒 安全

package/lib/config.js

@@ -35,7 +35,7 @@ export function normalizeConfig(raw = {}) {
   const access = input.access && typeof input.access === 'object' ? input.access : {};
   const port = Number(input.port);
   return {
-    port: Number.isInteger(port) && port > 0 && port < 65536 ? port : DEFAULT_PORT,
+    port: Number.isInteger(port) && port > 0 && port < 65_536 ? port : DEFAULT_PORT,
     gatewayUrl: typeof input.gatewayUrl === 'string' && input.gatewayUrl.trim()
       ? input.gatewayUrl.trim()
       : DEFAULT_GATEWAY_URL,

package/lib/dsh-cookie.js

@@ -15,7 +15,7 @@ import { readFileSync, existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { resolveDshHome } from './data-dir.js';
 
-const COOKIE_SPEC = { prefix: 'dsh-auth-', version: 1, ttlMs: 2592000000 };
+const COOKIE_SPEC = { prefix: 'dsh-auth-', version: 1, ttlMs: 2_592_000_000 };
 export const DSH_AUTH_COOKIE_PREFIX = COOKIE_SPEC.prefix;
 export const DSH_AUTH_COOKIE_VERSION = COOKIE_SPEC.version;
 export const DSH_AUTH_COOKIE_MAX_AGE_MS = COOKIE_SPEC.ttlMs;

package/lib/index.js

@@ -1,23 +1,17 @@
-// DSH 远程隧道云 · 官方客户端插件（Host 侧）
-//
-// 职责（保持精简，全部为独立实现）：
-//   1. 本地门禁代理：监听本机端口 → 转发 DSH 本体，注入 DSH 原生 loopback cookie；
-//   2. SaaS 隧道客户端：设备码绑定 → 短期令牌 → v2 控制通道（转发 HTTP / SSE / WS）；
-//   3. 设置页面的 RPC 控制面：状态、绑定、解绑、启停、访问链接。
-import { randomBytes } from 'node:crypto';
+
 import { readFileSync } from 'node:fs';
 import { hostname, platform as osPlatform, arch as osArch } from 'node:os';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import QRCode from 'qrcode';
 
+import { registerRpcChannel } from './rpc-compat.js';
 import { PLUGIN_ID, PACKAGE_NAME, DEFAULT_PORT, RPC_CHANNEL, RPC_ENDPOINTS, GATEWAY_PATH } from './identity.js';
 import { resolveConfigPath } from './data-dir.js';
 import {
   ensureConfigSecrets,
   loadConfig,
   maskSecret,
-  normalizeConfig,
   saveConfig,
   createSecret,
   hashPassword,
@@ -55,21 +49,20 @@ function errorPayload(err) {
 }
 
 function registerRpc(ctx, handler, logger) {
-  const rpc = ctx?.connection?.rpc;
-  if (!rpc?.handle) {
+  if (!ctx?.connection?.rpc?.handle) {
     logger?.warn?.('connection RPC unavailable — panel will stay disabled');
     return () => {};
   }
   try {
-    const dispose = rpc.handle(RPC_CHANNEL, handler, { authority: 'loopback' });
+    const dispose = registerRpcChannel(ctx, RPC_CHANNEL, handler, { authority: 'loopback' }, logger);
     return typeof dispose === 'function' ? dispose : () => {};
   } catch (err) {
     logger?.warn?.(`RPC register with options failed, retrying without: ${err?.message ?? err}`);
     try {
-      const dispose = rpc.handle(RPC_CHANNEL, handler);
+      const dispose = registerRpcChannel(ctx, RPC_CHANNEL, handler, undefined, logger);
       return typeof dispose === 'function' ? dispose : () => {};
     } catch (retryErr) {
-      logger?.error?.(`RPC register failed: ${retryErr?.message ?? retryErr}`);
+      logger?.error?.(`RPC register failed, panel buttons will return 405: ${retryErr?.message ?? retryErr}`);
       return () => {};
     }
   }

package/lib/rpc-compat.js

@@ -0,0 +1,46 @@
+// RPC 通道注册兼容层（自研）。
+//
+// 部分 DSH 版本的 connection 服务在注册 RPC 通道时，会在它自己的 ctx 上读取 webServer，
+// 而该 ctx 没有声明 inject，cordis 抛出 `cannot get property "webServer" without inject`。
+// 若不处理，通道注册失败，面板仍能渲染，但所有 RPC 调用在宿主侧得到 HTTP 405。
+//
+// 做法：先走公开的 rpc.handle；仅当抛出上述错误时，在 `internal/get` 事件上临时挂一个
+// 监听器，默认解析失败才补上本插件已 inject 的 webServer 单例，调用结束立即摘除。
+
+const MISSING_INJECT = /without inject/;
+
+export function isMissingWebServerInject(err) {
+  return err instanceof Error && MISSING_INJECT.test(err.message) && /webServer/.test(err.message);
+}
+
+function installFallback(ctx) {
+  const webServer = ctx?.webServer;
+  if (webServer === undefined || typeof ctx.on !== 'function') return () => {};
+  const listener = (lookupCtx, prop, error, next) => {
+    if (prop !== 'webServer') return next();
+    try {
+      return next();
+    } catch (err) {
+      if (err !== error) throw err;
+      return webServer;
+    }
+  };
+  const off = ctx.on('internal/get', listener, { global: true });
+  return typeof off === 'function' ? off : () => {};
+}
+
+export function registerRpcChannel(ctx, channel, handler, options, logger) {
+  const call = () => ctx.connection.rpc.handle(channel, handler, options);
+  try {
+    return call();
+  } catch (err) {
+    if (!isMissingWebServerInject(err)) throw err;
+    logger?.warn?.('connection RPC hit webServer inject regression, retrying with fallback');
+    const off = installFallback(ctx);
+    try {
+      return call();
+    } finally {
+      off();
+    }
+  }
+}

package/lib/saas/tunnel-client.mjs

@@ -7,7 +7,6 @@
 import { WebSocket } from 'ws';
 import { request as httpRequest } from 'node:http';
 import { connect as netConnect } from 'node:net';
-import { randomBytes } from 'node:crypto';
 
 export const SAAS_HEARTBEAT_INTERVAL_MS = 30_000;
 export const SAAS_HEARTBEAT_MAX_MISSED = 3;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qzsy/dsh-bridge",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "DSH 远程隧道云官方客户端插件：一条命令把本机 DeepSeek Harness 接入云端隧道（设备码绑定、短期令牌、本地门禁代理、HTTP/SSE/WebSocket 反向隧道）。",
   "releaseNotes": "【v3.0.0】官方客户端插件首个独立实现版本\n• 全新自研代码：插件骨架、本地门禁代理、SaaS 隧道客户端与设置面板均独立实现\n• 设备码绑定 + 短期设备令牌 + v2 控制通道（心跳/路由热更新/drain/终态吊销）\n• 本地门禁：回环免认证、隧道来源用进程内随机密钥标记、局域网访问需本地口令\n• 支持 HTTP / SSE 流式 / WebSocket 转发，公网地址复制与二维码\n• 数据目录 ~/.dsh/qzsy-dsh-bridge，默认本地端口 3092（可配置）",
   "type": "module",