dsh-remote-web 0.7.9 → 0.7.10-beta.3

package/runtime/clients/dsh-remote/dsh-bridge.mjs

@@ -114,6 +114,7 @@ import {
 // ⚠️ 微信流量只走「腾讯 ilink ↔ 本机」,**不经我们的 relay**;DSH 事件走本机回环。
 // 总开关 DSH_WECHAT=0(默认开启);未绑定时只起控制面,不起长轮询。
 import { createWeChatRuntime } from "./wechat-runtime.mjs";
+import { createPushReporter } from "./push-reporter.mjs";
 
 // ---------- 强制直连:清除代理环境变量 ----------
 // 家庭网络常配 Clash 等代理(127.0.0.1:7890),node 的 ws/fetch 会继承
@@ -288,7 +289,44 @@ function stampBridgeHeartbeat() {
   const now = Date.now();
   if (now - lastStateHeartbeatAt < STATE_HEARTBEAT_MIN_MS) return;
   lastStateHeartbeatAt = now;
-  persistBridgeState({ pid: process.pid, heartbeat_at: now });
+  persistBridgeState({
+    pid: process.pid,
+    heartbeat_at: now,
+    // 【0.7.10 / W1-T3】E2EE 死会话拒绝计数（见 noteE2eeWsReject 的说明）。
+    // 跟着心跳一起落盘：不额外写盘、不加定时器；旧面板/旧插件读到多余字段一律忽略。
+    e2ee_ws_reject_locked: e2eeWsRejectStats.locked,
+    e2ee_ws_reject_disabled: e2eeWsRejectStats.disabled,
+    e2ee_ws_reject_at: e2eeWsRejectStats.lastAt
+  });
+}
+
+/**
+ * 【0.7.10 / W1-T3】E2EE 会话拒绝计数 —— **只做可观测，不改任何协议行为**。
+ *
+ * 生产复盘（2026-10）：WS 升级被拒里 71.8% 是 `e2ee_session_locked`（死会话），涉 163 用户；
+ * 0.7.3+ 已闭环（手机侧清内存会话 + 连续 3 次失败作废交接单 + 每页一次受控 reload；
+ * bridge 侧回 `retryable:true, action:"rehandshake"` 让手机自动重握手）。但「死会话占比
+ * 降到多少」此前只在 nginx/router 侧可见，客户端自己答不出来。
+ *
+ * 这里把本进程的拒绝次数记下来、随心跳写进状态文件（面板「复制诊断信息」会带上一行），
+ * 于是支持包/诊断信息本身就能回答「这台机器还在被死会话打吗」。
+ * 落盘节流 ≥10s：死循环期一台设备一天能拒近万次，绝不能每拒一次就写盘。
+ */
+const e2eeWsRejectStats = { locked: 0, disabled: 0, lastAt: 0 };
+const E2EE_REJECT_FLUSH_MIN_MS = 10_000;
+let lastE2eeRejectFlushAt = 0;
+function noteE2eeWsReject(kind) {
+  if (kind === "disabled") e2eeWsRejectStats.disabled += 1;
+  else e2eeWsRejectStats.locked += 1;
+  const now = Date.now();
+  e2eeWsRejectStats.lastAt = now;
+  if (now - lastE2eeRejectFlushAt < E2EE_REJECT_FLUSH_MIN_MS) return;
+  lastE2eeRejectFlushAt = now;
+  persistBridgeState({
+    e2ee_ws_reject_locked: e2eeWsRejectStats.locked,
+    e2ee_ws_reject_disabled: e2eeWsRejectStats.disabled,
+    e2ee_ws_reject_at: e2eeWsRejectStats.lastAt
+  });
 }
 
 // ---------- 安装来源 / 版本(服务端设备行统计约定) ----------
@@ -1714,6 +1752,7 @@ export async function handleWsOpen(dchOrSend, frame) {
   const tagged = parseWsE2eeParams(path);
   if (tagged) {
     if (!e2ee.enabled) {
+      noteE2eeWsReject("disabled"); // 可观测计数（见 noteE2eeWsReject；不改行为）
       sendWsOpenReject(send, id, 1008, "e2ee_disabled:bridge 未启用端到端加密(请用明文连接)");
       return;
     }
@@ -1721,6 +1760,7 @@ export async function handleWsOpen(dchOrSend, frame) {
     if (!esess || !esess.verified) {
       // 会话可能刚被重启/被 LRU 挤掉：把「可自动重握手」写成机器可读信号，
       // 手机侧据此自动重建会话，而不是弹「请重新解锁」让用户输密码（生产 3964 次/设备）。
+      noteE2eeWsReject("locked");
       console.error(`[bridge] e2ee ws 拒绝(会话未解锁/未验证): ${path}`);
       sendWsOpenReject(send, id, 1008, "e2ee_session_locked:加密会话已失效，需要重新握手", {
         retryable: true,
@@ -2801,6 +2841,45 @@ function currentUpstreamForChannel() {
   return UPSTREAM;
 }
 
+/**
+ * 推送上报（2026-11-05）：把"任务完成/需要拍板/出错"上报给 SaaS，由服务端规则引擎决定是否推送。
+ *
+ * 为什么放在这里有独立开关：它是**可选增强**，任何失败都不得影响远程访问主链路。
+ * 真正的启动条件由 push-reporter 自己问服务端（`/api/push/public-key` 的 enabled+subscribed），
+ * 本地只有 `DSH_PUSH_REPORT=0` 能强制关闭。
+ */
+let pushReporter = null;
+let PUSH_TOKEN = "";
+
+function startPushReporter() {
+  if (String(process.env.DSH_PUSH_REPORT || "") === "0") {
+    console.log("[push] 上报已禁用(DSH_PUSH_REPORT=0)");
+    return;
+  }
+  try {
+    if (pushReporter) return;
+    pushReporter = createPushReporter({
+      apiBase: API_BASE,
+      deviceId: DEVICE_ID,
+      tokenProvider: () => PUSH_TOKEN,
+      upstream: () => currentUpstreamForChannel(),
+      cookie: harnessCookieOf,
+      detail: String(process.env.DSH_PUSH_DETAIL || "") === "1",
+      log: (level, message) => {
+        try {
+          if (level === "warn") console.warn(message);
+          else console.log(message);
+        } catch { /* 忽略 */ }
+      }
+    });
+    // 不 await：启动探测失败绝不影响隧道
+    void pushReporter.start().catch(() => {});
+  } catch (e) {
+    // 可选增强失败不得冒泡
+    console.warn(`[push] 上报器初始化失败（已忽略）：${e && e.message ? e.message : e}`);
+  }
+}
+
 function startWeChat() {
   if (WECHAT_DISABLED) {
     console.log("[bridge] 微信通道已禁用(DSH_WECHAT=0)");
@@ -2983,6 +3062,7 @@ async function runTunnel() {
   // (真机日志实测:同一个桥接启动里出现两条并发的 device-login)。
   // 而 /api/device-login 是按出口 IP 限流的 —— 每次启动都多花一份登录额度没有道理。
   WECHAT_TIER_TOKEN = { value: token, at: Date.now() };
+  PUSH_TOKEN = token;
   // 新进程开始:重置状态文件(上一轮的成功记录不能代表这一轮,面板据此判定 online)。
   // `pid` 一并写入 = **bridge 自证身份**:插件可以用「state.pid 活着 + heartbeat_at 新鲜」
   // 判断桥是否真的在跑,不必依赖按镜像名(node.exe)扫描 —— 桌面端宿主拉起的进程名不是 node.exe。
@@ -2998,6 +3078,8 @@ async function runTunnel() {
   }
   // 隧道已发起（或已进入锁定等待）后再起微信:主链路优先,微信永不阻塞远程访问
   startWeChat();
+  // 同理：推送上报也是可选增强，最后起、失败静默
+  startPushReporter();
   setTimeout(() => {
     console.log(`[bridge] 隧道模式运行中(上游 ${UPSTREAM},Ctrl-C 退出)`);
   }, 1000);
@@ -3043,6 +3125,8 @@ async function main() {
     console.log(`[bridge] 收到 ${sig},正在优雅退出...`);
     // 退出前把 E2EE 会话库刷一次（滑动 TTL 的 usedAt 要落盘；崩溃也能恢复到最多 60s 前）
     try { e2ee.flushStore(); } catch { /* 已内部兜底 */ }
+    // 退出前尽力把待上报的事件发出去（最多等 1s，绝不阻塞退出）
+    try { if (pushReporter) await pushReporter.stop(); } catch { /* 已内部兜底 */ }
     await stopWeChat();
     process.exit(0);
   };
@@ -3188,6 +3272,9 @@ export function __wsSessionState(id) {
   return { opened: s.opened === true, pending: s.pending ? s.pending.length : 0, cancelled: s.cancelled === true, failed: s.failed === true };
 }
 
+// test hook：E2EE 拒绝计数快照（W1-T3 可观测字段；状态文件里同名 e2ee_ws_reject_* 字段的来源）
+export function __e2eeRejectStatsForTest() { return { ...e2eeWsRejectStats }; }
+
 // 直接运行(node dsh-bridge.mjs)时启动服务;被测试 import 时只导出协议函数。
 const isMain = process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href;
 if (isMain) {