@adversity/coding-tool-x 2.2.0

package/src/server/api/commands.js

@@ -0,0 +1,245 @@
+/**
+ * Commands API 路由
+ *
+ * 管理 Claude Code 自定义命令
+ */
+
+const express = require('express');
+const { CommandsService } = require('../services/commands-service');
+
+const router = express.Router();
+const commandsService = new CommandsService();
+
+/**
+ * 获取命令列表
+ * GET /api/commands
+ * Query: projectPath - 项目路径（可选，用于获取项目级命令）
+ */
+router.get('/', (req, res) => {
+  try {
+    const { projectPath } = req.query;
+    const result = commandsService.listCommands(projectPath || null);
+
+    res.json({
+      success: true,
+      ...result
+    });
+  } catch (err) {
+    console.error('[Commands API] List commands error:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
+/**
+ * 获取命令统计
+ * GET /api/commands/stats
+ */
+router.get('/stats', (req, res) => {
+  try {
+    const { projectPath } = req.query;
+    const stats = commandsService.getStats(projectPath || null);
+
+    res.json({
+      success: true,
+      ...stats
+    });
+  } catch (err) {
+    console.error('[Commands API] Get stats error:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
+/**
+ * 获取单个命令详情
+ * GET /api/commands/:scope/:name
+ * GET /api/commands/:scope/ns/:namespace/:name
+ */
+router.get('/:scope/:name', (req, res) => {
+  try {
+    const { scope, name } = req.params;
+    const { projectPath, namespace } = req.query;
+
+    if (!['user', 'project'].includes(scope)) {
+      return res.status(400).json({
+        success: false,
+        message: '无效的 scope，必须是 user 或 project'
+      });
+    }
+
+    if (scope === 'project' && !projectPath) {
+      return res.status(400).json({
+        success: false,
+        message: '获取项目级命令需要提供 projectPath'
+      });
+    }
+
+    const command = commandsService.getCommand(name, scope, projectPath || null, namespace || null);
+
+    if (!command) {
+      return res.status(404).json({
+        success: false,
+        message: `命令 "${name}" 不存在`
+      });
+    }
+
+    res.json({
+      success: true,
+      command
+    });
+  } catch (err) {
+    console.error('[Commands API] Get command error:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
+/**
+ * 创建命令
+ * POST /api/commands
+ * Body: { name, scope, projectPath?, namespace?, description?, allowedTools?, argumentHint?, body }
+ */
+router.post('/', (req, res) => {
+  try {
+    const { name, scope, projectPath, namespace, description, allowedTools, argumentHint, body } = req.body;
+
+    if (!name) {
+      return res.status(400).json({
+        success: false,
+        message: '命令名称不能为空'
+      });
+    }
+
+    if (!['user', 'project'].includes(scope)) {
+      return res.status(400).json({
+        success: false,
+        message: '无效的 scope，必须是 user 或 project'
+      });
+    }
+
+    if (scope === 'project' && !projectPath) {
+      return res.status(400).json({
+        success: false,
+        message: '创建项目级命令需要提供 projectPath'
+      });
+    }
+
+    const command = commandsService.createCommand({
+      name,
+      scope,
+      projectPath: projectPath || null,
+      namespace: namespace || null,
+      description: description || '',
+      allowedTools: allowedTools || '',
+      argumentHint: argumentHint || '',
+      body: body || ''
+    });
+
+    res.json({
+      success: true,
+      command,
+      message: '命令创建成功'
+    });
+  } catch (err) {
+    console.error('[Commands API] Create command error:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
+/**
+ * 更新命令
+ * PUT /api/commands/:scope/:name
+ */
+router.put('/:scope/:name', (req, res) => {
+  try {
+    const { scope, name } = req.params;
+    const { projectPath, namespace, description, allowedTools, argumentHint, body } = req.body;
+
+    if (!['user', 'project'].includes(scope)) {
+      return res.status(400).json({
+        success: false,
+        message: '无效的 scope，必须是 user 或 project'
+      });
+    }
+
+    if (scope === 'project' && !projectPath) {
+      return res.status(400).json({
+        success: false,
+        message: '更新项目级命令需要提供 projectPath'
+      });
+    }
+
+    const command = commandsService.updateCommand({
+      name,
+      scope,
+      projectPath: projectPath || null,
+      namespace: namespace || null,
+      description: description || '',
+      allowedTools: allowedTools || '',
+      argumentHint: argumentHint || '',
+      body: body || ''
+    });
+
+    res.json({
+      success: true,
+      command,
+      message: '命令更新成功'
+    });
+  } catch (err) {
+    console.error('[Commands API] Update command error:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
+/**
+ * 删除命令
+ * DELETE /api/commands/:scope/:name
+ */
+router.delete('/:scope/:name', (req, res) => {
+  try {
+    const { scope, name } = req.params;
+    const { projectPath, namespace } = req.query;
+
+    if (!['user', 'project'].includes(scope)) {
+      return res.status(400).json({
+        success: false,
+        message: '无效的 scope，必须是 user 或 project'
+      });
+    }
+
+    if (scope === 'project' && !projectPath) {
+      return res.status(400).json({
+        success: false,
+        message: '删除项目级命令需要提供 projectPath'
+      });
+    }
+
+    const result = commandsService.deleteCommand(name, scope, projectPath || null, namespace || null);
+
+    res.json({
+      success: result.success,
+      message: result.message
+    });
+  } catch (err) {
+    console.error('[Commands API] Delete command error:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
+module.exports = router;

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

@@ -0,0 +1,182 @@
+// 配置模板 API 路由
+const express = require('express');
+const router = express.Router();
+const templatesService = require('../services/config-templates-service');
+
+/**
+ * GET /api/config-templates
+ * 获取所有配置模板
+ */
+router.get('/', (req, res) => {
+  try {
+    const templates = templatesService.getAllTemplates();
+    res.json({
+      success: true,
+      data: templates
+    });
+  } catch (error) {
+    res.status(500).json({
+      success: false,
+      message: error.message
+    });
+  }
+});
+
+/**
+ * GET /api/config-templates/available-configs
+ * 获取可用的配置项（用于模板编辑器选择）
+ * 注意：此路由必须在 /:id 之前定义
+ */
+router.get('/available-configs', (req, res) => {
+  try {
+    const configs = templatesService.getAvailableConfigs();
+    res.json({
+      success: true,
+      data: configs
+    });
+  } catch (error) {
+    res.status(500).json({
+      success: false,
+      message: error.message
+    });
+  }
+});
+
+/**
+ * GET /api/config-templates/:id
+ * 获取单个配置模板详情
+ */
+router.get('/:id', (req, res) => {
+  try {
+    const template = templatesService.getTemplateById(req.params.id);
+    if (!template) {
+      return res.status(404).json({
+        success: false,
+        message: '模板不存在'
+      });
+    }
+    res.json({
+      success: true,
+      data: template
+    });
+  } catch (error) {
+    res.status(500).json({
+      success: false,
+      message: error.message
+    });
+  }
+});
+
+/**
+ * POST /api/config-templates
+ * 创建自定义配置模板
+ */
+router.post('/', (req, res) => {
+  try {
+    const template = templatesService.createCustomTemplate(req.body);
+    res.json({
+      success: true,
+      message: '模板创建成功',
+      data: template
+    });
+  } catch (error) {
+    res.status(400).json({
+      success: false,
+      message: error.message
+    });
+  }
+});
+
+/**
+ * PUT /api/config-templates/:id
+ * 更新自定义配置模板
+ */
+router.put('/:id', (req, res) => {
+  try {
+    const template = templatesService.updateCustomTemplate(req.params.id, req.body);
+    res.json({
+      success: true,
+      message: '模板更新成功',
+      data: template
+    });
+  } catch (error) {
+    res.status(400).json({
+      success: false,
+      message: error.message
+    });
+  }
+});
+
+/**
+ * DELETE /api/config-templates/:id
+ * 删除自定义配置模板
+ */
+router.delete('/:id', (req, res) => {
+  try {
+    templatesService.deleteCustomTemplate(req.params.id);
+    res.json({
+      success: true,
+      message: '模板删除成功'
+    });
+  } catch (error) {
+    res.status(400).json({
+      success: false,
+      message: error.message
+    });
+  }
+});
+
+/**
+ * POST /api/config-templates/:id/apply
+ * 应用模板到项目目录
+ */
+router.post('/:id/apply', (req, res) => {
+  try {
+    const { targetPath } = req.body;
+    if (!targetPath) {
+      return res.status(400).json({
+        success: false,
+        message: '目标路径不能为空'
+      });
+    }
+    const result = templatesService.applyTemplateToProject(targetPath, req.params.id);
+    res.json({
+      success: true,
+      message: '模板应用成功',
+      data: result
+    });
+  } catch (error) {
+    res.status(400).json({
+      success: false,
+      message: error.message
+    });
+  }
+});
+
+/**
+ * POST /api/config-templates/:id/preview
+ * 预览模板应用效果
+ */
+router.post('/:id/preview', (req, res) => {
+  try {
+    const { targetPath } = req.body;
+    if (!targetPath) {
+      return res.status(400).json({
+        success: false,
+        message: '目标路径不能为空'
+      });
+    }
+    const preview = templatesService.previewTemplateApplication(targetPath, req.params.id);
+    res.json({
+      success: true,
+      data: preview
+    });
+  } catch (error) {
+    res.status(400).json({
+      success: false,
+      message: error.message
+    });
+  }
+});
+
+module.exports = router;

package/src/server/api/config.js

@@ -0,0 +1,147 @@
+const express = require('express');
+const router = express.Router();
+const { loadConfig, saveConfig } = require('../../config/loader');
+const DEFAULT_CONFIG = require('../../config/default');
+
+function clampNumber(value, fallback) {
+  const num = typeof value === 'number' ? value : parseFloat(value);
+  if (!Number.isFinite(num)) {
+    return fallback;
+  }
+  if (num < 0) return 0;
+  if (num > 1000) return 1000;
+  return Math.round(num * 1000000) / 1000000;
+}
+
+function sanitizePricing(inputPricing, currentPricing) {
+  const defaults = DEFAULT_CONFIG.pricing;
+  const sanitized = {};
+
+  Object.keys(defaults).forEach((toolKey) => {
+    const defaultValue = defaults[toolKey];
+    const existingValue = currentPricing?.[toolKey] || {};
+    const payload = inputPricing?.[toolKey] || {};
+
+    const mode = payload.mode === 'custom' ? 'custom' : (existingValue.mode || defaultValue.mode || 'auto');
+    sanitized[toolKey] = { mode };
+
+    Object.keys(defaultValue)
+      .filter((key) => key !== 'mode')
+      .forEach((rateKey) => {
+        const fallback = existingValue[rateKey] !== undefined ? existingValue[rateKey] : defaultValue[rateKey];
+        sanitized[toolKey][rateKey] = clampNumber(payload[rateKey], fallback);
+      });
+  });
+
+  return sanitized;
+}
+
+/**
+ * GET /api/config/advanced
+ * 获取高级配置（端口、日志、性能等）
+ */
+router.get('/advanced', (req, res) => {
+  try {
+    const config = loadConfig();
+    res.json({
+      ports: {
+        webUI: config.ports?.webUI || 10099,
+        proxy: config.ports?.proxy || 10088,
+        codexProxy: config.ports?.codexProxy || 10089,
+        geminiProxy: config.ports?.geminiProxy || 10090
+      },
+      maxLogs: config.maxLogs || 100,
+      statsInterval: config.statsInterval || 30,
+      enableSessionBinding: config.enableSessionBinding !== false, // 默认开启
+      pricing: config.pricing || DEFAULT_CONFIG.pricing
+    });
+  } catch (error) {
+    console.error('[Config API] Failed to get advanced config:', error);
+    res.status(500).json({ error: error.message });
+  }
+});
+
+/**
+ * POST /api/config/advanced
+ * 保存高级配置
+ */
+router.post('/advanced', (req, res) => {
+  try {
+    const { ports, maxLogs, statsInterval, pricing, enableSessionBinding } = req.body;
+
+    // 验证端口
+    if (ports) {
+      for (const [key, value] of Object.entries(ports)) {
+        const port = parseInt(value);
+        if (isNaN(port) || port < 1024 || port > 65535) {
+          return res.status(400).json({
+            error: `Invalid port for ${key}: must be between 1024-65535`
+          });
+        }
+      }
+    }
+
+    // 验证日志数量
+    if (maxLogs !== undefined) {
+      const logs = parseInt(maxLogs);
+      if (isNaN(logs) || logs < 50 || logs > 500) {
+        return res.status(400).json({
+          error: 'maxLogs must be between 50-500'
+        });
+      }
+    }
+
+    // 验证刷新间隔
+    if (statsInterval !== undefined) {
+      const interval = parseInt(statsInterval);
+      if (isNaN(interval) || interval < 10 || interval > 300) {
+        return res.status(400).json({
+          error: 'statsInterval must be between 10-300'
+        });
+      }
+    }
+
+    // 加载当前配置
+    const config = loadConfig();
+    const sanitizedPricing = sanitizePricing(pricing, config.pricing);
+
+    let normalizedPorts = config.ports;
+    if (ports) {
+      normalizedPorts = { ...config.ports };
+      Object.entries(ports).forEach(([key, value]) => {
+        const port = parseInt(value);
+        normalizedPorts[key] = port;
+      });
+    }
+
+    // 更新配置
+    const newConfig = {
+      ...config,
+      projectsDir: config.projectsDir.replace(require('os').homedir(), '~'),
+      ports: normalizedPorts,
+      maxLogs: maxLogs !== undefined ? parseInt(maxLogs) : config.maxLogs,
+      statsInterval: statsInterval !== undefined ? parseInt(statsInterval) : config.statsInterval,
+      enableSessionBinding: enableSessionBinding !== undefined ? enableSessionBinding : (config.enableSessionBinding !== false),
+      pricing: sanitizedPricing
+    };
+
+    // 保存配置
+    saveConfig(newConfig);
+
+    res.json({
+      success: true,
+      config: {
+        ports: newConfig.ports,
+        maxLogs: newConfig.maxLogs,
+        statsInterval: newConfig.statsInterval,
+        enableSessionBinding: newConfig.enableSessionBinding,
+        pricing: newConfig.pricing
+      }
+    });
+  } catch (error) {
+    console.error('[Config API] Failed to save advanced config:', error);
+    res.status(500).json({ error: error.message });
+  }
+});
+
+module.exports = router;

package/src/server/api/convert.js

@@ -0,0 +1,127 @@
+const express = require('express');
+const router = express.Router();
+const { convertSession, previewConversion } = require('../services/session-converter');
+
+/**
+ * 获取支持的格式列表
+ * GET /api/convert/formats
+ */
+router.get('/formats', (req, res) => {
+  res.json({
+    formats: [
+      {
+        id: 'claude',
+        name: 'Claude Code',
+        description: 'Anthropic Claude Code CLI session format',
+        extension: '.jsonl',
+        icon: 'claude'
+      },
+      {
+        id: 'codex',
+        name: 'OpenAI Codex',
+        description: 'OpenAI Codex CLI session format',
+        extension: '.jsonl',
+        icon: 'codex'
+      },
+      {
+        id: 'gemini',
+        name: 'Google Gemini',
+        description: 'Google Gemini CLI session format',
+        extension: '.json',
+        icon: 'gemini'
+      }
+    ],
+    conversions: [
+      { from: 'claude', to: 'codex' },
+      { from: 'claude', to: 'gemini' },
+      { from: 'codex', to: 'claude' },
+      { from: 'codex', to: 'gemini' },
+      { from: 'gemini', to: 'claude' },
+      { from: 'gemini', to: 'codex' }
+    ]
+  });
+});
+
+/**
+ * 预览转换结果
+ * POST /api/convert/preview
+ * Body: { sourceType, sessionId }
+ */
+router.post('/preview', async (req, res) => {
+  try {
+    const { sourceType, sessionId } = req.body;
+
+    if (!sourceType || !sessionId) {
+      return res.status(400).json({
+        success: false,
+        error: 'Missing required parameters: sourceType, sessionId'
+      });
+    }
+
+    const preview = await previewConversion(sourceType, sessionId);
+
+    res.json({
+      success: true,
+      preview
+    });
+  } catch (error) {
+    console.error('[Convert API] Preview error:', error);
+    res.status(500).json({
+      success: false,
+      error: error.message
+    });
+  }
+});
+
+/**
+ * 执行会话转换
+ * POST /api/convert
+ * Body: { sourceType, targetType, sessionId, options }
+ */
+router.post('/', async (req, res) => {
+  try {
+    const { sourceType, targetType, sessionId, options = {} } = req.body;
+
+    // 验证必需参数
+    if (!sourceType || !targetType || !sessionId) {
+      return res.status(400).json({
+        success: false,
+        error: 'Missing required parameters: sourceType, targetType, sessionId'
+      });
+    }
+
+    // 验证格式
+    const validTypes = ['claude', 'codex', 'gemini'];
+    if (!validTypes.includes(sourceType)) {
+      return res.status(400).json({
+        success: false,
+        error: `Invalid sourceType: ${sourceType}. Must be one of: ${validTypes.join(', ')}`
+      });
+    }
+    if (!validTypes.includes(targetType)) {
+      return res.status(400).json({
+        success: false,
+        error: `Invalid targetType: ${targetType}. Must be one of: ${validTypes.join(', ')}`
+      });
+    }
+    if (sourceType === targetType) {
+      return res.status(400).json({
+        success: false,
+        error: 'Source and target types must be different'
+      });
+    }
+
+    // 执行转换
+    const result = await convertSession(sourceType, targetType, sessionId, options);
+
+    res.json(result);
+  } catch (error) {
+    console.error('[Convert API] Conversion error:', error);
+    res.status(500).json({
+      success: false,
+      error: error.message
+    });
+  }
+});
+
+module.exports = router;