cc-viewer 1.6.312 → 1.6.313

package/dist/index.html

@@ -21,7 +21,7 @@
     // 整体显示大小已弃用 CSS zoom：Electron 改用 webFrame.setZoomFactor（首屏抢占见
     // electron/tab-content-preload.js），纯浏览器交由用户用浏览器自带快捷键缩放，故此处不再设 zoom。
   </script>
-  <script type="module" crossorigin src="/assets/index-4qAcuvOR.js"></script>
+  <script type="module" crossorigin src="/assets/index-ByBJZi-l.js"></script>
   <link rel="modulepreload" crossorigin href="/assets/vendor-antd-Bur5ZxWE.js">
   <link rel="modulepreload" crossorigin href="/assets/vendor-codemirror-Si44UqBp.js">
   <link rel="modulepreload" crossorigin href="/assets/vendor-mdxeditor-Cco3AQJS.js">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-viewer",
-  "version": "1.6.312",
+  "version": "1.6.313",
   "description": "Claude Code Logger visualization management tool",
   "license": "MIT",
   "main": "server.js",

package/server/lib/ansi-safe-slice.js

@@ -1,5 +1,14 @@
 /**
- * 在输出缓冲区从头部截断时，找到安全的截断起点，
+ * ANSI 转义序列安全边界工具（纯函数、零依赖，乱码残片不变量的语义基准）。
+ * 两个导出：
+ *   findSafeSliceStart(buf, rawStart)  —— 缓冲区"掐头"裁剪的安全起点（锚点扫描）
+ *   splitTrailingIncomplete(buf)       —— 批边界"截尾"缓带：[安全前段, 半截序列尾巴]
+ * 共同保证：xterm 收到的字节流中，任何删除/分批的续点都是合法解析起点，
+ * 半截序列永不以字面渲染。端到端验证见 test/terminal-pipeline-oracle.test.js。
+ */
+
+/**
+ * findSafeSliceStart：在输出缓冲区从头部截断时，找到安全的截断起点，
  * 避免切片落在 ANSI 转义序列中间——丢掉 ESC[ 前缀后剩余字节
  * 会被 xterm.js 当普通文本渲染（表现为 `[9m`、`?2026l`、`6;136;136m` 类乱码）。
  *
@@ -20,8 +29,54 @@
  * 孤儿化 END（?2026l，xterm 下无害 no-op），不可能产生无 END 的 BEGIN；
  * 跨 2026 块截断的配平由调用方负责（见 pty-flood-coalescer.js 的标记剥离）。
  */
+// 前向锚点扫描窗：TUI 流 ESC 密集（几十字节内必中锚点），上限只在纯文本流生效——
+// 多丢 ≤4KB 且发生在 ≥45KB 保留尾部的头部，不可感知。
 const DEFAULT_SCAN_WINDOW = 4096;
+// 回看判定窗：CSI 实际长度有界（最长常见真彩 SGR ≈20 字节），64 足以覆盖
+// "rawStart 是否落在某序列内部"的判定；OSC 超长场景由前向 ESC 锚兜住。
 const BACK_SCAN = 64;
