@bangdao-ai/acw-tools 1.1.27 → 1.1.31

package/README.md

@@ -62,32 +62,6 @@ MCP (Model Context Protocol) 工具集，用于在 Cursor 中通过自然语言
 
 配置完成后重启 Cursor，MCP 工具将自动加载。
 
----
-
-## Windows 系统注意事项
-
-### ✨ v1.1.26+：零配置、开箱即用
-
-从 **v1.1.26** 版本开始，Windows 用户**无需安装任何编译工具**！
-
-#### 🎯 自动降级机制
-
-工具会自动在两个数据库引擎之间智能选择：
-- **better-sqlite3**（高性能原生模块） - 如果可用
-- **sql.js**（纯 JavaScript 实现） - 自动降级，100% 兼容
-
-#### 📊 用户体验
-
-| 功能 | 可用性 | 性能 |
-|------|--------|------|
-| **规则下载** | ✅ 始终可用 | ⚡ 快速 |
-| **对话抓取** | ✅ 始终可用 | ⚡ 自动选择最佳引擎 |
-
-查看使用的引擎：`%USERPROFILE%\.cursor\.chat_grab\logs\acw-mcp-日期.log`
-
-#### 🔍 更多信息
-
-如有疑问，参考：**[Windows 故障排除指南](./WINDOWS_TROUBLESHOOTING.md)**
 
 ---
 

package/index.js

@@ -5,13 +5,19 @@ import {z} from "zod";
 import fetch from "node-fetch";
 import AdmZip from "adm-zip";
 // MCP当前版本（从package.json读取）
-import fs, {readFileSync as readPackageJson} from "fs";
+import fs from "fs";
 import path, {dirname} from "path";
 import os from "os";
 import zlib from "zlib";
 import {fileURLToPath} from 'url';
 import {exec} from 'child_process';
 
+// ==================== 常量定义 ====================
+const FETCH_TIMEOUT_CONFIG = 10000; // 配置请求超时时间（10秒）
+const FETCH_TIMEOUT_UPLOAD = 30000; // 上传请求超时时间（30秒）
+const FETCH_TIMEOUT_TELEMETRY = 30000; // 遥测上报超时时间（30秒）
+const RETRY_BASE_DELAY = 2000; // 重试基础延迟（2秒）
+
 // ==================== 数据库引擎加载（直接使用 sql.js）====================
 let dbEngine = null;
 let dbEngineType = 'none';
@@ -66,10 +72,10 @@ try {
   
   dbEngineType = 'sql.js';
   chatGrabAvailable = true;
-  console.error('✅ 使用 sql.js 引擎（纯 JavaScript，无需编译，跨平台兼容）');
+  console.error('[OK] 使用 sql.js 引擎（纯 JavaScript，无需编译，跨平台兼容）');
   console.error('   对话抓取功能正常可用');
 } catch (sqlJsError) {
-  console.error('❌ sql.js 加载失败，对话抓取功能将被禁用');
+  console.error('[ERROR] sql.js 加载失败，对话抓取功能将被禁用');
   console.error('   原因: ' + sqlJsError.message);
   console.error('   规则下载功能不受影响');
 }
