@mrrisega/dsh-remote 0.7.6-beta.3 → 0.7.6-beta.4

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

@@ -631,7 +631,10 @@ export function dcSend(dc, obj) {
  *   · 每轮发送前先排空控制车道，并检查 `ws.bufferedAmount`：超过高水位就停手等它排空。
  *     于是控制帧前面最多只有「高水位 + 一片」的待发字节 —— 默认 64KB + 64KB，手机 1Mbps
  *     下 ≈1s，8Mbps 下 ≈0.13s，远小于 router 的 20s，也满足「大响应传输中 1s 内应答」目标。
- *   · 小帧（交互消息 / SSE 块）单独一条车道，优先于大帧的下一片（交互不被整帧传输拖住）。
+ *   · **数据帧严格 FIFO**（2026-10-24 修）：早期实现让小帧（交互/SSE 块）插到大帧下一片之前，
+ *     这在同一 WS 流里是**乱序** —— 生产表现为手机远程页「历史加载失败：session event stream
+ *     emitted an entry before its opening cursor」。现在只有一个数据队列，大帧按片就地推进，
+ *     绝不因大小/类型被后来的帧超越；只有控制帧（不承载有序数据）保留插队权。
  *   · 阈值 / 分片大小可用环境变量调（见 tunnelBulkOptionsFromEnv），弱网部署可再调低。
  */
 export const TUNNEL_BULK_HWM_DEFAULT = 64 * 1024;    // 发送缓冲高水位（字节）
@@ -680,13 +683,19 @@ export function makePrioritySender({
   let pumping = false;
   let scheduled = false;
   let timerPending = false;
-  const smallQ = []; // 小帧（可整帧直发）：交互消息 / SSE 块 —— 优先于大帧的下一片
-  const bigQ = [];   // 大帧：{ frames: string[], i }
-  const stats = { controlSent: 0, smallSent: 0, bigFrames: 0, bigChunks: 0, waits: 0, dropped: 0 };
-
-  function enqueueBulk(text) {
+  // 🔴 2026-10-24 事故修复：数据帧**必须严格 FIFO**。
+  //   旧实现分「小帧车道 / 大帧车道」，小帧会插到大帧下一片之前 —— 这违反了同一 WS 流里
+  //   消息的顺序语义，生产表现为手机远程页「历史加载失败：session event stream emitted an
+  //   entry before its opening cursor（gateway/internal）」：事件流请求/响应被乱序送达，
+  //   客户端的游标推进到了前面，重连时服务端按该游标回放就触发 cursor 错乱。
+  //   现在：控制帧仍可插队（它们是协议控制帧，不承载有序数据）；**数据帧只有一个队列**，
+  //   大帧按片就地推进，绝不因大小/类型被后来的帧超越。
+  const dataQ = []; // { frames: string[], i: number }；frames.length===1 = 未分片小帧
+  const stats = { controlSent: 0, dataSent: 0, bigFrames: 0, bigChunks: 0, waits: 0, dropped: 0 };
+
+  function enqueueData(text) {
     if (text.length <= chunkSize) {
-      smallQ.push(text);
+      dataQ.push({ frames: [text], i: 0 });
       return;
     }
     const cid = `c${++chunkSeq}`;
@@ -696,7 +705,7 @@ export function makePrioritySender({
       frames[i] = JSON.stringify({ __chunk: { id: cid, n, i, data: text.slice(i * chunkSize, (i + 1) * chunkSize) } });
     }
     stats.bigFrames += 1;
-    bigQ.push({ frames, i: 0 });
+    dataQ.push({ frames, i: 0 });
   }
 
   function scheduleNext(waitMs) {
@@ -716,7 +725,7 @@ export function makePrioritySender({
     if (pumping || closed) return;
     pumping = true;
     let yieldMode = ""; // ""=没有剩余，"schedule"=让出事件循环，"poll"=等缓冲排空
-    let budget = 32;    // 一轮最多发多少条小帧
+    let budget = 64;    // 一轮最多发多少条未分片小帧（大帧每轮只发一片）
     try {
       for (;;) {
         // ① 控制车道永远先走：哪怕大帧正传着 16MB，控制帧也在**下一轮**第一时间出去。
@@ -725,31 +734,31 @@ export function makePrioritySender({
           try { rawSend(frame); stats.controlSent += 1; } catch { closed = true; }
         }
         if (closed) { yieldMode = ""; break; }
-        // ② 小帧优先于大帧的下一片：大包传输期间，交互消息 / SSE 块不该排在它后面。
-        if (smallQ.length > 0 && budget > 0) {
-          try { rawSend(smallQ.shift()); stats.smallSent += 1; } catch { closed = true; break; }
+        if (dataQ.length === 0) { yieldMode = ""; break; }
+        if (budget <= 0) { yieldMode = "schedule"; break; }
+        const head = dataQ[0];
+        if (head.frames.length === 1) {
+          // 未分片小帧：可连着多发几条，但绝不越过队头（保证 FIFO）
+          try { rawSend(head.frames[0]); stats.dataSent += 1; } catch { closed = true; break; }
+          dataQ.shift();
           budget -= 1;
           continue; // 回环顶先查控制车道
         }
-        if (smallQ.length > 0) { yieldMode = "schedule"; break; } // 一轮预算用完
-        if (bigQ.length === 0) { yieldMode = ""; break; }
-        // ③ 背压：已入队字节超过高水位 → 停手等排空，别把控制帧埋进几十秒的队列里。
+        // 队头是大帧：每轮只推一片，片间让出事件循环（控制帧/入站帧不被饿死），顺序不变
         let pending = 0;
         try { pending = Number(bufferedAmount()) || 0; } catch { pending = 0; }
         if (pending > bulkHighWater) { stats.waits += 1; yieldMode = "poll"; break; }
-        const item = bigQ[0];
-        try { rawSend(item.frames[item.i]); stats.bigChunks += 1; } catch { closed = true; break; }
-        item.i += 1;
-        if (item.i >= item.frames.length) bigQ.shift();
-        yieldMode = "schedule"; // 大帧：一片一让，给入站帧 / 控制帧 / 小帧机会
+        try { rawSend(head.frames[head.i]); stats.dataSent += 1; stats.bigChunks += 1; } catch { closed = true; break; }
+        head.i += 1;
+        if (head.i >= head.frames.length) dataQ.shift();
+        yieldMode = "schedule";
         break;
       }
     } finally {
       pumping = false;
       if (closed) {
         controlQ.length = 0;
-        smallQ.length = 0;
-        bigQ.length = 0;
+        dataQ.length = 0;
       } else if (yieldMode) {
         scheduleNext(yieldMode === "poll" ? pollMs : 0);
       }
@@ -761,7 +770,7 @@ export function makePrioritySender({
     try { text = JSON.stringify(obj); } catch { return false; }
     if (closed) { stats.dropped += 1; return false; }
     if (isControlFrame(obj)) controlQ.push(text);
-    else enqueueBulk(text);
+    else enqueueData(text);
     pump();
     return true;
   }
@@ -770,8 +779,7 @@ export function makePrioritySender({
   function close() {
     closed = true;
     controlQ.length = 0;
-    smallQ.length = 0;
-    bigQ.length = 0;
+    dataQ.length = 0;
   }
 
   return {
@@ -779,11 +787,11 @@ export function makePrioritySender({
     close,
     stats: () => ({
       ...stats,
-      queued: smallQ.length + bigQ.length,
+      queued: dataQ.length,
       controlQueued: controlQ.length,
       closed
     }),
-    hasBacklog: () => smallQ.length > 0 || bigQ.length > 0 || controlQ.length > 0
+    hasBacklog: () => dataQ.length > 0 || controlQ.length > 0
   };
 }
 

package/clients/dsh-remote/test/bridge-control-priority.test.mjs

@@ -151,7 +151,7 @@ test("契约②：发送缓冲高水位以上时停手（控制帧不会被埋
   assert.equal(pos, beforeControl, "排空后第一时间发控制帧（之前的背压不能把它排到分块后面）");
 });
 
-test("契约③：大帧传输中小帧优先（交互不被整帧传输拖住）；close() 丢弃未发内容", () => {
+test("契约③：数据帧严格 FIFO（大小不得插队，2026-10-24 历史游标错乱事故回归）；close() 丢弃未发内容", () => {
   const sock = fakeSocket();
   const sched = makeScheduler();
   const sender = makePrioritySender({
@@ -162,15 +162,23 @@ test("契约③：大帧传输中小帧优先（交互不被整帧传输拖住
   });
   // 大帧刚发出第一片（之后每轮只发一片）
   sender.send({ id: "big3", type: "http", body: "C".repeat(512 * 1024) });
-  // 传输中插入两条小帧（交互消息 / SSE 块）：必须插在大帧的下一片之前，而不是排在整帧之后
+  // 传输中插入两条小帧（交互消息 / SSE 块）：**不得插队**，必须排在大帧之后（FIFO）
   sender.send({ id: "i1", type: "ws-msg", data: "hello" });
   sender.send({ id: "i2", type: "http-chunk", body: "chunk" });
   const ids = sock.frames.map((s) => {
     const o = JSON.parse(s);
     return o.__chunk ? "__chunk" : o.id;
   });
-  assert.deepEqual(ids.slice(0, 3), ["__chunk", "i1", "i2"], "小帧必须插在大帧的下一片之前");
-  assert.equal(sender.stats().bigChunks, 1, "此时大帧只发了 1 片");
+  assert.equal(ids[0], "__chunk", "大帧第一片先发");
+  assert.ok(!ids.slice(0, 3).includes("i1"), "后入队的小帧绝不能插队到大帧分片之前（顺序语义）");
+  for (let i = 0; i < 5000 && sched.pending() > 0; i += 1) { sock.drain(10 * 1024 * 1024); sched.tick(); }
+  const orderedIds = sock.frames.map((s) => {
+    const o = JSON.parse(s);
+    return o.__chunk ? "__chunk" : o.id;
+  });
+  const firstNonChunk = orderedIds.findIndex((id) => id !== "__chunk");
+  assert.ok(firstNonChunk >= 8, `大帧的分片必须全部先发完（首个非分片位置 ${firstNonChunk}）`);
+  assert.deepEqual(orderedIds.slice(firstNonChunk), ["i1", "i2"], "小帧必须在大帧之后、且保持入队顺序");
 
   // close 后：未发内容丢弃，后续 send 返回 false（重连后不能把旧分片发到新连接上）
   const sock2 = fakeSocket();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrisega/dsh-remote",
-  "version": "0.7.6-beta.3",
+  "version": "0.7.6-beta.4",
   "description": "手机远程控制 DeepSeek Harness · Remote control DeepSeek Harness (dsh web) from any phone browser — 100% 全功能 App 级体验：发消息、看工具执行、审批权限、改设置、管凭据，含特权操作，免内网穿透。一条命令安装 npx @mrrisega/dsh-remote。Mobile remote control for DSH, self-host or SaaS, no server needed on LAN.",
   "keywords": [
     "deepseek-harness",

package/packages/dsh-remote-web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-remote-web",
-  "version": "0.7.6-beta.3",
+  "version": "0.7.6-beta.4",
   "description": "公网远程控制 DeepSeek Harness（dsh web）：安装即得专属加密地址，人在外面也能用手机访问电脑上的 dsh——无需同一局域网/WiFi、无需公网 IP 与内网穿透，全程加密；手机端 100% 还原电脑体验（对话/工具/审批/设置）。技术用户可选自建服务，流量走自己的服务器。Remote control DeepSeek Harness (dsh web) from anywhere over the public internet — install, get an encrypted URL, use it from your phone on any network (dual-half cordis plugin: Settings panel + same-origin /dsh-remote routes). (2026-09 由 dsh-remote-ui 更名 / renamed from dsh-remote-ui; dsh-remote 的 dsh web 插件半，不是纯 UI/皮肤插件)",
   "type": "module",
   "main": "lib/index.js",

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

@@ -631,7 +631,10 @@ export function dcSend(dc, obj) {
  *   · 每轮发送前先排空控制车道，并检查 `ws.bufferedAmount`：超过高水位就停手等它排空。
  *     于是控制帧前面最多只有「高水位 + 一片」的待发字节 —— 默认 64KB + 64KB，手机 1Mbps
  *     下 ≈1s，8Mbps 下 ≈0.13s，远小于 router 的 20s，也满足「大响应传输中 1s 内应答」目标。
- *   · 小帧（交互消息 / SSE 块）单独一条车道，优先于大帧的下一片（交互不被整帧传输拖住）。
+ *   · **数据帧严格 FIFO**（2026-10-24 修）：早期实现让小帧（交互/SSE 块）插到大帧下一片之前，
+ *     这在同一 WS 流里是**乱序** —— 生产表现为手机远程页「历史加载失败：session event stream
+ *     emitted an entry before its opening cursor」。现在只有一个数据队列，大帧按片就地推进，
+ *     绝不因大小/类型被后来的帧超越；只有控制帧（不承载有序数据）保留插队权。
  *   · 阈值 / 分片大小可用环境变量调（见 tunnelBulkOptionsFromEnv），弱网部署可再调低。
  */
 export const TUNNEL_BULK_HWM_DEFAULT = 64 * 1024;    // 发送缓冲高水位（字节）
@@ -680,13 +683,19 @@ export function makePrioritySender({
   let pumping = false;
   let scheduled = false;
   let timerPending = false;
-  const smallQ = []; // 小帧（可整帧直发）：交互消息 / SSE 块 —— 优先于大帧的下一片
-  const bigQ = [];   // 大帧：{ frames: string[], i }
-  const stats = { controlSent: 0, smallSent: 0, bigFrames: 0, bigChunks: 0, waits: 0, dropped: 0 };
-
-  function enqueueBulk(text) {
+  // 🔴 2026-10-24 事故修复：数据帧**必须严格 FIFO**。
+  //   旧实现分「小帧车道 / 大帧车道」，小帧会插到大帧下一片之前 —— 这违反了同一 WS 流里
+  //   消息的顺序语义，生产表现为手机远程页「历史加载失败：session event stream emitted an
+  //   entry before its opening cursor（gateway/internal）」：事件流请求/响应被乱序送达，
+  //   客户端的游标推进到了前面，重连时服务端按该游标回放就触发 cursor 错乱。
+  //   现在：控制帧仍可插队（它们是协议控制帧，不承载有序数据）；**数据帧只有一个队列**，
+  //   大帧按片就地推进，绝不因大小/类型被后来的帧超越。
+  const dataQ = []; // { frames: string[], i: number }；frames.length===1 = 未分片小帧
+  const stats = { controlSent: 0, dataSent: 0, bigFrames: 0, bigChunks: 0, waits: 0, dropped: 0 };
+
+  function enqueueData(text) {
     if (text.length <= chunkSize) {
-      smallQ.push(text);
+      dataQ.push({ frames: [text], i: 0 });
       return;
     }
     const cid = `c${++chunkSeq}`;
@@ -696,7 +705,7 @@ export function makePrioritySender({
       frames[i] = JSON.stringify({ __chunk: { id: cid, n, i, data: text.slice(i * chunkSize, (i + 1) * chunkSize) } });
     }
     stats.bigFrames += 1;
-    bigQ.push({ frames, i: 0 });
+    dataQ.push({ frames, i: 0 });
   }
 
   function scheduleNext(waitMs) {
@@ -716,7 +725,7 @@ export function makePrioritySender({
     if (pumping || closed) return;
     pumping = true;
     let yieldMode = ""; // ""=没有剩余，"schedule"=让出事件循环，"poll"=等缓冲排空
-    let budget = 32;    // 一轮最多发多少条小帧
+    let budget = 64;    // 一轮最多发多少条未分片小帧（大帧每轮只发一片）
     try {
       for (;;) {
         // ① 控制车道永远先走：哪怕大帧正传着 16MB，控制帧也在**下一轮**第一时间出去。
@@ -725,31 +734,31 @@ export function makePrioritySender({
           try { rawSend(frame); stats.controlSent += 1; } catch { closed = true; }
         }
         if (closed) { yieldMode = ""; break; }
-        // ② 小帧优先于大帧的下一片：大包传输期间，交互消息 / SSE 块不该排在它后面。
-        if (smallQ.length > 0 && budget > 0) {
-          try { rawSend(smallQ.shift()); stats.smallSent += 1; } catch { closed = true; break; }
+        if (dataQ.length === 0) { yieldMode = ""; break; }
+        if (budget <= 0) { yieldMode = "schedule"; break; }
+        const head = dataQ[0];
+        if (head.frames.length === 1) {
+          // 未分片小帧：可连着多发几条，但绝不越过队头（保证 FIFO）
+          try { rawSend(head.frames[0]); stats.dataSent += 1; } catch { closed = true; break; }
+          dataQ.shift();
           budget -= 1;
           continue; // 回环顶先查控制车道
         }
-        if (smallQ.length > 0) { yieldMode = "schedule"; break; } // 一轮预算用完
-        if (bigQ.length === 0) { yieldMode = ""; break; }
-        // ③ 背压：已入队字节超过高水位 → 停手等排空，别把控制帧埋进几十秒的队列里。
+        // 队头是大帧：每轮只推一片，片间让出事件循环（控制帧/入站帧不被饿死），顺序不变
         let pending = 0;
         try { pending = Number(bufferedAmount()) || 0; } catch { pending = 0; }
         if (pending > bulkHighWater) { stats.waits += 1; yieldMode = "poll"; break; }
-        const item = bigQ[0];
-        try { rawSend(item.frames[item.i]); stats.bigChunks += 1; } catch { closed = true; break; }
-        item.i += 1;
-        if (item.i >= item.frames.length) bigQ.shift();
-        yieldMode = "schedule"; // 大帧：一片一让，给入站帧 / 控制帧 / 小帧机会
+        try { rawSend(head.frames[head.i]); stats.dataSent += 1; stats.bigChunks += 1; } catch { closed = true; break; }
+        head.i += 1;
+        if (head.i >= head.frames.length) dataQ.shift();
+        yieldMode = "schedule";
         break;
       }
     } finally {
       pumping = false;
       if (closed) {
         controlQ.length = 0;
-        smallQ.length = 0;
-        bigQ.length = 0;
+        dataQ.length = 0;
       } else if (yieldMode) {
         scheduleNext(yieldMode === "poll" ? pollMs : 0);
       }
@@ -761,7 +770,7 @@ export function makePrioritySender({
     try { text = JSON.stringify(obj); } catch { return false; }
     if (closed) { stats.dropped += 1; return false; }
     if (isControlFrame(obj)) controlQ.push(text);
-    else enqueueBulk(text);
+    else enqueueData(text);
     pump();
     return true;
   }
@@ -770,8 +779,7 @@ export function makePrioritySender({
   function close() {
     closed = true;
     controlQ.length = 0;
-    smallQ.length = 0;
-    bigQ.length = 0;
+    dataQ.length = 0;
   }
 
   return {
@@ -779,11 +787,11 @@ export function makePrioritySender({
     close,
     stats: () => ({
       ...stats,
-      queued: smallQ.length + bigQ.length,
+      queued: dataQ.length,
       controlQueued: controlQ.length,
       closed
     }),
-    hasBacklog: () => smallQ.length > 0 || bigQ.length > 0 || controlQ.length > 0
+    hasBacklog: () => dataQ.length > 0 || controlQ.length > 0
   };
 }