6a-spec-install 1.0.1-dev.1 → 1.0.1-dev.3

package/README.md

@@ -7,19 +7,32 @@
 ### 安装
 
 ```bash
-# 安装 Cursor 配置（默认）
+# 安装 Cursor 配置（默认，完全覆盖模式）
 npx 6a-spec-install
 
-# 安装 Cursor 配置
-npx 6a-spec-install --tool cursor
+# 智能合并模式（推荐，保留用户自定义文件）
+npx 6a-spec-install --tool cursor --merge
 
-# 安装 Claude 配置
-npx 6a-spec-install --tool claude
+# 安装 Claude 配置（合并模式）
+npx 6a-spec-install --tool claude --merge
 
 # 同时安装两种工具
-npx 6a-spec-install --tool all
+npx 6a-spec-install --tool all --merge
 ```
 
+### 安装模式
+
+#### 完全覆盖模式（默认）
+- 会先备份现有配置到 `.cursor.backup.时间戳`
+- 完全覆盖目标目录
+- 适合首次安装或需要完全重置配置
+
+#### 智能合并模式（`--merge`）
+- **只更新包中存在的文件**，保留用户新增的自定义文件
+- 不会创建备份（因为不会删除文件）
+- 适合更新配置时保留自定义修改
+- 会显示更新和新增的文件统计
+
 ### 全局安装（可选）
 
 ```bash
@@ -33,7 +46,8 @@ npm install -g 6a-spec-install
 
 - ✅ 支持 Cursor IDE
 - ✅ 支持 Claude Desktop
-- ✅ 自动备份现有配置
+- ✅ 智能合并模式：保留用户自定义文件，只更新包中文件
+- ✅ 完全覆盖模式：自动备份现有配置后完全覆盖
 - ✅ 一键安装，开箱即用
 
 ## 目录结构
@@ -52,10 +66,18 @@ npm install -g 6a-spec-install
 ## 更新
 
 ```bash