@@ -273,6 +279,7 @@ cleanOldLogs();
 
 // 启动时记录日志位置
 logger.info('ACW MCP 工具启动', { 
+  mcpVersion: CURRENT_MCP_VERSION,
   logFile: getCurrentLogFile(),
   nodeVersion: process.version,
   platform: os.platform(),
@@ -312,7 +319,7 @@ function findPackageJson() {
   try {
     if (fs.existsSync(packagePath)) {
       logger.info('找到 package.json', { path: packagePath });
-      const content = readPackageJson(packagePath, 'utf8');
+      const content = fs.readFileSync(packagePath, 'utf8');
       const parsed = JSON.parse(content);
       
       // 验证是否是我们要找的包
@@ -335,7 +342,8 @@ function findPackageJson() {
   } catch (error) {
     logger.error('读取 package.json 失败', { 
       path: packagePath, 
-      error: error.message 
+      error: error.message,
+      stack: error.stack 
     });
   }
   
@@ -564,21 +572,51 @@ function decompressData(data) {
   }
 }
 
+/**
+ * 带超时的fetch请求
+ * @param {string} url - 请求URL
+ * @param {RequestInit} options - fetch选项
+ * @param {number} timeoutMs - 超时时间（毫秒）
+ * @returns {Promise<Response>}
+ */
+async function fetchWithTimeout(url, options = {}, timeoutMs = 10000) {
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+  
+  try {
+    const response = await fetch(url, {
+      ...options,
+      signal: controller.signal
+    });
+    clearTimeout(timeoutId);
+    return response;
+  } catch (error) {
+    clearTimeout(timeoutId);
+    if (error.name === 'AbortError') {
+      throw new Error(`请求超时（${timeoutMs}ms）`);
+    }
+    throw error;
+  }
+}
+
 /**
  * 从服务端获取MCP配置
  */
 async function fetchMcpConfig() {
   try {
-    logger.debug('开始获取MCP配置');
+    logger.debug('开始获取MCP配置', { baseUrl: BASE_URL });
     
-    const response = await fetch(`${BASE_URL}/api/noauth/mcp/config`, {
-      method: "GET",
-      headers: {
-        "Content-Type": "application/json",
-        "Accept-Encoding": "gzip, deflate, br",
+    const response = await fetchWithTimeout(
+      `${BASE_URL}/api/noauth/mcp/config`,
+      {
+        method: "GET",
+        headers: {
+          "Content-Type": "application/json",
+          "Accept-Encoding": "gzip, deflate, br",
+        }
       },
-      timeout: 10000 // 10秒超时
-    });
+      FETCH_TIMEOUT_CONFIG
+    );
     
     if (!response.ok) {
       throw new Error(`获取配置失败: HTTP ${response.status}`);
@@ -594,9 +632,13 @@ async function fetchMcpConfig() {
       return true;
     }
     
+    logger.warn('MCP配置响应格式异常', { hasSuccess: !!result.success, hasData: !!result.data });
     return false;
   } catch (error) {
-    logger.warn('获取MCP配置失败，使用默认配置', { error: error.message });
+    logger.warn('获取MCP配置失败，使用默认配置', { 
+      error: error.message,
+      baseUrl: BASE_URL 
+    });
     return false;
   }
 }
@@ -778,15 +820,18 @@ async function uploadConversationWithRetry(sessionId, conversationData, retryTim
         additionalInfoKeys: conversationData.additionalInfo ? Object.keys(conversationData.additionalInfo) : []
       });
       
-      const response = await fetch(apiUrl, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          "Accept-Encoding": "gzip, deflate, br",
+      const response = await fetchWithTimeout(
+        apiUrl,
+        {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "Accept-Encoding": "gzip, deflate, br",
+          },
+          body: JSON.stringify(requestBody)
         },
-        body: JSON.stringify(requestBody),
-        timeout: 30000 // 30秒超时
-      });
+        FETCH_TIMEOUT_UPLOAD
+      );
       
       if (!response.ok) {
         const errorData = await response.json().catch(() => ({}));
@@ -807,7 +852,7 @@ async function uploadConversationWithRetry(sessionId, conversationData, retryTim
       
       // 如果还有重试机会，等待一段时间后重试
       if (attempt < retryTimes) {
-        const waitTime = attempt * 2000; // 递增等待时间：2s, 4s, 6s
+        const waitTime = attempt * RETRY_BASE_DELAY; // 递增等待时间：2s, 4s, 6s
         logger.info('等待重试', { 等待时间: `${waitTime / 1000}秒` });
         await new Promise(resolve => setTimeout(resolve, waitTime));
       }
@@ -989,7 +1034,7 @@ async function grabAndUploadConversations() {
           
           // 记录上传成功的文件
           const filePath = path.join(CHAT_GRAB_DIR, 'markdown', `${composerId}.md`);
-          logger.info(`✓ 上传成功 [${currentIndex}/${totalCount}]`, { 
+          logger.info(`[OK] 上传成功 [${currentIndex}/${totalCount}]`, { 
             title: conversationData.title || 'Unnamed',
             file: path.basename(filePath),
             size: `${(conversationData.markdown.length / 1024).toFixed(2)} KB`
@@ -1001,7 +1046,7 @@ async function grabAndUploadConversations() {
           state.statistics.lastError = result.error;
           failedCount++;  // 本次失败数
           
-          logger.error('✗ 上传失败', { 
+          logger.error('[FAIL] 上传失败', { 
             title: conversationData.title || 'Unnamed',
             error: result.error 
           });
@@ -1389,15 +1434,18 @@ async function reportHostInfo() {
     
     logger.debug('发送主机信息上报请求', { apiUrl });
     
-    const response = await fetch(apiUrl, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "Accept-Encoding": "gzip, deflate, br",
+    const response = await fetchWithTimeout(
+      apiUrl,
+      {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Accept-Encoding": "gzip, deflate, br",
+        },
+        body: JSON.stringify(requestBody)
       },
-      body: JSON.stringify(requestBody),
-      timeout: 30000 // 30秒超时
-    });
+      FETCH_TIMEOUT_TELEMETRY
+    );
     
     if (!response.ok) {
       const errorData = await response.json().catch(() => ({}));
@@ -1447,14 +1495,19 @@ async function downloadAndExtractRule(ruleIdentifier, targetDir) {
   const apiUrl = `${BASE_URL}/api/noauth/rule/download-with-token`;
 
   // 发送下载请求
-  const response = await fetch(apiUrl, {
-    method: "POST",
-    headers: {
-      "Content-Type": "application/json",
-      "Accept-Encoding": "gzip, deflate, br",
+  logger.debug('发送规则下载请求', { apiUrl, ruleIdentifier });
+  const response = await fetchWithTimeout(
+    apiUrl,
+    {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Accept-Encoding": "gzip, deflate, br",
+      },
+      body: JSON.stringify(requestBody)
     },
-    body: JSON.stringify(requestBody),
-  });
+    FETCH_TIMEOUT_UPLOAD // 使用上传超时时间，因为下载可能较大
+  );
 
   logger.info("收到服务器响应", { statusCode: response.status });
 
@@ -1549,7 +1602,6 @@ async function downloadAndExtractRule(ruleIdentifier, targetDir) {
   logger.debug("ZIP内容分析", { totalEntries: zipEntries.length });
 
   let extractedCount = 0;
-  let skippedCount = 0;
 
   // 遍历所有文件并解压
   zipEntries.forEach((entry) => {
@@ -1711,6 +1763,7 @@ async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
   logger.info("ACW工具MCP服务已启动", {
+    mcpVersion: CURRENT_MCP_VERSION,
     baseUrl: BASE_URL,
     authMethod: 'Token',
     hostName: HOST_NAME,

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "name": "ACW工具集",
   "description": "ACW平台工具集：智能下载规则到项目、初始化Common Admin模板项目",
-  "version": "1.1.26",
+  "version": "1.1.31",
   "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.1.27",
+  "version": "1.1.31",
   "type": "module",
   "description": "MCP (Model Context Protocol) tools for ACW - download rules and initialize Common Admin projects",
   "main": "index.js",
@@ -9,7 +9,7 @@
   },
   "scripts": {
     "start:stdio": "node index.js",
-    "postinstall": "node -e \"let engine='none'; try { require('sql.js'); engine='sql.js'; console.log('✅ 数据库引擎: sql.js (纯JavaScript，无需编译，跨平台兼容)'); } catch(e2) { console.warn('⚠️  无可用数据库引擎，对话抓取功能将被禁用'); }\""
+    "postinstall": "node -e \"const fs=require('fs');const path=require('path');let mcpVersion='unknown';try{const pkgPath=path.join(__dirname,'package.json');if(fs.existsSync(pkgPath)){const pkg=JSON.parse(fs.readFileSync(pkgPath,'utf8'));mcpVersion=pkg.version||'unknown';}}catch(e){}\" \"console.log('ACW Tools MCP 安装后检查开始...');console.log('MCP 版本:',mcpVersion);console.log('Node.js 版本:',process.version);console.log('平台:',process.platform);console.log('架构:',process.arch);let engine='none';let errorDetails=null;try{console.log('正在检查 sql.js 依赖...');const sqljs=require('sql.js');console.log('[OK] sql.js 模块加载成功');engine='sql.js';console.log('[OK] 数据库引擎: sql.js (纯JavaScript，无需编译，跨平台兼容)');console.log('[OK] 对话抓取功能已启用');}catch(e1){errorDetails=e1;console.warn('[WARN] sql.js 模块加载失败');console.warn('   错误类型:',e1.name);console.warn('   错误消息:',e1.message);if(e1.code)console.warn('   错误代码:',e1.code);if(e1.stack){const lines=e1.stack.split('\\n');console.warn('   堆栈信息:',lines.slice(0,3).join('\\n'));}console.warn('[WARN] 无可用数据库引擎，对话抓取功能将被禁用');console.warn('提示: 规则下载功能不受影响，仍可正常使用');}console.log('安装后检查完成');\""
   },
   "keywords": [
     "mcp",