@adversity/coding-tool-x 2.3.0 → 2.4.1

package/src/commands/export-config.js

@@ -0,0 +1,205 @@
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const archiver = require('archiver');
+const chalk = require('chalk');
+
+/**
+ * 导出 Claude Code 配置为 ZIP 压缩包
+ * 包含：全局 CLAUDE.md、项目 CLAUDE.md、settings.json、MCP 服务器配置、Skills 等
+ */
+async function exportConfig(options = {}) {
+  const { output = 'claude-config.zip', includeProjects = true } = options;
+
+  try {
+    console.log(chalk.blue('🚀 开始导出 Claude Code 配置...'));
+
+    const homeDir = os.homedir();
+    const claudeDir = path.join(homeDir, '.claude');
+    const currentDir = process.cwd();
+
+    // 检查 .claude 目录是否存在
+    if (!fs.existsSync(claudeDir)) {
+      console.log(chalk.red('❌ 未找到 .claude 配置目录'));
+      return;
+    }
+
+    // 创建输出文件流
+    const outputPath = path.resolve(currentDir, output);
+    const outputStream = fs.createWriteStream(outputPath);
+    const archive = archiver('zip', { zlib: { level: 9 } });
+
+    // 监听错误
+    archive.on('error', (err) => {
+      throw err;
+    });
+
+    // 监听完成
+    archive.on('end', () => {
+      console.log(chalk.green(`\n✅ 配置导出成功！`));
+      console.log(chalk.gray(`   文件位置: ${outputPath}`));
+      console.log(chalk.gray(`   文件大小: ${(archive.pointer() / 1024 / 1024).toFixed(2)} MB`));
+    });
+
+    // 连接流
+    archive.pipe(outputStream);
+
+    // 收集配置清单
+    const manifest = {
+      exportTime: new Date().toISOString(),
+      version: '1.0.0',
+      globalConfig: {},
+      projectConfig: {},
+      enabledConfigs: []
+    };
+
+    // 1. 导出全局 CLAUDE.md
+    const globalClaudeMd = path.join(claudeDir, 'CLAUDE.md');
+    if (fs.existsSync(globalClaudeMd)) {
+      archive.file(globalClaudeMd, { name: 'global/CLAUDE.md' });
+      manifest.globalConfig.claudeMd = true;
+      manifest.enabledConfigs.push('global/CLAUDE.md');
+      console.log(chalk.gray('  ✓ 全局 CLAUDE.md'));
+    }
+
+    // 2. 导出 settings.json
+    const settingsJson = path.join(claudeDir, 'settings.json');
+    if (fs.existsSync(settingsJson)) {
+      archive.file(settingsJson, { name: 'global/settings.json' });
+      manifest.globalConfig.settings = true;
+      manifest.enabledConfigs.push('global/settings.json');
+      console.log(chalk.gray('  ✓ settings.json'));
+
+      // 解析 MCP 服务器配置
+      try {
+        const settings = JSON.parse(fs.readFileSync(settingsJson, 'utf-8'));
+        if (settings.mcpServers) {
+          manifest.globalConfig.mcpServers = Object.keys(settings.mcpServers);
+          console.log(chalk.gray(`    - MCP 服务器: ${manifest.globalConfig.mcpServers.join(', ')}`));
+        }
+        if (settings.hooks) {
+          manifest.globalConfig.hooks = Object.keys(settings.hooks);
+        }
+        if (settings.statusLine) {
+          manifest.globalConfig.statusLine = true;
+        }
+      } catch (e) {
+        console.log(chalk.yellow('    ⚠ settings.json 解析失败'));
+      }
+    }
+
+    // 3. 导出 Skills
+    const skillsDir = path.join(claudeDir, 'skills');
+    if (fs.existsSync(skillsDir)) {
+      const skills = fs.readdirSync(skillsDir).filter(f => !f.startsWith('.'));
+      if (skills.length > 0) {
+        archive.directory(skillsDir, 'global/skills');
+        manifest.globalConfig.skills = skills;
+        manifest.enabledConfigs.push('global/skills');
+        console.log(chalk.gray(`  ✓ Skills (${skills.length} 个)`));
+      }
+    }
+
+    // 4. 导出当前项目配置
+    if (includeProjects) {
+      // 项目级 CLAUDE.md
+      const projectClaudeMd = path.join(currentDir, 'CLAUDE.md');
+      if (fs.existsSync(projectClaudeMd)) {
+        archive.file(projectClaudeMd, { name: 'project/CLAUDE.md' });
+        manifest.projectConfig.claudeMd = true;
+        manifest.enabledConfigs.push('project/CLAUDE.md');
+        console.log(chalk.gray('  ✓ 项目 CLAUDE.md'));
+      }
+
+      // 项目级 settings.local.json
+      const projectSettings = path.join(currentDir, '.claude', 'settings.local.json');
+      if (fs.existsSync(projectSettings)) {
+        archive.file(projectSettings, { name: 'project/.claude/settings.local.json' });
+        manifest.projectConfig.settingsLocal = true;
+        manifest.enabledConfigs.push('project/.claude/settings.local.json');
+        console.log(chalk.gray('  ✓ 项目 settings.local.json'));
+      }
+
+      // 项目级 workspace CLAUDE.md
+      const workspaceClaudeMd = path.join(homeDir, 'workspace', 'CLAUDE.md');
+      if (fs.existsSync(workspaceClaudeMd)) {
+        archive.file(workspaceClaudeMd, { name: 'workspace/CLAUDE.md' });
+        manifest.projectConfig.workspaceClaudeMd = true;
+        manifest.enabledConfigs.push('workspace/CLAUDE.md');
+        console.log(chalk.gray('  ✓ workspace CLAUDE.md'));
+      }
+    }
+
+    // 5. 添加配置清单
+    archive.append(JSON.stringify(manifest, null, 2), { name: 'manifest.json' });
+    console.log(chalk.gray('  ✓ manifest.json'));
+
+    // 6. 添加 README
+    const readme = generateReadme(manifest);
+    archive.append(readme, { name: 'README.md' });
+    console.log(chalk.gray('  ✓ README.md'));
+
+    // 完成打包
+    await archive.finalize();
+
+  } catch (error) {
+    console.error(chalk.red('❌ 导出失败:'), error.message);
+    throw error;
+  }
+}
+
+/**
+ * 生成配置包说明文档
+ */
+function generateReadme(manifest) {
+  return `# Claude Code 配置包
+
+导出时间: ${new Date(manifest.exportTime).toLocaleString('zh-CN')}
+版本: ${manifest.version}
+
+## 📦 包含内容
+
+### 全局配置
+${manifest.globalConfig.claudeMd ? '- ✅ 全局 CLAUDE.md（AI 行为指令）' : ''}
+${manifest.globalConfig.settings ? '- ✅ settings.json（包含 MCP 服务器、Hooks 等）' : ''}
+${manifest.globalConfig.mcpServers ? `  - MCP 服务器: ${manifest.globalConfig.mcpServers.join(', ')}` : ''}
+${manifest.globalConfig.hooks ? `  - Hooks: ${manifest.globalConfig.hooks.join(', ')}` : ''}
+${manifest.globalConfig.skills ? `- ✅ Skills (${manifest.globalConfig.skills.length} 个): ${manifest.globalConfig.skills.join(', ')}` : ''}
+
+### 项目配置
+${manifest.projectConfig.claudeMd ? '- ✅ 项目 CLAUDE.md' : ''}
+${manifest.projectConfig.settingsLocal ? '- ✅ 项目 settings.local.json' : ''}
+${manifest.projectConfig.workspaceClaudeMd ? '- ✅ workspace CLAUDE.md' : ''}
+
+## 📥 如何导入
+
+### 方法 1：手动导入
+1. 解压此 ZIP 文件
+2. 复制 \`global/\` 内容到 \`~/.claude/\`
+3. 复制 \`project/\` 内容到你的项目目录
+4. 复制 \`workspace/\` 内容到 \`~/workspace/\`
+
+### 方法 2：使用命令（计划中）
+\`\`\`bash
+ctx import-config claude-config.zip
+\`\`\`
+
+## ⚠️ 注意事项
+
+1. **备份现有配置**：导入前请备份现有的 \`.claude\` 目录
+2. **敏感信息**：此配置包可能包含 API Keys、代理配置等敏感信息，请妥善保管
+3. **路径适配**：某些路径可能需要根据你的系统调整（如 hooks 中的脚本路径）
+4. **MCP 服务器**：需要确保目标环境已安装对应的 MCP 服务器
+
+## 📝 配置清单
+
+已启用的配置项：
+${manifest.enabledConfigs.map(c => `- ${c}`).join('\n')}
+
+---
+
+生成工具: Coding-Tool-X (ctx)
+`;
+}
+
+module.exports = { exportConfig };

