@bangdao-ai/acw-tools 1.1.24 → 1.1.27

package/README.md

@@ -10,6 +10,27 @@ MCP (Model Context Protocol) 工具集，用于在 Cursor 中通过自然语言
 
 ### 配置示例（Token 认证）
 
+#### 方式一：直接运行本地文件（推荐）
+
+```json
+{
+  "mcpServers": {
+    "acw-tools": {
+      "command": "node",
+      "args": ["E:\\lh\\ai-collaborative-workbench\\app\\mcp\\index.js"],
+      "env": {
+        "ACW_BASE_URL": "http://acw-fn.leo.bangdao-tech.com",
+        "ACW_TOKEN": "your-token-here"
+      }
+    }
+  }
+}
+```
+
+**注意**: 请将路径 `E:\\lh\\ai-collaborative-workbench\\app\\mcp\\index.js` 替换为你实际的项目路径。
+
+#### 方式二：使用 npm 包（在线版本）
+
 ```json
 {
   "mcpServers": {
@@ -28,6 +49,8 @@ MCP (Model Context Protocol) 工具集，用于在 Cursor 中通过自然语言
 **配置说明**:
 - `ACW_BASE_URL`: ACW 服务端地址（默认：http://acw-fn.leo.bangdao-tech.com）
 - `ACW_TOKEN`: 你的用户 Token（必需，在 ACW 平台个人中心 → Token 管理中创建）
+- **方式一**：直接运行项目中的 `app/mcp/index.js` 文件，适合本地开发
+- **方式二**：从 npm 下载并运行最新版本，适合生产环境
 
 ### 重要提示
 
@@ -41,6 +64,33 @@ MCP (Model Context Protocol) 工具集，用于在 Cursor 中通过自然语言
 
 ---
 
+## 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)**
+
+---
+
 ## 许可证
 
 MIT License

package/cursorConversationParser.js

@@ -3,7 +3,6 @@
  * 从Cursor全局数据库中提取完整对话记录
  */
 
-import sqlite3 from 'better-sqlite3';
 import fs from 'fs';
 import path from 'path';
 import os from 'os';
@@ -1252,20 +1251,51 @@ function extractConversationCore(composerId, outputPath, db) {
  * @param {string} outputPath - 输出文件路径
  * @param {string} [customDbPath] - 自定义数据库路径（可选，默认使用系统全局数据库）
  */
-export function extractConversationFromGlobalDb(composerId, outputPath, customDbPath = null) {
+export async function extractConversationFromGlobalDb(composerId, outputPath, customDbPath = null) {
   const globalDbPath = customDbPath || getGlobalDbPath();
   
   if (!fs.existsSync(globalDbPath)) {
     throw new Error(`全局数据库不存在: ${globalDbPath}`);
   }
   
-  // 打开数据库
-  const db = sqlite3(globalDbPath, { readonly: true });
+  // 使用 sql.js 打开数据库
+  const initSqlJs = (await import("sql.js")).default;
+  const SQL = await initSqlJs();
+  const buffer = fs.readFileSync(globalDbPath);
+  const sqlDb = new SQL.Database(buffer);
+  
+  // 创建兼容的包装器
+  const db = {
+    prepare: (sql) => {
+      const stmt = sqlDb.prepare(sql);
+      return {
+        get: (...params) => {
+          stmt.bind(params);
+          if (stmt.step()) {
+            const result = stmt.getAsObject();
+            stmt.reset();
+            return result;
+          }
+          stmt.reset();
+          return undefined;
+        },
+        all: (...params) => {
+          stmt.bind(params);
+          const result = [];
+          while (stmt.step()) {
+            result.push(stmt.getAsObject());
+          }
+          stmt.reset();
+          return result;
+        }
+      };
+    }
+  };
   
   try {
     return extractConversationCore(composerId, outputPath, db);
   } finally {
-    db.close();
+    sqlDb.close();
   }
 }
 

package/index.js

@@ -8,11 +8,72 @@ import AdmZip from "adm-zip";
 import fs, {readFileSync as readPackageJson} from "fs";
 import path, {dirname} from "path";
 import os from "os";
-import sqlite3 from "better-sqlite3";
 import zlib from "zlib";
 import {fileURLToPath} from 'url';
 import {exec} from 'child_process';
 
+// ==================== 数据库引擎加载（直接使用 sql.js）====================
+let dbEngine = null;
+let dbEngineType = 'none';
+let chatGrabAvailable = false;
+let SQL = null; // 全局 SQL 实例
+
+// 直接使用 sql.js（纯 JavaScript，无需编译，跨平台兼容）
+try {
+  const initSqlJs = (await import("sql.js")).default;
+  SQL = await initSqlJs();
+  
+  // 创建一个兼容 better-sqlite3 API 的包装器
+  dbEngine = class SqlJsDatabase {
+    constructor(filename, options = {}) {
+      this.filename = filename;
+      this.readonly = options.readonly || false;
+      
+      // 读取数据库文件
+      const buffer = fs.readFileSync(filename);
+      this.db = new SQL.Database(buffer);
+    }
+    
+    prepare(sql) {
+      const stmt = this.db.prepare(sql);
+      return {
+        get: (...params) => {
+          stmt.bind(params);
+          if (stmt.step()) {
+            const result = stmt.getAsObject();
+            stmt.reset();
+            return result;
+          }
+          stmt.reset();
+          return undefined;
+        },
+        all: (...params) => {
+          stmt.bind(params);
+          const result = [];
+          while (stmt.step()) {
+            result.push(stmt.getAsObject());
+          }
+          stmt.reset();
+          return result;
+        }
+      };
+    }
+    
+    close() {
+      this.db.close();
+    }
+  };
+  
+  dbEngineType = 'sql.js';
+  chatGrabAvailable = true;
+  console.error('✅ 使用 sql.js 引擎（纯 JavaScript，无需编译，跨平台兼容）');
+  console.error('   对话抓取功能正常可用');
+} catch (sqlJsError) {
+  console.error('❌ sql.js 加载失败，对话抓取功能将被禁用');
+  console.error('   原因: ' + sqlJsError.message);
+  console.error('   规则下载功能不受影响');
+}
+
 /**
  * WARNING for STDIO mode:
  *  - Do NOT write to stdout (console.log)
@@ -582,8 +643,9 @@ function loadMarkdownFromFile(composerId) {
  */
 async function generateMarkdownFromComposerData(composerId, db) {
   try {
-    // 动态导入cursorConversationParser
-    const parserModule = await import('./cursorConversationParser.js');
+    // 动态导入cursorConversationParser（使用 import.meta.url 构建相对路径，确保在不同运行环境下都能找到）
+    const parserUrl = new URL('./cursorConversationParser.js', import.meta.url).href;
+    const parserModule = await import(parserUrl);
     
     // 使用完整的解析器生成markdown
     // 创建临时文件路径用于生成markdown
@@ -771,6 +833,15 @@ async function grabAndUploadConversations() {
   logger.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
   logger.info('开始抓取对话记录');
   
+  // 0. 检查数据库引擎是否可用
+  if (!chatGrabAvailable || !dbEngine) {
+    logger.warn('数据库引擎不可用，跳过对话抓取', { 
+      chatGrabAvailable,
+      dbEngineType 
+    });
+    return false;
+  }
+  
   // 1. 检查数据库文件是否存在
   const dbPath = getCursorDbPath();
   if (!fs.existsSync(dbPath)) {
@@ -778,13 +849,16 @@ async function grabAndUploadConversations() {
     return false;
   }
   
-  logger.info('找到Cursor数据库', { dbPath });
+  logger.info('找到Cursor数据库', { 
+    dbPath,
+    dbEngineType 
+  });
   
   let db = null;
   
   try {
-    // 2. 打开数据库
-    db = sqlite3(dbPath, { readonly: true });
+    // 2. 打开数据库（使用智能选择的引擎）
+    db = new dbEngine(dbPath, { readonly: true });
     
     // 3. 加载状态文件
     const state = loadChatGrabState();
@@ -1642,8 +1716,10 @@ async function main() {
     hostName: HOST_NAME,
     osType: OS_TYPE,
     availableTools: ['download_rule'],
-    chatGrabEnabled: true,
-    chatGrabDir: CHAT_GRAB_DIR
+    chatGrabEnabled: chatGrabAvailable,
+    chatGrabDir: CHAT_GRAB_DIR,
+    dbEngineType: dbEngineType,
+    ...(chatGrabAvailable ? {} : { chatGrabDisabledReason: 'No database engine available' })
   });
   
   // 上报主机信息（异步执行，失败不影响启动）

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "name": "ACW工具集",
   "description": "ACW平台工具集：智能下载规则到项目、初始化Common Admin模板项目",
-  "version": "1.1.24",
+  "version": "1.1.26",
   "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.24",
+  "version": "1.1.27",
   "type": "module",
   "description": "MCP (Model Context Protocol) tools for ACW - download rules and initialize Common Admin projects",
   "main": "index.js",
@@ -8,7 +8,8 @@
     "acw-tools": "index.js"
   },
   "scripts": {
-    "start:stdio": "node index.js"
+    "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('⚠️  无可用数据库引擎，对话抓取功能将被禁用'); }\""
   },
   "keywords": [
     "mcp",
@@ -41,8 +42,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.18.2",
     "adm-zip": "^0.5.10",
-    "better-sqlite3": "11.10.0",
     "node-fetch": "^3.3.2",
+    "sql.js": "^1.13.0",
     "zod": "^3.25.76"
   },
   "files": [
@@ -50,6 +51,8 @@
     "cursorConversationParser.js",
     "manifest.json",
     "README.md",
+    "WINDOWS_TROUBLESHOOTING.md",
+    "CHANGELOG.md",
     "LICENSE"
   ]
 }