@bangdao-ai/acw-tools 1.4.13 → 1.4.14

package/index.js

@@ -30,6 +30,7 @@ const COMPRESSION_THRESHOLD = parseInt(process.env.MCP_COMPRESSION_THRESHOLD ||
 let dbEngine = null;
 let dbEngineType = 'none';
 let chatGrabAvailable = false;
+let dbEngineLoadError = null; // 记录加载失败的具体错误
 
 // 尝试加载 better-sqlite3（原生模块，性能最好）
 try {
@@ -42,8 +43,25 @@ try {
   dbEngineType = 'better-sqlite3';
   chatGrabAvailable = true;
 } catch (betterSqlite3Error) {
-  // better-sqlite3 加载失败，对话抓取功能不可用
-  // 错误会在后续使用时通过日志记录
+  // 记录详细错误信息，帮助用户排查问题
+  dbEngineLoadError = betterSqlite3Error.message || String(betterSqlite3Error);
+  
+  // 输出到 stderr（Cursor 会捕获显示）
+  console.error(`[ACW-MCP] better-sqlite3 加载失败: ${dbEngineLoadError}`);
+  console.error('[ACW-MCP] 对话抓取功能不可用。如需启用，请执行以下步骤:');
+  if (process.platform === 'darwin') {
+    console.error('[ACW-MCP] 1. 安装 Xcode Command Line Tools: xcode-select --install');
+    console.error('[ACW-MCP] 2. 全局安装: npm install -g @bangdao-ai/acw-tools');
+    console.error('[ACW-MCP] 3. 修改 Cursor MCP 配置使用全局安装版本');
+  } else if (process.platform === 'win32') {
+    console.error('[ACW-MCP] 1. 安装 windows-build-tools: npm install -g windows-build-tools');
+    console.error('[ACW-MCP] 2. 全局安装: npm install -g @bangdao-ai/acw-tools');
+    console.error('[ACW-MCP] 3. 修改 Cursor MCP 配置使用全局安装版本');
+  } else {
+    console.error('[ACW-MCP] 1. 安装编译工具: sudo apt-get install build-essential python3');
+    console.error('[ACW-MCP] 2. 全局安装: npm install -g @bangdao-ai/acw-tools');
+    console.error('[ACW-MCP] 3. 修改 Cursor MCP 配置使用全局安装版本');
+  }
 }
 
 /**
@@ -1424,7 +1442,13 @@ async function grabAndUploadConversations() {
   if (!chatGrabAvailable || !dbEngine) {
     logger.warn('数据库引擎不可用，跳过对话抓取', { 
       chatGrabAvailable,
-      dbEngineType 
+      dbEngineType,
+      loadError: dbEngineLoadError || '未知错误',
+      hint: process.platform === 'darwin' 
+        ? '请执行 xcode-select --install 安装编译工具，然后全局安装: npm install -g @bangdao-ai/acw-tools'
+        : process.platform === 'win32'
+        ? '请安装 windows-build-tools，然后全局安装: npm install -g @bangdao-ai/acw-tools'
+        : '请安装 build-essential，然后全局安装: npm install -g @bangdao-ai/acw-tools'
     });
     return false;
   }
@@ -2859,7 +2883,15 @@ async function main() {
     chatGrabEnabled: chatGrabAvailable && isTokenValid && isMainInstance,
     chatGrabDir: CHAT_GRAB_DIR,
     dbEngineType: dbEngineType,
-    ...(chatGrabAvailable ? {} : { chatGrabDisabledReason: 'No database engine available' }),
+    ...(chatGrabAvailable ? {} : { 
+      chatGrabDisabledReason: 'No database engine available',
+      dbEngineLoadError: dbEngineLoadError || 'Unknown error',
+      fixHint: process.platform === 'darwin' 
+        ? 'Run: xcode-select --install && npm install -g @bangdao-ai/acw-tools'
+        : process.platform === 'win32'
+        ? 'Run: npm install -g windows-build-tools && npm install -g @bangdao-ai/acw-tools'
+        : 'Run: sudo apt-get install build-essential && npm install -g @bangdao-ai/acw-tools'
+    }),
     ...(!isTokenValid ? { tokenDisabledReason: 'ACW_TOKEN not configured or invalid' } : {}),
     ...(!isMainInstance ? { schedulerDisabledReason: '非主实例，定时任务由其他实例负责' } : {})
   });

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "name": "ACW工具集",
   "description": "ACW平台工具集：智能下载规则到项目、初始化Common Admin模板项目",
-  "version": "1.4.13",
+  "version": "1.4.14",
   "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.4.13",
+  "version": "1.4.14",
   "type": "module",
   "description": "MCP (Model Context Protocol) tools for ACW - download rules and initialize Common Admin projects",
   "main": "index.js",