@adversity/coding-tool-x 2.4.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/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/projects.js

@@ -4,9 +4,9 @@ const { getProjectsWithStats, saveProjectOrder, getProjectOrder, deleteProject }
 
 module.exports = (config) => {
   // GET /api/projects - Get all projects with stats
-  router.get('/', (req, res) => {
+  router.get('/', async (req, res) => {
     try {
-      const projects = getProjectsWithStats(config);
+      const projects = await getProjectsWithStats(config);
       const order = getProjectOrder(config);
 
       // Sort projects by saved order

package/src/server/api/sessions.js

@@ -45,10 +45,10 @@ module.exports = (config) => {
   });
 
   // GET /api/sessions/:projectName - Get sessions for a project
-  router.get('/:projectName', (req, res) => {
+  router.get('/:projectName', async (req, res) => {
     try {
       const { projectName } = req.params;
-      const result = getSessionsForProject(config, projectName);
+      const result = await getSessionsForProject(config, projectName);
       const aliases = loadAliases();
 
       // Parse project path info
@@ -222,8 +222,8 @@ module.exports = (config) => {
   });
 
   // GET /api/sessions/:projectName/:sessionId/messages - Get session messages with pagination
-router.get('/:projectName/:sessionId/messages', async (req, res) => {
-  try {
+  router.get('/:projectName/:sessionId/messages', async (req, res) => {
+    try {
       const { projectName, sessionId } = req.params;
       const { page = 1, limit = 20, order = 'desc' } = req.query;
 
@@ -271,86 +271,86 @@ router.get('/:projectName/:sessionId/messages', async (req, res) => {
       }
 
       // Read and parse session file
-    const allMessages = [];
-    const metadata = {};
+      const allMessages = [];
+      const metadata = {};
 
-    const stream = fs.createReadStream(sessionFile, { encoding: 'utf8' });
-    const rl = readline.createInterface({ input: stream, crlfDelay: Infinity });
+      const stream = fs.createReadStream(sessionFile, { encoding: 'utf8' });
+      const rl = readline.createInterface({ input: stream, crlfDelay: Infinity });
 
-    try {
-      for await (const line of rl) {
-        if (!line.trim()) continue;
-        try {
-          const json = JSON.parse(line);
+      try {
+        for await (const line of rl) {
+          if (!line.trim()) continue;
+          try {
+            const json = JSON.parse(line);
 
-          if (json.type === 'summary' && json.summary) {
-            metadata.summary = json.summary;
-          }
-          if (json.gitBranch) {
-            metadata.gitBranch = json.gitBranch;
-          }
-          if (json.cwd) {
-            metadata.cwd = json.cwd;
-          }
+            if (json.type === 'summary' && json.summary) {
+              metadata.summary = json.summary;
+            }
+            if (json.gitBranch) {
+              metadata.gitBranch = json.gitBranch;
+            }
+            if (json.cwd) {
+              metadata.cwd = json.cwd;
+            }
 
-          if (json.type === 'user' || json.type === 'assistant') {
-            const message = {
-              type: json.type,
-              content: null,
-              timestamp: json.timestamp || null,
-              model: json.model || null
-            };
-
-            if (json.type === 'user') {
-              if (typeof json.message?.content === 'string') {
-                message.content = json.message.content;
-              } else if (Array.isArray(json.message?.content)) {
-                const parts = [];
-                for (const item of json.message.content) {
-                  if (item.type === 'text' && item.text) {
-                    parts.push(item.text);
-                  } else if (item.type === 'tool_result') {
-                    const resultContent = typeof item.content === 'string'
-                      ? item.content
-                      : JSON.stringify(item.content, null, 2);
-                    parts.push(`**[工具结果]**\n\`\`\`\n${resultContent}\n\`\`\``);
-                  } else if (item.type === 'image') {
-                    parts.push('[图片]');
+            if (json.type === 'user' || json.type === 'assistant') {
+              const message = {
+                type: json.type,
+                content: null,
+                timestamp: json.timestamp || null,
+                model: json.model || null
+              };
+
+              if (json.type === 'user') {
+                if (typeof json.message?.content === 'string') {
+                  message.content = json.message.content;
+                } else if (Array.isArray(json.message?.content)) {
+                  const parts = [];
+                  for (const item of json.message.content) {
+                    if (item.type === 'text' && item.text) {
+                      parts.push(item.text);
+                    } else if (item.type === 'tool_result') {
+                      const resultContent = typeof item.content === 'string'
+                        ? item.content
+                        : JSON.stringify(item.content, null, 2);
+                      parts.push(`**[工具结果]**\n\`\`\`\n${resultContent}\n\`\`\``);
+                    } else if (item.type === 'image') {
+                      parts.push('[图片]');
+                    }
                   }
+                  message.content = parts.join('\n\n') || '[工具交互]';
                 }
-                message.content = parts.join('\n\n') || '[工具交互]';
-              }
-            } else if (json.type === 'assistant') {
-              if (Array.isArray(json.message?.content)) {
-                const parts = [];
-                for (const item of json.message.content) {
-                  if (item.type === 'text' && item.text) {
-                    parts.push(item.text);
-                  } else if (item.type === 'tool_use') {
-                    const inputStr = JSON.stringify(item.input, null, 2);
-                    parts.push(`**[调用工具: ${item.name}]**\n\`\`\`json\n${inputStr}\n\`\`\``);
-                  } else if (item.type === 'thinking' && item.thinking) {
-                    parts.push(`**[思考]**\n${item.thinking}`);
+              } else if (json.type === 'assistant') {
+                if (Array.isArray(json.message?.content)) {
+                  const parts = [];
+                  for (const item of json.message.content) {
+                    if (item.type === 'text' && item.text) {
+                      parts.push(item.text);
+                    } else if (item.type === 'tool_use') {
+                      const inputStr = JSON.stringify(item.input, null, 2);
+                      parts.push(`**[调用工具: ${item.name}]**\n\`\`\`json\n${inputStr}\n\`\`\``);
+                    } else if (item.type === 'thinking' && item.thinking) {
+                      parts.push(`**[思考]**\n${item.thinking}`);
+                    }
                   }
+                  message.content = parts.join('\n\n') || '[处理中...]';
+                } else if (typeof json.message?.content === 'string') {
+                  message.content = json.message.content;
                 }
-                message.content = parts.join('\n\n') || '[处理中...]';
-              } else if (typeof json.message?.content === 'string') {
-                message.content = json.message.content;
               }
-            }
 
-            if (message.content && message.content !== 'Warmup') {
-              allMessages.push(message);
+              if (message.content && message.content !== 'Warmup') {
+                allMessages.push(message);
+              }
             }
+          } catch (err) {
+            // Skip invalid lines
           }
-        } catch (err) {
-          // Skip invalid lines
         }
+      } finally {
+        rl.close();
+        stream.destroy();
       }
-    } finally {
-      rl.close();
-      stream.destroy();
-    }
 
       // Sort messages (desc = newest first)
       if (order === 'desc') {