cc-team-viewer 1.5.4 → 1.5.5

package/cli/cli.js

@@ -247,6 +247,18 @@ async function runProxyCommand(args) {
     cmdArgs.unshift(settingsJson);
     cmdArgs.unshift('--settings');
 
+    // 打印 viewer 访问地址（服务器由 interceptor 自动启动）
+    // 等待 viewer 服务器就绪后打印
+    const { getPort } = await import('../server/server.js');
+    await new Promise(resolve => {
+      const check = () => { getPort() ? resolve() : setTimeout(check, 200); };
+      setTimeout(check, 300);
+    });
+    const viewerPort = getPort();
+    if (viewerPort) {
+      console.error(`\n[cctv] 监控面板: http://127.0.0.1:${viewerPort}\n`);
+    }
+
     const child = spawn(cmd, cmdArgs, { stdio: 'inherit', env });
 
     child.on('exit', (code) => {

package/package.json

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

package/proxy/interceptor.js

@@ -10,6 +10,8 @@ import { dirname, join, basename } from 'node:path';
 import { LOG_DIR } from '../cli/findcc.js';
 import { initLogger, logInfo, logWarn, logError, logDebug } from '../lib/logger.js';
 
+const MOBILE_DEBUG = process.env.CCV_MOBILE_DEBUG === '1';
+const mobileLog = MOBILE_DEBUG ? (...args) => logDebug('[MOBILE-DEBUG]', ...args) : () => {};
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -605,15 +607,15 @@ export function setOnLogWrittenCallback(callback) {
  * @param {Object|Array} newEntries - 新增的日志条目（单个对象或数组）
  */
 function triggerLogWrittenCallback(newEntries) {
-  console.log('[MOBILE-DEBUG] triggerLogWrittenCallback called, hasCallback:', !!_onLogWrittenCallback);
+  mobileLog('triggerLogWrittenCallback called, hasCallback:', !!_onLogWrittenCallback);
   if (_onLogWrittenCallback) {
     try {
       // 统一转为数组格式
       const entries = Array.isArray(newEntries) ? newEntries : (newEntries ? [newEntries] : []);
-      console.log('[MOBILE-DEBUG] calling callback with', entries.length, 'entries');
+      mobileLog('calling callback with', entries.length, 'entries');
       _onLogWrittenCallback(entries);
     } catch (err) {
-      console.error('[MOBILE-DEBUG] callback error:', err.message);
+      mobileLog('callback error:', err.message);
     }
   }
 }
@@ -668,6 +670,24 @@ export function setupInterceptor() {
         stdio: 'ignore',
         env: { ...process.env, CCV_DETACHED: '1' }
       }).unref();
+
+      // 等待 viewer 服务器就绪后打印访问地址
+      const waitAndPrint = async () => {
+        for (let i = 0; i < 30; i++) {
+          await new Promise(r => setTimeout(r, 500));
+          for (let p = 7008; p <= 7020; p++) {
+            const ok = await new Promise(res => {
+              const c = connect(p, '127.0.0.1', () => { c.end(); res(true); });
+              c.on('error', () => res(false));
+            });
+            if (ok) {
+              process.stderr.write(`\n[cctv] 监控面板: http://127.0.0.1:${p}\n`);
+              return;
+            }
+          }
+        }
+      };
+      waitAndPrint().catch(() => {});
     };
 
     tryStartProxy().catch(() => {});

package/server/mobile-bridge.js

@@ -18,6 +18,9 @@ import { readLogFile } from './sse.js';
 import { buildSessionsFromEntries, assignMessageTimestamps } from '../src/utils/sessionBuilder.js';
 import { classifyUserContent } from '../src/utils/contentFilter.js';
 
+const MOBILE_DEBUG = process.env.CCV_MOBILE_DEBUG === '1';
+const mobileLog = MOBILE_DEBUG ? (...args) => console.log('[MOBILE-DEBUG]', ...args) : () => {};
+
 let actualPort = 0;
 let accessToken = '';
 let mobileWss = null;
@@ -173,10 +176,10 @@ function simplifyMessage(message, index) {
 
 function buildLatestChatSnapshot() {
   const entries = readLogFile();
-  console.log('[MOBILE-DEBUG] buildLatestChatSnapshot: entries count:', entries?.length || 0);
+  mobileLog('buildLatestChatSnapshot: entries count:', entries?.length || 0);
 
   if (!Array.isArray(entries) || entries.length === 0) {
-    console.log('[MOBILE-DEBUG] buildLatestChatSnapshot: no entries, returning empty snapshot');
+    mobileLog('buildLatestChatSnapshot: no entries, returning empty snapshot');
     return {
       type: 'chat_snapshot',
       connectionSessionId: connectionState.connectionSessionId || '',
@@ -190,26 +193,26 @@ function buildLatestChatSnapshot() {
 
   assignMessageTimestamps(entries);
   const sessions = buildSessionsFromEntries(entries);
-  console.log('[MOBILE-DEBUG] buildLatestChatSnapshot: sessions count:', sessions?.length || 0);
+  mobileLog('buildLatestChatSnapshot: sessions count:', sessions?.length || 0);
 
   // DEBUG: 检查第一条 entry 的 mainAgent 标记
   if (entries.length > 0 && sessions.length === 0) {
     const first = entries[0];
-    console.log('[MOBILE-DEBUG] DEBUG: first entry has mainAgent:', first?.mainAgent, 'url:', first?.url, 'timestamp:', first?.timestamp);
+    mobileLog('DEBUG: first entry has mainAgent:', first?.mainAgent, 'url:', first?.url, 'timestamp:', first?.timestamp);
     // 检查 body.messages
     const hasMessages = Array.isArray(first?.body?.messages);
-    console.log('[MOBILE-DEBUG] DEBUG: first entry has body.messages:', hasMessages, 'count:', first?.body?.messages?.length);
+    mobileLog('DEBUG: first entry has body.messages:', hasMessages, 'count:', first?.body?.messages?.length);
     // 检查 system
     const hasSystem = !!first?.body?.system;
-    console.log('[MOBILE-DEBUG] DEBUG: first entry has body.system:', hasSystem);
+    mobileLog('DEBUG: first entry has body.system:', hasSystem);
     const sysText = Array.isArray(first?.body?.system)
       ? first.body.system.map(s => s?.text || '').join('')
       : (first?.body?.system || '');
-    console.log('[MOBILE-DEBUG] DEBUG: system contains "Claude Code":', sysText.includes('Claude Code'));
+    mobileLog('DEBUG: system contains "Claude Code":', sysText.includes('Claude Code'));
   }
 
   const latestSession = sessions[sessions.length - 1];
-  console.log('[MOBILE-DEBUG] buildLatestChatSnapshot: latestSession messages:', latestSession?.messages?.length || 0);
+  mobileLog('buildLatestChatSnapshot: latestSession messages:', latestSession?.messages?.length || 0);
 
   const messages = Array.isArray(latestSession?.messages)
     ? latestSession.messages
@@ -217,7 +220,7 @@ function buildLatestChatSnapshot() {
       .filter(msg => msg.text || msg.role !== 'user')
     : [];
 
-  console.log('[MOBILE-DEBUG] buildLatestChatSnapshot: final messages after filter:', messages.length);
+  mobileLog('buildLatestChatSnapshot: final messages after filter:', messages.length);
 
   const latestReply = normalizeTextContent(latestSession?.response?.body?.content);
 
@@ -281,7 +284,7 @@ function sendHubMessage(message) {
 }
 
 function broadcastLocal(message) {
-  console.log('[MOBILE-DEBUG] broadcastLocal: clients count:', mobileClients.size);
+  mobileLog('broadcastLocal: clients count:', mobileClients.size);
   const payload = typeof message === 'string' ? message : JSON.stringify(message);
   for (const client of mobileClients) {
     if (client.readyState === WebSocket.OPEN) {
@@ -293,7 +296,7 @@ function broadcastLocal(message) {
 }
 
 function broadcast(message, { includeHub = true } = {}) {
-  console.log('[MOBILE-DEBUG] broadcast called');
+  mobileLog('broadcast called');
   broadcastLocal(message);
   if (includeHub) {
     sendHubMessage(message);
@@ -319,26 +322,26 @@ function broadcastState({ includeHub = true } = {}) {
 }
 
 function maybeBroadcastChatSnapshot({ includeHub = true } = {}) {
-  console.log('[MOBILE-DEBUG] maybeBroadcastChatSnapshot called, active:', connectionState.active);
+  mobileLog('maybeBroadcastChatSnapshot called, active:', connectionState.active);
   if (!connectionState.active) {
-    console.log('[MOBILE-DEBUG] skipped: connection not active');
+    mobileLog('skipped: connection not active');
     return;
   }
   const snapshot = buildLatestChatSnapshot();
-  console.log('[MOBILE-DEBUG] snapshot built, messages:', snapshot?.messages?.length, 'cached:', cachedMessages.length);
+  mobileLog('snapshot built, messages:', snapshot?.messages?.length, 'cached:', cachedMessages.length);
   // 去重时排除时间戳字段，只比较消息内容
   const { updatedAt, ...contentOnly } = snapshot;
   const nextJson = JSON.stringify(contentOnly);
 
   // DEBUG: 输出 JSON 长度变化，帮助诊断问题
-  console.log('[MOBILE-DEBUG] json len:', nextJson.length, 'vs last:', lastChatSnapshotJson.length, 'equal:', nextJson === lastChatSnapshotJson);
+  mobileLog('json len:', nextJson.length, 'vs last:', lastChatSnapshotJson.length, 'equal:', nextJson === lastChatSnapshotJson);
 
   if (nextJson === lastChatSnapshotJson) {
-    console.log('[MOBILE-DEBUG] skipped: snapshot unchanged (dedup)');
+    mobileLog('skipped: snapshot unchanged (dedup)');
     return;
   }
   lastChatSnapshotJson = nextJson;
-  console.log('[MOBILE-DEBUG] broadcasting snapshot to', mobileClients.size, 'clients');
+  mobileLog('broadcasting snapshot to', mobileClients.size, 'clients');
   // 更新缓存
   cachedMessages = snapshot.messages;
   cachedLatestReply = snapshot.latestReply;
@@ -501,7 +504,7 @@ async function handlePromptAnswer(answer, sessionId) {
 }
 
 function handlePtyData(data) {
-  console.log('[MOBILE-DEBUG] handlePtyData called, data length:', data?.length, 'active:', connectionState.active, 'mode:', connectionState.mode);
+  mobileLog('handlePtyData called, data length:', data?.length, 'active:', connectionState.active, 'mode:', connectionState.mode);
   const clean = stripAnsi(data);
   if (!clean) return;
   ptyBuffer += clean;
@@ -520,7 +523,7 @@ function handlePtyData(data) {
         timestamp: new Date().toISOString(),
       });
     } else {
-      console.log('[MOBILE-DEBUG] terminal_output NOT sent: hubSocket=', hubSocket ? hubSocket.readyState : 'null', 'hubConnected=', connectionState.hubConnected);
+      mobileLog('terminal_output NOT sent: hubSocket=', hubSocket ? hubSocket.readyState : 'null', 'hubConnected=', connectionState.hubConnected);
     }
   }
 }
@@ -743,7 +746,7 @@ export function initMobileBridge({ server, port, token, projectName }) {
   ptyExitUnsubscribe = onPtyExit(handlePtyExit);
 
   mobileWss.on('connection', (ws) => {
-    console.log('[MOBILE-DEBUG] mobile client connected');
+    mobileLog('mobile client connected');
     mobileClients.add(ws);
     refreshConnectedClients();
     sendJson(ws, buildConnectionStateMessage());
@@ -978,7 +981,7 @@ export function stopMobileConnection() {
 }
 
 export function notifyMobileLogEntries(newEntries) {
-  console.log('[MOBILE-DEBUG] notifyMobileLogEntries called, entries:', newEntries?.length, 'active:', connectionState.active);
+  mobileLog('notifyMobileLogEntries called, entries:', newEntries?.length, 'active:', connectionState.active);
   // 直接走完整日志重建路径
   // 实时性来自 interceptor 的直接回调（跳过 fs.watchFile 轮询延迟）
   // 可靠性来自完整日志重建（避免增量逻辑的各种边界问题）

package/server/sse.js

@@ -446,7 +446,7 @@ export function watchLogDirectory() {
 
         if (entries.length > 0) {
           // 通知移动端，传递新增条目以支持增量构建
-          console.log('[MOBILE-DEBUG] sse.js handleFileChange triggered, calling notifyMobileLogEntries');
+          debugLog('sse.js handleFileChange triggered, calling notifyMobileLogEntries');
           notifyMobileLogEntries(entries);
           // 根据日志文件路径查找对应的 team
           let team = getTeamByLogFile(filePath);