package/src/config/default.js

@@ -3,7 +3,7 @@ const path = require('path');
 const os = require('os');
 
 const DEFAULT_CONFIG = {
-  projectsDir: path.join(os.homedir(), '.claude', 'ctx', 'projects'),
+  projectsDir: path.join(os.homedir(), '.claude', 'projects'),
   defaultProject: null,
   maxDisplaySessions: 100,
   pageSize: 15,

package/src/server/api/config-export.js

@@ -0,0 +1,122 @@
+/**
+ * 配置导出/导入 API 路由
+ */
+
+const express = require('express');
+const configExportService = require('../services/config-export-service');
+
+const router = express.Router();
+
+/**
+ * 导出所有配置
+ * GET /api/config-export
+ */
+router.get('/', (req, res) => {
+  try {
+    const result = configExportService.exportAllConfigs();
+
+    if (result.success) {
+      // 设置响应头，触发文件下载
+      const filename = `ctx-config-${new Date().toISOString().split('T')[0]}.json`;
+      res.setHeader('Content-Disposition', `attachment; filename="${filename}"`);
+      res.setHeader('Content-Type', 'application/json');
+      res.json(result.data);
+    } else {
+      res.status(500).json({
+        success: false,
+        message: result.message
+      });
+    }
+  } catch (err) {
+    console.error('[ConfigExport API] 导出失败:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
+/**
+ * 导入配置
+ * POST /api/config-export/import
+ * Body: { data: {...}, overwrite: boolean }
+ */
+router.post('/import', (req, res) => {
+  try {
+    const { data, overwrite = false } = req.body;
+
+    if (!data) {
+      return res.status(400).json({
+        success: false,
+        message: '缺少导入数据'
+      });
+    }
+
+    const result = configExportService.importConfigs(data, { overwrite });
+
+    res.json(result);
+  } catch (err) {
+    console.error('[ConfigExport API] 导入失败:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
+/**
+ * 预览导入配置（不实际导入）
+ * POST /api/config-export/preview
+ */
+router.post('/preview', (req, res) => {
+  try {
+    const { data } = req.body;
+
+    if (!data || !data.data) {
+      return res.status(400).json({
+        success: false,
+        message: '无效的导入数据格式'
+      });
+    }
+
+    const summary = {
+      version: data.version,
+      exportedAt: data.exportedAt,
+      counts: {
+        permissionTemplates: (data.data.permissionTemplates || []).length,
+        configTemplates: (data.data.configTemplates || []).length,
+        channels: (data.data.channels || []).length
+      },
+      items: {
+        permissionTemplates: (data.data.permissionTemplates || []).map(t => ({
+          id: t.id,
+          name: t.name,
+          description: t.description
+        })),
+        configTemplates: (data.data.configTemplates || []).map(t => ({
+          id: t.id,
+          name: t.name,
+          description: t.description
+        })),
+        channels: (data.data.channels || []).map(c => ({
+          id: c.id,
+          name: c.name,
+          type: c.type
+        }))
+      }
+    };
+
+    res.json({
+      success: true,
+      data: summary
+    });
+  } catch (err) {
+    console.error('[ConfigExport API] 预览失败:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
+module.exports = router;

package/src/server/api/config-sync.js

@@ -0,0 +1,155 @@
+/**
+ * 配置同步 API 路由
+ */
+
+const express = require('express');
+const { ConfigSyncService } = require('../services/config-sync-service');
+
+const router = express.Router();
+const configSyncService = new ConfigSyncService();
+
+/**
+ * 获取可同步的配置列表
+ * GET /api/config-sync/available
+ * Query: source=global|workspace, projectPath=...
+ */
+router.get('/available', (req, res) => {
+    try {
+        const { source = 'global', projectPath } = req.query;
+
+        if (source === 'workspace' && !projectPath) {
+            return res.status(400).json({
+                success: false,
+                message: '获取工作区配置需要指定 projectPath'
+            });
+        }
+
+        const configs = configSyncService.getAvailableConfigs(source, projectPath);
+
+        res.json({
+            success: true,
+            source,
+            configs
+        });
+    } catch (err) {
+        console.error('[ConfigSync API] Get available configs error:', err);
+        res.status(500).json({
+            success: false,
+            message: err.message
+        });
+    }
+});
+
+/**
+ * 获取同步统计信息
+ * GET /api/config-sync/stats
+ * Query: projectPath=...
+ */
+router.get('/stats', (req, res) => {
+    try {
+        const { projectPath } = req.query;
+        const stats = configSyncService.getStats(projectPath);
+
+        res.json({
+            success: true,
+            stats
+        });
+    } catch (err) {
+        console.error('[ConfigSync API] Get stats error:', err);
+        res.status(500).json({
+            success: false,
+            message: err.message
+        });
+    }
+});
+
+/**
+ * 预览同步结果
+ * POST /api/config-sync/preview
+ * Body: { source, target, configTypes, projectPath, selectedItems }
+ */
+router.post('/preview', (req, res) => {
+    try {
+        const { source, target, configTypes, projectPath, selectedItems } = req.body;
+
+        if (!source || !target) {
+            return res.status(400).json({
+                success: false,
+                message: '请指定源和目标'
+            });
+        }
+
+        if (!configTypes || configTypes.length === 0) {
+            return res.status(400).json({
+                success: false,
+                message: '请选择要同步的配置类型'
+            });
+        }
+
+        const preview = configSyncService.previewSync({
+            source,
+            target,
+            configTypes,
+            projectPath,
+            selectedItems
+        });
+
+        res.json({
+            success: true,
+            preview
+        });
+    } catch (err) {
+        console.error('[ConfigSync API] Preview sync error:', err);
+        res.status(500).json({
+            success: false,
+            message: err.message
+        });
+    }
+});
+
+/**
+ * 执行同步
+ * POST /api/config-sync/execute
+ * Body: { source, target, configTypes, projectPath, selectedItems, overwrite }
+ */
+router.post('/execute', (req, res) => {
+    try {
+        const { source, target, configTypes, projectPath, selectedItems, overwrite = false } = req.body;
+
+        if (!source || !target) {
+            return res.status(400).json({
+                success: false,
+                message: '请指定源和目标'
+            });
+        }
+
+        if (!configTypes || configTypes.length === 0) {
+            return res.status(400).json({
+                success: false,
+                message: '请选择要同步的配置类型'
+            });
+        }
+
+        const result = configSyncService.executeSync({
+            source,
+            target,
+            configTypes,
+            projectPath,
+            selectedItems,
+            overwrite
+        });
+
+        res.json({
+            success: true,
+            result
+        });
+    } catch (err) {
+        console.error('[ConfigSync API] Execute sync error:', err);
+        res.status(500).json({
+            success: false,
+            message: err.message
+        });
+    }
+});
+
+module.exports = router;

package/src/server/api/config-templates.js

@@ -139,7 +139,7 @@ router.delete('/:id', (req, res) => {
  */
 router.post('/:id/apply', (req, res) => {
   try {
-    const { targetPath, aiConfigType } = req.body;
+    const { targetPath, aiConfigType, aiConfigTypes } = req.body;
     if (!targetPath) {
       return res.status(400).json({
         success: false,
@@ -147,8 +147,11 @@ router.post('/:id/apply', (req, res) => {
       });
     }
     const options = {};
-    if (aiConfigType) {
-      options.aiConfigType = aiConfigType;
+    // 优先使用新的数组参数，兼容旧的单值参数
+    if (aiConfigTypes) {
+      options.aiConfigTypes = aiConfigTypes;
+    } else if (aiConfigType) {
+      options.aiConfigTypes = [aiConfigType];
     }
     const result = templatesService.applyTemplateToProject(targetPath, req.params.id, options);
     res.json({
@@ -170,7 +173,7 @@ router.post('/:id/apply', (req, res) => {
  */
 router.post('/:id/preview', (req, res) => {
   try {
-    const { targetPath, aiConfigType } = req.body;
+    const { targetPath, aiConfigType, aiConfigTypes } = req.body;
     if (!targetPath) {
       return res.status(400).json({
         success: false,
@@ -178,8 +181,11 @@ router.post('/:id/preview', (req, res) => {
       });
     }
     const options = {};
-    if (aiConfigType) {
-      options.aiConfigType = aiConfigType;
+    // 优先使用新的数组参数，兼容旧的单值参数
+    if (aiConfigTypes) {
+      options.aiConfigTypes = aiConfigTypes;
+    } else if (aiConfigType) {
+      options.aiConfigTypes = [aiConfigType];
     }
     const preview = templatesService.previewTemplateApplication(targetPath, req.params.id, options);
     res.json({

package/src/server/api/health-check.js

@@ -1,11 +1,6 @@
 const express = require('express');
 const router = express.Router();
-const {
-  healthCheckAllProjects,
-  scanLegacySessionFiles,
-  migrateSessionFiles,
-  cleanLegacySessionFiles
-} = require('../services/health-check');
+const { healthCheckAllProjects } = require('../services/health-check');
 const { getProjects } = require('../services/sessions');
 
 module.exports = (config) => {
@@ -31,88 +26,5 @@ module.exports = (config) => {
     }
   });
 
-  /**
-   * GET /api/health-check/scan-legacy - 扫描旧文件
-   */
-  router.get('/scan-legacy', (req, res) => {
-    try {
-      const result = scanLegacySessionFiles();
-
-      res.json({
-        success: true,
-        timestamp: new Date().toISOString(),
-        ...result
-      });
-    } catch (error) {
-      console.error('Legacy scan failed:', error);
-      res.status(500).json({
-        success: false,
-        error: error.message
-      });
-    }
-  });
-
-  /**
-   * POST /api/health-check/migrate-legacy - 迁移旧文件到正确位置
-   * Body:
-   * {
-   *   "dryRun": boolean,  // 是否只是预演
-   *   "projectNames": string[]  // 可选：指定要迁移的项目
-   * }
-   */
-  router.post('/migrate-legacy', (req, res) => {
-    try {
-      const { dryRun = false, projectNames = null } = req.body;
-
-      const result = migrateSessionFiles({
-        dryRun,
-        projectNames
-      });
-
-      res.json({
-        success: true,
-        timestamp: new Date().toISOString(),
-        ...result
-      });
-    } catch (error) {
-      console.error('Legacy migration failed:', error);
-      res.status(500).json({
-        success: false,
-        error: error.message
-      });
-    }
-  });
-
-  /**
-   * POST /api/health-check/clean-legacy - 清理旧文件
-   * Body:
-   * {
-   *   "dryRun": boolean,  // 是否只是预演
-   *   "projectNames": string[]  // 可选：指定要清理的项目
-   * }
-   */
-  router.post('/clean-legacy', (req, res) => {
-    try {
-      const { dryRun = false, projectNames = null } = req.body;
-
-      const result = cleanLegacySessionFiles({
-        dryRun,
-        projectNames
-      });
-
-      res.json({
-        success: true,
-        timestamp: new Date().toISOString(),
-        ...result
-      });
-    } catch (error) {
-      console.error('Legacy cleanup failed:', error);
-      res.status(500).json({
-        success: false,
-        error: error.message
-      });
-    }
-  });
-
   return router;
 };