cfix 1.0.0

package/bin/cfix

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * CodeFix CLI 入口文件
+ * 命令: cfix
+ */
+
+const path = require('path');
+
+// 设置根目录环境变量
+process.env.CFIX_ROOT = path.resolve(__dirname, '..');
+
+// 运行 CLI
+const cli = require('../cli/index');
+cli.run();

package/bin/cfix.cmd

@@ -0,0 +1,6 @@
+@echo off
+REM CodeFix CLI Windows 入口文件
+
+SETLOCAL
+SET "NODE_PATH=%NODE_PATH%;%~dp0..\node_modules"
+node "%~dp0..\cli\index.js" %*

package/cli/commands/config.js

@@ -0,0 +1,58 @@
+/**
+ * 配置管理命令
+ */
+
+const config = require('../lib/config-manager');
+
+async function get(key) {
+  try {
+    const value = config.get(key);
+    console.log(`${key}: ${JSON.stringify(value, null, 2)}`);
+  } catch (error) {
+    console.error(`❌ 获取配置失败: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+async function set(key, value) {
+  try {
+    // 尝试解析为 JSON
+    let parsedValue;
+    try {
+      parsedValue = JSON.parse(value);
+    } catch {
+      parsedValue = value;
+    }
+
+    config.set(key, parsedValue);
+    console.log(`✅ 已设置 ${key} = ${JSON.stringify(parsedValue)}`);
+
+    // 🔑 工作目录同步提示
+    if (key === 'server.workDir' || key === 'projects.defaultWorkDir') {
+      console.log(`💡 提示: server.workDir 和 projects.defaultWorkDir 已自动同步`);
+    }
+  } catch (error) {
+    console.error(`❌ 设置配置失败: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+async function list() {
+  try {
+    const allConfig = config.get();
+    console.log(JSON.stringify(allConfig, null, 2));
+  } catch (error) {
+    console.error(`❌ 获取配置失败: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+async function edit() {
+  console.log('🚧 编辑配置命令正在开发中...');
+}
+
+async function reset() {
+  console.log('🚧 重置配置命令正在开发中...');
+}
+
+module.exports = { get, set, list, edit, reset };

package/cli/commands/doctor.js

@@ -0,0 +1,240 @@
+/**
+ * 环境检查命令
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+
+/**
+ * 检查 Node.js
+ */
+function checkNode() {
+  const version = process.version;
+  const major = parseInt(version.slice(1).split('.')[0]);
+
+  if (major < 18) {
+    return { status: 'warning', message: `Node.js: ${version} (推荐 18+)` };
+  }
+
+  return { status: 'ok', message: `Node.js: ${version}` };
+}
+
+/**
+ * 检查 Git
+ */
+function checkGit() {
+  try {
+    const version = execSync('git --version', { encoding: 'utf-8' }).trim();
+    return { status: 'ok', message: version };
+  } catch {
+    return { status: 'error', message: 'Git 未安装' };
+  }
+}
+
+/**
+ * 检查配置文件
+ */
+function checkConfig() {
+  const config = require('../lib/config-manager');
+  const configPath = config.getConfigPath();
+
+  if (fs.existsSync(configPath)) {
+    return { status: 'ok', message: `配置文件: ${configPath}` };
+  }
+
+  return { status: 'warning', message: '配置文件不存在，将使用默认配置' };
+}
+
+/**
+ * 检查服务状态
+ */
+async function checkService() {
+  const ProcessManager = require('../lib/process-manager');
+  const config = require('../lib/config-manager');
+  const pm = new ProcessManager(config);
+
+  try {
+    const isRunning = await pm.isRunning();
+    if (isRunning) {
+      const pid = pm.getPid();
+      return { status: 'ok', message: `服务运行中 (PID: ${pid})` };
+    }
+    return { status: 'warning', message: '服务未运行' };
+  } catch {
+    return { status: 'error', message: '服务连接失败' };
+  }
+}
+
+/**
+ * 检查依赖
+ */
+function checkDependencies() {
+  const rootDir = process.env.CFIX_ROOT || path.resolve(__dirname, '../..');
+  const packageJson = path.join(rootDir, 'package.json');
+  const nodeModules = path.join(rootDir, 'node_modules');
+
+  if (!fs.existsSync(packageJson)) {
+    return { status: 'error', message: 'package.json 不存在' };
+  }
+
+  if (!fs.existsSync(nodeModules)) {
+    return { status: 'error', message: '依赖未安装，请运行 npm install' };
+  }
+
+  return { status: 'ok', message: '依赖已安装' };
+}
+
+/**
+ * 检查 AI 引擎
+ */
+function checkAIEngines() {
+  const engines = [];
+
+  // 检查 Claude CLI
+  try {
+    execSync('claude --version', { encoding: 'utf-8', stdio: 'pipe' });
+    engines.push('Claude CLI');
+  } catch {
+    // Claude CLI 不可用
+  }
+
+  // 检查 Claude API 配置
+  if (process.env.ANTHROPIC_API_KEY) {
+    engines.push('Claude API');
+  }
+
+  // 检查 Zhipu GLM
+  if (process.env.ZHIPU_API_KEY) {
+    engines.push('Zhipu GLM');
+  }
+
+  if (engines.length === 0) {
+    return { status: 'warning', message: '未配置 AI 引擎' };
+  }
+
+  return { status: 'ok', message: `可用引擎: ${engines.join(', ')}` };
+}
+
+/**
+ * 检查端口占用
+ */
+function checkPort() {
+  const config = require('../lib/config-manager');
+  const serviceConfig = config.getServiceConfig();
+  const port = serviceConfig.port || 3008;
+
+  try {
+    const net = require('net');
+    const server = net.createServer();
+
+    return new Promise((resolve) => {
+      server.once('error', () => {
+        resolve({ status: 'warning', message: `端口 ${port} 已被占用` });
+      });
+
+      server.once('listening', () => {
+        server.close();
+        resolve({ status: 'ok', message: `端口 ${port} 可用` });
+      });
+
+      server.listen(port);
+    });
+  } catch {
+    return { status: 'error', message: `端口 ${port} 检查失败` };
+  }
+}
+
+/**
+ * 检查系统资源
+ */
+function checkSystemResources() {
+  const totalMem = Math.round(os.totalmem() / 1024 / 1024 / 1024);
+  const freeMem = Math.round(os.freemem() / 1024 / 1024 / 1024);
+  const cpus = os.cpus().length;
+
+  if (freeMem < 1) {
+    return { status: 'warning', message: `内存: ${freeMem}GB/${totalMem}GB (可用内存不足)` };
+  }
+
+  return { status: 'ok', message: `CPU: ${cpus}核 | 内存: ${freeMem}GB/${totalMem}GB` };
+}
+
+/**
+ * 检查项目注册表
+ */
+function checkProjectRegistry() {
+  const config = require('../lib/config-manager');
+  const projects = config.listProjects();
+
+  if (projects.length === 0) {
+    return { status: 'warning', message: '未注册项目' };
+  }
+
+  return { status: 'ok', message: `已注册 ${projects.length} 个项目` };
+}
+
+/**
+ * 主处理函数
+ */
+async function handle(options = {}) {
+  console.log('🔍 CodeFix 环境检查');
+  console.log('');
+
+  const checks = [
+    { name: 'Node.js', fn: checkNode },
+    { name: 'Git', fn: checkGit },
+    { name: '配置', fn: checkConfig },
+    { name: '依赖', fn: checkDependencies },
+    { name: 'AI 引擎', fn: checkAIEngines },
+    { name: '端口', fn: checkPort },
+    { name: '系统资源', fn: checkSystemResources },
+    { name: '项目注册表', fn: checkProjectRegistry },
+    { name: '服务', fn: checkService }
+  ];
+
+  let errors = 0;
+  let warnings = 0;
+
+  for (const check of checks) {
+    try {
+      const result = await check.fn();
+      const icon = result.status === 'ok' ? '✅' : result.status === 'warning' ? '⚠️' : '❌';
+
+      console.log(`${icon} ${check.name.padEnd(12)} ${result.message}`);
+
+      if (result.status === 'error') errors++;
+      if (result.status === 'warning') warnings++;
+    } catch (error) {
+      console.log(`❌ ${check.name.padEnd(12)} 检查失败: ${error.message}`);
+      errors++;
+    }
+  }
+
+  console.log('');
+  console.log('======================================');
+
+  if (errors > 0) {
+    console.log(`❌ 发现 ${errors} 个错误，请修复后重试`);
+    console.log('======================================');
+    process.exit(1);
+  } else if (warnings > 0) {
+    console.log(`⚠️  发现 ${warnings} 个警告`);
+    console.log('');
+    console.log('建议操作:');
+    console.log('  cfix start               # 启动服务');
+    console.log('  cfix project add <path>  # 添加项目');
+    console.log('  cfix config set ai.defaultEngine <engine>  # 配置 AI 引擎');
+    console.log('======================================');
+  } else {
+    console.log('✅ 所有检查通过！');
+    console.log('');
+    console.log('下一步:');
+    console.log('  cfix start         # 启动服务');
+    console.log('  cfix "你的需求"    # 创建修复任务');
+    console.log('======================================');
+  }
+}
+
+module.exports = { handle };

package/cli/commands/fix.js

@@ -0,0 +1,211 @@
+/**
+ * 修复命令
+ */
+
+const ServiceClient = require("../lib/service-client");
+const ProcessManager = require("../lib/process-manager");
+const config = require("../lib/config-manager");
+const { createFormatter } = require("../lib/formatter");
+const path = require("path");
+
+const pm = new ProcessManager(config);
+
+/**
+ * 创建修复任务
+ */
+async function handle(requirement, options) {
+  // 创建格式化器
+  const formatter = createFormatter(options.output);
+
+  // 如果没有提供需求，显示帮助
+  if (!requirement) {
+    formatter.error("请提供修复需求");
+    process.exit(1);
+  }
+
+  // 静默模式跳过所有装饰性输出
+  if (options.output !== "quiet") {
+    console.log("🔧 创建修复任务");
+    console.log("");
+    console.log("======================================");
+    console.log(`需求: ${requirement}`);
+    console.log("======================================");
+    console.log("");
+  }
+
+  try {
+    // 确保服务运行
+    await ensureServiceRunning(options.output);
+
+    // 检测或获取项目路径
+    const projectPath = await resolveProjectPath(options.project);
+
+    if (options.output !== "quiet") {
+      console.log(`📁 项目路径: ${projectPath}`);
+      console.log("");
+    }
+
+    // 创建任务
+    const client = new ServiceClient();
+    const taskOptions = {
+      projectPath,
+      repoUrl: options.repoUrl,
+      requirement,
+      runTests: options.runTests || false,
+      mergeToAlpha: options.mergeToAlpha || false,
+      mergeToBeta: options.mergeToBeta || false,
+      autoConfirm: options.yes || false,
+      aiEngine: options.engine,
+      maxTurns: options.maxTurns,
+    };
+
+    if (options.output !== "quiet") {
+      console.log("⏳ 创建任务...");
+    }
+
+    const result = await client.createFixTask(taskOptions);
+
+    // JSON 模式直接输出结果
+    if (options.output === "json") {
+      formatter.output(result);
+      return result.taskId;
+    }
+
+    // Quiet 模式只输出任务 ID
+    if (options.output === "quiet") {
+      console.log(result.taskId);
+      return result.taskId;
+    }
+
+    console.log("");
+    console.log("======================================");
+    console.log("✅ 任务已创建");
+    console.log("======================================");
+    console.log("");
+    console.log(`任务 ID: ${result.taskId}`);
+    console.log(`状态: ${result.status || "padding"}`);
+    console.log("");
+
+    // 如果需要等待任务完成
+    if (options.wait) {
+      console.log("⏳ 等待任务完成...");
+      console.log("");
+
+      const finalTask = await client.waitForTask(result.taskId, {
+        timeout: 1800000, // 30分钟
+        interval: 2000,
+        onProgress: (task) => {
+          if (task.progress) {
+            process.stdout.write(`\r进度: ${task.progress}%`);
+          }
+        },
+      });
+
+      console.log("");
+      console.log("");
+      console.log("======================================");
+      console.log("✅ 任务完成");
+      console.log("======================================");
+      console.log("");
+
+      // 显示结果
+      if (finalTask.result) {
+        console.log("修复结果:");
+        console.log(
+          `  修改文件: ${finalTask.result.files?.modified?.length || 0} 个`
+        );
+        console.log(
+          `  新增文件: ${finalTask.result.files?.added?.length || 0} 个`
+        );
+        console.log(
+          `  删除文件: ${finalTask.result.files?.deleted?.length || 0} 个`
+        );
+      }
+
+      // 如果需要确认
+      if (finalTask.status === "waiting_approval") {
+        console.log("");
+        console.log("⚠️  任务需要人工确认");
+        console.log("");
+        console.log("使用以下命令查看修改:");
+        console.log(`  cfix task ${result.taskId}       # 查看详情`);
+        console.log(`  cfix approve ${result.taskId}   # 批准修改`);
+        console.log(`  cfix reject ${result.taskId}    # 拒绝修改`);
+      }
+    } else {
+      console.log("提示:");
+      console.log(`  cfix task ${result.taskId}       # 查看任务详情`);
+      console.log(`  cfix tasks                      # 查看所有任务`);
+      console.log(`  cfix wait ${result.taskId}      # 等待任务完成`);
+    }
+
+    return result.taskId;
+  } catch (error) {
+    if (options.output === "json") {
+      formatter.error("创建任务失败", error);
+    } else if (options.output === "quiet") {
+      console.error(`错误: ${error.message}`);
+    } else {
+      console.error("");
+      console.error("======================================");
+      console.error(`❌ 创建任务失败: ${error.message}`);
+      console.error("======================================");
+    }
+    process.exit(1);
+  }
+}
+
+/**
+ * 确保服务运行
+ */
+async function ensureServiceRunning(outputFormat = "interactive") {
+  const isRunning = await pm.isRunning();
+
+  if (!isRunning) {
+    if (outputFormat !== "quiet") {
+      console.log("⚠️  服务未运行，正在自动启动...");
+      console.log("");
+    }
+
+    await pm.start({ daemon: true, wait: true });
+
+    if (outputFormat !== "quiet") {
+      console.log("");
+      console.log("✅ 服务已启动");
+      console.log("");
+    }
+  }
+}
+
+/**
+ * 解析项目路径
+ */
+async function resolveProjectPath(projectOption) {
+  // 如果指定了项目路径
+  if (projectOption) {
+    // 检查是否是已注册的项目别名/名称
+    const project = config.findProject(projectOption);
+    if (project) {
+      return project.path;
+    }
+    // 直接返回路径
+    return path.resolve(projectOption);
+  }
+
+  // 尝试检测当前目录
+  const currentProject = config.detectCurrentProject();
+  if (currentProject) {
+    return currentProject.path;
+  }
+
+  // 使用默认项目
+  const defaultProject = config.getDefaultProject();
+  if (defaultProject) {
+    return defaultProject.path;
+  }
+
+  // 如果没有找到项目
+  throw new Error("未找到项目，请使用 --project 指定项目路径");
+}
+
+module.exports = { handle };

package/cli/commands/help.js

@@ -0,0 +1,62 @@
+/**
+ * 帮助命令
+ */
+
+const config = require('../lib/config-manager');
+
+/**
+ * 显示帮助信息
+ */
+async function handle() {
+  console.log(`
+╔═══════════════════════════════════════════════════════════════╗
+║                      CodeFix CLI v${require('../../package.json').version}                      ║
+║                 AI 自动代码修复工具                              ║
+╚═══════════════════════════════════════════════════════════════╝
+
+核心命令:
+  cfix <requirement>              创建修复任务
+  cfix start                      启动服务
+  cfix stop                       停止服务
+  cfix restart                    重启服务
+  cfix status                     查看服务状态
+  cfix logs [-f]                  查看日志
+
+项目管理:
+  cfix project add <path>         添加项目
+  cfix project remove <path>      移除项目
+  cfix project list               列出所有项目
+  cfix project info <path>        项目详情
+
+配置管理:
+  cfix config get <key>           获取配置
+  cfix config set <key> <value>   设置配置
+  cfix config list                列出配置
+  cfix config edit                编辑配置
+
+任务管理:
+  cfix tasks [-p <project>]       查看任务列表
+  cfix task <taskId>              查看任务详情
+  cfix approve <taskId>           批准任务
+  cfix reject <taskId>            拒绝任务
+  cfix cancel <taskId>            取消任务
+
+工具命令:
+  cfix init [path]                初始化项目配置
+  cfix monitor                    打开监控面板
+  cfix doctor                     环境检查
+  cfix version                    版本信息
+
+更多帮助:
+  cfix <command> --help           查看命令详细帮助
+
+配置文件:
+  全局配置: ${config.getConfigPath()}
+  项目配置: <project>/.cfix.json
+
+文档:
+  https://github.com/your-repo/cfix
+`);
+}
+
+module.exports = { handle };