@bangdao-ai/acw-tools 1.4.19 → 1.4.20

package/index.js

@@ -26,27 +26,24 @@ 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阈值
 
-// ==================== 数据库引擎加载（使用 better-sqlite3）====================
+// ==================== 数据库引擎加载（使用 better-sqlite3，支持 ABI 版本自动修复）====================
+import { loadBetterSqlite3WithAutoFix } from './prebuildFixer.js';
+
 let dbEngine = null;
 let dbEngineType = 'none';
 let chatGrabAvailable = false;
-let dbEngineLoadError = null; // 记录加载失败的具体错误
+let dbEngineLoadError = null;
 
-// 尝试加载 better-sqlite3（原生模块，性能最好）
-try {
-  const Database = (await import("better-sqlite3")).default;
-  // 测试模块是否真正可用（有时 import 成功但 bindings 失败）
-  const testDb = new Database(':memory:');
-  testDb.close();
-  
-  dbEngine = Database;
+// 使用自动修复模块加载 better-sqlite3
+// 如果检测到 ABI 版本不匹配（如 npx 缓存问题），会自动从 OSS 下载正确版本的预编译包
+const loadResult = await loadBetterSqlite3WithAutoFix(console.error);
+
+if (loadResult.success) {
+  dbEngine = loadResult.Database;
   dbEngineType = 'better-sqlite3';
   chatGrabAvailable = true;
-} catch (betterSqlite3Error) {
-  // 记录详细错误信息，帮助用户排查问题
-  dbEngineLoadError = betterSqlite3Error.message || String(betterSqlite3Error);
-  
-  // 输出到 stderr（Cursor 会捕获显示）
+} else {
+  dbEngineLoadError = loadResult.error;
   console.error(`[ACW-MCP] better-sqlite3 加载失败: ${dbEngineLoadError}`);
   console.error('[ACW-MCP] 对话抓取功能不可用。如需启用，请执行以下步骤:');
   if (process.platform === 'darwin') {

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "name": "ACW工具集",
   "description": "ACW平台工具集：智能下载规则到项目、初始化Common Admin模板项目",
-  "version": "1.4.19",
+  "version": "1.4.20",
   "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.19",
+  "version": "1.4.20",
   "type": "module",
   "description": "MCP (Model Context Protocol) tools for ACW - download rules and initialize Common Admin projects",
   "main": "index.js",
@@ -51,6 +51,7 @@
     "index.js",
     "cursorConversationParser.js",
     "postinstall.js",
+    "prebuildFixer.js",
     "manifest.json",
     "README.md",
     "LICENSE"

package/prebuildFixer.js

@@ -0,0 +1,296 @@
+#!/usr/bin/env node
+/**
+ * better-sqlite3 预编译包运行时修复模块
+ * 
+ * 解决的问题：
+ * - npx 缓存导致 Node 版本切换后 ABI 不匹配
+ * - postinstall 脚本没有正确执行
+ * - 网络问题导致预编译包下载失败
+ * 
+ * 工作原理：
+ * 1. 检测当前 Node.js 的 ABI 版本
+ * 2. 检查已安装的 .node 文件是否匹配
+ * 3. 如果不匹配，从 OSS 下载正确版本的预编译包
+ * 4. 替换旧的 .node 文件
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+import https from 'https';
+import http from 'http';
+import zlib from 'zlib';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// OSS 预编译包镜像地址
+const OSS_PREBUILD_BASE = 'https://bd-acw.oss-cn-beijing.aliyuncs.com/prebuilds/better-sqlite3';
+
+// better-sqlite3 版本（需与 package.json 中的版本匹配）
+const BETTER_SQLITE3_VERSION = '12.4.1';
+
+// 获取当前 Node.js 的 ABI 版本
+function getNodeAbi() {
+  return `v${process.versions.modules}`;
+}
+
+// 获取平台标识
+function getPlatformTag() {
+  return `${process.platform}-${process.arch}`;
+}
+
+// 下载文件
+function downloadFile(url, destPath) {
+  return new Promise((resolve, reject) => {
+    const protocol = url.startsWith('https') ? https : http;
+    const file = fs.createWriteStream(destPath);
+    
+    protocol.get(url, (response) => {
+      if (response.statusCode === 301 || response.statusCode === 302) {
+        downloadFile(response.headers.location, destPath).then(resolve).catch(reject);
+        return;
+      }
+      
+      if (response.statusCode !== 200) {
+        reject(new Error(`HTTP ${response.statusCode}`));
+        return;
+      }
+      
+      response.pipe(file);
+      file.on('finish', () => {
+        file.close();
+        resolve();
+      });
+    }).on('error', (err) => {
+      fs.unlink(destPath, () => {});
+      reject(err);
+    });
+  });
+}
+
+// 解压 tar.gz 文件
+function extractTarGz(tarPath, destDir) {
+  try {
+    execSync(`tar -xzf "${tarPath}" -C "${destDir}"`, { stdio: 'pipe' });
+    return true;
+  } catch (e) {
+    if (process.platform === 'win32') {
+      try {
+        const gunzipped = tarPath.replace('.tar.gz', '.tar');
+        const data = fs.readFileSync(tarPath);
+        const unzipped = zlib.gunzipSync(data);
+        fs.writeFileSync(gunzipped, unzipped);
+        execSync(`tar -xf "${gunzipped}" -C "${destDir}"`, { stdio: 'pipe' });
+        fs.unlinkSync(gunzipped);
+        return true;
+      } catch (e2) {
+        return false;
+      }
+    }
+    return false;
+  }
+}
+
+// 递归查找 .node 文件
+function findNodeFile(dir) {
+  try {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        const found = findNodeFile(fullPath);
+        if (found) return found;
+      } else if (entry.name.endsWith('.node')) {
+        return fullPath;
+      }
+    }
+  } catch (e) {
+    // 忽略错误
+  }
+  return null;
+}
+
+// 递归删除目录
+function cleanupDir(dir) {
+  try {
+    if (!fs.existsSync(dir)) return;
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        cleanupDir(fullPath);
+      } else {
+        fs.unlinkSync(fullPath);
+      }
+    }
+    fs.rmdirSync(dir);
+  } catch (e) {
+    // 忽略清理错误
+  }
+}
+
+/**
+ * 检查错误是否是 ABI 版本不匹配
+ * @param {Error} error - 加载 better-sqlite3 时的错误
+ * @returns {{ isAbiMismatch: boolean, currentAbi: string, expectedAbi: string }}
+ */
+export function checkAbiMismatch(error) {
+  const message = error?.message || '';
+  
+  // 匹配错误信息中的 ABI 版本
+  // 示例: "NODE_MODULE_VERSION 115. This version of Node.js requires NODE_MODULE_VERSION 127"
+  const match = message.match(/NODE_MODULE_VERSION\s+(\d+).*NODE_MODULE_VERSION\s+(\d+)/);
+  
+  if (match) {
+    return {
+      isAbiMismatch: true,
+      installedAbi: `v${match[1]}`,
+      requiredAbi: `v${match[2]}`
+    };
+  }
+  
+  return { isAbiMismatch: false, installedAbi: null, requiredAbi: null };
+}
+
+/**
+ * 从 OSS 下载并安装正确版本的预编译包
+ * @param {Function} logFn - 日志函数（输出到 stderr）
+ * @returns {Promise<boolean>} - 是否成功
+ */
+export async function fixPrebuild(logFn = console.error) {
+  const abi = getNodeAbi();
+  const platform = getPlatformTag();
+  const filename = `better-sqlite3-v${BETTER_SQLITE3_VERSION}-node-${abi}-${platform}.tar.gz`;
+  const url = `${OSS_PREBUILD_BASE}/v${BETTER_SQLITE3_VERSION}/${filename}`;
+  
+  logFn(`[ACW-MCP] 检测到 ABI 版本不匹配，尝试自动修复...`);
+  logFn(`[ACW-MCP] 当前 Node ABI: ${abi}, 平台: ${platform}`);
+  logFn(`[ACW-MCP] 正在从 OSS 下载预编译包...`);
+  
+  // 找到 better-sqlite3 的安装路径
+  const betterSqlite3Path = path.join(__dirname, 'node_modules', 'better-sqlite3');
+  if (!fs.existsSync(betterSqlite3Path)) {
+    logFn('[ACW-MCP] 找不到 better-sqlite3 目录');
+    return false;
+  }
+  
+  // 下载预编译包
+  const tempDir = path.join(__dirname, '.prebuild-temp');
+  const tempFile = path.join(tempDir, filename);
+  const extractDir = path.join(tempDir, 'extracted');
+  
+  try {
+    if (!fs.existsSync(tempDir)) {
+      fs.mkdirSync(tempDir, { recursive: true });
+    }
+    if (!fs.existsSync(extractDir)) {
+      fs.mkdirSync(extractDir, { recursive: true });
+    }
+    
+    await downloadFile(url, tempFile);
+    logFn('[ACW-MCP] 下载成功');
+    
+    if (!extractTarGz(tempFile, extractDir)) {
+      logFn('[ACW-MCP] 解压失败');
+      cleanupDir(tempDir);
+      return false;
+    }
+    logFn('[ACW-MCP] 解压成功');
+    
+    const nodeFile = findNodeFile(extractDir);
+    if (!nodeFile) {
+      logFn('[ACW-MCP] 未找到 .node 文件');
+      cleanupDir(tempDir);
+      return false;
+    }
+    
+    // 复制到 build/Release/ 目录
+    const targetDir = path.join(betterSqlite3Path, 'build', 'Release');
+    if (!fs.existsSync(targetDir)) {
+      fs.mkdirSync(targetDir, { recursive: true });
+    }
+    
+    const targetFile = path.join(targetDir, 'better_sqlite3.node');
+    
+    // 如果目标文件存在，先删除
+    if (fs.existsSync(targetFile)) {
+      fs.unlinkSync(targetFile);
+    }
+    
+    fs.copyFileSync(nodeFile, targetFile);
+    logFn('[ACW-MCP] 预编译包安装成功');
+    
+    // 清理临时文件
+    cleanupDir(tempDir);
+    
+    return true;
+  } catch (e) {
+    logFn(`[ACW-MCP] 修复失败: ${e.message}`);
+    cleanupDir(tempDir);
+    return false;
+  }
+}
+
+/**
+ * 尝试加载 better-sqlite3，如果 ABI 不匹配则自动修复
+ * @param {Function} logFn - 日志函数
+ * @returns {Promise<{ success: boolean, Database: any, error: string }>}
+ */
+export async function loadBetterSqlite3WithAutoFix(logFn = console.error) {
+  // 第一次尝试加载
+  try {
+    const Database = (await import('better-sqlite3')).default;
+    const testDb = new Database(':memory:');
+    testDb.close();
+    return { success: true, Database, error: null };
+  } catch (firstError) {
+    const { isAbiMismatch, installedAbi, requiredAbi } = checkAbiMismatch(firstError);
+    
+    if (!isAbiMismatch) {
+      // 不是 ABI 不匹配问题，直接返回错误
+      return { success: false, Database: null, error: firstError.message };
+    }
+    
+    logFn(`[ACW-MCP] ABI 版本不匹配: 已安装 ${installedAbi}, 需要 ${requiredAbi}`);
+    
+    // 尝试自动修复
+    const fixSuccess = await fixPrebuild(logFn);
+    
+    if (!fixSuccess) {
+      return { 
+        success: false, 
+        Database: null, 
+        error: `ABI 版本不匹配且自动修复失败: ${firstError.message}` 
+      };
+    }
+    
+    // 修复后重新尝试加载
+    // 注意：ESM 模块有缓存，需要用特殊方式绕过
+    // 但由于 .node 文件是动态加载的，替换后应该能正常工作
+    try {
+      // 清除 require 缓存（对 CJS 有效）
+      try {
+        const modulePath = require.resolve('better-sqlite3');
+        delete require.cache[modulePath];
+      } catch (e) {
+        // ESM 环境可能没有 require
+      }
+      
+      // 重新 import（ESM 会从缓存中取，但 bindings 会重新加载 .node）
+      const Database = (await import('better-sqlite3')).default;
+      const testDb = new Database(':memory:');
+      testDb.close();
+      
+      logFn('[ACW-MCP] 自动修复成功，better-sqlite3 已加载');
+      return { success: true, Database, error: null };
+    } catch (secondError) {
+      return { 
+        success: false, 
+        Database: null, 
+        error: `自动修复后仍无法加载: ${secondError.message}` 
+      };
+    }
+  }
+}