npm - cc-viewer - Versions diffs - 1.6.26 → 1.6.28 - Mend

cc-viewer 1.6.26 → 1.6.28

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/dist/assets/{index-Bp_VsiSj.css → index-DbVOM09a.css} +2 -2
package/dist/assets/{index-D3V7nrsz.js → index-Drek604n.js} +125 -125
package/dist/index.html +2 -2
package/interceptor.js +63 -11
package/lib/delta-reconstructor.js +169 -0
package/lib/interceptor-core.js +27 -1
package/lib/log-management.js +34 -5
package/lib/log-watcher.js +7 -1
package/lib/stats-worker.js +5 -2
package/package.json +1 -1
package/server.js +31 -8

package/dist/index.html CHANGED Viewed

@@ -6,8 +6,8 @@
   <title>Claude Code Viewer</title>
   <link rel="icon" href="/favicon.ico?v=1">
   <link rel="shortcut icon" href="/favicon.ico?v=1">
-  <script type="module" crossorigin src="/assets/index-D3V7nrsz.js"></script>
-  <link rel="stylesheet" crossorigin href="/assets/index-Bp_VsiSj.css">
+  <script type="module" crossorigin src="/assets/index-Drek604n.js"></script>
+  <link rel="stylesheet" crossorigin href="/assets/index-DbVOM09a.css">
 </head>
 <body>
   <div id="root"></div>

package/interceptor.js CHANGED Viewed

@@ -11,7 +11,7 @@ import { homedir } from 'node:os';
 import { fileURLToPath } from 'node:url';
 import { dirname, join, basename } from 'node:path';
 import { LOG_DIR } from './findcc.js';
-import { assembleStreamMessage, cleanupTempFiles, findRecentLog, isAnthropicApiPath, isMainAgentRequest, migrateConversationContext } from './lib/interceptor-core.js';
+import { assembleStreamMessage, cleanupTempFiles, findRecentLog, isAnthropicApiPath, isMainAgentRequest, rotateLogFile } from './lib/interceptor-core.js';
@@ -85,6 +85,20 @@ function resolveResumeChoice(choice) {
   return result;
 }
+// Delta storage: 增量存储开关和状态（默认开启，设置 CCV_DISABLE_DELTA=1 关闭）
+// 注意：delta 计算依赖 mainAgent 请求串行（Claude CLI 保证），不做并发互斥
+const _deltaStorageEnabled = process.env.CCV_DISABLE_DELTA !== '1';
+let _lastMessagesCount = 0;     // 上一次 mainAgent 写入的完整 messages 数量
+let _mainAgentDeltaCount = 0;   // mainAgent 请求计数器（用于触发定期 checkpoint）
+const CHECKPOINT_INTERVAL = 10; // 每 N 条 mainAgent 请求写一个 checkpoint
+/** Delta storage: completed 写入成功后更新状态 */
+function _commitDeltaState(originalLength) {
+  if (_deltaStorageEnabled && originalLength > 0) {
+    _lastMessagesCount = originalLength;
+  }
+}
 // Teammate 子进程检测：--parent-session-id（旧模式）或 --agent-name（原生 team 模式）
 const _isTeammate = process.argv.includes('--parent-session-id') || process.argv.includes('--agent-name');
 // 提取 teammate 元数据（--agent-name worker-1 --team-name fix-ts-errors）
@@ -184,21 +198,24 @@ export function resetWorkspace() {
   LOG_FILE = '';
 }
-const MAX_LOG_SIZE = 150 * 1024 * 1024; // 150MB
+const MAX_LOG_SIZE = 250 * 1024 * 1024; // 250MB
 function checkAndRotateLogFile() {
   // Teammate 不做日志轮转，由 leader 负责
   if (_isTeammate) return;
   try {
-    if (!existsSync(LOG_FILE)) return;
-    const size = statSync(LOG_FILE).size;
-    if (size >= MAX_LOG_SIZE) {
-      const oldFile = LOG_FILE;
-      const { filePath } = generateNewLogFilePath();
-      LOG_FILE = filePath;
-      migrateConversationContext(oldFile, filePath);
+    if (!existsSync(LOG_FILE) || statSync(LOG_FILE).size < MAX_LOG_SIZE) return;
+  } catch { return; }
+  const { filePath } = generateNewLogFilePath();
+  const result = rotateLogFile(LOG_FILE, filePath, MAX_LOG_SIZE);
+  if (result.rotated) {
+    LOG_FILE = result.newFile;
+    // 重置 delta 状态，强制下一条 mainAgent 请求写完整 checkpoint
+    if (_deltaStorageEnabled) {
+      _lastMessagesCount = 0;
+      _mainAgentDeltaCount = 0;
     }
-  } catch { }
+  }
 }
 // 从环境变量 ANTHROPIC_BASE_URL 提取域名用于请求匹配
