cfix 1.0.0

package/cli/lib/config-manager.js

@@ -0,0 +1,612 @@
+/**
+ * 配置管理器
+ * 管理全局配置和项目配置
+ */
+
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+/**
+ * 共享工作目录路径
+ */
+const SHARED_WORK_DIR = process.env.WORK_DIR ||  path.join(os.homedir(), 'cfix-projects');
+
+/**
+ * 默认配置
+ */
+const DEFAULT_CONFIG = {
+  version: '2.0.0',
+  service: {
+    port: 3008,
+    host: 'localhost',
+    autoStart: true,
+    logLevel: 'info',
+    maxConcurrent: 3,
+    timeout: 30000
+  },
+  server: {
+    workDir: SHARED_WORK_DIR,
+    corsOrigin: '*'
+  },
+  projects: {
+    defaultWorkDir: SHARED_WORK_DIR,
+    defaultProject: null,
+    registry: []
+  },
+  ai: {
+    defaultEngine: 'claude-cli',
+    claudeCLI: {
+      path: 'claude',
+      permissionMode: 'acceptEdits',
+      allowedTools: 'Bash(*) Read(*) Edit(*) Write(*)',
+      debug: false,
+      maxTurns: 20,
+      timeout: 1800000
+    }
+  },
+  cli: {
+    output: 'interactive',
+    spinner: true,
+    colors: true,
+    confirmChanges: true,
+    autoOpenMonitor: false
+  },
+  notification: {
+    enabled: false,
+    wecomWebhook: null,
+    systemNotification: {
+      enabled: false,
+      showOnTaskStart: true,
+      showOnTaskComplete: true,
+      showOnTaskFailure: true,
+      showOnApproval: true
+    }
+  },
+  logging: {
+    level: 'info'
+  },
+  security: {
+    apiKey: null,
+    allowedIPs: [],
+    rateLimit: {
+      windowMs: 900000, // 15分钟
+      max: 20
+    }
+  },
+  redis: {
+    host: null,
+    port: 6379,
+    password: null
+  },
+  queue: {
+    maxConcurrent: 3,
+    useRedis: false
+  }
+};
+
+/**
+ * 配置管理器类
+ */
+class ConfigManager {
+  constructor() {
+    this.store = {};
+    this.configDir = this.getConfigDir();
+    this.configFile = path.join(this.configDir, 'config.json');
+    this.init();
+  }
+
+  /**
+   * 获取配置目录
+   */
+  getConfigDir() {
+    const platform = process.platform;
+    let baseDir;
+
+    if (platform === 'win32') {
+      baseDir = process.env.LOCALAPPDATA || path.join(os.homedir(), '.cfix');
+    } else {
+      baseDir = path.join(os.homedir(), '.cfix');
+    }
+
+    return baseDir;
+  }
+
+  /**
+   * 从环境变量加载配置
+   */
+  loadFromEnv() {
+    return {
+      server: {
+        port: process.env.PORT ? parseInt(process.env.PORT) : undefined,
+        workDir: process.env.WORK_DIR || undefined,
+        corsOrigin: process.env.CORS_ORIGIN || undefined
+      },
+      ai: {
+        defaultEngine: process.env.AI_ENGINE || undefined,
+        claudeCLI: {
+          path: process.env.CLAUDE_CLI_PATH || undefined,
+          permissionMode: process.env.CLAUDE_PERMISSION_MODE || undefined,
+          allowedTools: process.env.CLAUDE_ALLOWED_TOOLS || undefined,
+          debug: process.env.CLAUDE_DEBUG === 'true' ? true : (process.env.CLAUDE_DEBUG === 'false' ? false : undefined),
+          maxTurns: process.env.MAX_CONVERSATION_TURNS ? parseInt(process.env.MAX_CONVERSATION_TURNS) : undefined
+        }
+      },
+      security: {
+        apiKey: process.env.API_KEY || undefined,
+        rateLimit: {
+          max: process.env.RATE_LIMIT_MAX ? parseInt(process.env.RATE_LIMIT_MAX) : undefined
+        }
+      },
+      notification: {
+        wecomWebhook: process.env.WECOM_WEBHOOK || undefined,
+        systemNotification: {
+          enabled: process.env.SYSTEM_NOTIFICATION_ENABLED === 'true' ? true : (process.env.SYSTEM_NOTIFICATION_ENABLED === 'false' ? false : undefined)
+        }
+      },
+      logging: {
+        level: process.env.LOG_LEVEL || undefined
+      },
+      redis: {
+        host: process.env.REDIS_HOST || undefined,
+        port: process.env.REDIS_PORT ? parseInt(process.env.REDIS_PORT) : undefined,
+        password: process.env.REDIS_PASSWORD || undefined
+      },
+      queue: {
+        maxConcurrent: process.env.QUEUE_MAX_CONCURRENT ? parseInt(process.env.QUEUE_MAX_CONCURRENT) : undefined,
+        useRedis: process.env.USE_REDIS_QUEUE === 'true' ? true : (process.env.USE_REDIS_QUEUE === 'false' ? false : undefined)
+      }
+    };
+  }
+
+  /**
+   * 判断是否为对象
+   */
+  isObject(item) {
+    return item && typeof item === 'object' && !Array.isArray(item);
+  }
+
+  /**
+   * 深度合并配置
+   * 跳过 undefined 值，保留已有的有效值
+   */
+  deepMerge(target, ...sources) {
+    if (!sources.length) return target;
+    const source = sources.shift();
+
+    if (this.isObject(target) && this.isObject(source)) {
+      for (const key in source) {
+        if (source[key] === undefined) continue; // 跳过 undefined
+
+        if (this.isObject(source[key])) {
+          if (!target[key]) Object.assign(target, { [key]: {} });
+          this.deepMerge(target[key], source[key]);
+        } else {
+          Object.assign(target, { [key]: source[key] });
+        }
+      }
+    }
+
+    return this.deepMerge(target, ...sources);
+  }
+
+  /**
+   * 初始化配置
+   */
+  init() {
+    // 确保配置目录存在
+    if (!fs.existsSync(this.configDir)) {
+      fs.mkdirSync(this.configDir, { recursive: true });
+    }
+
+    // 1. 加载默认配置（深拷贝）
+    const defaults = JSON.parse(JSON.stringify(DEFAULT_CONFIG));
+
+    // 2. 加载环境变量
+    const envConfig = this.loadFromEnv();
+
+    // 3. 加载配置文件
+    let fileConfig = {};
+    if (fs.existsSync(this.configFile)) {
+      try {
+        const content = fs.readFileSync(this.configFile, 'utf-8');
+        fileConfig = JSON.parse(content);
+      } catch (error) {
+        console.warn(`配置文件损坏，使用默认配置: ${error.message}`);
+      }
+    }
+    // console.log('envConfig', envConfig,defaults, fileConfig)
+    // 4. 深度合并: 默认值 <- 环境变量 <- 配置文件
+    this.store = this.deepMerge(this.deepMerge(defaults, envConfig), fileConfig);
+
+    // 5. 配置迁移
+    this.migrate();
+
+    // 6. 自动保存（如果配置文件不存在）
+    if (!fs.existsSync(this.configFile)) {
+      this.save();
+    }
+  }
+
+  /**
+   * 配置迁移
+   */
+  migrate() {
+    // 检查版本
+    if (!this.store.version || this.store.version < '2.0.0') {
+      console.log('检测到旧版配置，正在迁移...');
+
+      // 迁移 AI 配置
+      if (this.store.ai && !this.store.ai.claudeCLI) {
+        this.store.ai.claudeCLI = {
+          permissionMode: this.store.ai.permissionMode || 'acceptEdits',
+          maxTurns: this.store.ai.maxConversations || 20,
+          timeout: this.store.ai.timeout || 1800000,
+          path: 'claude',
+          allowedTools: 'Bash(*) Read(*) Edit(*) Write(*)',
+          debug: false
+        };
+        delete this.store.ai.maxConversations;
+        delete this.store.ai.permissionMode;
+        delete this.store.ai.timeout;
+      }
+
+      // 迁移 service.maxConcurrent 到 queue.maxConcurrent
+      if (this.store.service?.maxConcurrent && !this.store.queue?.maxConcurrent) {
+        if (!this.store.queue) this.store.queue = {};
+        this.store.queue.maxConcurrent = this.store.service.maxConcurrent;
+      }
+
+      // 迁移 notifications 到 notification
+      if (this.store.notifications && !this.store.notification) {
+        this.store.notification = this.store.notifications;
+        delete this.store.notifications;
+      }
+
+      // 添加缺少的配置块
+      if (!this.store.server) {
+        this.store.server = {
+          workDir: this.store.projects?.defaultWorkDir || DEFAULT_CONFIG.server.workDir,
+          corsOrigin: '*'
+        };
+      }
+
+      if (!this.store.security) {
+        this.store.security = DEFAULT_CONFIG.security;
+      }
+
+      if (!this.store.logging) {
+        this.store.logging = { level: this.store.service?.logLevel || 'info' };
+      }
+
+      if (!this.store.redis) {
+        this.store.redis = DEFAULT_CONFIG.redis;
+      }
+
+      this.store.version = '2.0.0';
+      this.save();
+      console.log('✅ 配置已迁移到 v2.0.0');
+    }
+  }
+
+  /**
+   * 保存配置
+   */
+  save() {
+    fs.writeFileSync(this.configFile, JSON.stringify(this.store, null, 2), 'utf-8');
+  }
+
+  /**
+   * 获取全局配置
+   * @param {string} key - 配置键（支持点号分隔的路径）
+   * @returns {*} 配置值
+   */
+  get(key) {
+    if (!key) {
+      return this.store;
+    }
+
+    // 支持点号分隔的路径，如 'service.port'
+    const keys = key.split('.');
+    let value = this.store;
+
+    for (const k of keys) {
+      if (value && typeof value === 'object') {
+        value = value[k];
+      } else {
+        return undefined;
+      }
+    }
+
+    return value;
+  }
+
+  /**
+   * 设置全局配置
+   * @param {string} key - 配置键
+   * @param {*} value - 配置值
+   */
+  set(key, value) {
+    // 支持点号分隔的路径
+    const keys = key.split('.');
+    let target = this.store;
+
+    for (let i = 0; i < keys.length - 1; i++) {
+      const k = keys[i];
+      if (!(k in target) || typeof target[k] !== 'object') {
+        target[k] = {};
+      }
+      target = target[k];
+    }
+
+    target[keys[keys.length - 1]] = value;
+
+    // 🔑 同步工作目录配置
+    // 当设置 server.workDir 时，同时更新 projects.defaultWorkDir
+    if (key === 'server.workDir') {
+      if (!this.store.projects) this.store.projects = {};
+      this.store.projects.defaultWorkDir = value;
+    }
+    // 当设置 projects.defaultWorkDir 时，同时更新 server.workDir
+    else if (key === 'projects.defaultWorkDir') {
+      if (!this.store.server) this.store.server = {};
+      this.store.server.workDir = value;
+    }
+
+    this.save();
+  }
+
+  /**
+   * 删除配置
+   * @param {string} key - 配置键
+   */
+  delete(key) {
+    const keys = key.split('.');
+    let target = this.store;
+
+    for (let i = 0; i < keys.length - 1; i++) {
+      const k = keys[i];
+      if (!(k in target) || typeof target[k] !== 'object') {
+        return;
+      }
+      target = target[k];
+    }
+
+    delete target[keys[keys.length - 1]];
+    this.save();
+  }
+
+  /**
+   * 清空所有配置
+   */
+  clear() {
+    this.store = { ...DEFAULT_CONFIG };
+    this.save();
+  }
+
+  /**
+   * 获取配置文件路径
+   */
+  getConfigPath() {
+    return this.configFile;
+  }
+
+  /**
+   * 获取项目配置
+   * @param {string} projectPath - 项目路径
+   * @returns {Object|null} 项目配置
+   */
+  getProjectConfig(projectPath) {
+    const configFile = path.join(projectPath, '.cfix.json');
+    if (!fs.existsSync(configFile)) {
+      return null;
+    }
+
+    try {
+      const content = fs.readFileSync(configFile, 'utf-8');
+      return JSON.parse(content);
+    } catch (error) {
+      throw new Error(`读取项目配置失败: ${error.message}`);
+    }
+  }
+
+  /**
+   * 保存项目配置
+   * @param {string} projectPath - 项目路径
+   * @param {Object} config - 配置对象
+   */
+  saveProjectConfig(projectPath, config) {
+    const configFile = path.join(projectPath, '.cfix.json');
+    const content = JSON.stringify(config, null, 2);
+    fs.writeFileSync(configFile, content, 'utf-8');
+  }
+
+  /**
+   * 添加项目到注册表
+   * @param {Object} project - 项目对象
+   */
+  addProject(project) {
+    const projects = this.get('projects.registry') || [];
+
+    // 检查是否已存在
+    const exists = projects.some(p => p.path === project.path);
+    if (exists) {
+      throw new Error('项目已存在');
+    }
+
+    projects.push(project);
+    this.set('projects.registry', projects);
+  }
+
+  /**
+   * 从注册表移除项目
+   * @param {string} identifier - 项目标识（路径/名称/别名）
+   */
+  removeProject(identifier) {
+    const projects = this.get('projects.registry') || [];
+    const project = this.findProject(identifier);
+
+    if (!project) {
+      throw new Error('项目不存在');
+    }
+
+    const index = projects.indexOf(project);
+    projects.splice(index, 1);
+    this.set('projects.registry', projects);
+  }
+
+  /**
+   * 查找项目
+   * @param {string} identifier - 项目标识
+   * @returns {Object|null} 项目对象
+   */
+  findProject(identifier) {
+    const projects = this.get('projects.registry') || [];
+
+    // 按路径查找
+    const resolvedPath = path.resolve(identifier);
+    let project = projects.find(p => p.path === resolvedPath);
+    if (project) return project;
+
+    // 按名称查找
+    project = projects.find(p => p.name === identifier);
+    if (project) return project;
+
+    // 按别名查找
+    project = projects.find(p => p.alias === identifier);
+    if (project) return project;
+
+    return null;
+  }
+
+  /**
+   * 列出所有项目
+   */
+  listProjects() {
+    return this.get('projects.registry') || [];
+  }
+
+  /**
+   * 设置默认项目
+   * @param {string} identifier - 项目标识
+   */
+  setDefaultProject(identifier) {
+    const project = this.findProject(identifier);
+    if (!project) {
+      throw new Error('项目不存在');
+    }
+    this.set('projects.defaultProject', project.path);
+  }
+
+  /**
+   * 获取默认项目
+   */
+  getDefaultProject() {
+    const defaultPath = this.get('projects.defaultProject');
+    if (!defaultPath) {
+      return null;
+    }
+    return this.findProject(defaultPath);
+  }
+
+  /**
+   * 检测当前目录项目
+   */
+  detectCurrentProject() {
+    const cwd = process.cwd();
+
+    // 检查是否为 Git 仓库
+    const gitDir = path.join(cwd, '.git');
+    if (!fs.existsSync(gitDir)) {
+      return null;
+    }
+
+    // 读取项目配置
+    const projectConfig = this.getProjectConfig(cwd);
+    if (projectConfig) {
+      return {
+        path: cwd,
+        ...projectConfig
+      };
+    }
+
+    // 在注册表中查找
+    return this.findProject(cwd);
+  }
+
+  /**
+   * 获取服务配置
+   */
+  getServiceConfig() {
+    return {
+      port: this.get('service.port'),
+      host: this.get('service.host'),
+      autoStart: this.get('service.autoStart'),
+      logLevel: this.get('service.logLevel'),
+      maxConcurrent: this.get('service.maxConcurrent'),
+      timeout: this.get('service.timeout')
+    };
+  }
+
+  /**
+   * 获取 AI 配置
+   */
+  getAIConfig() {
+    return {
+      defaultEngine: this.get('ai.defaultEngine'),
+      claudeCLI: this.get('ai.claudeCLI')
+    };
+  }
+
+  /**
+   * 获取 CLI 配置
+   */
+  getCLIConfig() {
+    return {
+      output: this.get('cli.output'),
+      spinner: this.get('cli.spinner'),
+      colors: this.get('cli.colors'),
+      confirmChanges: this.get('cli.confirmChanges'),
+      autoOpenMonitor: this.get('cli.autoOpenMonitor')
+    };
+  }
+
+  /**
+   * 验证配置
+   * @param {Object} config - 配置对象
+   */
+  validateConfig(config) {
+    // 端口验证（检查 service.port 和 server.port）
+    if (config.service && config.service.port) {
+      const port = parseInt(config.service.port);
+      if (isNaN(port) || port < 1 || port > 65535) {
+        throw new Error('无效的端口号');
+      }
+    }
+    if (config.server && config.server.port) {
+      const port = parseInt(config.server.port);
+      if (isNaN(port) || port < 1 || port > 65535) {
+        throw new Error('无效的端口号');
+      }
+    }
+
+    // AI 引擎验证
+    if (config.ai && config.ai.defaultEngine) {
+      if (config.ai.defaultEngine !== 'claude-cli') {
+        throw new Error('无效的 AI 引擎，当前仅支持 claude-cli');
+      }
+    }
+
+    // Claude CLI 配置验证
+    if (config.ai?.claudeCLI) {
+      const cli = config.ai.claudeCLI;
+      if (cli.maxTurns && (cli.maxTurns < 1 || cli.maxTurns > 100)) {
+        throw new Error('maxTurns 必须在 1-100 之间');
+      }
+    }
+
+    return true;
+  }
+}
+
+// 导出单例
+module.exports = new ConfigManager();