coding-tool-x 3.2.0

package/src/server/api/commands.js

@@ -0,0 +1,482 @@
+/**
+ * Commands API 路由
+ *
+ * 管理 Claude Code 自定义命令
+ */
+
+const express = require('express');
+const { CommandsService } = require('../services/commands-service');
+
+const router = express.Router();
+const SUPPORTED_PLATFORMS = ['claude', 'opencode'];
+const commandServices = new Map();
+
+function resolvePlatform(rawPlatform) {
+  return SUPPORTED_PLATFORMS.includes(rawPlatform) ? rawPlatform : 'claude';
+}
+
+function getPlatform(req) {
+  return resolvePlatform(req.query?.platform || req.body?.platform);
+}
+
+function getCommandsService(req) {
+  const platform = getPlatform(req);
+  if (!commandServices.has(platform)) {
+    commandServices.set(platform, new CommandsService(platform));
+  }
+  return { platform, service: commandServices.get(platform) };
+}
+
+/**
+ * 获取命令列表
+ * GET /api/commands
+ * Query: projectPath - 项目路径（可选，用于获取项目级命令）
+ */
+router.get('/', (req, res) => {
+  try {
+    const { platform, service } = getCommandsService(req);
+    const { projectPath } = req.query;
+    const result = service.listCommands(projectPath || null);
+
+    res.json({
+      success: true,
+      platform,
+      ...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 { platform, service } = getCommandsService(req);
+    const { projectPath } = req.query;
+    const stats = service.getStats(projectPath || null);
+
+    res.json({
+      success: true,
+      platform,
+      ...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 { platform, service } = getCommandsService(req);
+    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 = service.getCommand(name, scope, projectPath || null, namespace || null);
+
+    if (!command) {
+      return res.status(404).json({
+        success: false,
+        message: `命令 "${name}" 不存在`
+      });
+    }
+
+    res.json({
+      success: true,
+      platform,
+      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 { platform, service } = getCommandsService(req);
+    const { name, scope, projectPath, namespace, description, allowedTools, argumentHint, agent, model, subtask, 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 = service.createCommand({
+      name,
+      scope,
+      projectPath: projectPath || null,
+      namespace: namespace || null,
+      description: description || '',
+      allowedTools: allowedTools || '',
+      argumentHint: argumentHint || '',
+      agent: agent || '',
+      model: model || '',
+      subtask: typeof subtask === 'boolean' ? subtask : undefined,
+      body: body || ''
+    });
+
+    res.json({
+      success: true,
+      platform,
+      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 { platform, service } = getCommandsService(req);
+    const { scope, name } = req.params;
+    const { projectPath, namespace, description, allowedTools, argumentHint, agent, model, subtask, 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 = service.updateCommand({
+      name,
+      scope,
+      projectPath: projectPath || null,
+      namespace: namespace || null,
+      description: description || '',
+      allowedTools: allowedTools || '',
+      argumentHint: argumentHint || '',
+      agent: agent || '',
+      model: model || '',
+      subtask: typeof subtask === 'boolean' ? subtask : undefined,
+      body: body || ''
+    });
+
+    res.json({
+      success: true,
+      platform,
+      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 { platform, service } = getCommandsService(req);
+    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 = service.deleteCommand(name, scope, projectPath || null, namespace || null);
+
+    res.json({
+      platform,
+      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
+    });
+  }
+});
+
+// ==================== 仓库管理 API ====================
+
+/**
+ * 获取所有命令（包括远程仓库）
+ * GET /api/commands/all
+ * Query: projectPath, refresh=1 强制刷新缓存
+ */
+router.get('/all', async (req, res) => {
+  try {
+    const { platform, service } = getCommandsService(req);
+    const { projectPath, refresh } = req.query;
+    const forceRefresh = refresh === '1';
+    const result = await service.listAllCommands(projectPath || null, forceRefresh);
+
+    res.json({
+      success: true,
+      platform,
+      ...result
+    });
+  } catch (err) {
+    console.error('[Commands API] List all commands error:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
+/**
+ * 获取仓库列表
+ * GET /api/commands/repos
+ */
+router.get('/repos', (req, res) => {
+  try {
+    const { platform, service } = getCommandsService(req);
+    const repos = service.getRepos();
+    res.json({
+      success: true,
+      platform,
+      repos
+    });
+  } catch (err) {
+    console.error('[Commands API] Get repos error:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
+/**
+ * 添加仓库
+ * POST /api/commands/repos
+ * Body: { owner, name, branch, directory, enabled }
+ */
+router.post('/repos', (req, res) => {
+  try {
+    const { platform, service } = getCommandsService(req);
+    const { owner, name, branch = 'main', directory = '', enabled = true } = req.body;
+
+    if (!owner || !name) {
+      return res.status(400).json({
+        success: false,
+        message: 'Missing owner or name'
+      });
+    }
+
+    const repos = service.addRepo({ owner, name, branch, directory, enabled });
+
+    res.json({
+      success: true,
+      platform,
+      repos
+    });
+  } catch (err) {
+    console.error('[Commands API] Add repo error:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
+/**
+ * 删除仓库
+ * DELETE /api/commands/repos/:owner/:name
+ * Query: directory - 可选，子目录路径
+ */
+router.delete('/repos/:owner/:name', (req, res) => {
+  try {
+    const { platform, service } = getCommandsService(req);
+    const { owner, name } = req.params;
+    const { directory = '' } = req.query;
+    const repos = service.removeRepo(owner, name, directory);
+
+    res.json({
+      success: true,
+      platform,
+      repos
+    });
+  } catch (err) {
+    console.error('[Commands API] Remove repo error:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
+/**
+ * 切换仓库启用状态
+ * PUT /api/commands/repos/:owner/:name/toggle
+ * Body: { enabled, directory }
+ */
+router.put('/repos/:owner/:name/toggle', (req, res) => {
+  try {
+    const { platform, service } = getCommandsService(req);
+    const { owner, name } = req.params;
+    const { enabled, directory = '' } = req.body;
+
+    const repos = service.toggleRepo(owner, name, directory, enabled);
+
+    res.json({
+      success: true,
+      platform,
+      repos
+    });
+  } catch (err) {
+    console.error('[Commands API] Toggle repo error:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
+/**
+ * 从远程仓库安装命令
+ * POST /api/commands/install
+ * Body: command object from listAllCommands
+ */
+router.post('/install', async (req, res) => {
+  try {
+    const { platform, service } = getCommandsService(req);
+    const command = req.body;
+
+    if (!command || !command.repoOwner || !command.repoName) {
+      return res.status(400).json({
+        success: false,
+        message: 'Missing command info or repo info'
+      });
+    }
+
+    const result = await service.installFromRemote(command);
+
+    res.json({
+      success: true,
+      platform,
+      ...result
+    });
+  } catch (err) {
+    console.error('[Commands API] Install command error:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
+/**
+ * 卸载命令
+ * POST /api/commands/uninstall
+ * Body: { path } - 命令的相对路径
+ */
+router.post('/uninstall', (req, res) => {
+  try {
+    const { platform, service } = getCommandsService(req);
+    const { path } = req.body;
+
+    if (!path) {
+      return res.status(400).json({
+        success: false,
+        message: 'Missing path'
+      });
+    }
+
+    const result = service.uninstallCommand(path);
+
+    res.json({
+      success: true,
+      platform,
+      ...result
+    });
+  } catch (err) {
+    console.error('[Commands API] Uninstall command error:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
+module.exports = router;

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

@@ -0,0 +1,212 @@
+/**
+ * 配置导出/导入 API 路由
+ */
+
+const express = require('express');
+const configExportService = require('../services/config-export-service');
+const AdmZip = require('adm-zip');
+
+const router = express.Router();
+
+function parseConfigZip(buffer) {
+  const zip = new AdmZip(buffer);
+  const entry = zip.getEntry('config.json');
+  if (!entry) {
+    throw new Error('配置包缺少 config.json');
+  }
+  const content = entry.getData().toString('utf8');
+  return JSON.parse(content);
+}
+
+function buildPreviewSummary(data) {
+  return {
+    version: data.version,
+    exportedAt: data.exportedAt,
+    counts: {
+      configTemplates: (data.data.configTemplates || []).length,
+      channels: (data.data.channels || []).length,
+      plugins: (data.data.plugins || []).length
+    },
+    items: {
+      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
+      })),
+      plugins: (data.data.plugins || []).map(p => ({
+        name: p.name,
+        type: p.type,
+        version: p.version
+      }))
+    }
+  };
+}
+
+/**
+ * 导出所有配置
+ * GET /api/config-export
+ */
+router.get('/', (req, res) => {
+  try {
+    const format = (req.query.format || 'json').toLowerCase();
+    const result = format === 'zip'
+      ? configExportService.exportAllConfigsZip()
+      : configExportService.exportAllConfigs();
+
+    if (result.success) {
+      if (format === 'zip') {
+        // 设置响应头，触发文件下载
+        const filename = result.filename || `ctx-config-${new Date().toISOString().split('T')[0]}.zip`;
+        res.setHeader('Content-Disposition', `attachment; filename="${filename}"`);
+        res.setHeader('Content-Type', 'application/zip');
+        res.send(result.data);
+      } else {
+        // 设置响应头，触发文件下载
+        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
+    });
+  }
+});
+
+/**
+ * 导入 ZIP 配置
+ * POST /api/config-export/import-zip
+ */
+router.post('/import-zip', express.raw({ type: ['application/zip', 'application/octet-stream'], limit: '100mb' }), (req, res) => {
+  try {
+    const overwrite = req.query.overwrite === 'true';
+    const buffer = req.body;
+
+    if (!Buffer.isBuffer(buffer) || buffer.length === 0) {
+      return res.status(400).json({
+        success: false,
+        message: '缺少 ZIP 文件内容'
+      });
+    }
+
+    const data = parseConfigZip(buffer);
+    const result = configExportService.importConfigs(data, { overwrite });
+    res.json(result);
+  } catch (err) {
+    console.error('[ConfigExport API] 导入 ZIP 失败:', 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 = buildPreviewSummary(data);
+
+    res.json({
+      success: true,
+      data: summary
+    });
+  } catch (err) {
+    console.error('[ConfigExport API] 预览失败:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
+/**
+ * 预览 ZIP 导入配置（不实际导入）
+ * POST /api/config-export/preview-zip
+ */
+router.post('/preview-zip', express.raw({ type: ['application/zip', 'application/octet-stream'], limit: '100mb' }), (req, res) => {
+  try {
+    const buffer = req.body;
+    if (!Buffer.isBuffer(buffer) || buffer.length === 0) {
+      return res.status(400).json({
+        success: false,
+        message: '缺少 ZIP 文件内容'
+      });
+    }
+
+    const data = parseConfigZip(buffer);
+    if (!data || !data.data) {
+      return res.status(400).json({
+        success: false,
+        message: '无效的导入数据格式'
+      });
+    }
+
+    const summary = buildPreviewSummary(data);
+    res.json({
+      success: true,
+      data: summary
+    });
+  } catch (err) {
+    console.error('[ConfigExport API] 预览 ZIP 失败:', err);
+    res.status(500).json({
+      success: false,
+      message: err.message
+    });
+  }
+});
+
+module.exports = router;