@@ -356,7 +373,7 @@ export function setupInterceptor() {
       }
     } catch { }
-    // 用户新指令边界：检查日志文件大小，超过 200MB 则切换新文件
+    // 用户新指令边界：检查日志文件大小，超过 250MB 则切换新文件
     if (requestEntry?.mainAgent) {
       checkAndRotateLogFile();
       // 仅 mainAgent 请求时缓存模型名，避免 SubAgent 覆盖
@@ -369,6 +386,36 @@ export function setupInterceptor() {
       }
     }
+    // Delta storage：仅 mainAgent 且开关启用时，将 body.messages 转为增量格式
+    let _deltaOriginalMessagesLength = 0; // 缓存本次请求的原始 messages 长度，用于 completed 后更新状态
+    if (_deltaStorageEnabled && requestEntry?.mainAgent && Array.isArray(requestEntry.body?.messages)) {
+      const messages = requestEntry.body.messages;
+      _deltaOriginalMessagesLength = messages.length;
+      _mainAgentDeltaCount++;
+      // 判断是否需要写 checkpoint
+      const needsCheckpoint =
+        _lastMessagesCount === 0 ||                           // 进程重启 / 首次请求
+        messages.length < _lastMessagesCount ||               // messages 缩短（/clear、context 压缩）
+        (_mainAgentDeltaCount % CHECKPOINT_INTERVAL === 0);   // 定期 checkpoint
+      if (needsCheckpoint) {
+        // checkpoint：保持完整 messages，标记 _isCheckpoint
+        requestEntry._deltaFormat = 1;
+        requestEntry._totalMessageCount = messages.length;
+        requestEntry._conversationId = 'mainAgent';
+        requestEntry._isCheckpoint = true;
+      } else {
+        // delta：只保留新增的 messages
+        const delta = messages.slice(_lastMessagesCount);
+        requestEntry._deltaFormat = 1;
+        requestEntry._totalMessageCount = messages.length;
+        requestEntry._conversationId = 'mainAgent';
+        requestEntry._isCheckpoint = false;
+        requestEntry.body.messages = delta;
+      }
+    }
     // 生成唯一请求 ID，用于关联在途请求和完成请求
     const requestId = `${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
     if (requestEntry) {
@@ -447,6 +494,7 @@ export function setupInterceptor() {
                       delete requestEntry.inProgress;
                       delete requestEntry.requestId;
                       appendFileSync(LOG_FILE, JSON.stringify(requestEntry) + '\n---\n');
+                      _commitDeltaState(_deltaOriginalMessagesLength);
                       // Release memory: clear large objects after disk write
                       streamedContent = '';
                       requestEntry.response = null;
@@ -455,6 +503,7 @@ export function setupInterceptor() {
                       delete requestEntry.inProgress;
                       delete requestEntry.requestId;
                       appendFileSync(LOG_FILE, JSON.stringify(requestEntry) + '\n---\n');
+                      _commitDeltaState(_deltaOriginalMessagesLength);
                       streamedContent = '';
                       requestEntry.response = null;
                     }
@@ -487,6 +536,7 @@ export function setupInterceptor() {
           delete requestEntry.inProgress;
           delete requestEntry.requestId;
           appendFileSync(LOG_FILE, JSON.stringify(requestEntry) + '\n---\n');
+          _commitDeltaState(_deltaOriginalMessagesLength);
         }
       } else {
         // 对于非流式响应，可以安全读取body
@@ -513,10 +563,12 @@ export function setupInterceptor() {
           delete requestEntry.requestId;
           appendFileSync(LOG_FILE, JSON.stringify(requestEntry) + '\n---\n');
+          _commitDeltaState(_deltaOriginalMessagesLength);
         } catch (err) {
           delete requestEntry.inProgress;
           delete requestEntry.requestId;
           appendFileSync(LOG_FILE, JSON.stringify(requestEntry) + '\n---\n');
+          _commitDeltaState(_deltaOriginalMessagesLength);
         }
       }
     }

package/lib/delta-reconstructor.js ADDED Viewed

@@ -0,0 +1,169 @@
+/**
+ * Delta Reconstructor — 增量日志重建模块
+ *
+ * 将 delta 格式的日志条目重建为完整的 messages 数组。
+ * 仅处理 mainAgent 条目，teammate/旧格式条目直接跳过。
+ *
+ * 提供两种 API：
+ * - reconstructEntries(entries): 批量重建，用于 readLogFile() 和 readLocalLog()
+ * - createIncrementalReconstructor(): 有状态的增量重建器，用于 watcher 逐条重建
+ */
+/**
+ * 判断一个条目是否为 checkpoint（应重置累积状态）。
+ * 三种情况视为 checkpoint：
+ * 1. 无 _deltaFormat 字段 → 旧格式全量条目
+ * 2. _isCheckpoint === true → 显式 checkpoint
+ * 3. _totalMessageCount === body.messages.length → 隐式 checkpoint（delta 长度 === 总长度）
+ */
+function isCheckpointEntry(entry) {
+  // 无 _deltaFormat：旧格式全量条目
+  if (!entry._deltaFormat) return true;
+  // 显式 checkpoint
+  if (entry._isCheckpoint) return true;
+  // 隐式 checkpoint：delta 长度等于总长度
+  const msgs = entry.body?.messages;
+  if (Array.isArray(msgs) && entry._totalMessageCount === msgs.length) return true;
+  return false;
+}
+/**
+ * 判断一个条目是否为需要重建的 delta 条目（mainAgent + _deltaFormat）。
+ */
+function isDeltaEntry(entry) {
+  return entry._deltaFormat && entry.mainAgent;
+}
+/**
+ * 批量重建 — 用于 readLogFile() 和 readLocalLog()。
+ * 输入已去重的条目数组，输出重建后的条目数组（原地修改 body.messages）。
+ * 非 mainAgent delta 条目不受影响。
+ *
+ * @param {Array} entries - 已去重、按时间顺序排列的条目数组
+ * @returns {Array} 重建后的条目数组（同一引用，原地修改）
+ */
+export function reconstructEntries(entries) {
+  // 第一遍：正向重建
+  let accumulated = []; // mainAgent 累积 messages
+  const broken = [];    // 记录重建失败的条目索引（用于第二遍补偿）
+  for (let i = 0; i < entries.length; i++) {
+    const entry = entries[i];
+    if (!isDeltaEntry(entry)) {
+      // 非 delta 条目（旧格式 / teammate）：如果是 mainAgent 旧格式，重置累积状态
+      if (entry.mainAgent && Array.isArray(entry.body?.messages)) {
+        accumulated = [...entry.body.messages];
+      }
+      continue;
+    }
+    // delta 条目处理
+    const msgs = entry.body?.messages;
+    if (!Array.isArray(msgs)) continue;
+    if (isCheckpointEntry(entry)) {
+      // checkpoint：用当前 messages 重置累积状态
+      accumulated = [...msgs];
+    } else {
+      // delta：拼接到累积数组
+      accumulated = [...accumulated, ...msgs];
+      // 挂载重建后的完整 messages（checkpoint/旧格式条目保持不变）
+      entry.body.messages = accumulated;
+      if (entry._totalMessageCount && accumulated.length !== entry._totalMessageCount) {
+        broken.push(i);
+      }
+    }
+  }
+  // 第二遍：补偿修复 — 用后续最近的 checkpoint 回填断裂的条目
+  if (broken.length > 0) {
+    _compensateBrokenEntries(entries, broken);
+  }
+  return entries;
+}
+/**
+ * 补偿修复：对断裂的 delta 条目，从后续最近的 checkpoint 中提取完整 messages 回填。
+ * checkpoint 包含截至该点的完整历史，可以据此反推之前条目的 messages。
+ */
+function _compensateBrokenEntries(entries, brokenIndices) {
+  for (const brokenIdx of brokenIndices) {
+    const brokenEntry = entries[brokenIdx];
+    const expectedCount = brokenEntry._totalMessageCount;
+    if (!expectedCount) continue;
+    // 向后查找最近的 checkpoint 或旧格式全量条目
+    for (let j = brokenIdx + 1; j < entries.length; j++) {
+      const candidate = entries[j];
+      if (!candidate.mainAgent || !Array.isArray(candidate.body?.messages)) continue;
+      const candidateMsgs = candidate.body.messages;
+      const candidateTotal = candidate._totalMessageCount || candidateMsgs.length;
+      // 候选条目必须是 checkpoint/旧格式且包含足够的 messages
+      const isFullEntry = !candidate._deltaFormat || isCheckpointEntry(candidate);
+      if (isFullEntry && candidateTotal >= expectedCount) {
+        // 从完整 messages 中截取前 expectedCount 条作为补偿
+        brokenEntry.body.messages = candidateMsgs.slice(0, expectedCount);
+        break;
+      }
+    }
+  }
+}
+/**
+ * 创建有状态的增量重建器 — 用于 watcher 逐条重建。
+ * 每次调用 reconstruct(entry) 处理一条新条目。
+ *
+ * @returns {{ reconstruct: (entry: object) => object }}
+ */
+export function createIncrementalReconstructor() {
+  let accumulated = []; // mainAgent 累积 messages
+  return {
+    /**
+     * 重建单条条目。
+     * - 非 delta 条目：如果是 mainAgent 旧格式，更新累积状态，原样返回
+     * - checkpoint：重置累积状态，原样返回
+     * - delta：拼接重建，修改 body.messages 后返回
+     *
+     * @param {object} entry - 单条日志条目
+     * @returns {object} 重建后的条目（同一引用）
+     */
+    reconstruct(entry) {
+      // 跳过 inProgress 条目：它会被同一请求的 completed 条目覆盖，
+      // 如果两者都处理会导致 accumulated 重复拼接相同的 delta
+      if (entry.inProgress) return entry;
+      if (!isDeltaEntry(entry)) {
+        // 非 delta 条目：如果是 mainAgent 旧格式，更新累积状态
+        if (entry.mainAgent && Array.isArray(entry.body?.messages)) {
+          accumulated = [...entry.body.messages];
+        }
+        return entry;
+      }
+      const msgs = entry.body?.messages;
+      if (!Array.isArray(msgs)) return entry;
+      if (isCheckpointEntry(entry)) {
+        // checkpoint：重置累积状态
+        accumulated = [...msgs];
+      } else {
+        // delta：拼接
+        accumulated = [...accumulated, ...msgs];
+        entry.body.messages = accumulated;
+      }
+      return entry;
+    },
+    /**
+     * 重置累积状态（用于 full_reload 等场景）。
+     */
+    reset() {
+      accumulated = [];
+    }
+  };
+}

package/lib/interceptor-core.js CHANGED Viewed

@@ -201,7 +201,9 @@ export function migrateConversationContext(oldFile, newFile) {
         const entry = JSON.parse(parts[i]);
         if (entry.mainAgent) {
           const msgs = entry.body?.messages;
-          if (Array.isArray(msgs) && msgs.length === 1) {
+          // Delta storage: 使用 _totalMessageCount（delta 条目）或 msgs.length（旧格式）
+          const msgCount = entry._totalMessageCount || (Array.isArray(msgs) ? msgs.length : 0);
+          if (msgCount === 1) {
             originIndex = i;
             break;
           }
@@ -236,3 +238,27 @@ export function migrateConversationContext(oldFile, newFile) {
     }
   } catch { }
 }
+/**
+ * Rotate log file when it exceeds maxSize.
+ * Creates an empty new file (no content migration) and appends '\n' to old file
+ * to trigger fs.watchFile callback for watcher migration.
+ *
+ * @param {string} currentFile - current log file path
+ * @param {string} newFile - new log file path to rotate to
+ * @param {number} maxSize - max file size in bytes
+ * @returns {{ rotated: boolean, oldFile?: string, newFile?: string }}
+ */
+export function rotateLogFile(currentFile, newFile, maxSize) {
+  try {
+    if (!existsSync(currentFile)) return { rotated: false };
+    const size = statSync(currentFile).size;
+    if (size < maxSize) return { rotated: false };
+    // 不迁移旧内容，创建空新文件（立即创建，避免 watcher 时序窗口）
+    try { writeFileSync(newFile, ''); } catch { }
+    // 触发旧文件 watcher 回调，使其检测到文件变更并切换到新文件
+    try { appendFileSync(currentFile, '\n'); } catch { }
+    return { rotated: true, oldFile: currentFile, newFile };
+  } catch { }
+  return { rotated: false };
+}

package/lib/log-management.js CHANGED Viewed

@@ -1,5 +1,6 @@
 import { readFileSync, writeFileSync, existsSync, statSync, readdirSync, unlinkSync, realpathSync } from 'node:fs';
 import { join } from 'node:path';
+import { reconstructEntries } from './delta-reconstructor.js';
 /**
  * Validate that a resolved file path is contained within logDir.
@@ -77,10 +78,16 @@ export function readLocalLog(logDir, file) {
   validateLogPath(logDir, file);
   const filePath = join(logDir, file);
   const content = readFileSync(filePath, 'utf-8');
-  const entries = content.split('\n---\n').filter(line => line.trim()).map(entry => {
+  const parsed = content.split('\n---\n').filter(line => line.trim()).map(entry => {
     try { return JSON.parse(entry); } catch { return null; }
   }).filter(Boolean);
-  return entries;
+  // Delta storage: 先去重（timestamp|url），再重建 delta 条目
+  const map = new Map();
+  for (const entry of parsed) {
+    const key = `${entry.timestamp}|${entry.url}`;
+    map.set(key, entry);
+  }
+  return reconstructEntries(Array.from(map.values()));
 }
 /**
@@ -160,11 +167,33 @@ export function mergeLogFiles(logDir, files) {
     err.code = 'INVALID_INPUT';
     throw err;
   }
-  // 合并内容写入第一个文件
+  // Delta storage: 合并时先重建为全量格式再拼接（输出全部为旧格式全量条目，无 _deltaFormat）
   const targetFile = files[0];
   const targetPath = join(logDir, targetFile);
-  const contents = files.map(f => readFileSync(join(logDir, f), 'utf-8').trimEnd());
-  writeFileSync(targetPath, contents.join('\n---\n') + '\n');
+  const allEntries = [];
+  for (const f of files) {
+    const content = readFileSync(join(logDir, f), 'utf-8');
+    const parsed = content.split('\n---\n').filter(line => line.trim()).map(entry => {
+      try { return JSON.parse(entry); } catch { return null; }
+    }).filter(Boolean);
+    // 去重
+    const map = new Map();
+    for (const entry of parsed) {
+      const key = `${entry.timestamp}|${entry.url}`;
+      map.set(key, entry);
+    }
+    // 重建 delta 为全量
+    const reconstructed = reconstructEntries(Array.from(map.values()));
+    // 清除 delta 元字段，输出为旧格式全量条目
+    for (const entry of reconstructed) {
+      delete entry._deltaFormat;
+      delete entry._totalMessageCount;
+      delete entry._conversationId;
+      delete entry._isCheckpoint;
+    }
+    allEntries.push(...reconstructed);
+  }
+  writeFileSync(targetPath, allEntries.map(e => JSON.stringify(e)).join('\n---\n') + '\n---\n');
   // 删除其余文件
   for (let i = 1; i < files.length; i++) {
     unlinkSync(join(logDir, files[i]));

package/lib/log-watcher.js CHANGED Viewed

@@ -1,6 +1,7 @@
 import { readFileSync, existsSync, watchFile, unwatchFile, openSync, readSync, closeSync, statSync } from 'node:fs';
 import { isMainAgentEntry, extractCachedContent } from './kv-cache-analyzer.js';
 import { buildContextWindowEvent, getContextSizeForModel } from './context-watcher.js';
+import { reconstructEntries, createIncrementalReconstructor } from './delta-reconstructor.js';
 // 跟踪所有被 watch 的日志文件
 const watchedFiles = new Map();
@@ -31,7 +32,7 @@ export function readLogFile(logFile) {
       const key = `${entry.timestamp}|${entry.url}`;
       map.set(key, entry);
     }
-    return Array.from(map.values());
+    return reconstructEntries(Array.from(map.values()));
   } catch (err) {
     console.error('Error reading log file:', err);
     return [];
@@ -84,6 +85,8 @@ export function watchLogFile(opts) {
   // Track byte offset instead of string length — avoids full-file re-read on every poll
   let lastByteOffset = 0;
   let pendingTail = ''; // incomplete entry carried across polls
+  // Delta storage: 增量重建器，用于逐条重建 mainAgent delta 条目
+  const _reconstructor = createIncrementalReconstructor();
   try {
     if (existsSync(logFile)) {
       lastByteOffset = statSync(logFile).size;
@@ -99,6 +102,7 @@ export function watchLogFile(opts) {
       if (currentSize < lastByteOffset) {
         lastByteOffset = 0;
         pendingTail = '';
+        _reconstructor.reset();
         // 文件被清空可能是轮转信号，立即检查是否已切换到新文件
         const currentLogFile = getLogFile();
@@ -157,6 +161,8 @@ export function watchLogFile(opts) {
             if (!parsed.pid) {
               parsed.pid = getClaudePid();
             }
+            // Delta storage: reconstruct before push — 确保前端收到完整 messages
+            _reconstructor.reconstruct(parsed);
             sendToClients(clients, parsed);
             runParallelHook('onNewEntry', parsed).catch(() => {});
             if (isMainAgentEntry(parsed)) {

package/lib/stats-worker.js CHANGED Viewed

@@ -108,7 +108,8 @@ function parseJsonlFile(filePath) {
         // 会话轮次统计（仅 MainAgent，排除 SUGGESTION MODE）
         if (entry.mainAgent && Array.isArray(entry.body?.messages)) {
           const msgs = entry.body.messages;
-          const len = msgs.length;
+          // Delta storage: 使用 _totalMessageCount（delta 条目）或 msgs.length（旧格式）
+          const len = entry._totalMessageCount || msgs.length;
           if (!isSuggestionMode(msgs)) {
             // messages 数量大幅缩减：新会话（/clear 等），重置追踪
             if (len < maxMsgLen * 0.5 && (maxMsgLen - len) > 4) {
@@ -129,12 +130,14 @@ function parseJsonlFile(filePath) {
                 maxMsgLen = len;
               }
               const texts = extractUserTexts(msgs);
+              // Delta storage: delta 条目的 msgs 只有新增部分，prevTextCount 不适用，从 0 开始收集
+              const textStart = entry._deltaFormat ? 0 : prevTextCount;
               // 生成本次 prompt 签名，用于跳过同轮重复请求
               const sig = texts.join('\x00');
               if (sig === lastCollectedSig && !isNewTurn) {
                 // 同一轮的重复请求（内容完全相同），跳过
               } else {
-                for (let ti = prevTextCount; ti < texts.length; ti++) {
+                for (let ti = textStart; ti < texts.length; ti++) {
                   const flat = texts[ti].replace(/[\r\n]+/g, ' ').trim();
                   if (flat) preview.push(flat.slice(0, 100));
                 }

package/package.json CHANGED Viewed

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

package/server.js CHANGED Viewed

@@ -1313,14 +1313,37 @@ async function handleRequest(req, res) {
         return;
       }
       const fileName = file.split('/').pop();
-      const stat = statSync(realPath);
-      res.writeHead(200, {
-        'Content-Type': 'application/octet-stream',
-        'Content-Disposition': `attachment; filename="${encodeURIComponent(fileName)}"`,
-        'Content-Length': stat.size,
-      });
-      const stream = createReadStream(realPath);
-      stream.pipe(res);
+      const format = parsedUrl.searchParams.get('format');
+      // Delta storage: format=raw 下载原始文件；默认下载重建后的全量格式
+      if (format === 'raw') {
+        const stat = statSync(realPath);
+        res.writeHead(200, {
+          'Content-Type': 'application/octet-stream',
+          'Content-Disposition': `attachment; filename="${encodeURIComponent(fileName)}"`,
+          'Content-Length': stat.size,
+        });
+        const stream = createReadStream(realPath);
+        stream.pipe(res);
+      } else {
+        // 重建为全量格式下载
+        const { readLocalLog } = await import('./lib/log-management.js');
+        const entries = readLocalLog(LOG_DIR, file);
+        // 清除 delta 元字段
+        for (const entry of entries) {
+          delete entry._deltaFormat;
+          delete entry._totalMessageCount;
+          delete entry._conversationId;
+          delete entry._isCheckpoint;
+        }
+        const content = entries.map(e => JSON.stringify(e)).join('\n---\n') + '\n---\n';
+        const buf = Buffer.from(content, 'utf-8');
+        res.writeHead(200, {
+          'Content-Type': 'application/octet-stream',
+          'Content-Disposition': `attachment; filename="${encodeURIComponent(fileName)}"`,
+          'Content-Length': buf.length,
+        });
+        res.end(buf);
+      }
     } catch (err) {
       res.writeHead(500, { 'Content-Type': 'application/json' });
       res.end(JSON.stringify({ error: err.message }));