cc-viewer 1.6.294 → 1.6.295

package/server/lib/log-watcher.js

@@ -1,4 +1,5 @@
-import { readFileSync, existsSync, watchFile, unwatchFile, openSync, readSync, closeSync, statSync } from 'node:fs';
+import { readFileSync, existsSync, watch, watchFile, unwatchFile, openSync, readSync, closeSync, statSync } from 'node:fs';
+import { dirname, basename } from 'node:path';
 import { isMainAgentEntry, extractCachedContent } from './kv-cache-analyzer.js';
 import { buildContextWindowEvent, getContextSizeForModel } from './context-watcher.js';
 import { reconstructEntries, createIncrementalReconstructor } from './delta-reconstructor.js';
@@ -6,17 +7,26 @@ import { countLogEntries, streamReconstructedEntries } from './log-stream.js';
 import { enrichEntry } from './enrich-plan-input.js';
 import { resolveJsonlPath } from './jsonl-archive.js';
 
-// 跟踪所有被 watch 的日志文件
+// 跟踪所有被 watch 的日志文件。value: fileState 对象（外部只用 .has()/.keys()）
 const watchedFiles = new Map();
 
+// 目录级 fs.watch 实例注册表（事件驱动，替代 per-file 轮询）
+const _dirWatchers = new Map();
+
+// Windows 单次 appendFileSync 触发 2+ 事件，防抖合并
+const FSWATCH_DEBOUNCE_MS = 80;
+
+// 安全网慢轮询：fs.watch 可能漏事件（buffer overflow 等），冷 fallback 兜底
+const SAFETY_POLL_MS = 5000;
+
+const FORCE_POLL = process.env.CCV_FORCE_POLL === '1';
+
 /**
  * Read and parse a JSONL log file.
  * @param {string} logFile - absolute path to the log file
  * @returns {Array} parsed and deduplicated entries
  */
 export function readLogFile(logFile) {
-  // 透明支持归档后的 .jsonl.zip。active log（被 watchLogFile 追加写入的文件）不会被归档
-  // （archive 拒绝最新文件），watchLogFile 内部的 openSync/readSync 因此无需走 resolveJsonlPath。
   logFile = resolveJsonlPath(logFile);
   if (!existsSync(logFile)) {
     return [];
@@ -24,8 +34,6 @@ export function readLogFile(logFile) {
 
   try {
     const content = readFileSync(logFile, 'utf-8');
-    // Windows 上若 writer 使用 os.EOL，分隔符会变 \r\n---\r\n。固定 LF 切会失败 → 整文件
-    // 解析成一条乱码或漏。CRLF-tolerant split 把两边都 cover 住。
     const entries = content.split(/\r?\n---\r?\n/).filter(line => line.trim());
     const parsed = entries.map(entry => {
       try {
@@ -34,7 +42,6 @@ export function readLogFile(logFile) {
         return null;
       }
     }).filter(Boolean);
-    // 去重：同一 timestamp+url 的条目，后出现的（带 response）覆盖先出现的（在途）
     const map = new Map();
     for (const entry of parsed) {
       const key = `${entry.timestamp}|${entry.url}`;
@@ -47,8 +54,6 @@ export function readLogFile(logFile) {
   }
 }
 
-// SSE 单客户端 backpressure 容忍上限：连续未排空 > 此时长则视为 dead 客户端剔除。
-// 与 server.js 同名常量值保持一致（避免循环依赖，此处单独 mirror）。
 const SSE_BACKPRESSURE_TIMEOUT_MS = 5000;
 
 function _removeClient(clients, client) {
@@ -56,14 +61,7 @@ function _removeClient(clients, client) {
   if (idx !== -1) clients.splice(idx, 1);
 }
 
-/**
- * 向单个 SSE client 安全写入 payload。
- * - 写错或 client.destroyed/!writable：立即从 clients 数组移除
- * - write 返回 false（写缓冲满）：标记时间戳，超过 SSE_BACKPRESSURE_TIMEOUT_MS 仍未排空则剔除并 end()
- * - drain 后重置 _sseBackpressureSince=0，下次 backpressure 重新计时
- */
 function _safeSseWrite(clients, client, payload) {
-  // 仅在显式标记 destroyed/writable=false 时剔除；undefined（如老 mock）按"活"处理。
   if (client.destroyed === true || client.writable === false) {
     _removeClient(clients, client);
     return false;
@@ -88,25 +86,13 @@ function _safeSseWrite(clients, client, payload) {
   return true;
 }
 
-/**
- * Send an SSE entry to all connected clients.
- * @param {Array} clients - SSE client array
- * @param {object} entry - parsed log entry
- */
 export function sendToClients(clients, entry) {
   const payload = `data: ${JSON.stringify(entry)}\n\n`;
-  // 倒序遍历允许循环内安全 splice
   for (let i = clients.length - 1; i >= 0; i--) {
     _safeSseWrite(clients, clients[i], payload);
   }
 }
 
-/**
- * Send a named SSE event to all connected clients.
- * @param {Array} clients - SSE client array
- * @param {string} eventName - SSE event name
- * @param {object} data - event payload
- */
 export function sendEventToClients(clients, eventName, data) {
   const payload = `event: ${eventName}\ndata: ${JSON.stringify(data)}\n\n`;
   for (let i = clients.length - 1; i >= 0; i--) {
@@ -114,11 +100,6 @@ export function sendEventToClients(clients, eventName, data) {
   }
 }
 
-/**
- * 旋转处理器专用：发送已序列化的 load_chunk segment 数据。
- * @param {Array} clients - SSE client array
- * @param {string} dataJson - segment 已被调用方 JSON.stringify
- */
 export function sendChunkToClients(clients, dataJson) {
   const payload = `event: load_chunk\ndata: ${dataJson}\n\n`;
   for (let i = clients.length - 1; i >= 0; i--) {
@@ -126,24 +107,180 @@ export function sendChunkToClients(clients, dataJson) {
   }
 }
 
-/**
- * Watch a log file for changes and broadcast new entries.
- * @param {object} opts
- * @param {string} opts.logFile - log file to watch
- * @param {Array} opts.clients - SSE clients array
- * @param {Function} opts.getClaudePid - returns Claude process PID
- * @param {Function} opts.runParallelHook - plugin hook runner
- * @param {Function} opts.notifyStatsWorker - stats worker notifier
- * @param {Function} opts.getLogFile - returns current LOG_FILE value
- */
+// --- 轮转切换（抽取公共逻辑） ---
+
+function _switchToRotatedFile(logFile, currentLogFile, clients, opts) {
+  _unwatchSingleFile(logFile);
+  const total = countLogEntries(currentLogFile);
+  sendEventToClients(clients, 'load_start', { total, incremental: false });
+  streamReconstructedEntries(currentLogFile, (segment) => {
+    sendChunkToClients(clients, JSON.stringify(segment));
+  });
+  sendEventToClients(clients, 'load_end', {});
+  watchLogFile({ ...opts, logFile: currentLogFile });
+}
+
+// --- 增量读 + 解析 + 广播（独立于触发机制） ---
+
+function _readDelta(state) {
+  const { logFile, opts, reconstructor } = state;
+  const { clients, getClaudePid, runParallelHook, notifyStatsWorker, getLogFile } = opts;
+  try {
+    const currentSize = statSync(logFile).size;
+
+    if (currentSize < state.lastByteOffset) {
+      state.lastByteOffset = 0;
+      state.pendingTail = '';
+      reconstructor.reset();
+
+      const currentLogFile = getLogFile();
+      if (currentLogFile !== logFile && !watchedFiles.has(currentLogFile)) {
+        _switchToRotatedFile(logFile, currentLogFile, clients, opts);
+        return;
+      }
+    }
+
+    if (currentSize <= state.lastByteOffset) return;
+
+    const bytesToRead = currentSize - state.lastByteOffset;
+    const buf = Buffer.alloc(bytesToRead);
+    const fd = openSync(logFile, 'r');
+    try {
+      readSync(fd, buf, 0, bytesToRead, state.lastByteOffset);
+    } finally {
+      closeSync(fd);
+    }
+    state.lastByteOffset = currentSize;
+
+    const raw = state.pendingTail + buf.toString('utf-8');
+    const parts = raw.split('\n---\n');
+    state.pendingTail = parts.pop() || '';
+
+    if (parts.length === 0 && state.pendingTail.trim()) {
+      try {
+        JSON.parse(state.pendingTail);
+        parts.push(state.pendingTail);
+        state.pendingTail = '';
+      } catch {}
+    }
+
+    const validParts = parts.filter(p => p.trim());
+    if (validParts.length > 0) {
+      validParts.forEach(entry => {
+        try {
+          const parsed = JSON.parse(entry);
+          if (!parsed.pid) parsed.pid = getClaudePid();
+          reconstructor.reconstruct(parsed);
+          try { enrichEntry(parsed); } catch {}
+          sendToClients(clients, parsed);
+          runParallelHook('onNewEntry', parsed).catch(() => {});
+          if (isMainAgentEntry(parsed) && !parsed.inProgress) {
+            const cached = extractCachedContent(parsed);
+            if (cached) sendEventToClients(clients, 'kv_cache_content', cached);
+            const usage = parsed.response?.body?.usage;
+            if (usage) {
+              const contextSize = getContextSizeForModel(parsed.body?.model);
+              const cwData = buildContextWindowEvent(usage, contextSize);
+              if (cwData) sendEventToClients(clients, 'context_window', cwData);
+            }
+          }
+        } catch {}
+      });
+      notifyStatsWorker(logFile);
+    }
+
+    const currentLogFile = getLogFile();
+    if (currentLogFile !== logFile && !watchedFiles.has(currentLogFile)) {
+      _switchToRotatedFile(logFile, currentLogFile, clients, opts);
+    }
+  } catch {
+    // File not yet created or transient read error
+  }
+}
+
+// --- 目录级 fs.watch 管理 ---
+
+function _getOrCreateDirWatcher(dir) {
+  if (_dirWatchers.has(dir)) return _dirWatchers.get(dir);
+
+  try {
+    const files = new Map();
+    const watcher = watch(dir, (eventType, filename) => {
+      if (!filename) {
+        for (const [, fileState] of files) {
+          _scheduleDebouncedRead(fileState);
+        }
+        return;
+      }
+      const fileState = files.get(filename);
+      if (fileState) _scheduleDebouncedRead(fileState);
+    });
+
+    watcher.on('error', () => {
+      for (const [, fileState] of files) {
+        _fallbackToPolling(fileState);
+      }
+      try { watcher.close(); } catch {}
+      _dirWatchers.delete(dir);
+    });
+
+    const entry = { watcher, files };
+    _dirWatchers.set(dir, entry);
+    return entry;
+  } catch {
+    return null;
+  }
+}
+
+function _scheduleDebouncedRead(fileState) {
+  if (fileState.debounceTimer) return;
+  fileState.debounceTimer = setTimeout(() => {
+    fileState.debounceTimer = null;
+    _readDelta(fileState);
+  }, FSWATCH_DEBOUNCE_MS);
+}
+
+function _fallbackToPolling(fileState) {
+  if (fileState.polling) return;
+  fileState.polling = true;
+  watchFile(fileState.logFile, { interval: 500 }, () => {
+    _readDelta(fileState);
+  });
+}
+
+function _unwatchSingleFile(logFile) {
+  const fileState = watchedFiles.get(logFile);
+  watchedFiles.delete(logFile);
+
+  if (!fileState) return;
+
+  if (fileState.debounceTimer) clearTimeout(fileState.debounceTimer);
+  if (fileState.safetyTimer) clearInterval(fileState.safetyTimer);
+
+  if (fileState.polling) {
+    try { unwatchFile(logFile); } catch {}
+    return;
+  }
+
+  const dir = dirname(logFile);
+  const filename = basename(logFile);
+  const dirEntry = _dirWatchers.get(dir);
+  if (dirEntry) {
+    dirEntry.files.delete(filename);
+    if (dirEntry.files.size === 0) {
+      try { dirEntry.watcher.close(); } catch {}
+      _dirWatchers.delete(dir);
+    }
+  }
+}
+
+// --- 公开 API ---
+
 export function watchLogFile(opts) {
-  const { logFile, clients, getClaudePid, runParallelHook, notifyStatsWorker, getLogFile } = opts;
+  const { logFile } = opts;
   if (watchedFiles.has(logFile)) return;
 
-  // 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)) {
@@ -151,150 +288,60 @@ export function watchLogFile(opts) {
     }
   } catch {}
 
-  watchedFiles.set(logFile, true);
-  watchFile(logFile, { interval: 500 }, () => {
-    try {
-      const currentSize = statSync(logFile).size;
-
-      // File truncated (rotation or clear) — reset offset and check rotation immediately
-      if (currentSize < lastByteOffset) {
-        lastByteOffset = 0;
-        pendingTail = '';
-        _reconstructor.reset();
-
-        // 文件被清空可能是轮转信号，立即检查是否已切换到新文件
-        const currentLogFile = getLogFile();
-        if (currentLogFile !== logFile && !watchedFiles.has(currentLogFile)) {
-          unwatchFile(logFile);
-          watchedFiles.delete(logFile);
-
-          // 流式分段广播，避免全量加载 OOM；走 _safeSseWrite 包装做 backpressure / dead-client 清理
-          const rotTotal = countLogEntries(currentLogFile);
-          sendEventToClients(clients, 'load_start', { total: rotTotal, incremental: false });
-          streamReconstructedEntries(currentLogFile, (segment) => {
-            sendChunkToClients(clients, JSON.stringify(segment));
-          });
-          sendEventToClients(clients, 'load_end', {});
-          watchLogFile({ ...opts, logFile: currentLogFile });
-          return;
-        }
-      }
+  const fileState = {
+    logFile,
+    opts,
+    reconstructor: _reconstructor,
+    lastByteOffset,
+    pendingTail: '',
+    debounceTimer: null,
+    safetyTimer: null,
+    polling: false,
+  };
 
-      if (currentSize <= lastByteOffset) return;
+  watchedFiles.set(logFile, fileState);
 
-      // Read only the new bytes
-      const bytesToRead = currentSize - lastByteOffset;
-      const buf = Buffer.alloc(bytesToRead);
-      const fd = openSync(logFile, 'r');
-      try {
-        readSync(fd, buf, 0, bytesToRead, lastByteOffset);
-      } finally {
-        closeSync(fd);
-      }
-      lastByteOffset = currentSize;
+  if (FORCE_POLL) {
+    _fallbackToPolling(fileState);
+    return;
+  }
 
-      const raw = pendingTail + buf.toString('utf-8');
-      const parts = raw.split('\n---\n');
+  const dir = dirname(logFile);
+  const filename = basename(logFile);
+  const dirEntry = _getOrCreateDirWatcher(dir);
 
-      // Last part may be incomplete — keep it for next poll
-      pendingTail = parts.pop() || '';
+  if (!dirEntry) {
+    _fallbackToPolling(fileState);
+    return;
+  }
 
-      // If there's only the tail and no complete entries, check if tail is a complete entry
-      // (happens when the file ends without a trailing \n---\n)
-      if (parts.length === 0 && pendingTail.trim()) {
-        try {
-          JSON.parse(pendingTail);
-          // Valid JSON — treat as complete entry
-          parts.push(pendingTail);
-          pendingTail = '';
-        } catch {
-          // Incomplete — keep in pendingTail for next poll
-        }
-      }
+  dirEntry.files.set(filename, fileState);
 
-      const validParts = parts.filter(p => p.trim());
-      if (validParts.length > 0) {
-        validParts.forEach(entry => {
-          try {
-            const parsed = JSON.parse(entry);
-            if (!parsed.pid) {
-              parsed.pid = getClaudePid();
-            }
-            // Delta storage: reconstruct before push — 确保前端收到完整 messages
-            _reconstructor.reconstruct(parsed);
-            // ExitPlanMode V2 input 服务端补全（详见 enrich-plan-input.js#enrichEntry JSDoc）。
-            // 同步实现：候选扫描天然廉价（无 ExitPlanMode 块直接 0ms 返回）；命中
-            // 路径由 transcript 64MB 上限 + miss 30s TTL + path mtime 校验三层兜
-            // 住，最坏 ~150ms。如未来 hit 比例显著上升再考虑 setImmediate 拆分。
-            try { enrichEntry(parsed); } catch { /* 静默回退 */ }
-            sendToClients(clients, parsed);
-            runParallelHook('onNewEntry', parsed).catch(() => {});
-            if (isMainAgentEntry(parsed) && !parsed.inProgress) {
-              const cached = extractCachedContent(parsed);
-              if (cached) {
-                sendEventToClients(clients, 'kv_cache_content', cached);
-              }
-              const usage = parsed.response?.body?.usage;
-              if (usage) {
-                const contextSize = getContextSizeForModel(parsed.body?.model);
-                const cwData = buildContextWindowEvent(usage, contextSize);
-                if (cwData) {
-                  sendEventToClients(clients, 'context_window', cwData);
-                }
-              }
-            }
-          } catch (err) {
-            // Skip invalid entries
-          }
-        });
-        notifyStatsWorker(logFile);
-      }
+  fileState.safetyTimer = setInterval(() => {
+    _readDelta(fileState);
+  }, SAFETY_POLL_MS);
+}
 
-      // 检测日志文件是否已轮转到新文件
-      const currentLogFile = getLogFile();
-      if (currentLogFile !== logFile && !watchedFiles.has(currentLogFile)) {
-        // Unwatch old file to prevent watcher leak on rotation
-        unwatchFile(logFile);
-        watchedFiles.delete(logFile);
-
-        // 流式分段广播，避免全量加载 OOM
-        const endRotTotal = countLogEntries(currentLogFile);
-        clients.forEach(client => {
-          try { client.write(`event: load_start\ndata: ${JSON.stringify({ total: endRotTotal, incremental: false })}\n\n`); } catch { }
-        });
-        streamReconstructedEntries(currentLogFile, (segment) => {
-          const data = JSON.stringify(segment);
-          clients.forEach(client => {
-            try { client.write(`event: load_chunk\ndata: ${data}\n\n`); } catch { }
-          });
-        });
-        clients.forEach(client => {
-          try { client.write(`event: load_end\ndata: {}\n\n`); } catch { }
-        });
-        watchLogFile({ ...opts, logFile: currentLogFile });
-      }
-    } catch (err) {
-      // File not yet created, will retry on next poll
-    }
-  });
+export function unwatchLogFile(logFile) {
+  _unwatchSingleFile(logFile);
+}
+
+export function unwatchAll() {
+  for (const logFile of watchedFiles.keys()) {
+    _unwatchSingleFile(logFile);
+  }
+  for (const [, entry] of _dirWatchers) {
+    try { entry.watcher.close(); } catch {}
+  }
+  _dirWatchers.clear();
+  watchedFiles.clear();
 }
 
-/**
- * Start watching the current log file + install statusLine + context window.
- * @param {object} opts
- * @param {string} opts.logFile - current LOG_FILE
- * @param {Array} opts.clients - SSE clients array
- * @param {Function} opts.getClaudePid
- * @param {Function} opts.runParallelHook
- * @param {Function} opts.notifyStatsWorker
- * @param {Function} opts.getLogFile
- */
 export function startWatching(opts) {
   const { clients, ...watchOpts } = opts;
   watchLogFile({ ...watchOpts, clients });
 }
 
-/** Get the watchedFiles Map (for cleanup in stopViewer). */
 export function getWatchedFiles() {
   return watchedFiles;
 }

package/server/lib/plugin-manager.js

@@ -75,7 +75,7 @@ export async function installPluginFromUrl(pluginsDir, fileUrl, extractNameScrip
   writeFileSync(tmpFile, content, 'utf-8');
   try {
     const result = await new Promise((resolve, reject) => {
-      execFile('node', [extractNameScript, tmpFile], { timeout: 5000 }, (err, stdout) => {
+      execFile('node', [extractNameScript, tmpFile], { timeout: 5000, windowsHide: true }, (err, stdout) => {
         if (err) return reject(err);
         resolve(stdout);
       });

package/server/lib/updater.js

@@ -107,7 +107,7 @@ export function isAnyCcvBusy({ currentPid, busy, portRange, lsofImpl } = {}) {
 
   const [start, end] = Array.isArray(portRange) && portRange.length === 2 ? portRange : [7008, 7099];
   const pid = typeof currentPid === 'number' ? currentPid : process.pid;
-  const runLsof = lsofImpl || ((cmd) => execSync(cmd, { timeout: 2000, encoding: 'utf-8' }));
+  const runLsof = lsofImpl || ((cmd) => execSync(cmd, { timeout: 2000, encoding: 'utf-8', windowsHide: true }));
 
   try {
     const out = String(runLsof(`lsof -iTCP:${start}-${end} -sTCP:LISTEN -P -n -Fp`));
@@ -216,7 +216,9 @@ export async function checkAndUpdate(options = {}) {
         const child = spawnImpl(
           'npm',
           ['install', '-g', `cc-viewer@${remoteVersion}`, '--no-audit', '--no-fund'],
-          { detached: true, stdio: 'ignore', shell: process.platform === 'win32' }
+          // windowsHide：Windows 下 shell 模式经 cmd.exe 跑 npm.cmd（console-subsystem），
+          // 不隐藏会在后台更新期间常驻一个可见控制台窗口；POSIX 上为 no-op。
+          { detached: true, stdio: 'ignore', shell: process.platform === 'win32', windowsHide: true }
         );
         if (child && typeof child.unref === 'function') child.unref();
       } catch (err) {

package/server/pty-manager.js

@@ -178,7 +178,7 @@ export async function spawnClaude(proxyPort, cwd, extraArgs = [], claudePath = n
   if (process.versions.electron) {
     const { execSync } = await import('node:child_process');
     try {
-      nodePath = execSync(process.platform === 'win32' ? 'where node' : 'which node', { encoding: 'utf-8' }).trim();
+      nodePath = execSync(process.platform === 'win32' ? 'where node' : 'which node', { encoding: 'utf-8', windowsHide: true }).trim();
       if (process.platform === 'win32') nodePath = nodePath.split('\n')[0].trim();
     } catch {
       nodePath = process.platform === 'win32' ? 'node' : '/usr/local/bin/node';

package/server/routes/ask-perm.js

@@ -223,7 +223,7 @@ function askHook(req, res, parsedUrl, isLocal, deps) {
 // Phase 3: short-poll handoff endpoint. ask-bridge GET /api/ask-hook/:id/result?wait=30000
 // 在 wait ms 内若答案/cancel 到达 → 立即返；否则返 204 让 client 重发。
 // 内存有 entry → 注册 listener；内存无 → 查 disk consume（server 重启场景）。
-function askHookResult(req, res, parsedUrl, isLocal, deps) {
+async function askHookResult(req, res, parsedUrl, isLocal, deps) {
   const url = parsedUrl.pathname;
   try {
     // URL 形如 /api/ask-hook/<id>/result?wait=30000；id 受白名单约束（与 POST 同源）
@@ -242,7 +242,7 @@ function askHookResult(req, res, parsedUrl, isLocal, deps) {
     // 用 consumeIfFinal 单次 withLock 内判 status 决定是否 delete —— 旧设计的
     // "consume + 若 pending 再 setEntry 写回" 两段是 race window：中间被 markAnswered 命中后，
     // setEntry 走 status guard 已经不会覆盖；但不删的 pending 也无须重写一遍。
-    const diskEntry = askStoreConsumeIfFinal(id);
+    const diskEntry = await askStoreConsumeIfFinal(id);
     if (diskEntry && diskEntry.status === 'answered') {
       res.writeHead(200, { 'Content-Type': 'application/json' });
       res.end(JSON.stringify({ answers: diskEntry.answers || {} }));

package/server/routes/dingtalk.js

@@ -80,6 +80,8 @@ function dingtalkConfigPost(req, res, parsedUrl, isLocal, deps) {
       allowStaffIds: incoming.allowStaffIds,
       maxChunkChars: incoming.maxChunkChars,
       blockOnSkipPermissions: incoming.blockOnSkipPermissions,
+      ackCard: incoming.ackCard,
+      cardTemplateId: incoming.cardTemplateId,
     });
     // 驱动进程管理器（替代旧的在进程 reloadBridge）：启用→重启 worker，停用→停 worker。
     try {

package/server/routes/files-fs.js

@@ -614,7 +614,7 @@ function openFile(req, res, parsedUrl, isLocal, deps) {
       if (plat === 'darwin') {
         execFile('open', [fullPath], () => {});
       } else if (plat === 'win32') {
-        execFile('cmd.exe', ['/c', 'start', '', fullPath], () => {});
+        execFile('cmd.exe', ['/c', 'start', '', fullPath], { windowsHide: true }, () => {});
       } else {
         execFile('xdg-open', [fullPath], () => {});
       }
@@ -842,7 +842,7 @@ function createDir(req, res, parsedUrl, isLocal, deps) {
 function openLogDir(req, res) {
   const dir = LOG_FILE ? dirname(LOG_FILE) : LOG_DIR;
   const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'explorer' : 'xdg-open';
-  execFile(cmd, [dir], () => {});
+  execFile(cmd, [dir], { windowsHide: true }, () => {});
   res.writeHead(200, { 'Content-Type': 'application/json' });
   res.end(JSON.stringify({ ok: true, dir }));
 }
@@ -851,7 +851,7 @@ function openProfileDir(req, res) {
   const dir = dirname(PROFILE_PATH);
   if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
   const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'explorer' : 'xdg-open';
-  execFile(cmd, [dir], () => {});
+  execFile(cmd, [dir], { windowsHide: true }, () => {});
   res.writeHead(200, { 'Content-Type': 'application/json' });
   res.end(JSON.stringify({ ok: true, dir }));
 }
@@ -859,7 +859,7 @@ function openProfileDir(req, res) {
 function openProjectDir(req, res) {
   const dir = process.env.CCV_PROJECT_DIR || process.cwd();
   const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'explorer' : 'xdg-open';
-  execFile(cmd, [dir], () => {});
+  execFile(cmd, [dir], { windowsHide: true }, () => {});
   res.writeHead(200, { 'Content-Type': 'application/json' });
   res.end(JSON.stringify({ ok: true, dir }));
 }

package/server/routes/project-meta.js

@@ -4,6 +4,23 @@ import { join } from 'node:path';
 import { PACKAGE_JSON } from '../_paths.js';
 import { LOG_DIR } from '../../findcc.js';
 import { _projectName } from '../interceptor.js';
+import { detectHomebrewInstall } from '../lib/updater.js';
+
+// 判定当前 cc-viewer 的安装渠道，供前端精准匹配升级命令。
+//   - electron：桌面版（in-process server），走 GitHub Releases 重新下载安装包。
+//   - brew：Homebrew Cellar 布局命中 → `brew upgrade cc-viewer`（npm install -g 会跟 Cellar 打架）。
+//   - npm：默认兜底 → `npm install -g cc-viewer --registry=...`（指定官方源避免镜像滞后拿到旧版本）。
+// deps 仅供单测注入；失败安全：detect 抛异常时回落到 npm（不会误导 brew 用户走 npm）。
+export function getInstallMethod({
+  electron = process.versions && process.versions.electron,
+  detect = detectHomebrewInstall,
+} = {}) {
+  if (electron) return 'electron';
+  try {
+    if (detect()) return 'brew';
+  } catch { /* 探测失败 → 回落 npm */ }
+  return 'npm';
+}
 
 function projectName(req, res) {
   res.writeHead(200, { 'Content-Type': 'application/json' });
@@ -20,7 +37,7 @@ function versionInfo(req, res) {
   try {
     const pkg = JSON.parse(readFileSync(PACKAGE_JSON, 'utf-8'));
     res.writeHead(200, { 'Content-Type': 'application/json' });
-    res.end(JSON.stringify({ version: pkg.version }));
+    res.end(JSON.stringify({ version: pkg.version, installMethod: getInstallMethod() }));
   } catch {
     res.writeHead(500, { 'Content-Type': 'application/json' });
     res.end(JSON.stringify({ error: 'Failed to read version' }));