dsh-mobile-plugin 0.1.93 → 0.1.94

package/lib/shared/sse-write.js

@@ -89,6 +89,48 @@ function stableEventId(payload, frame, namespace = 'session') {
   return frame && typeof frame.rpcId === 'string' && frame.rpcId ? frame.rpcId : undefined;
 }
 
+/**
+ * 每条连接上「距离上次补齐注释」的状态：上次补齐的时刻、之后写出去的字节数。
+ *
+ * 键是响应对象，连接收掉后自然被回收，不需要显式清理。
+ */
+const PAD_STATES = new WeakMap();
+
+/**
+ * 决定这一条记录要不要补注释、补多少。
+ *
+ * 补注释的**唯一理由**是让安卓 RN 的 XHR 攒够字节尽快把进度事件吐给界面；补多少与补
+ * 多勤都不影响这条理由，只影响代价 —— 一条记录补整份 2048 字节时，一次几十秒的流式
+ * 回复（每秒几十条增量）光注释就要几 MB。所以改成按窗口补齐：
+ *  - 距离上次补齐不到 `padEveryMs` 且累计字节还没越过 `padBytes` → 先不补，攒着；
+ *  - 到了窗口边界或单条记录自己就够大 → 补到「自上次补齐以来累计 ≥ padBytes」为止。
+ * 客户端看到的仍然是「每 ≥padBytes 就有一条补过注释的记录」，界面的出字节奏不变。
+ */
+function takePadding(res, written, padBytes, padEveryMs) {
+  let state = PAD_STATES.get(res);
+  if (!state) {
+    state = { at: 0, bytes: 0 };
+    PAD_STATES.set(res, state);
+  }
+  const now = Date.now();
+  const pending = state.bytes + written;
+  const due = padEveryMs > 0 ? now - state.at >= padEveryMs : true;
+  if (pending >= padBytes) {
+    // 这一发自己就越过了阈值，注释是纯浪费。
+    state.bytes = 0;
+    state.at = now;
+    return '';
+  }
+  if (!due) {
+    state.bytes = pending;
+    return '';
+  }
+  const padding = ssePadding(padBytes - pending);
+  state.bytes = 0;
+  state.at = now;
+  return padding;
+}
+
 /**
  * 写一条 SSE 记录。
  *
@@ -97,7 +139,9 @@ function stableEventId(payload, frame, namespace = 'session') {
  * @param {object} [options]
  * @param {object} [options.frame] 宿主 mux 帧，只用于算稳定 id
  * @param {string} [options.namespace='session'] 兜底 id 的前缀
- * @param {string} [options.padding=''] 每条记录后补的 SSE 注释行（见 ssePadding）
+ * @param {string} [options.padding=''] 固定的 SSE 注释行（调用方自己算好时用，见 ssePadding）
+ * @param {number} [options.paddingBytes=0] 让这条流维持的最小出字节数：>0 时按窗口补齐（见 takePadding）
+ * @param {number} [options.padEveryMs=0] 补齐窗口；0 表示每条记录都补到 paddingBytes
  * @param {number} [options.retryMs=SSE_RETRY_MS] SSE 重连间隔
  * @param {(payload: object) => boolean} [options.shedWhenBuffered] 超过软水位时这一帧能不能丢
  * @returns {{ok: boolean, shed?: boolean, needDrain?: boolean}}
@@ -110,6 +154,8 @@ function writeSse(res, payload, options = {}) {
     frame = null,
     namespace = 'session',
     padding = '',
+    paddingBytes = 0,
+    padEveryMs = 0,
     retryMs = SSE_RETRY_MS,
     shedWhenBuffered = shedWithoutSeq,
   } = options;
@@ -120,7 +166,11 @@ function writeSse(res, payload, options = {}) {
   const fields = [`retry: ${retryMs}`];
   if (id) fields.push(`id: ${id}`);
   fields.push(`data: ${JSON.stringify(payload)}`);
-  if (padding) fields.push(padding);
+  const extra = padding || (paddingBytes > 0
+    // 按字节算：正文是中文时字符数只有字节数三分之一，按字符算会低估、补多。
+    ? takePadding(res, Buffer.byteLength(`${fields.join('\n')}\n`, 'utf8'), Math.floor(paddingBytes), Math.floor(padEveryMs))
+    : '');
+  if (extra) fields.push(extra);
   fields.push('', '');
   try {
     // `write()` 返回 false 才是背压的正信号：数据已经堆到高水位，继续写只会把内存

package/lib/sidecar-facade-worker.cjs

@@ -68,8 +68,18 @@ const NETWORK_POLL_MS = 5000
 // 隧道重连间隔。onClose 与 start().catch 两条失败路径共用这个幂等调度器，
 // 否则每次失败会排两个定时器（重连风暴）；幂等性由
 // test/reconnect-scheduler.test.cjs 精确验证。
+//
+// 抖动 2s：中转重启后所有宿主在同一刻掉线，固定间隔会让它们踩着同一个点回来。
+// 退避到 30s：中转没起来时不该每 5 秒敲一次；注册成功由 onRegistered 里的 reset 清账。
 const RECONNECT_DELAY_MS = 5000
-const reconnect = createReconnectScheduler({ delayMs: RECONNECT_DELAY_MS, onFire: () => startTunnel() })
+const RECONNECT_JITTER_MS = 2000
+const RECONNECT_MAX_DELAY_MS = 30_000
+const reconnect = createReconnectScheduler({
+  delayMs: RECONNECT_DELAY_MS,
+  jitterMs: RECONNECT_JITTER_MS,
+  maxDelayMs: RECONNECT_MAX_DELAY_MS,
+  onFire: () => startTunnel(),
+})
 
 function send(res, code, value) {
   if (res.headersSent) return res.end()
@@ -239,7 +249,11 @@ function startTunnel() {
     // 是新实例、它的 ws 还停在 CONNECTING。于是 /status 报「已连接」、宿主据此放行镜像
     // 推送，worker 却按真值回 503，镜像一条也发不出去（现场：host.log 里
     // 「bg queue: sidecar facade request failed: 503」刷屏，而隧道其实在正常转发会话）。
-    onRegistered: () => { if (tunnel !== current) return; tunnelState = 'connected'; tunnelError = null; publishState() },
+    onRegistered: () => {
+      // 注册成功 = 链路真的通了：连续失败账清零，下次掉线重新从 5s 起算。
+      if (tunnel !== current) return; reconnect.reset()
+      tunnelState = 'connected'; tunnelError = null; publishState()
+    },
     onClose: () => { if (tunnel === current && config.enabled) { tunnelState = 'error'; tunnelError = '连接断开'; publishState(); scheduleReconnect() } },
     onPairRequest: async (message) => {
       try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mobile-plugin",
-  "version": "0.1.93",
+  "version": "0.1.94",
   "description": "Mobile API (/api/mobile/v1) and relay client for the DSH mobile app — desktop profile build (0.2.0-rc.2 compatible, peers resolved by the host)",
   "license": "MIT",
   "type": "module",