@bangdao-ai/acw-tools 1.1.23 → 1.1.26

package/CHANGELOG.md

@@ -0,0 +1,121 @@
+# 变更日志
+
+所有重要的项目变更都会记录在此文件中。
+
+格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
+版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+## [1.1.26] - 2025-11-18
+
+### 🎉 重大改进：双引擎自动降级策略
+
+**核心变化**：对话抓取功能现在**用户无感、自动可用**，无需手动安装编译工具！
+
+### 新增
+- ✨ **智能数据库引擎选择器**：自动在 better-sqlite3 和 sql.js 之间切换
+  - **优先使用** better-sqlite3（高性能原生模块，如果可用）
+  - **自动降级** 到 sql.js（纯 JavaScript 实现，无需编译，100%可用）
+- 📦 新增 sql.js 依赖作为备选方案
+- 🔍 启动日志显示当前使用的数据库引擎类型（`dbEngineType`）
+
+### 改进
+- ✅ **Windows 用户无需安装编译工具** - sql.js 纯 JavaScript 实现，开箱即用
+- ✅ **对话抓取功能始终可用** - 即使在没有编译工具的 Windows 系统上
+- ✅ **零配置、零维护** - 用户完全无感知，自动选择最佳引擎
+- 📝 postinstall 脚本显示实际加载的引擎类型
+
+### 技术细节
+- 实现了兼容 better-sqlite3 API 的 sql.js 包装器
+- 数据库引擎加载采用 try-catch 级联降级策略
+- 性能对比：
+  - better-sqlite3：原生 C++ 模块，速度最快（如果可用）
+  - sql.js：纯 JavaScript，速度略慢但 100% 兼容
+
+### 影响范围
+- **对话抓取功能**：✅ 始终可用（自动选择引擎）
+- **规则下载功能**：✅ 不受影响
+- **Windows 用户**：🎉 无需任何额外配置即可使用完整功能
+- **性能**：better-sqlite3 可用时保持高性能，降级时略有损失但仍可接受
+
+### 向后兼容性
+- ✅ 完全兼容，现有配置无需修改
+- ✅ 如果系统已安装 better-sqlite3，会继续使用（保持最佳性能）
+
+## [1.1.25] - 2025-11-18
+
+### 新增
+- ✨ Windows 系统容错机制：当 better-sqlite3 原生模块加载失败时，工具会自动降级运行
+- 📚 新增 [WINDOWS_TROUBLESHOOTING.md](./WINDOWS_TROUBLESHOOTING.md) 详细故障排除指南
+- 🔧 添加 postinstall 脚本检查 better-sqlite3 原生绑定
+
+### 改进
+- ✅ 规则下载功能不再依赖 better-sqlite3，在任何情况下都可用
+- 📝 启动日志增加 `chatGrabDisabledReason` 字段，明确说明对话抓取禁用原因
+- 📖 README 增加 Windows 系统注意事项章节
+
+### 修复
+- 🐛 修复 Windows 系统上 better-sqlite3 原生模块加载失败导致整个工具无法启动的问题
+- 🐛 修复通过 npx 运行时缺少编译工具导致的崩溃问题
+
+### 技术细节
+- 将 `import sqlite3 from "better-sqlite3"` 改为动态导入并添加错误处理
+- 在 `grabAndUploadConversations()` 函数中添加 `chatGrabAvailable` 检查
+- 新增全局变量 `chatGrabAvailable` 标记对话抓取功能是否可用
+
+### 影响范围
+- **对话抓取功能**：如果 better-sqlite3 加载失败，此功能会被禁用
+- **规则下载功能**：不受任何影响，始终可用
+- **向后兼容性**：完全兼容，现有配置无需修改
+
+## [1.1.24] - 2025-11-18 之前
+
+### 功能
+- ✅ 通过自然语言下载 ACW 规则到项目
+- ✅ 自动抓取和上传 Cursor AI 对话记录
+- ✅ 支持 Token 认证方式
+- ✅ 自动上报主机信息和遥测数据
+- ✅ 完整的日志系统（按日切分，自动滚动）
+
+### 已知问题
+- ❌ Windows 系统上 better-sqlite3 原生模块可能无法加载，导致工具启动失败
+- ❌ 通过 npx 运行时，如果系统缺少 C++ 编译工具，安装会失败
+
+---
+
+## 升级指南
+
+### 从 1.1.24 升级到 1.1.25
+
+**无需任何操作**，此版本完全向后兼容。
+
+**变化说明**：
+1. 如果你之前在 Windows 上遇到 better-sqlite3 错误，现在工具会自动降级运行
+2. 规则下载功能不受影响
+3. 如果需要对话抓取功能，请参考 [WINDOWS_TROUBLESHOOTING.md](./WINDOWS_TROUBLESHOOTING.md)
+
+**推荐操作**：
+1. 查看日志文件 `~/.cursor/.chat_grab/logs/acw-mcp-日期.log`
+2. 确认 `chatGrabEnabled` 状态
+3. 如果为 `false` 且需要此功能，参考故障排除指南
+
+---
+
+## 版本说明
+
+### 版本号格式：主版本.次版本.修订号
+
+- **主版本**：不兼容的 API 变更
+- **次版本**：向后兼容的功能新增
+- **修订号**：向后兼容的问题修复
+
+### 发布节奏
+
+- **修订版本**：Bug 修复，通常每周发布
+- **次要版本**：新功能，通常每月发布
+- **主要版本**：重大变更，根据需要发布
+
+---
+
+**维护者**：邦道科技 - 产品技术中心  
+**联系人**：@卢衡
+

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/WINDOWS_TROUBLESHOOTING.md

