cfix 1.0.0

package/scripts/completion.bash

@@ -0,0 +1,87 @@
+#!/usr/bin/env bash
+# cfix bash completion
+
+_cfix_completion() {
+  local cur prev words cword
+  _init_completion || return
+
+  # 主命令
+  if [[ ${cword} -eq 1 ]]; then
+    COMPREPLY=($(compgen -W "
+      fix
+      start stop restart
+      status logs
+      project
+      config
+      tasks task approve reject cancel wait
+      init monitor doctor
+      version help
+      --help --version
+    " -- "${cur}"))
+    return
+  fi
+
+  # 子命令补全
+  case "${words[1]}" in
+    project)
+      if [[ ${cword} -eq 2 ]]; then
+        COMPREPLY=($(compgen -W "add remove list info" -- "${cur}"))
+      fi
+      ;;
+
+    config)
+      if [[ ${cword} -eq 2 ]]; then
+        COMPREPLY=($(compgen -W "get set list edit reset" -- "${cur}"))
+      fi
+      ;;
+
+    init)
+      # 目录补全
+      COMPREPLY=($(compgen -d -- "${cur}"))
+      ;;
+
+    monitor)
+      if [[ ${cword} -eq 2 ]]; then
+        COMPREPLY=($(compgen -W "--follow --no-auto-start" -- "${cur}"))
+      fi
+      ;;
+
+    fix)
+      if [[ "${cur}" == -* ]]; then
+        COMPREPLY=($(compgen -W "--project --output --wait --yes --help" -- "${cur}"))
+      fi
+      ;;
+
+    start|stop|restart)
+      if [[ "${cur}" == -* ]]; then
+        COMPREPLY=($(compgen -W "--daemon --wait --quiet --help" -- "${cur}"))
+      fi
+      ;;
+
+    logs)
+      if [[ "${cur}" == -* ]]; then
+        COMPREPLY=($(compgen -W "--follow --errors --help" -- "${cur}"))
+      fi
+      ;;
+
+    tasks)
+      if [[ "${cur}" == -* ]]; then
+        COMPREPLY=($(compgen -W "--project --status --all --help" -- "${cur}"))
+      fi
+      ;;
+
+    wait)
+      if [[ "${cur}" == -* ]]; then
+        COMPREPLY=($(compgen -W "--timeout --interval --yes --help" -- "${cur}"))
+      fi
+      ;;
+
+    approve)
+      if [[ "${cur}" == -* ]]; then
+        COMPREPLY=($(compgen -W "--yes --help" -- "${cur}"))
+      fi
+      ;;
+  esac
+}
+
+complete -F _cfix_completion cfix

package/scripts/completion.zsh

@@ -0,0 +1,102 @@
+#compdef cfix
+# cfix zsh completion
+
+_cfix() {
+  local -a commands
+  commands=(
+    'fix:创建修复任务'
+    'start:启动服务'
+    'stop:停止服务'
+    'restart:重启服务'
+    'status:查看服务状态'
+    'logs:查看日志'
+    'project:项目管理命令'
+    'config:配置管理命令'
+    'tasks:查看任务列表'
+    'task:查看任务详情'
+    'approve:批准任务'
+    'reject:拒绝任务'
+    'cancel:取消任务'
+    'wait:等待任务完成'
+    'init:初始化项目配置'
+    'monitor:打开监控面板'
+    'doctor:环境检查'
+    'version:版本信息'
+    'help:帮助信息'
+  )
+
+  if [[ CURRENT -eq 1 ]]; then
+    _describe 'command' commands
+    return
+  fi
+
+  case "${words[2]}" in
+    project)
+      _cfix_project() {
+        local -a subcommands
+        subcommands=(
+          'add:添加项目'
+          'remove:移除项目'
+          'list:列出所有项目'
+          'info:项目详情'
+        )
+        if [[ CURRENT -eq 2 ]]; then
+          _describe 'subcommand' subcommands
+        elif [[ "${words[3]}" == add ]]; then
+          _files -/
+        fi
+      }
+      _cfix_project
+      ;;
+
+    config)
+      _cfix_config() {
+        local -a subcommands
+        subcommands=(
+          'get:获取配置'
+          'set:设置配置'
+          'list:列出配置'
+          'edit:编辑配置文件'
+          'reset:重置配置'
+        )
+        if [[ CURRENT -eq 2 ]]; then
+          _describe 'subcommand' subcommands
+        fi
+      }
+      _cfix_config
+      ;;
+
+    init)
+      _directories
+      ;;
+
+    fix)
+      _arguments \
+        '--project[项目路径]' \
+        '--output[输出格式]:format:(interactive json quiet)' \
+        '--wait[等待任务完成]' \
+        '--yes[自动确认]' \
+        '--help[显示帮助]'
+      ;;
+
+    monitor)
+      _arguments \
+        '--follow[持续监控状态]' \
+        '--no-auto-start[不自动启动服务]'
+      ;;
+
+    wait)
+      _arguments \
+        '--timeout[超时时间(毫秒)]' \
+        '--interval[检查间隔(毫秒)]' \
+        '--yes[自动批准]'
+      ;;
+
+    approve)
+      _arguments \
+        '--yes[跳过确认]'
+      ;;
+  esac
+}
+
+_cfix "$@"

