@adversity/coding-tool-x 2.2.0 → 2.4.0

package/src/server/services/commands-service.js

@@ -5,15 +5,28 @@
  * 命令目录:
  * - 用户级: ~/.claude/commands/
  * - 项目级: .claude/commands/
+ *
+ * 支持从 GitHub 仓库扫描和安装命令
  */
 
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
+const { RepoScannerBase } = require('./repo-scanner-base');
+const {
+  parseCommandContent,
+  detectCommandFormat,
+  convertCommandToCodex,
+  convertCommandToClaude,
+  parseFrontmatter
+} = require('./format-converter');
 
 // 命令目录路径
 const USER_COMMANDS_DIR = path.join(os.homedir(), '.claude', 'commands');
 
+// 默认仓库源
+const DEFAULT_REPOS = [];
+
 /**
  * 确保目录存在
  */
@@ -24,51 +37,9 @@ function ensureDir(dirPath) {
 }
 
 /**
- * 解析 YAML frontmatter
+ * 生成 frontmatter 字符串（用于命令创建/更新）
  */
-function parseFrontmatter(content) {
-  const result = {
-    frontmatter: {},
-    body: content
-  };
-
-  // 移除 BOM
-  content = content.trim().replace(/^\uFEFF/, '');
-
-  // 解析 YAML frontmatter
-  const match = content.match(/^---\s*\n([\s\S]*?)\n---\s*\n?([\s\S]*)$/);
-  if (!match) {
-    return result;
-  }
-
-  const frontmatterText = match[1];
-  result.body = match[2].trim();
-
-  // 简单解析 YAML（支持基本字段）
-  const lines = frontmatterText.split('\n');
-  for (const line of lines) {
-    const colonIndex = line.indexOf(':');
-    if (colonIndex === -1) continue;
-
-    const key = line.slice(0, colonIndex).trim();
-    let value = line.slice(colonIndex + 1).trim();
-
-    // 去除引号
-    if ((value.startsWith('"') && value.endsWith('"')) ||
-        (value.startsWith("'") && value.endsWith("'"))) {
-      value = value.slice(1, -1);
-    }
-
-    result.frontmatter[key] = value;
-  }
-
-  return result;
-}
-
-/**
- * 生成 frontmatter 字符串
- */
-function generateFrontmatter(data) {
+function generateCommandFrontmatter(data) {
   const lines = ['---'];
 
   if (data.description) {
@@ -80,6 +51,15 @@ function generateFrontmatter(data) {
   if (data['argument-hint']) {
     lines.push(`argument-hint: ${data['argument-hint']}`);
   }
+  if (data.model) {
+    lines.push(`model: ${data.model}`);
+  }
+  if (data.context) {
+    lines.push(`context: ${data.context}`);
+  }
+  if (data.agent) {
+    lines.push(`agent: ${data.agent}`);
+  }
 
   lines.push('---');
   return lines.join('\n');
@@ -141,12 +121,96 @@ function scanCommandsDir(dir, basePath, scope) {
   return commands;
 }
 
+/**
+ * Commands 仓库扫描器
+ */
+class CommandsRepoScanner extends RepoScannerBase {
+  constructor() {
+    super({
+      type: 'commands',
+      installDir: USER_COMMANDS_DIR,
+      markerFile: null, // 直接扫描 .md 文件
+      fileExtension: '.md',
+      defaultRepos: DEFAULT_REPOS
+    });
+  }
+
+  /**
+   * 获取并解析单个命令文件
+   */
+  async fetchAndParseItem(file, repo, baseDir) {
+    try {
+      // 计算相对路径
+      const relativePath = baseDir ? file.path.slice(baseDir.length + 1) : file.path;
+      const fileName = path.basename(file.path, '.md');
+      const namespace = path.dirname(relativePath);
+
+      // 获取文件内容
+      const content = await this.fetchRawContent(repo, file.path);
+      const { frontmatter, body } = this.parseFrontmatter(content);
+
+      return {
+        key: `${repo.owner}/${repo.name}:${relativePath}`,
+        name: fileName,
+        namespace: namespace === '.' ? null : namespace,
+        scope: 'remote',
+        path: relativePath,
+        repoPath: file.path,
+        description: frontmatter.description || '',
+        allowedTools: frontmatter['allowed-tools'] || '',
+        argumentHint: frontmatter['argument-hint'] || '',
+        body,
+        fullContent: content,
+        installed: this.isInstalled(relativePath),
+        readmeUrl: `https://github.com/${repo.owner}/${repo.name}/blob/${repo.branch}/${file.path}`,
+        repoOwner: repo.owner,
+        repoName: repo.name,
+        repoBranch: repo.branch,
+        repoDirectory: repo.directory || ''
+      };
+    } catch (err) {
+      console.warn(`[CommandsRepoScanner] Parse command ${file.path} error:`, err.message);
+      return null;
+    }
+  }
+
+  /**
+   * 检查命令是否已安装
+   */
+  isInstalled(relativePath) {
+    const fullPath = path.join(this.installDir, relativePath);
+    return fs.existsSync(fullPath);
+  }
+
+  /**
+   * 获取去重 key
+   */
+  getDedupeKey(item) {
+    // 使用 namespace/name 作为去重 key
+    return item.namespace ? `${item.namespace}/${item.name}`.toLowerCase() : item.name.toLowerCase();
+  }
+
+  /**
+   * 安装命令
+   */
+  async installCommand(item) {
+    const repo = {
+      owner: item.repoOwner,
+      name: item.repoName,
+      branch: item.repoBranch
+    };
+
+    return this.installFromRepo(item.repoPath, repo, item.path);
+  }
+}
+
 /**
  * Commands 服务类
  */
 class CommandsService {
   constructor() {
     this.userCommandsDir = USER_COMMANDS_DIR;
+    this.repoScanner = new CommandsRepoScanner();
     ensureDir(this.userCommandsDir);
   }
 
@@ -179,6 +243,52 @@ class CommandsService {
     };
   }
 
+  /**
+   * 获取所有命令（包括远程仓库）
+   * @param {boolean} forceRefresh - 强制刷新远程缓存
+   */
+  async listAllCommands(projectPath = null, forceRefresh = false) {
+    // 获取本地命令
+    const { commands: localCommands, userCount, projectCount } = this.listCommands(projectPath);
+
+    // 获取远程命令
+    let remoteCommands = [];
+    try {
+      remoteCommands = await this.repoScanner.listRemoteItems(forceRefresh);
+
+      // 更新安装状态
+      for (const cmd of remoteCommands) {
+        cmd.installed = this.repoScanner.isInstalled(cmd.path);
+      }
+    } catch (err) {
+      console.warn('[CommandsService] Failed to fetch remote commands:', err.message);
+    }
+
+    // 合并列表（本地优先）
+    const allCommands = [...localCommands];
+    const localKeys = new Set(localCommands.map(c =>
+      c.namespace ? `${c.namespace}/${c.name}`.toLowerCase() : c.name.toLowerCase()
+    ));
+
+    for (const remote of remoteCommands) {
+      const key = remote.namespace ? `${remote.namespace}/${remote.name}`.toLowerCase() : remote.name.toLowerCase();
+      if (!localKeys.has(key)) {
+        allCommands.push(remote);
+      }
+    }
+
+    // 排序
+    allCommands.sort((a, b) => a.name.toLowerCase().localeCompare(b.name.toLowerCase()));
+
+    return {
+      commands: allCommands,
+      total: allCommands.length,
+      userCount,
+      projectCount,
+      remoteCount: remoteCommands.length
+    };
+  }
+
   /**
    * 获取单个命令详情
    */
@@ -250,7 +360,7 @@ class CommandsService {
 
     let content = '';
     if (Object.keys(frontmatterData).length > 0) {
-      content = generateFrontmatter(frontmatterData) + '\n\n';
+      content = generateCommandFrontmatter(frontmatterData) + '\n\n';
     }
     content += body || '';
 
@@ -285,7 +395,7 @@ class CommandsService {
 
     let content = '';
     if (Object.keys(frontmatterData).length > 0) {
-      content = generateFrontmatter(frontmatterData) + '\n\n';
+      content = generateCommandFrontmatter(frontmatterData) + '\n\n';
     }
     content += body || '';
 
@@ -353,8 +463,82 @@ class CommandsService {
       namespaces
     };
   }
+
+  // ==================== 仓库管理 ====================
+
+  /**
+   * 获取仓库列表
+   */
+  getRepos() {
+    return this.repoScanner.loadRepos();
+  }
+
+  /**
+   * 添加仓库
+   */
+  addRepo(repo) {
+    return this.repoScanner.addRepo(repo);
+  }
+
+  /**
+   * 删除仓库
+   */
+  removeRepo(owner, name, directory = '') {
+    return this.repoScanner.removeRepo(owner, name, directory);
+  }
+
+  /**
+   * 切换仓库启用状态
+   */
+  toggleRepo(owner, name, directory = '', enabled) {
+    return this.repoScanner.toggleRepo(owner, name, directory, enabled);
+  }
+
+  /**
+   * 从远程仓库安装命令
+   */
+  async installFromRemote(command) {
+    return this.repoScanner.installCommand(command);
+  }
+
+  /**
+   * 卸载命令
+   */
+  uninstallCommand(relativePath) {
+    return this.repoScanner.uninstall(relativePath);
+  }
+
+  // ==================== 格式转换 ====================
+
+  /**
+   * 转换命令格式
+   * @param {string} content - 命令内容
+   * @param {string} targetFormat - 目标格式 ('claude' | 'codex')
+   */
+  convertCommandFormat(content, targetFormat) {
+    const sourceFormat = detectCommandFormat(content);
+
+    if (sourceFormat === targetFormat) {
+      return { content, warnings: [], format: targetFormat };
+    }
+
+    if (targetFormat === 'codex') {
+      return convertCommandToCodex(content);
+    } else {
+      return convertCommandToClaude(content);
+    }
+  }
+
+  /**
+   * 检测命令格式
+   * @param {string} content - 命令内容
+   */
+  detectFormat(content) {
+    return detectCommandFormat(content);
+  }
 }
 
 module.exports = {
-  CommandsService
+  CommandsService,
+  DEFAULT_REPOS
 };

package/src/server/services/config-export-service.js

@@ -0,0 +1,209 @@
+/**
+ * 配置导出/导入服务
+ * 支持权限模板、配置模板、频道配置的导出与导入
+ */
+
+const fs = require('fs');
+const path = require('path');
+const permissionTemplatesService = require('./permission-templates-service');
+const configTemplatesService = require('./config-templates-service');
+const channelsService = require('./channels');
+
+const CONFIG_VERSION = '1.0.0';
+
+/**
+ * 导出所有配置为JSON
+ * @returns {Object} 配置导出对象
+ */
+function exportAllConfigs() {
+  try {
+    // 获取所有权限模板（只导出自定义模板）
+    const allPermissionTemplates = permissionTemplatesService.getAllTemplates();
+    const customPermissionTemplates = allPermissionTemplates.filter(t => !t.isBuiltin);
+
+    // 获取所有配置模板（只导出自定义模板）
+    const allConfigTemplates = configTemplatesService.getAllTemplates();
+    const customConfigTemplates = allConfigTemplates.filter(t => !t.isBuiltin);
+
+    // 获取所有频道配置
+    const channelsData = channelsService.getAllChannels();
+    const channels = channelsData?.channels || [];
+
+    const exportData = {
+      version: CONFIG_VERSION,
+      exportedAt: new Date().toISOString(),
+      data: {
+        permissionTemplates: customPermissionTemplates,
+        configTemplates: customConfigTemplates,
+        channels: channels || []
+      }
+    };
+
+    return {
+      success: true,
+      data: exportData
+    };
+  } catch (error) {
+    console.error('[ConfigExport] 导出配置失败:', error);
+    return {
+      success: false,
+      message: error.message
+    };
+  }
+}
+
+/**
+ * 导入配置
+ * @param {Object} importData - 导入的配置对象
+ * @param {Object} options - 导入选项 { overwrite: boolean }
+ * @returns {Object} 导入结果
+ */
+function importConfigs(importData, options = {}) {
+  const { overwrite = false } = options;
+  const results = {
+    permissionTemplates: { success: 0, failed: 0, skipped: 0 },
+    configTemplates: { success: 0, failed: 0, skipped: 0 },
+    channels: { success: 0, failed: 0, skipped: 0 }
+  };
+
+  try {
+    // 验证导入数据格式
+    if (!importData || !importData.data) {
+      throw new Error('无效的导入数据格式');
+    }
+
+    const { permissionTemplates = [], configTemplates = [], channels = [] } = importData.data;
+
+    // 导入权限模板
+    for (const template of permissionTemplates) {
+      try {
+        const existing = permissionTemplatesService.getTemplateById(template.id);
+
+        if (existing && !overwrite) {
+          results.permissionTemplates.skipped++;
+          continue;
+        }
+
+        if (existing && overwrite) {
+          permissionTemplatesService.updateTemplate(template.id, template);
+        } else {
+          // 创建新模板（使用原ID）
+          const newTemplate = {
+            ...template,
+            isBuiltin: false,
+            importedAt: new Date().toISOString()
+          };
+          permissionTemplatesService.createTemplate(newTemplate);
+        }
+        results.permissionTemplates.success++;
+      } catch (err) {
+        console.error(`[ConfigImport] 导入权限模板失败: ${template.name}`, err);
+        results.permissionTemplates.failed++;
+      }
+    }
+
+    // 导入配置模板
+    for (const template of configTemplates) {
+      try {
+        const existing = configTemplatesService.getTemplateById(template.id);
+
+        if (existing && !overwrite) {
+          results.configTemplates.skipped++;
+          continue;
+        }
+
+        if (existing && overwrite) {
+          configTemplatesService.updateTemplate(template.id, template);
+        } else {
+          const newTemplate = {
+            ...template,
+            isBuiltin: false,
+            importedAt: new Date().toISOString()
+          };
+          configTemplatesService.createTemplate(newTemplate);
+        }
+        results.configTemplates.success++;
+      } catch (err) {
+        console.error(`[ConfigImport] 导入配置模板失败: ${template.name}`, err);
+        results.configTemplates.failed++;
+      }
+    }
+
+    // 导入频道配置
+    for (const channel of channels) {
+      try {
+        const channelsData = channelsService.getAllChannels();
+        const existingChannels = channelsData?.channels || [];
+        const existing = existingChannels.find(c => c.id === channel.id);
+
+        if (existing && !overwrite) {
+          results.channels.skipped++;
+          continue;
+        }
+
+        if (existing && overwrite) {
+          channelsService.updateChannel(channel.id, channel);
+        } else {
+          // createChannel 需要单独的参数，不是一个对象
+          const { name, baseUrl, apiKey, websiteUrl, ...extraConfig } = channel;
+          channelsService.createChannel(name, baseUrl, apiKey, websiteUrl, extraConfig);
+        }
+        results.channels.success++;
+      } catch (err) {
+        console.error(`[ConfigImport] 导入频道失败: ${channel.name}`, err);
+        results.channels.failed++;
+      }
+    }
+
+    return {
+      success: true,
+      results,
+      message: generateImportSummary(results)
+    };
+  } catch (error) {
+    console.error('[ConfigImport] 导入配置失败:', error);
+    return {
+      success: false,
+      message: error.message,
+      results
+    };
+  }
+}
+
+/**
+ * 生成导入摘要消息
+ */
+function generateImportSummary(results) {
+  const parts = [];
+
+  if (results.permissionTemplates.success > 0) {
+    parts.push(`权限模板: ${results.permissionTemplates.success}成功`);
+  }
+  if (results.configTemplates.success > 0) {
+    parts.push(`配置模板: ${results.configTemplates.success}成功`);
+  }
+  if (results.channels.success > 0) {
+    parts.push(`频道: ${results.channels.success}成功`);
+  }
+
+  const totalSkipped = results.permissionTemplates.skipped +
+                       results.configTemplates.skipped +
+                       results.channels.skipped;
+  if (totalSkipped > 0) {
+    parts.push(`${totalSkipped}项已跳过`);
+  }
+
+  const totalFailed = results.permissionTemplates.failed +
+                      results.configTemplates.failed +
+                      results.channels.failed;
+  if (totalFailed > 0) {
+    parts.push(`${totalFailed}项失败`);
+  }
+
+  return parts.join(', ');
+}
+
+module.exports = {
+  exportAllConfigs,
+  importConfigs
+};