-# 更新到最新版本
+# 更新到最新版本（智能合并，推荐）
+npx 6a-spec-install@latest --tool cursor --merge
+
+# 更新到最新版本（完全覆盖）
 npx 6a-spec-install@latest --tool cursor
 ```
 
+**推荐使用 `--merge` 模式**，这样可以：
+- 保留你在 `.cursor/` 目录中自定义的文件
+- 只更新包中提供的文件
+- 不会丢失你的个性化配置
+
 ## 开发
 
 ### 本地测试

package/bin/6a-spec-install

@@ -7,6 +7,7 @@ const installer = require('../lib/installer');
 const args = process.argv.slice(2);
 let tool = 'cursor';
 let help = false;
+let mergeMode = false;
 
 for (let i = 0; i < args.length; i++) {
   const arg = args[i];
@@ -14,6 +15,8 @@ for (let i = 0; i < args.length; i++) {
     tool = args[++i] || 'cursor';
   } else if (arg === '--help' || arg === '-h') {
     help = true;
+  } else if (arg === '--merge' || arg === '-m') {
+    mergeMode = true;
   }
 }
 
@@ -26,13 +29,14 @@ if (help) {
 
 选项:
   --tool, -t TOOL    安装目标工具 (cursor/claude/all, 默认: cursor)
+  --merge, -m        智能合并模式（保留用户自定义文件，只更新包中文件）
   --help, -h         显示帮助信息
 
 示例:
-  npx 6a-spec-install --tool cursor    # 只安装 Cursor 配置
-  npx 6a-spec-install --tool claude    # 只安装 Claude 配置
-  npx 6a-spec-install --tool all       # 安装两种工具配置
-  npx 6a-spec-install                  # 默认安装 Cursor 配置
+  npx 6a-spec-install --tool cursor           # 完全覆盖模式（会先备份）
+  npx 6a-spec-install --tool cursor --merge   # 智能合并模式（保留自定义文件）
+  npx 6a-spec-install --tool claude --merge   # 安装 Claude 配置（合并模式）
+  npx 6a-spec-install --tool all              # 安装两种工具配置
 
 支持的工具:
   cursor  - 安装 Cursor IDE 的提示词配置
@@ -43,7 +47,7 @@ if (help) {
 }
 
 // 执行安装
-installer.install(tool).catch(err => {
+installer.install(tool, mergeMode).catch(err => {
   console.error('❌ 安装失败:', err.message);
   process.exit(1);
 });

package/lib/installer.js

@@ -6,6 +6,7 @@ class Installer {
     // 获取包目录（安装后）
     this.packageDir = this.findPackageDir();
     this.targetDir = process.cwd();
+    this.mergeMode = false; // 合并模式标志
   }
 
   // 查找包目录（支持本地开发和 npm 安装）
@@ -50,24 +51,98 @@ class Installer {
     return null;
   }
 
-  // 递归复制目录
+  // 递归删除目录
+  removeDir(dirPath) {
+    if (fs.existsSync(dirPath)) {
+      const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+      for (const entry of entries) {
+        const fullPath = path.join(dirPath, entry.name);
+        if (entry.isDirectory()) {
+          this.removeDir(fullPath);
+        } else {
+          fs.unlinkSync(fullPath);
+        }
+      }
+      fs.rmdirSync(dirPath);
+    }
+  }
+
+  // 递归复制目录（完全覆盖模式）
   copyDir(src, dest) {
+    // 如果目标目录存在，先完全删除（确保完全覆盖）
+    if (fs.existsSync(dest)) {
+      this.removeDir(dest);
+    }
+    
+    // 重新创建目录并复制
+    fs.mkdirSync(dest, { recursive: true });
+
+    const entries = fs.readdirSync(src, { withFileTypes: true });
+
+    for (const entry of entries) {
+      const srcPath = path.join(src, entry.name);
+      const destPath = path.join(dest, entry.name);
+
+      if (entry.isDirectory()) {
+        this.copyDir(srcPath, destPath);
+      } else {
+        fs.copyFileSync(srcPath, destPath);
+      }
+    }
+  }
+
+  // 智能合并目录（只更新包中存在的文件，保留用户自定义文件）
+  mergeDir(src, dest) {
     if (!fs.existsSync(dest)) {
       fs.mkdirSync(dest, { recursive: true });
     }
 
     const entries = fs.readdirSync(src, { withFileTypes: true });
+    let updatedCount = 0;
+    let addedCount = 0;
 
     for (const entry of entries) {
       const srcPath = path.join(src, entry.name);
       const destPath = path.join(dest, entry.name);
 
       if (entry.isDirectory()) {
-        this.copyDir(srcPath, destPath);
+        const result = this.mergeDir(srcPath, destPath);
+        updatedCount += result.updated;
+        addedCount += result.added;
       } else {
+        const exists = fs.existsSync(destPath);
         fs.copyFileSync(srcPath, destPath);
+        if (exists) {
+          updatedCount++;
+        } else {
+          addedCount++;
+        }
+      }
+    }
+
+    return { updated: updatedCount, added: addedCount };
+  }
+
+  // 获取目录中所有文件的相对路径列表
+  getAllFiles(dir, baseDir = dir) {
+    const files = [];
+    if (!fs.existsSync(dir)) {
+      return files;
+    }
+
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = path.join(dir, entry.name);
+      const relativePath = path.relative(baseDir, fullPath);
+
+      if (entry.isDirectory()) {
+        files.push(...this.getAllFiles(fullPath, baseDir));
+      } else {
+        files.push(relativePath);
       }
     }
+
+    return files;
   }
 
   // 安装 Cursor 配置
@@ -81,10 +156,35 @@ class Installer {
       throw new Error('未找到 .cursor 源目录');
     }
 
-    this.backupDir(targetDir);
+    const targetExists = fs.existsSync(targetDir);
     
-    this.log('复制 Cursor 配置文件...');
-    this.copyDir(sourceDir, targetDir);
+    if (this.mergeMode && targetExists) {
+      // 智能合并模式
+      this.log('使用智能合并模式（保留用户自定义文件）...');
+      
+      // 统计用户自定义文件
+      const sourceFiles = new Set(this.getAllFiles(sourceDir, sourceDir));
+      const targetFiles = this.getAllFiles(targetDir, targetDir);
+      const customFiles = targetFiles.filter(f => !sourceFiles.has(f));
+      
+      if (customFiles.length > 0) {
+        this.log(`检测到 ${customFiles.length} 个用户自定义文件，将保留`, 'info');
+      }
+      
+      const result = this.mergeDir(sourceDir, targetDir);
+      this.log(`更新了 ${result.updated} 个文件，新增了 ${result.added} 个文件`, 'info');
+      
+      if (customFiles.length > 0) {
+        this.log(`保留了 ${customFiles.length} 个用户自定义文件`, 'info');
+      }
+    } else {
+      // 完全覆盖模式
+      if (targetExists) {
+        this.backupDir(targetDir);
+      }
+      this.log('复制 Cursor 配置文件...');
+      this.copyDir(sourceDir, targetDir);
+    }
     
     this.log('✓ Cursor 配置安装完成！', 'success');
   }
@@ -100,44 +200,90 @@ class Installer {
       throw new Error('未找到源配置目录');
     }
 
-    this.backupDir(targetDir);
-    
-    this.log('转换并复制 Claude 配置文件...');
+    const targetExists = fs.existsSync(targetDir);
     
     // 创建目标目录结构
     if (!fs.existsSync(targetDir)) {
       fs.mkdirSync(targetDir, { recursive: true });
     }
 
-    // 复制 commands 到 prompts
-    const commandsDir = path.join(sourceDir, 'commands');
-    if (fs.existsSync(commandsDir)) {
-      const promptsDir = path.join(targetDir, 'prompts');
-      this.copyDir(commandsDir, promptsDir);
-    }
+    if (this.mergeMode && targetExists) {
+      // 智能合并模式
+      this.log('使用智能合并模式（保留用户自定义文件）...');
+      
+      // 复制 commands 到 prompts
+      const commandsDir = path.join(sourceDir, 'commands');
+      if (fs.existsSync(commandsDir)) {
+        const promptsDir = path.join(targetDir, 'prompts');
+        const result = this.mergeDir(commandsDir, promptsDir);
+        if (result.updated > 0 || result.added > 0) {
+          this.log(`prompts: 更新了 ${result.updated} 个文件，新增了 ${result.added} 个文件`, 'info');
+        }
+      }
 
-    // 复制 rules
-    const rulesDir = path.join(sourceDir, 'rules');
-    if (fs.existsSync(rulesDir)) {
-      const targetRulesDir = path.join(targetDir, 'rules');
-      this.copyDir(rulesDir, targetRulesDir);
-    }
+      // 复制 rules
+      const rulesDir = path.join(sourceDir, 'rules');
+      if (fs.existsSync(rulesDir)) {
+        const targetRulesDir = path.join(targetDir, 'rules');
+        const result = this.mergeDir(rulesDir, targetRulesDir);
+        if (result.updated > 0 || result.added > 0) {
+          this.log(`rules: 更新了 ${result.updated} 个文件，新增了 ${result.added} 个文件`, 'info');
+        }
+      }
 
-    // 复制 scripts
-    const scriptDir = path.join(sourceDir, 'script');
-    if (fs.existsSync(scriptDir)) {
-      const targetScriptDir = path.join(targetDir, 'script');
-      this.copyDir(scriptDir, targetScriptDir);
+      // 复制 scripts
+      const scriptDir = path.join(sourceDir, 'script');
+      if (fs.existsSync(scriptDir)) {
+        const targetScriptDir = path.join(targetDir, 'script');
+        const result = this.mergeDir(scriptDir, targetScriptDir);
+        if (result.updated > 0 || result.added > 0) {
+          this.log(`script: 更新了 ${result.updated} 个文件，新增了 ${result.added} 个文件`, 'info');
+        }
+      }
+    } else {
+      // 完全覆盖模式
+      if (targetExists) {
+        this.backupDir(targetDir);
+      }
+      this.log('转换并复制 Claude 配置文件...');
+      
+      // 复制 commands 到 prompts
+      const commandsDir = path.join(sourceDir, 'commands');
+      if (fs.existsSync(commandsDir)) {
+        const promptsDir = path.join(targetDir, 'prompts');
+        this.copyDir(commandsDir, promptsDir);
+      }
+
+      // 复制 rules
+      const rulesDir = path.join(sourceDir, 'rules');
+      if (fs.existsSync(rulesDir)) {
+        const targetRulesDir = path.join(targetDir, 'rules');
+        this.copyDir(rulesDir, targetRulesDir);
+      }
+
+      // 复制 scripts
+      const scriptDir = path.join(sourceDir, 'script');
+      if (fs.existsSync(scriptDir)) {
+        const targetScriptDir = path.join(targetDir, 'script');
+        this.copyDir(scriptDir, targetScriptDir);
+      }
     }
     
     this.log('✓ Claude 配置安装完成！', 'success');
   }
 
   // 主安装方法
-  async install(tool = 'cursor') {
+  async install(tool = 'cursor', mergeMode = false) {
+    this.mergeMode = mergeMode;
+    
     this.log(`6A-spec 安装工具`);
     this.log(`目标目录: ${this.targetDir}`);
     this.log(`工具: ${tool}`);
+    if (mergeMode) {
+      this.log(`模式: 智能合并（保留用户自定义文件）`, 'info');
+    } else {
+      this.log(`模式: 完全覆盖（会先备份现有配置）`, 'info');
+    }
 
     try {
       switch (tool.toLowerCase()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "6a-spec-install",
-  "version": "1.0.1-dev.1",
+  "version": "1.0.1-dev.3",
   "description": "6A-spec 驱动开发提示词安装工具，支持 Cursor 和 Claude",
   "main": "lib/installer.js",
   "bin": {