@bangdao-ai/acw-tools 1.3.6-beta.2 → 1.3.7

package/cursorConversationParser.js

@@ -8,6 +8,41 @@ import path from 'path';
 import os from 'os';
 import zlib from 'zlib';
 
+// ==================== DEBUG 模式配置 ====================
+// 通过环境变量 ACW_DEBUG=true 启用详细日志
+const DEBUG_MODE = process.env.ACW_DEBUG === 'true';
+
+// DEBUG 日志目录（与主日志目录相同）
+const DEBUG_LOG_DIR = path.join(os.homedir(), '.cursor', '.chat_grab', 'logs');
+
+// 确保日志目录存在
+if (DEBUG_MODE && !fs.existsSync(DEBUG_LOG_DIR)) {
+  fs.mkdirSync(DEBUG_LOG_DIR, { recursive: true });
+}
+
+/**
+ * DEBUG 日志函数
+ * 仅在 DEBUG_MODE 启用时输出详细日志到文件
+ */
+function debugLog(message, data = null) {
+  if (!DEBUG_MODE) return;
+  
+  const now = new Date();
+  const timestamp = now.toISOString().replace('T', ' ').replace('Z', '');
+  const logFile = path.join(DEBUG_LOG_DIR, `acw-mcp-debug-${now.toISOString().split('T')[0]}.log`);
+  
+  let logLine = `${timestamp} [DEBUG] ${message}`;
+  if (data !== null) {
+    if (typeof data === 'object') {
+      logLine += '\n' + JSON.stringify(data, null, 2);
+    } else {
+      logLine += ` ${data}`;
+    }
+  }
+  
+  fs.appendFileSync(logFile, logLine + '\n', 'utf8');
+}
+
 /**
  * 获取Cursor全局数据库路径
  */