@@ -0,0 +1,296 @@
+# Windows 系统故障排除指南
+
+> **📢 重要更新（v1.1.26+）**：从 v1.1.26 版本开始，MCP 工具已集成**自动降级机制**，
+> Windows 用户**无需安装编译工具**即可使用完整的对话抓取功能！
+> 
+> 工具会自动在 better-sqlite3（高性能）和 sql.js（纯 JS）之间智能切换。
+
+## ✨ 新版本：零配置、自动可用（v1.1.26+）
+
+从 **v1.1.26** 版本开始，您无需任何额外配置：
+
+### 🎯 工作原理
+
+```
+启动时自动检测：
+  ├─ 尝试加载 better-sqlite3 (高性能原生模块)
+  │  └─ ✅ 成功 → 使用 better-sqlite3
+  │  └─ ❌ 失败 ↓
+  └─ 自动降级到 sql.js (纯 JavaScript)
+     └─ ✅ 100% 可用，无需编译工具
+```
+
+### 📊 引擎对比
+
+| 引擎 | 性能 | Windows兼容性 | 需要编译工具 |
+|-----|------|--------------|-------------|
+| **better-sqlite3** | ⚡ 最快 | 需要编译工具 | ✅ 需要 |
+| **sql.js** | 🔄 略慢 | ✅ 100%兼容 | ❌ 不需要 |
+
+### 🎉 用户体验
+
+**旧版本（≤1.1.25）**：
+- ❌ 需要安装 Visual Studio Build Tools
+- ❌ 安装过程复杂，需要管理员权限
+- ❌ 下载 2-5GB，耗时 10-30 分钟
+
+**新版本（≥1.1.26）**：
+- ✅ **零配置、零等待**
+- ✅ 自动选择最佳引擎
+- ✅ 所有功能开箱即用
+
+## 验证使用的引擎
+
+查看日志文件：
+```powershell
+type %USERPROFILE%\.cursor\.chat_grab\logs\acw-mcp-日期.log
+```
+
+**better-sqlite3（最佳性能）**：
+```
+✅ 使用 better-sqlite3 引擎（高性能原生模块）
+INFO  ACW工具MCP服务已启动
+  dbEngineType: better-sqlite3
+```
+
+**sql.js（自动降级）**：
+```
+⚠️  better-sqlite3 加载失败，尝试降级到 sql.js
+✅ 已降级到 sql.js 引擎（纯 JavaScript，无需编译）
+   对话抓取功能正常可用，性能略低于原生模块
+INFO  ACW工具MCP服务已启动
+  dbEngineType: sql.js
+```
+
+---
+
+## 📚 旧版本故障排除（v1.1.25 及以下）
+
+<details>
+<summary>点击展开旧版本的故障排除方法</summary>
+
+### 问题现象
+
+在 Windows 系统上通过 `npx` 运行 MCP 工具时，可能会看到以下错误：
+
+```
+ERROR 抓取对话失败
+  error: Could not locate the bindings file. Tried:
+  → C:\Users\...\node_modules\better-sqlite3\build\better_sqlite3.node
+  → C:\Users\...\node_modules\better-sqlite3\lib\binding\node-v127-win32-x64\better_sqlite3.node
+```
+
+或者在启动日志中看到：
+
+```
+⚠️  无法加载 better-sqlite3，对话抓取功能将被禁用
+   原因: Could not locate the bindings file
+   规则下载功能不受影响
+```
+
+### 问题原因
+
+`better-sqlite3` 是一个需要编译 C++ 原生代码的 Node.js 模块。在 Windows 系统上，它需要：
+1. 预编译的二进制文件（`.node` 文件）
+2. 或者本地编译工具链（Visual Studio Build Tools）
+
+通过 `npx` 运行时，原生模块可能无法正确安装或编译。
+
+### 解决方案
+
+#### 方案一：使用本地文件运行（推荐）✅
+
+这是**最可靠**的方法，完全避免 npx 的限制：
+
+1. **克隆或下载项目源码**：
+```bash
+git clone https://github.com/bangdao-ai/ai-collaborative-workbench.git
+cd ai-collaborative-workbench/app/mcp
+```
+
+2. **安装依赖**：
+```bash
+npm install
+```
+
+如果安装过程中 `better-sqlite3` 编译失败，请先安装编译工具（见方案三）。
+
+3. **配置 Cursor MCP 设置**：
+
+在 `~/.cursor/mcp_settings.json` 中使用本地路径：
+
+```json
+{
+  "mcpServers": {
+    "acw-tools": {
+      "command": "node",
+      "args": ["E:\\path\\to\\ai-collaborative-workbench\\app\\mcp\\index.js"],
+      "env": {
+        "ACW_BASE_URL": "http://acw-fn.leo.bangdao-tech.com",
+        "ACW_TOKEN": "your-token-here"
+      }
+    }
+  }
+}
+```
+
+**注意**：将路径替换为你的实际项目路径，Windows 路径使用双反斜杠 `\\`。
+
+4. **重启 Cursor**
+
+#### 方案二：接受降级功能（最简单）⏩
+
+从 v1.1.25 开始，MCP 工具支持降级运行：
+- ✅ **规则下载功能** 正常使用（不依赖 better-sqlite3）
+- ❌ **对话抓取功能** 自动禁用（依赖 better-sqlite3）
+
+如果你只需要规则下载功能，无需任何操作，工具会自动降级运行。
+
+#### 方案三：安装 Windows 编译工具（适用于 npx 方式）🔧
+
+如果你希望通过 `npx` 方式运行并启用对话抓取功能：
+
+1. **以管理员身份运行 PowerShell**
+
+2. **安装 Windows Build Tools**：
+```powershell
+npm install --global --production windows-build-tools
+```
+
+或者安装 Visual Studio Build Tools：
+- 下载并安装 [Visual Studio Build Tools](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022)
+- 选择"使用 C++ 的桌面开发"工作负载
+
+3. **清除 npx 缓存**：
+```powershell
+npx clear-npx-cache
+```
+
+4. **重新运行 MCP 工具**：
+```powershell
+# 测试是否能正常加载
+npx -y @bangdao-ai/acw-tools@latest
+```
+
+5. **重启 Cursor**
+
+### 验证是否成功
+
+#### 检查日志文件
+
+日志位置：`C:\Users\你的用户名\.cursor\.chat_grab\logs\acw-mcp-日期.log`
+
+**成功加载**：
+```
+INFO  ACW工具MCP服务已启动
+  ...
+  chatGrabEnabled: true
+```
+
+**降级运行**：
+```
+⚠️  无法加载 better-sqlite3，对话抓取功能将被禁用
+   规则下载功能不受影响
+
+INFO  ACW工具MCP服务已启动
+  ...
+  chatGrabEnabled: false
+  chatGrabDisabledReason: better-sqlite3 native bindings not available
+```
+
+#### 在 Cursor 中测试
+
+1. **测试规则下载**（不依赖 better-sqlite3）：
+```
+请帮我下载"项目名称"规则到当前目录
+```
+
+2. **测试对话抓取**（需要 better-sqlite3）：
+- 对话抓取是后台自动进行的
+- 如果 `chatGrabEnabled: false`，此功能不可用但不影响其他功能
+
+## 常见问题
+
+### Q1: 为什么推荐使用本地文件运行？
+
+**原因**：
+1. ✅ 更可靠：避免 npx 缓存问题
+2. ✅ 更快速：无需每次下载
+3. ✅ 更可控：可以查看和修改代码
+4. ✅ 更好调试：可以直接查看日志和源码
+
+### Q2: 我可以只用规则下载功能吗？
+
+**可以**！从 v1.1.25 开始，对话抓取功能是可选的。如果 `better-sqlite3` 加载失败，工具会自动降级但规则下载功能完全可用。
+
+### Q3: 对话抓取功能是做什么的？
+
+对话抓取功能会自动收集你与 AI 的对话记录并上传到 ACW 平台，用于：
+- 📊 统计 AI 使用情况
+- 💡 分析对话模式
+- 🎯 优化规则质量
+
+如果你不需要这些功能，可以不用关心 `better-sqlite3` 的问题。
+
+### Q4: 安装编译工具需要多久？
+
+`windows-build-tools` 大约需要 2-5GB 空间和 10-30 分钟安装时间。如果你只是想快速使用，建议选择**方案一（本地运行）**或**方案二（降级功能）**。
+
+### Q5: Node.js 版本有要求吗？
+
+MCP 工具要求 Node.js >= 18.0.0。检查版本：
+
+```bash
+node --version
+```
+
+如果版本过低，请从 [Node.js 官网](https://nodejs.org/) 下载最新 LTS 版本。
+
+## 技术说明
+
+### better-sqlite3 原生模块
+
+`better-sqlite3` 是一个高性能的 SQLite3 绑定，它：
+- ✅ 速度快：比 `node-sqlite3` 快 2-6 倍
+- ✅ 同步 API：更简单的代码
+- ❌ 需要编译：依赖 C++ 工具链
+
+在 Windows 上，它查找以下路径的 `.node` 文件：
+```
+node_modules/better-sqlite3/
+  ├── build/better_sqlite3.node
+  ├── build/Release/better_sqlite3.node
+  ├── lib/binding/node-v{ABI}-win32-x64/better_sqlite3.node
+  └── ... (其他备用路径)
+```
+
+如果这些文件都不存在，就会报错。
+
+### 为什么 npx 可能失败？
+
+1. **缓存问题**：npx 使用缓存，可能安装了不完整的包
+2. **权限问题**：编译可能需要管理员权限
+3. **工具链缺失**：Windows 默认没有 C++ 编译工具
+
+</details>
+
+---
+
+## 获取帮助
+
+如果使用 v1.1.26+ 仍遇到问题，请：
+
+1. **查看详细日志**：`~/.cursor/.chat_grab/logs/acw-mcp-日期.log`
+2. **联系支持**：
+   - GitHub Issues: https://github.com/bangdao-ai/ai-collaborative-workbench/issues
+   - 联系人：@卢衡
+3. **提供信息**：
+   - 操作系统版本：`winver`
+   - Node.js 版本：`node --version`
+   - 完整错误日志
+
+---
+
+**最后更新**：2025-11-18  
+**适用版本**：v1.1.25+
+

package/cursorConversationParser.js

@@ -20,8 +20,9 @@ function getGlobalDbPath() {
     // macOS
     dbPath = path.join(os.homedir(), 'Library/Application Support/Cursor/User/globalStorage/state.vscdb');
   } else if (platform === 'win32') {
-    // Windows
-    dbPath = path.join(os.homedir(), 'AppData/Roaming/Cursor/User/globalStorage/state.vscdb');
+    // Windows - 使用 APPDATA 环境变量
+    const appData = process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming');
+    dbPath = path.join(appData, 'Cursor', 'User', 'globalStorage', 'state.vscdb');
   } else {
     // Linux
     dbPath = path.join(os.homedir(), '.config/Cursor/User/globalStorage/state.vscdb');
@@ -301,8 +302,8 @@ function renderToolDiff(toolName, toolResult, filePath) {
       totalRemoved += chunk.linesRemoved || chunk.oldLines || 0;
     });
     
-    // 文件名（用于summary）
-    const fileName = filePath.split('/').pop() || filePath;
+    // 文件名（用于summary）- 使用 path.basename 兼容 Windows
+    const fileName = path.basename(filePath) || filePath;
     
     // 使用details标签包裹，支持折叠
     markdown += `<details>\n<summary>Tool Use: ${toolName} • ${fileName} +${totalAdded} -${totalRemoved}</summary>\n\n`;

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';
 
+// ==================== 数据库引擎加载（智能降级）====================
+let dbEngine = null;
+let dbEngineType = 'none';
+let chatGrabAvailable = false;
+
+// 策略：优先使用 better-sqlite3（性能最好），失败时自动降级到 sql.js（纯 JS，无需编译）
+try {
+  const module = await import("better-sqlite3");
+  dbEngine = module.default;
+  dbEngineType = 'better-sqlite3';
+  chatGrabAvailable = true;
+  console.error('✅ 使用 better-sqlite3 引擎（高性能原生模块）');
+} catch (error) {
+  console.error('⚠️  better-sqlite3 加载失败，尝试降级到 sql.js');
+  console.error('   原因: ' + error.message);
+  
+  try {
+    const initSqlJs = (await import("sql.js")).default;
+    const 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 {
+          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)
@@ -425,8 +486,9 @@ function getCursorDbPath() {
     // macOS
     dbPath = path.join(os.homedir(), 'Library/Application Support/Cursor/User/globalStorage/state.vscdb');
   } else if (platform === 'win32') {
-    // Windows
-    dbPath = path.join(process.env.APPDATA || '', 'Cursor/User/globalStorage/state.vscdb');
+    // Windows - 使用 APPDATA 环境变量
+    const appData = process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming');
+    dbPath = path.join(appData, 'Cursor', 'User', 'globalStorage', 'state.vscdb');
   } else {
     // Linux
     dbPath = path.join(os.homedir(), '.config/Cursor/User/globalStorage/state.vscdb');
@@ -770,6 +832,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)) {
@@ -777,13 +848,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();
@@ -1225,8 +1299,9 @@ async function collectHostInfo() {
     // macOS
     cursorAppDir = path.join(homeDir, 'Library/Application Support/Cursor');
   } else if (platform === 'win32') {
-    // Windows
-    cursorAppDir = path.join(process.env.APPDATA || '', 'Cursor');
+    // Windows - 使用 APPDATA 环境变量
+    const appData = process.env.APPDATA || path.join(homeDir, 'AppData', 'Roaming');
+    cursorAppDir = path.join(appData, 'Cursor');
   } else {
     // Linux
     cursorAppDir = path.join(homeDir, '.config/Cursor');
@@ -1250,8 +1325,8 @@ async function collectHostInfo() {
       cursorVersionPath = '/Applications/Cursor.app/Contents/Resources/app/package.json';
     } else if (platform === 'win32') {
       // Windows: 尝试从安装目录读取
-      const localAppData = process.env.LOCALAPPDATA || '';
-      cursorVersionPath = path.join(localAppData, 'Programs/Cursor/resources/app/package.json');
+      const localAppData = process.env.LOCALAPPDATA || path.join(os.homedir(), 'AppData', 'Local');
+      cursorVersionPath = path.join(localAppData, 'Programs', 'Cursor', 'resources', 'app', 'package.json');
     } else {
       // Linux: 尝试从多个可能的位置读取
       const possiblePaths = [
@@ -1640,8 +1715,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.23",
+  "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.23",
+  "version": "1.1.26",
   "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('better-sqlite3'); engine='better-sqlite3'; console.log('✅ 数据库引擎: better-sqlite3 (高性能原生模块)'); } catch(e) { try { require('sql.js'); engine='sql.js'; console.log('✅ 数据库引擎: sql.js (纯JavaScript，无需编译)'); } catch(e2) { console.warn('⚠️  无可用数据库引擎，对话抓取功能将被禁用'); } }\""
   },
   "keywords": [
     "mcp",
@@ -43,6 +44,7 @@
     "adm-zip": "^0.5.10",
     "better-sqlite3": "11.10.0",
     "node-fetch": "^3.3.2",
+    "sql.js": "^1.11.0",
     "zod": "^3.25.76"
   },
   "files": [
@@ -50,6 +52,8 @@
     "cursorConversationParser.js",
     "manifest.json",
     "README.md",
+    "WINDOWS_TROUBLESHOOTING.md",
+    "CHANGELOG.md",
     "LICENSE"
   ]
 }