+// 缓带上限：正常序列远小于此；超限视为畸形流（永不终结的 OSC/DCS），
+// 放弃缓带按原样发出，防半截尾巴无界滞留内存/延迟。
+const DEFAULT_MAX_CARRY = 4096;
+
+/**
+ * 把 buf 切成 [可安全发出的前段, 尾部未终结的半截转义序列]。
+ * 用途：flushBatch 给每批输出包裹 DEC 2026 SYNC 标记——若批边界劈开一条序列，
+ * 注入的标记会吃掉它的 ESC，让后半段以字面渲染（`[9m`/`8;2;102m` 类残片的总根源）。
+ * 半截尾巴缓带到下一批（PTY 续写必然补全）即可保证每个被包裹的批序列完整。
+ * 尾部孤立高代理同样缓带（不劈 emoji 码点）。超 maxCarry 的悬挂（畸形流如
+ * 永不终结的 OSC）放弃缓带按原样发出，防止无界延迟/内存。
+ */
+export function splitTrailingIncomplete(buf, maxCarry = DEFAULT_MAX_CARRY) {
+  if (!buf) return ['', ''];
+  const k = buf.lastIndexOf('\x1b');
+  if (k !== -1 && buf.length - k <= maxCarry) {
+    const intro = k + 1 < buf.length ? buf.charCodeAt(k + 1) : -1;
+    let complete;
+    if (intro === -1) {
+      complete = false;                       // 裸 ESC 收尾
+    } else if (intro === 0x5b) {              // CSI：任何 0x40-0x7e 终字节即终结
+      complete = false;
+      for (let j = k + 2; j < buf.length; j++) {
+        const c = buf.charCodeAt(j);
+        if (c >= 0x40 && c <= 0x7e) { complete = true; break; }
+      }
+    } else if (intro === 0x5d) {              // OSC：k 是最后一个 ESC → ST 不可能，只看 BEL
+      complete = buf.indexOf('\x07', k + 2) !== -1;
+    } else if (intro === 0x50) {              // DCS：ST 终结需要 ESC，而 k 已是最后一个
+      complete = false;
+    } else {                                  // 短转义：ESC + 中间字节(0x20-0x2f)* + 终字节
+      let j = k + 1;
+      while (j < buf.length && buf.charCodeAt(j) >= 0x20 && buf.charCodeAt(j) <= 0x2f) j++;
+      complete = j < buf.length;
+    }
+    if (!complete) return [buf.slice(0, k), buf.slice(k)];
+  }
+  // 尾部孤立高代理：配对的低代理还在路上
+  const last = buf.charCodeAt(buf.length - 1);
+  if (last >= 0xd800 && last <= 0xdbff) return [buf.slice(0, -1), buf.slice(-1)];
+  return [buf, ''];
+}
 
 export function findSafeSliceStart(buf, rawStart, scanWindow = DEFAULT_SCAN_WINDOW) {
   if (rawStart <= 0) return 0;

package/server/pty-manager.js

@@ -6,7 +6,7 @@ import { platform, arch, homedir } from 'node:os';
 import { createRequire } from 'node:module';
 import { prepareEmbeddedShellSpawn, stripClaudeNoFlickerUnlessOptedIn } from './lib/terminal-env.js';
 import { killPtyTree } from './lib/term-signals.js';
-import { findSafeSliceStart } from './lib/ansi-safe-slice.js';
+import { findSafeSliceStart, splitTrailingIncomplete } from './lib/ansi-safe-slice.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -65,11 +65,18 @@ export { findSafeSliceStart };
 const SYNC_BEGIN = '\x1b[?2026h';
 const SYNC_END   = '\x1b[?2026l';
 
-function flushBatch() {
+function flushBatch(force = false) {
   batchScheduled = false;
   if (!batchBuffer) return;
-  const chunk = SYNC_BEGIN + batchBuffer + SYNC_END;
-  batchBuffer = '';
+  // 批边界半截序列缓带：每批都包 SYNC 标记，若批边界劈开一条转义序列，注入的标记
+  // 会吃掉它的 ESC、让后半段以字面渲染（`[9m`/`8;2;102m` 类残片的总根源）。半截尾巴
+  // 留到下一批（PTY 续写必然补全）；force=true（进程退出）时不缓带，冲洗全部残余。
+  let safe = batchBuffer;
+  let carry = '';
+  if (!force) [safe, carry] = splitTrailingIncomplete(batchBuffer);
+  batchBuffer = carry;
+  if (!safe) return;
+  const chunk = SYNC_BEGIN + safe + SYNC_END;
   for (const cb of dataListeners) {
     try { cb(chunk); } catch { }
   }
@@ -275,7 +282,7 @@ async function _spawnClaudeImpl(proxyPort, cwd, extraArgs = [], claudePath = nul
   });
 
   ptyProcess.onExit(({ exitCode }) => {
-    flushBatch();
+    flushBatch(true);
     lastExitCode = exitCode;
     ptyProcess = null;
     ptyKind = null;
@@ -455,7 +462,7 @@ async function _spawnShellImpl() {
   });
 
   ptyProcess.onExit(({ exitCode }) => {
-    flushBatch();
+    flushBatch(true);
     lastExitCode = exitCode;
     ptyProcess = null;
     ptyKind = null;
@@ -488,7 +495,7 @@ export function resizePty(cols, rows) {
 
 export function killPty() {
   if (ptyProcess) {
-    flushBatch();
+    flushBatch(true);
     batchBuffer = '';
     batchScheduled = false;
     // Windows：node-pty 的 ConPTY kill 有已知同步挂起问题（microsoft/node-pty#454），

package/server/scratch-pty-manager.js

@@ -5,7 +5,7 @@ import { platform, arch, homedir } from 'node:os';
 import { createRequire } from 'node:module';
 import { prepareEmbeddedShellSpawn } from './lib/terminal-env.js';
 import { killPtyTree } from './lib/term-signals.js';
-import { findSafeSliceStart } from './lib/ansi-safe-slice.js';
+import { findSafeSliceStart, splitTrailingIncomplete } from './lib/ansi-safe-slice.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -74,11 +74,17 @@ function maybeReap(id, s) {
   }
 }
 
-function flushBatch(s) {
+function flushBatch(s, force = false) {
   s.batchScheduled = false;
   if (!s.batchBuffer) return;
-  const chunk = s.batchBuffer;
-  s.batchBuffer = '';
+  // 批边界半截序列缓带（同 pty-manager.flushBatch）：scratch chunk 本身不包 SYNC 标记，
+  // 但洪泛限流器会按 flush 包裹——chunk 尾部序列完整才能保证 flush 边界不撕裂。
+  // force=true（进程退出）时不缓带，冲洗全部残余。
+  let chunk = s.batchBuffer;
+  let carry = '';
+  if (!force) [chunk, carry] = splitTrailingIncomplete(s.batchBuffer);
+  s.batchBuffer = carry;
+  if (!chunk) return;
   // snapshot 防 listener 在迭代中卸载产生跳号
   for (const cb of [...s.dataListeners]) {
     try { cb(chunk); } catch { }
@@ -159,7 +165,7 @@ export async function spawnScratch(id) {
     });
 
     s.ptyProcess.onExit(({ exitCode }) => {
-      flushBatch(s);
+      flushBatch(s, true);
       s.lastExitCode = exitCode;
       s.ptyProcess = null;
       for (const cb of [...s.exitListeners]) {
@@ -208,7 +214,7 @@ export function killScratch(id) {
   const s = ptys.get(id);
   if (!s) return;
   if (s.ptyProcess) {
-    flushBatch(s);
+    flushBatch(s, true);
     s.batchBuffer = '';
     s.batchScheduled = false;
     // 与 pty-manager.killPty 同款：win32 用 taskkill /T 收割 ConPTY 树，

package/server/server.js

@@ -1262,7 +1262,8 @@ async function setupTerminalWebSocket(httpServer) {
       floodGate = createFloodCoalescer({
         send: (data) => {
           if (ws.readyState === 1 && bpGate.offer()) {
-            try { ws.send(JSON.stringify({ type: 'data', data })); } catch {}
+            // send 抛错 = 该条数据永久丢失（流中间挖洞且无路径补发）→ 立即快照对齐兜底
+            try { ws.send(JSON.stringify({ type: 'data', data })); } catch { sendScratchResync(); return; }
             _countMsg();
           }
         },
@@ -1359,6 +1360,26 @@ async function setupTerminalWebSocket(httpServer) {
       // 该 ws 收到第一条 resize 时（见 ws.on('message')），抖动 (rows+1) → (rows) 触发 SIGWINCH。
       // 注：仅 PTY 已运行时才需要兜底；shell 不在 alternate-screen 不需要。
       let _needRedrawBootstrap = state.running === true;
+      // 加载期免疫补救：claude -c 大会话有数秒加载期，首发 SIGWINCH 若打在 TUI 渲染器
+      // 挂载前会被忽略且兜底是一次性的 → 画面空白持续到用户敲键盘。数据感知延迟重试：
+      // 连接以来 PTY 零输出（= 画面必然空白）才补发，有数据流过即作罢；ws close 清理。
+      let _ptyDataSeen = false;
+      const _redrawRetryTimers = [];
+      const _nudgeRedraw = () => {
+        try {
+          if (process.platform !== 'win32') {
+            const pid = getClaudePid();
+            if (pid && pid !== process.pid) process.kill(pid, 'SIGWINCH');
+          }
+        } catch {}
+      };
+      const _armRedrawRetries = () => {
+        for (const delay of [2000, 6000]) {
+          const t = setTimeout(() => { if (!_ptyDataSeen) _nudgeRedraw(); }, delay);
+          t.unref?.();
+          _redrawRetryTimers.push(t);
+        }
+      };
 
       // 反压闸门：写缓冲堆积时停发 data，恢复后用 outputBuffer 快照 resync 追赶；
       // resync 后强制 claude TUI 全屏重绘，避免洪泛结束于 TUI 静止态时画面停在快照
@@ -1425,7 +1446,8 @@ async function setupTerminalWebSocket(httpServer) {
       floodGate = createFloodCoalescer({
         send: (data) => {
           if (ws.readyState === 1 && bpGate.offer()) {
-            try { ws.send(JSON.stringify({ type: 'data', data })); } catch {}
+            // send 抛错 = 该条数据永久丢失（流中间挖洞且无路径补发）→ 立即快照对齐兜底
+            try { ws.send(JSON.stringify({ type: 'data', data })); } catch { sendResync(); return; }
             _countMsg();
           }
         },
@@ -1443,6 +1465,7 @@ async function setupTerminalWebSocket(httpServer) {
 
       // PTY 输出 → WebSocket(合并 ws 后客户端自行按 msg.type 分发,server 端不再 role 过滤)
       const removeDataListener = onPtyData((data) => {
+        _ptyDataSeen = true;
         floodGate.offer(data);
       });
 
@@ -1819,20 +1842,18 @@ async function setupTerminalWebSocket(httpServer) {
             // 让 PTY 短暂处于错误尺寸再回滚（避免 50-100ms 闪烁）
             if (_needRedrawBootstrap) {
               _needRedrawBootstrap = false;
-              try {
-                // Windows 无 SIGWINCH；ConPTY 在前面的 resizePty 调用里已经处理过 resize 通知，
-                // 这里仅是 POSIX 上的"等尺寸 noop 不发信号"兜底，Win 上跳过避免抛异常。
-                if (process.platform !== 'win32') {
-                  const pid = getClaudePid();
-                  if (pid && pid !== process.pid) process.kill(pid, 'SIGWINCH');
-                }
-              } catch {}
+              // Windows 无 SIGWINCH；ConPTY 在前面的 resizePty 调用里已经处理过 resize 通知，
+              // _nudgeRedraw 仅是 POSIX 上的"等尺寸 noop 不发信号"兜底（内部跳过 win32）。
+              _nudgeRedraw();
+              // claude -c 加载期免疫 SIGWINCH → 零输出时延迟补发（见上方声明处注释）
+              _armRedrawRetries();
             }
           }
         } catch {}
       });
 
       ws.on('close', () => {
+        for (const t of _redrawRetryTimers) clearTimeout(t);
         bpGate.dispose();
         floodGate.dispose();
         removeDataListener();