package/src/assets/README.md

@@ -0,0 +1,32 @@
+# 通知图标资源
+
+此目录用于存放系统通知所需的图标资源。
+
+## 所需图标
+
+请准备以下图标文件（PNG 格式，建议尺寸 64x64 或 128x128）：
+
+1. **icon.png** - 主图标（用于通知）
+2. **success.png** - 成功图标（可选）
+3. **error.png** - 错误图标（可选）
+
+## 如何添加图标
+
+### 方法 1: 使用现有图标
+将您的项目 logo 或品牌图标复制到此目录，重命名为 `icon.png`
+
+### 方法 2: 使用在线工具生成
+1. 访问 https://www.favicon-generator.org/
+2. 上传您的图片或使用文字生成
+3. 下载 PNG 格式图标
+4. 保存到此目录
+
+### 方法 3: 使用默认图标
+如果不提供图标，node-notifier 将使用系统默认图标
+
+## 注意事项
+
+- 图标文件应为透明背景的 PNG 格式
+- 建议尺寸：64x64 或 128x128 像素
+- 文件大小建议小于 100KB
+- 如果图标未找到，通知功能仍能正常工作，只是不会显示自定义图标

package/src/claude-cli-service.js

@@ -0,0 +1,216 @@
+const ExecUtil = require("./utils/exec");
+const path = require("path");
+const { logger } = require("./logger");
+const GitService = require("./git-service");
+
+/**
+ * Claude CLI 服务
+ * 使用 claude -p "prompt" 命令执行一次性任务
+ * 参考命令：claude -p "prompt" --permission-mode acceptEdits --allowedTools "..." --debug
+ */
+class ClaudeCLIService {
+  constructor(config) {
+    this.claudePath = config.claudePath || "claude"; // Claude CLI 路径
+    this.permissionMode = config.permissionMode || "acceptEdits"; // 权限模式
+    this.allowedTools =
+      config.allowedTools || "Bash(*) Read(*) Edit(*) Write(*)"; // 允许的工具
+    this.debug = config.debug || true; // 是否开启调试模式
+    this.maxTurns = config.maxTurns || 20;
+  }
+
+  /**
+   * 使用 Claude CLI 修复代码
+   * @param {string} projectPath - 项目路径
+   * @param {string} requirement - 修复要求
+   * @param {Object} options - 可选参数
+   * @param {Function} options.onProcessCreated - 子进程创建回调
+   * @returns {Promise<object>} 修复结果
+   */
+  async fixCode(projectPath, requirement, options = {}) {
+    return new Promise((resolve, reject) => {
+      const startTime = Date.now();
+      let isCancelled = false;
+
+      // 构建提示词
+      const prompt = `你是一个专业的代码修复助手。我需要你帮我完成以下任务：
+
+【任务描述】
+${requirement}
+
+【项目路径】
+${projectPath}
+
+【工作流程】
+1. 了解项目结构
+2. 查找相关代码
+3. 读取需要修改的文件
+4. 完成代码修改
+5. 完成后请总结你做了哪些更改
+
+【重要提示】
+- 请仔细阅读现有代码，理解项目结构后再修改
+- 修改时保持代码风格一致
+- 确保修改后的代码语法正确
+- 完成后请明确说明修改了哪些文件
+
+现在开始工作吧！`;
+
+      logger.info("🤖 启动 Claude CLI 进行代码修复...");
+      logger.info(`📂 工作目录: ${projectPath}`);
+      logger.info(`📋 需求: ${requirement}`);
+      logger.info(`🔧 权限模式: ${this.permissionMode}`);
+      logger.info(`🛠️  允许工具: ${this.allowedTools}`);
+      logger.info(`📝 Prompt 长度: ${prompt.length} 字符`);
+
+      // 转义 prompt 用于 shell 命令（关键：处理换行符）
+      const escapedPrompt = prompt
+        .replace(/\\/g, '\\\\')    // 转义反斜杠
+        .replace(/\r\n/g, '\\n')   // Windows 换行符转为 \n
+        .replace(/\n/g, '\\n')     // Unix 换行符转为 \n
+        .replace(/\r/g, '\\n')     // Mac 换行符转为 \n
+        .replace(/"/g, '\\"')      // 转义双引号
+        .replace(/`/g, '\\`')      // 转义反引号
+        .replace(/\$/g, '\\$');    // 转义美元符号
+
+      // 构建完整的 shell 命令字符串
+      let command = `${this.claudePath} -p "${escapedPrompt}" --permission-mode ${this.permissionMode} --allowedTools "${this.allowedTools}"`;
+
+      // 添加调试模式
+      if (this.debug) {
+        command += " --debug";
+      }
+
+      logger.info(
+        `🔧 执行命令: ${this.claudePath} -p "<prompt>" --permission-mode ${
+          this.permissionMode
+        }${this.debug ? " --debug" : ""}`
+      );
+      logger.debug("command:", command);
+
+      // 启动 Claude CLI 子进程（使用 shell 模式，传入完整命令字符串）
+      // 使用 ExecUtil.spawnShell 确保在 Windows 上隐藏窗口
+      const claude = ExecUtil.spawnShell(command, {
+        cwd: projectPath,
+        stdio: ["ignore", "pipe", "pipe"], // stdin 设为 ignore，避免等待输入
+        env: {
+          ...process.env,
+          FORCE_COLOR: "0", // 禁用颜色输出
+          CI: "true", // 非交互式环境标识
+        },
+      });
+
+      // 通知父进程：子进程已创建，传递终止函数
+      if (options.onProcessCreated) {
+        options.onProcessCreated({
+          childProcess: claude,
+          cancel: () => {
+            if (!isCancelled) {
+              isCancelled = true;
+              logger.warn('🛑 收到取消请求，正在终止 Claude CLI 进程...');
+
+              // 先尝试优雅终止
+              claude.kill('SIGTERM');
+
+              // 5秒后强制终止
+              setTimeout(() => {
+                if (claude.exitCode === null) {
+                  logger.warn('⚠️ 进程未响应 SIGTERM，使用 SIGKILL 强制终止');
+                  claude.kill('SIGKILL');
+                }
+              }, 5000);
+            }
+          }
+        });
+      }
+
+      let stdout = "";
+      let stderr = "";
+      // 不再从输出提取文件列表,改为通过 git diff 获取
+
+      // 添加超时保护（30分钟）
+      const timeout = setTimeout(() => {
+        logger.warn("⚠️  执行超时，强制终止 Claude CLI 进程");
+        claude.kill("SIGTERM");
+        setTimeout(() => claude.kill("SIGKILL"), 5000);
+      }, 30 * 60 * 1000);
+
+      // 收集标准输出
+      claude.stdout.on("data", (data) => {
+        const output = data.toString();
+        stdout += output;
+
+        // 实时显示输出
+        process.stdout.write(output);
+      });
+
+      // 收集标准错误
+      claude.stderr.on("data", (data) => {
+        const error = data.toString();
+        stderr += error;
+        // 调试模式下显示 stderr
+        if (this.debug) {
+          process.stderr.write(error);
+        }
+      });
+
+      // 处理进程退出
+      claude.on("close", (code) => {
+        clearTimeout(timeout); // 清理超时定时器
+        const duration = ((Date.now() - startTime) / 1000).toFixed(2);
+
+        logger.info("=".repeat(60));
+        logger.info(`✅ Claude CLI 执行完成`);
+        logger.info(`⏱️  耗时: ${duration}s`);
+        logger.info(`📝 退出代码: ${code}`);
+        logger.info("=".repeat(60));
+
+        // 如果是取消导致的退出
+        if (isCancelled) {
+          reject(new Error('任务已被用户取消'));
+          return;
+        }
+
+        if (code === 0) {
+          // 使用 GitService 获取变更信息
+          const gitDiffResult = GitService.getWorkspaceDiff(projectPath);
+
+          resolve({
+            success: true,
+            changedFiles: gitDiffResult.actualChangedFiles, // 实际变更的文件列表
+            summary: gitDiffResult.fullDiff
+              ? `变更了 ${gitDiffResult.actualChangedFiles.length} 个文件`
+              : "", // 简单摘要
+            fullOutput: stdout,
+            conversationTurns: this.countConversationTurns(stdout),
+            duration: `${duration}s`,
+            exitCode: code,
+            // 新增: Git diff 详细信息
+            gitDiff: gitDiffResult,
+          });
+        } else {
+          reject(
+            new Error(`Claude CLI 执行失败，退出代码: ${code}\n${stderr}`)
+          );
+        }
+      });
+
+      // 处理错误
+      claude.on("error", (error) => {
+        clearTimeout(timeout); // 清理超时定时器
+        logger.error("❌ Claude CLI 启动失败:", error.message);
+        reject(new Error(`无法启动 Claude CLI: ${error.message}`));
+      });
+    });
+  }
+
+  /**
+   * 统计对话轮次
+   */
+  countConversationTurns(output) {
+    // 简单统计 "Assistant:" 或类似标记的出现次数
+    const matches = output.match(/(?:Assistant|Claude|AI):/gi);
+    return matches ? matches.length : 0;
+  }
+}
+
+module.exports = ClaudeCLIService;

package/src/config/index.js

@@ -0,0 +1,69 @@
+const UnifiedConfigManager = require('../../cli/lib/config-manager');
+const { logger } = require('../logger');
+
+/**
+ * 服务端配置包装器
+ * 使用统一配置管理器，添加服务端特定验证
+ */
+class ServerConfigWrapper {
+  constructor() {
+    // 使用统一配置管理器（单例）
+    this.configManager = UnifiedConfigManager;
+    this.validate();
+  }
+
+  /**
+   * 获取配置
+   */
+  get(path) {
+    return this.configManager.get(path);
+  }
+
+  /**
+   * 设置配置
+   */
+  set(path, value) {
+    return this.configManager.set(path, value);
+  }
+
+  /**
+   * 获取所有配置
+   */
+  getAll() {
+    return this.configManager.get();
+  }
+
+  /**
+   * 验证配置（服务端特定）
+   */
+  validate() {
+    const errors = [];
+
+    // 必需配置检查
+    const workDir = this.get('server.workDir');
+    if (!workDir) {
+      errors.push('server.workDir 未配置（请设置 WORK_DIR 环境变量或在配置文件中设置）');
+    }
+
+    // AI 引擎配置检查
+    const engine = this.get('ai.defaultEngine');
+    if (engine !== 'claude-cli') {
+      errors.push(`未知的 AI 引擎: ${engine}，当前仅支持 claude-cli`);
+    }
+
+    // 端口检查
+    const port = this.get('server.port') || this.get('service.port');
+    if (port && (port < 1 || port > 65535)) {
+      errors.push(`无效的端口号: ${port}`);
+    }
+
+    if (errors.length > 0) {
+      logger.error('配置验证失败:', errors);
+      throw new Error(`配置验证失败: ${errors.join(', ')}`);
+    }
+
+    logger.info('✅ 配置验证通过');
+  }
+}
+
+module.exports = new ServerConfigWrapper();