dsh-mobile-plugin 0.4.6 → 0.4.7

package/lib/relay/tunnel.js

@@ -87,6 +87,10 @@ class RelayTunnel {
     this.httpPumpCursor = 0;
     this.pendingHttpResponseBytes = 0;
     this.lastPong = 0;
+    // 对端存不存镜像：注册回执里明确说了才改，没说（老中转）按「存」处理，行为与以前一字
+    // 不差。纯转发节点（`MIRROR_CACHE=0`）收下整份镜像也只解析完丢掉，worker 据此只把
+    // 摘要推上去（lib/sidecar-facade-worker.cjs 的 digestFrame）。
+    this.relayMirror = true;
     // 清除所有授权的等待回调（一次一个）；由 requestRevokeAll 注入，revokeAllAck 触发。
     this._revokeAllAck = null;
   }
@@ -462,6 +466,9 @@ class RelayTunnel {
 
   /** 建立连接并注册；resolve 于收到 registered，reject 于连接/注册失败 */
   start() {
+    // 每条新连接都从「对端存镜像」重新判定：能走到推送的那一步一定已经收到过回执，
+    // 而回执缺这个字段的老中转本来就该按「存」处理。
+    this.relayMirror = true;
     return new Promise((resolve, reject) => {
       let settled = false;
       const done = (fn, arg) => {
@@ -482,6 +489,9 @@ class RelayTunnel {
 
       const push = createFrameDecoder((frame) => {
         if (frame.type === T.registered) {
+          // 回执里带 `mirror`：对端说不存镜像，就只推摘要（凭据 + 两个 revision），正文不推。
+          // 老中转回的是空载荷，`parseJson` 给空对象，于是判定为「存」——与以前完全一样。
+          this.relayMirror = parseJson(frame.payload).mirror !== false;
           clearTimeout(timer);
           done(resolve);
           this.onRegistered();

package/lib/sidecar-facade-worker.cjs

@@ -41,6 +41,9 @@ let tunnel = null
 let lan = null
 let tunnelState = 'off'
 let tunnelError = null
+// 当前这条隧道的对端存不存镜像（注册回执里报的）。false ⇒ 宿主只推摘要帧，正文不推。
+// 未知与老中转一律按 true：那是原来的行为，别让一次漏字段把镜像功能悄悄降级。
+let relayMirror = true
 let lanState = 'off'
 let lanError = null
 // 局域网代理**实际**在监听的端口。0 = 还没起来。首选端口被占时会退到内核分配的
@@ -62,7 +65,7 @@ function lanUrlPort() { return lanBoundPort || config.lanPort }
 function publishState() {
   process.send?.({
     type: 'state',
-    tunnel: { state: tunnelState, error: tunnelError },
+    tunnel: { state: tunnelState, error: tunnelError, mirror: relayMirror },
     lan: { enabled: Boolean(config.lanEnabled), port: lanUrlPort(), requestedPort: config.lanPort, state: lanState, error: lanError },
   })
 }
@@ -122,11 +125,40 @@ const TUNNEL_SEND_MAX_BODY = 8 * 1024 * 1024 - 64 * 1024
  * 裁字段而不是改推送策略：宿主那侧「推什么、什么时候推」一个字都不用改，两侧版本
  * 不必同时上线（老 worker + 新宿主也照旧工作，只是白推；新 worker + 老宿主也照旧）。
  */
-function frameForTunnel(body) {
+/**
+ * 对端不存镜像时上隧道的那一帧：只留中转还会真的读的东西。
+ *
+ * 纯转发节点（`MIRROR_CACHE=0`）的 `mirror::remember` 只留凭据摘要与时间戳，两份清单正文
+ * 解析完就丢——那是每台宿主每 5 秒几十 KB、一天上百 GB 的白推。所以对端在注册回执里说
+ * `mirror:false` 之后，清单与工作区各只留 `ok` 和 `revision`：
+ *
+ * - `ok` 必须留着，中转用它判「这份镜像是不是畸形」；
+ * - `revision` 必须留着，它是中转镜像账本里那一版的身份；
+ * - `creds` 必须留着，`/push-token` 的鉴权真源就是这本账里的摘要，丢了它上报全 403。
+ *
+ * 本地快照不受影响：`localSnapshot` 在这一帧被裁之前就已经赋值，局域网直连的读取隔离
+ * 读的是它（见 `/tunnel/send` 那一段）。
+ */
+function digestFrame(body) {
+  const pick = (value) => {
+    const out = { ok: true }
+    if (value && typeof value === 'object' && typeof value.revision === 'string') out.revision = value.revision
+    return out
+  }
+  return {
+    kind: 'sync',
+    at: body.at,
+    sessions: pick(body.sessions),
+    workspaces: pick(body.workspaces),
+    creds: Array.isArray(body.creds) ? body.creds : [],
+  }
+}
+
+function frameForTunnel(body, mirrorOff = false) {
   if (!body || typeof body !== 'object') return { kind: 'raw', data: body }
   if (body.kind !== 'sync') return body
   const { messages, stats, models, ...rest } = body
-  return rest
+  return mirrorOff ? digestFrame(rest) : rest
 }
 // /configure 只送 relay.json 那几十个字段，给 64KB 绰绰有余；放宽只会让误用更难发现。
 const CONFIGURE_MAX_BODY = 64 * 1024
@@ -255,6 +287,8 @@ function stopTunnel() {
   reconnect.cancel()
   if (tunnel) tunnel.stop()
   tunnel = null; tunnelState = 'off'; tunnelError = null
+  // 断开即忘掉上一台中转的口径：下次连的可能是另一台，别拿旧的判断去决定推不推正文。
+  relayMirror = true
   publishState()
 }
 function startNetworkMonitor() {
@@ -297,8 +331,10 @@ function openTunnel() {
     // 「bg queue: sidecar facade request failed: 503」刷屏，而隧道其实在正常转发会话）。
     onRegistered: () => {
       // 注册成功 = 链路真的通了：连续失败账清零，下次掉线重新从 5s 起算。
+      // 回执里的镜像口径（`relayMirror`）跟着状态一起改、一起播，同样只在这道身份闸之内：
+      // 旧实例迟到的回执不许改新连接的口径。
       if (tunnel !== current) return; reconnect.reset()
-      tunnelState = 'connected'; tunnelError = null; publishState()
+      tunnelState = 'connected'; tunnelError = null; relayMirror = current.relayMirror !== false; publishState()
     },
     onClose: () => { if (tunnel === current && config.enabled) { tunnelState = 'error'; tunnelError = '连接断开'; publishState(); scheduleReconnect() } },
     onPairRequest: async (message) => {
@@ -444,7 +480,7 @@ function status() {
   // 量不到的一律报 null、不拿 0 顶替：0 是「一条都没有」，与「不知道」是两件事。
   const lanStreams = lan && typeof lan.stats === 'function' ? lan.stats() : null
   const relaySseOpen = tunnel ? (typeof tunnel.upstreamSseCount === 'number' ? tunnel.upstreamSseCount : null) : 0
-  return { ok: true, sidecar: true, enabled: Boolean(config.enabled), relayUrl: config.relayUrl || '', instanceId: config.instanceId, name: config.name, localPort: config.upstreamPort, tunnel: { state: tunnelState, error: tunnelError }, lan: { enabled: Boolean(config.lanEnabled), port: lanUrlPort(), requestedPort: config.lanPort, state: lanState, error: lanError }, process: { memoryUsage: process.memoryUsage() }, streams: { lan: lanStreams, relaySseOpen } }
+  return { ok: true, sidecar: true, enabled: Boolean(config.enabled), relayUrl: config.relayUrl || '', instanceId: config.instanceId, name: config.name, localPort: config.upstreamPort, tunnel: { state: tunnelState, error: tunnelError, mirror: relayMirror }, lan: { enabled: Boolean(config.lanEnabled), port: lanUrlPort(), requestedPort: config.lanPort, state: lanState, error: lanError }, process: { memoryUsage: process.memoryUsage() }, streams: { lan: lanStreams, relaySseOpen } }
 }
 const server = http.createServer(async (req, res) => {
   try {
@@ -470,7 +506,7 @@ const server = http.createServer(async (req, res) => {
         const frameType = body && typeof body === 'object' && body.kind === 'push'
           ? (body.pushFrame === 'register' ? T.pushRegister : T.pushSend)
           : T.sync;
-        tunnel.sendJson(frameType, 0, frameForTunnel(body));
+        tunnel.sendJson(frameType, 0, frameForTunnel(body, relayMirror === false));
         return send(res, 202, { ok: true });
       }
       return send(res, 503, { ok: false, error: 'tunnel not connected' });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mobile-plugin",
-  "version": "0.4.6",
+  "version": "0.4.7",
   "description": "Mobile API (/api/mobile/v1) and relay client for the DSH mobile app — desktop profile build (dsh 0.2.x, peers resolved by the host)",
   "license": "MIT",
   "engines": {