@@ -187,10 +222,9 @@ function parseCodeChanges(bubble) {
  * @param {Object} composerData - Composer数据
  * @param {Array} bubbles - 会话气泡数组
  * @param {string} markdownContent - Markdown内容（用于计算大小）
- * @param {Function} debugLogger - 可选的debug日志函数，用于输出详细的bubble数据
  * @returns {Object} 返回 { additionalInfo, executionsList }
  */
-function extractAdditionalInfo(composerData, bubbles, markdownContent = '', debugLogger = null) {
+function extractAdditionalInfo(composerData, bubbles, markdownContent = '') {
   // 计算内容大小（KB）
   const contentSizeBytes = Buffer.byteLength(markdownContent, 'utf8');
   const contentSizeKb = parseFloat((contentSizeBytes / 1024).toFixed(2));
@@ -308,28 +342,39 @@ function extractAdditionalInfo(composerData, bubbles, markdownContent = '', debu
       const tokenCount = bubble.tokenCount || {};
       const modelInfo = bubble.modelInfo || {};
       
-      // DEBUG模式：输出完整的bubble数据用于排查timingInfo问题
+      // DEBUG: 输出原始 bubble.timingInfo 情况
       const hasRawTimingInfo = !!bubble.timingInfo;
       const hasClientRpcSendTime = !!(bubble.timingInfo && bubble.timingInfo.clientRpcSendTime);
       const hasClientSettleTime = !!(bubble.timingInfo && bubble.timingInfo.clientSettleTime);
       
-      // 如果没有timingInfo或缺少关键字段，输出详细日志
-      if (debugLogger && (!hasRawTimingInfo || !hasClientRpcSendTime || !hasClientSettleTime)) {
-        debugLogger('🔍 [DEBUG] AI bubble缺少timingInfo关键字段', {
-          bubbleId: bubble.bubbleId,
+      // DEBUG 模式：记录每个 AI bubble 的 timingInfo 详情
+      if (DEBUG_MODE) {
+        debugLog(`[AI Bubble] bubbleId=${bubble.bubbleId}`, {
           hasTimingInfo: hasRawTimingInfo,
           hasClientRpcSendTime,
           hasClientSettleTime,
-          timingInfoKeys: bubble.timingInfo ? Object.keys(bubble.timingInfo) : [],
-          timingInfoValues: bubble.timingInfo || null,
-          // 输出bubble的其他关键字段帮助排查
-          bubbleKeys: Object.keys(bubble),
-          modelName: modelInfo.modelName || null,
-          tokenCount: tokenCount,
-          createdAt: bubble.createdAt,
-          // 完整bubble数据（JSON字符串，便于分析）
-          fullBubbleJson: JSON.stringify(bubble, null, 2)
+          rawTimingInfo: bubble.timingInfo,
+          modelName: modelInfo.modelName,
+          tokenCount: tokenCount
         });
+        
+        // 如果缺少 timingInfo，输出完整的 bubble 数据用于排查
+        if (!hasRawTimingInfo || !hasClientRpcSendTime || !hasClientSettleTime) {
+          debugLog(`[AI Bubble 缺少 timingInfo] 完整 bubble 数据:`, {
+            bubbleId: bubble.bubbleId,
+            type: bubble.type,
+            createdAt: bubble.createdAt,
+            // 输出 bubble 的所有顶级字段（排除可能很大的 text/richText）
+            bubbleKeys: Object.keys(bubble),
+            // 完整的 bubble 数据（用于深度排查）
+            fullBubble: {
+              ...bubble,
+              // 截断可能很长的文本字段
+              text: bubble.text ? `[长度: ${bubble.text.length}] ${bubble.text.substring(0, 200)}...` : null,
+              richText: bubble.richText ? `[长度: ${bubble.richText.length}]` : null
+            }
+          });
+        }
       }
       
       let executionTime = 0;
@@ -424,6 +469,22 @@ function extractAdditionalInfo(composerData, bubbles, markdownContent = '', debu
     additionalInfo.performance.minExecutionTime = 0;
   }
   
+  // DEBUG 模式：输出 timingInfo 统计汇总
+  if (DEBUG_MODE) {
+    debugLog(`[timingInfo 统计汇总] composerId=${composerData?.composerId}`, {
+      totalAiExecutions: additionalInfo.performance.aiExecutionCount,
+      withTimingInfo: aiExecutionsWithTimingInfo,
+      withoutTimingInfo: aiExecutionsWithoutTimingInfo,
+      validExecutionCount: validAiExecutionCount,
+      totalExecutionTime: additionalInfo.performance.totalExecutionTime,
+      averageExecutionTime: additionalInfo.performance.averageExecutionTime,
+      // 列出所有缺少 timingInfo 的 AI execution
+      missingTimingInfoBubbles: additionalInfo.performance.executions
+        .filter(e => e.type === 'ai' && !e.timingInfo)
+        .map(e => ({ bubbleId: e.bubbleId, modelName: e.modelName, timestamp: e.timestamp }))
+    });
+  }
+  
   // 分离executions数组
   const executionsList = additionalInfo.performance.executions;
   
@@ -598,9 +659,8 @@ function formatListDirResult(directoryTree) {
  * @param {string} composerId - Composer ID
  * @param {string} outputPath - 输出文件路径
  * @param {Object} db - 已打开的数据库连接
- * @param {Function} debugLogger - 可选的debug日志函数
  */
-function extractConversationCore(composerId, outputPath, db, debugLogger = null) {
+function extractConversationCore(composerId, outputPath, db) {
   try {
     // 1. 获取composer元数据
     const composerDataRow = db.prepare(
@@ -1434,7 +1494,7 @@ function extractConversationCore(composerId, outputPath, db, debugLogger = null)
     fs.writeFileSync(outputPath, markdown, 'utf-8');
     
     // 提取附加信息和执行明细列表
-    const { additionalInfo, executionsList } = extractAdditionalInfo(composerData, bubbles, markdown, debugLogger);
+    const { additionalInfo, executionsList } = extractAdditionalInfo(composerData, bubbles, markdown);
     
     return {
       success: true,
@@ -1459,9 +1519,8 @@ function extractConversationCore(composerId, outputPath, db, debugLogger = null)
  * @param {string} composerId - Composer ID
  * @param {string} outputPath - 输出文件路径
  * @param {string} [customDbPath] - 自定义数据库路径（可选，默认使用系统全局数据库）
- * @param {Function} [debugLogger] - 可选的debug日志函数，用于输出详细的bubble数据
  */
-export async function extractConversationFromGlobalDb(composerId, outputPath, customDbPath = null, debugLogger = null) {
+export async function extractConversationFromGlobalDb(composerId, outputPath, customDbPath = null) {
   const globalDbPath = customDbPath || getGlobalDbPath();
   
   if (!fs.existsSync(globalDbPath)) {
@@ -1473,7 +1532,7 @@ export async function extractConversationFromGlobalDb(composerId, outputPath, cu
   const db = new Database(globalDbPath, { readonly: true });
   
   try {
-    return extractConversationCore(composerId, outputPath, db, debugLogger);
+    return extractConversationCore(composerId, outputPath, db);
   } finally {
     db.close();
   }
@@ -1484,10 +1543,9 @@ export async function extractConversationFromGlobalDb(composerId, outputPath, cu
  * @param {string} composerId - Composer ID
  * @param {string} outputPath - 输出文件路径
  * @param {Object} db - 已打开的数据库连接
- * @param {Function} [debugLogger] - 可选的debug日志函数，用于输出详细的bubble数据
  */
-export function extractConversationFromGlobalDbWithConnection(composerId, outputPath, db, debugLogger = null) {
-  return extractConversationCore(composerId, outputPath, db, debugLogger);
+export function extractConversationFromGlobalDbWithConnection(composerId, outputPath, db) {
+  return extractConversationCore(composerId, outputPath, db);
 }
 
 /**

package/index.js

@@ -25,7 +25,6 @@ const RETRY_BASE_DELAY = 2000; // 重试基础延迟（2秒）
 // ==================== 压缩配置 ====================
 const COMPRESSION_ENABLED = process.env.MCP_COMPRESSION_ENABLED !== 'false'; // 默认启用
 const COMPRESSION_THRESHOLD = parseInt(process.env.MCP_COMPRESSION_THRESHOLD || '1048576', 10); // 默认1MB阈值
-const DEBUG_MODE = process.env.ACW_DEBUG === 'true'; // Debug模式：输出详细的bubble日志用于排查问题
 
 // ==================== 数据库引擎加载（使用 better-sqlite3）====================
 let dbEngine = null;
@@ -242,11 +241,6 @@ function cleanOldLogs() {
 // 清理旧日志
 cleanOldLogs();
 
-// 启动时记录 DEBUG 模式状态
-if (DEBUG_MODE) {
-  logger.info('🔧 DEBUG模式已启用 - 将输出详细的bubble数据用于排查timingInfo问题');
-}
-
 // ==================== 版本信息初始化 ====================
 
 const __filename = fileURLToPath(import.meta.url);
@@ -684,9 +678,7 @@ async function generateMarkdownFromComposerData(composerId, db) {
     
     try {
       // 调用完整的解析器（传入已打开的数据库连接）
-      // DEBUG模式下传入logger.debug用于输出详细的bubble数据
-      const debugLoggerFn = DEBUG_MODE ? (msg, data) => logger.debug(msg, data) : null;
-      const result = parserModule.extractConversationFromGlobalDbWithConnection(composerId, tempFile, db, debugLoggerFn);
+      const result = parserModule.extractConversationFromGlobalDbWithConnection(composerId, tempFile, db);
       
       if (!result || !result.success) {
         logger.warn('解析器返回失败', { 

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "name": "ACW工具集",
   "description": "ACW平台工具集：智能下载规则到项目、初始化Common Admin模板项目",
-  "version": "1.3.6",
+  "version": "1.3.7",
   "author": "邦道科技 - 产品技术中心",
   "homepage": "https://www.npmjs.com/package/@bangdao-ai/acw-tools",
   "repository": "https://www.npmjs.com/package/@bangdao-ai/acw-tools?activeTab=readme",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bangdao-ai/acw-tools",
-  "version": "1.3.6-beta.2",
+  "version": "1.3.7",
   "type": "module",
   "description": "MCP (Model Context Protocol) tools for ACW - download rules and initialize Common Admin projects",
   "main": "index.js",