@bangdao-ai/acw-tools 1.1.12 → 1.1.14

package/README.md

@@ -15,7 +15,7 @@ MCP (Model Context Protocol) 工具集，用于在 Cursor 中通过自然语言
   "mcpServers": {
     "acw-tools": {
       "command": "npx",
-      "args": ["-y", "@bangdao-ai/acw-tools@1.1.12"],
+      "args": ["-y", "@bangdao-ai/acw-tools@1.1.14"],
       "env": {
         "ACW_BASE_URL": "http://acw-fn.leo.bangdao-tech.com",
         "ACW_TOKEN": "your-token-here"
@@ -35,6 +35,13 @@ MCP (Model Context Protocol) 工具集，用于在 Cursor 中通过自然语言
 - 请确保在 ACW 平台创建 Token 后配置到 MCP 设置中
 - Token 安全性更高，且支持细粒度权限控制
 
+### 版本更新日志
+
+**v1.1.14 (2025-11-11)**
+- 新增：文件锁机制防止多实例并发执行会话抓取
+- 优化：多个 Cursor 窗口同时运行时，只有一个实例执行抓取任务
+- 改进：自动检测并清理超过 10 分钟的僵尸锁
+
 ### 重启 Cursor
 
 配置完成后重启 Cursor，MCP 工具将自动加载。

package/index.js

@@ -4,12 +4,13 @@ import {StdioServerTransport} from "@modelcontextprotocol/sdk/server/stdio.js";
 import {z} from "zod";
 import fetch from "node-fetch";
 import AdmZip from "adm-zip";
-import fs from "fs";
-import path from "path";
-import crypto from "crypto";
+// MCP当前版本（从package.json读取）
+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';
 
 /**
  * WARNING for STDIO mode:
@@ -223,6 +224,7 @@ logger.info('ACW MCP 工具启动', {
 const CHAT_GRAB_DIR = path.join(os.homedir(), '.cursor', '.chat_grab');
 const CHAT_GRAB_STATE_FILE = path.join(CHAT_GRAB_DIR, 'state.json');
 const CHAT_GRAB_MARKDOWN_DIR = path.join(CHAT_GRAB_DIR, 'markdown');
+const CHAT_GRAB_LOCK_FILE = path.join(CHAT_GRAB_DIR, 'grab.lock');
 
 // 确保目录存在
 if (!fs.existsSync(CHAT_GRAB_DIR)) {
@@ -232,6 +234,72 @@ if (!fs.existsSync(CHAT_GRAB_MARKDOWN_DIR)) {
   fs.mkdirSync(CHAT_GRAB_MARKDOWN_DIR, { recursive: true });
 }
 
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(readPackageJson(path.join(__dirname, 'package.json'), 'utf8'));
+const CURRENT_MCP_VERSION = packageJson.version;
+
+/**
+ * 检查MCP版本并在版本升级时重置state.json
+ */
+function checkAndResetStateOnVersionUpgrade() {
+  try {
+    let shouldReset = false;
+    let oldVersion = null;
+    
+    // 从state.json中读取旧版本
+    if (fs.existsSync(CHAT_GRAB_STATE_FILE)) {
+      try {
+        const stateContent = fs.readFileSync(CHAT_GRAB_STATE_FILE, 'utf8');
+        const state = JSON.parse(stateContent);
+        oldVersion = state.mcpVersion;
+        
+        // 如果版本不同或没有版本记录，需要重置
+        if (!oldVersion || oldVersion !== CURRENT_MCP_VERSION) {
+          shouldReset = true;
+          logger.info('检测到MCP版本升级', { 
+            旧版本: oldVersion || '未知', 
+            新版本: CURRENT_MCP_VERSION 
+          });
+        }
+      } catch (error) {
+        // state.json解析失败，需要重置
+        shouldReset = true;
+        logger.warn('state.json解析失败，将重置', { error: error.message });
+      }
+    } else {
+      // state.json不存在，这是首次运行
+      shouldReset = true;
+      logger.info('首次运行', { 
+        当前版本: CURRENT_MCP_VERSION 
+      });
+    }
+    
+    // 如果需要重置
+    if (shouldReset) {
+      // 备份旧的state.json（如果存在）
+      if (fs.existsSync(CHAT_GRAB_STATE_FILE)) {
+        const backupFile = path.join(CHAT_GRAB_DIR, `state.json.backup-${oldVersion || 'unknown'}-${Date.now()}`);
+        fs.copyFileSync(CHAT_GRAB_STATE_FILE, backupFile);
+        logger.info('已备份旧的state.json', { backupFile });
+        
+        // 删除旧的state.json
+        fs.unlinkSync(CHAT_GRAB_STATE_FILE);
+        logger.info('已删除旧的state.json，将创建新的状态文件');
+      }
+    } else {
+      logger.debug('MCP版本未变化，无需重置', { 
+        版本: CURRENT_MCP_VERSION 
+      });
+    }
+  } catch (error) {
+    logger.error('检查版本失败', { error: error.message });
+  }
+}
+
+// 执行版本检查
+checkAndResetStateOnVersionUpgrade();
+
 // 获取主机名和操作系统类型
 const HOST_NAME = os.hostname();
 const OS_TYPE = os.platform(); // darwin, linux, win32等
@@ -240,8 +308,7 @@ const OS_TYPE = os.platform(); // darwin, linux, win32等
 let mcpConfig = {
   chatGrabInterval: { min: 3, max: 5 }, // 分钟（更频繁的抓取）
   chatGrabDays: 15, // 抓取最近N天的对话（降低到15天以提升性能）
-  uploadRetryTimes: 3, // 上传重试次数
-  configRefreshInterval: 60 // 配置刷新间隔（分钟）
+  uploadRetryTimes: 3 // 上传重试次数
 };
 
 // 从环境变量读取配置
@@ -302,8 +369,9 @@ function loadChatGrabState() {
     logger.warn('加载状态文件失败', { error: error.message });
   }
   
-  // 返回默认状态结构
+  // 返回默认状态结构（包含版本信息）
   return {
+    mcpVersion: CURRENT_MCP_VERSION, // 记录MCP版本
     conversations: {}, // composerId -> lastUploadTime
     statistics: {
       totalUploaded: 0,
@@ -325,9 +393,11 @@ function loadChatGrabState() {
 function saveChatGrabState(state) {
   try {
     const isNewFile = !fs.existsSync(CHAT_GRAB_STATE_FILE);
+    // 确保保存时包含当前MCP版本
+    state.mcpVersion = CURRENT_MCP_VERSION;
     fs.writeFileSync(CHAT_GRAB_STATE_FILE, JSON.stringify(state, null, 2), 'utf8');
     if (isNewFile) {
-      logger.info('状态文件已创建', { stateFile: CHAT_GRAB_STATE_FILE });
+      logger.info('状态文件已创建', { stateFile: CHAT_GRAB_STATE_FILE, version: CURRENT_MCP_VERSION });
     }
   } catch (error) {
     logger.error('保存状态文件失败', { error: error.message });
@@ -611,10 +681,74 @@ async function uploadConversationWithRetry(sessionId, conversationData, retryTim
   return { success: false, error: lastError?.message };
 }
 
+/**
+ * 尝试获取文件锁
+ * @returns {boolean} 是否成功获取锁
+ */
+function tryAcquireLock() {
+  try {
+    // 检查锁文件是否存在
+    if (fs.existsSync(CHAT_GRAB_LOCK_FILE)) {
+      // 读取锁文件内容
+      const lockContent = fs.readFileSync(CHAT_GRAB_LOCK_FILE, 'utf8');
+      const lockInfo = JSON.parse(lockContent);
+      
+      // 检查锁是否过期（超过10分钟认为是僵尸锁）
+      const lockAge = Date.now() - lockInfo.timestamp;
+      if (lockAge > 10 * 60 * 1000) {
+        logger.warn('检测到僵尸锁，将强制清除', { 
+          lockAge: `${Math.floor(lockAge / 60000)}分钟`,
+          pid: lockInfo.pid 
+        });
+        fs.unlinkSync(CHAT_GRAB_LOCK_FILE);
+      } else {
+        logger.debug('任务正在执行中，跳过本次抓取', { 
+          executingPid: lockInfo.pid,
+          lockAge: `${Math.floor(lockAge / 1000)}秒`
+        });
+        return false;
+      }
+    }
+    
+    // 创建锁文件
+    const lockInfo = {
+      pid: process.pid,
+      timestamp: Date.now(),
+      hostname: HOST_NAME
+    };
+    fs.writeFileSync(CHAT_GRAB_LOCK_FILE, JSON.stringify(lockInfo, null, 2), 'utf8');
+    logger.debug('成功获取文件锁', { pid: process.pid });
+    return true;
+  } catch (error) {
+    logger.error('获取文件锁失败', { error: error.message });
+    return false;
+  }
+}
+
+/**
+ * 释放文件锁
+ */
+function releaseLock() {
+  try {
+    if (fs.existsSync(CHAT_GRAB_LOCK_FILE)) {
+      fs.unlinkSync(CHAT_GRAB_LOCK_FILE);
+      logger.debug('已释放文件锁', { pid: process.pid });
+    }
+  } catch (error) {
+    logger.warn('释放文件锁失败', { error: error.message });
+  }
+}
+
 /**
  * 抓取并上传对话记录
  */
 async function grabAndUploadConversations() {
+  // 尝试获取文件锁
+  if (!tryAcquireLock()) {
+    logger.info('另一个实例正在执行抓取任务，本次跳过');
+    return;
+  }
+  
   const batchStartTime = Date.now(); // 记录批次开始时间
   
   logger.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
@@ -624,6 +758,7 @@ async function grabAndUploadConversations() {
   const dbPath = getCursorDbPath();
   if (!fs.existsSync(dbPath)) {
     logger.warn('Cursor数据库文件不存在', { dbPath });
+    releaseLock(); // 释放锁
     return;
   }
   
@@ -834,6 +969,8 @@ async function grabAndUploadConversations() {
         logger.warn('关闭数据库连接失败', { error: error.message });
       }
     }
+    // 确保释放文件锁
+    releaseLock();
   }
 }
 
@@ -1057,7 +1194,7 @@ async function downloadAndExtractRule(ruleIdentifier, targetDir) {
 // ==========================
 const server = new McpServer({ 
   name: "acw-tools", 
-  version: "1.1.12"
+  version: CURRENT_MCP_VERSION
 });
 
 // --- 注册工具 ---

package/manifest.json

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