@ttjl/ai-code-review 1.0.0

package/src/formatters/console-formatter.js

@@ -0,0 +1,146 @@
+const chalk = require('chalk');
+
+class ConsoleFormatter {
+  constructor(config) {
+    this.config = config;
+    if (this.config.output.console.color) {
+      this.colors = {
+        error: chalk.red,
+        warning: chalk.yellow,
+        info: chalk.blue,
+        success: chalk.green,
+        dim: chalk.gray,
+        cyan: chalk.cyan
+      };
+    } else {
+      this.colors = {
+        error: (text) => text,
+        warning: (text) => text,
+        info: (text) => text,
+        success: (text) => text,
+        dim: (text) => text,
+        cyan: (text) => text
+      };
+    }
+  }
+
+  /**
+   * 格式化单个文件的审查结果
+   */
+  formatFile(result) {
+    if (result.error) {
+      console.log(`  ❌ ${this.colors.error(result.error)}`);
+      return;
+    }
+
+    if (!result.issues || result.issues.length === 0) {
+      console.log(`  ✅ ${this.colors.success('通过')}`);
+      return;
+    }
+
+    result.issues.forEach(issue => {
+      this.formatIssue(issue);
+    });
+  }
+
+  /**
+   * 格式化单个问题
+   */
+  formatIssue(issue) {
+    const color = this.colors[issue.severity] || this.colors.dim;
+    const symbol = this.getSymbol(issue.severity);
+
+    console.log(
+      `  ${symbol} ${color(`[${issue.severity.toUpperCase()}]`)} ` +
+        `${this.colors.dim(`Line ${issue.line}:`)} ${issue.message}`
+    );
+
+    if (issue.suggestion) {
+      console.log(
+        `    ${this.colors.dim('💡 建议:')} ${this.colors.cyan(
+          issue.suggestion
+        )}`
+      );
+    }
+
+    if (issue.code) {
+      console.log(`    ${this.colors.dim('代码:')}`);
+      const codeLines = issue.code.split('\n');
+      codeLines.forEach(line => {
+        console.log(`    ${this.colors.dim(line)}`);
+      });
+    }
+  }
+
+  /**
+   * 格式化总结
+   */
+  formatSummary(results, issues) {
+    console.log('\n' + chalk.bold('='.repeat(60)));
+    console.log(chalk.bold('  代码审查总结'));
+    console.log(chalk.bold('='.repeat(60)));
+
+    console.log(`\n  📁 审查文件: ${chalk.cyan(results.length)}`);
+
+    const errors = issues.filter(i => i.severity === 'error').length;
+    const warnings = issues.filter(i => i.severity === 'warning').length;
+    const infos = issues.filter(i => i.severity === 'info').length;
+
+    console.log(`  ❌ 错误: ${chalk.red(errors)}`);
+    console.log(`  ⚠️  警告: ${chalk.yellow(warnings)}`);
+    console.log(`  ℹ️  提示: ${chalk.blue(infos)}`);
+
+    if (errors > 0 && this.config.review.onFail === 'block') {
+      console.log(
+        `\n  ${chalk.bgRed.white.bold(' 提交被阻止 ')} ` +
+          `${chalk.red('请修复错误后再提交')}`
+      );
+    } else {
+      console.log(`\n  ✅ ${chalk.green.bold('审查完成')}`);
+    }
+
+    console.log(chalk.bold('='.repeat(60)) + '\n');
+  }
+
+  /**
+   * 获取严重级别对应的符号
+   */
+  getSymbol(severity) {
+    const symbols = {
+      error: '❌',
+      warning: '⚠️ ',
+      info: 'ℹ️ '
+    };
+    return symbols[severity] || '•';
+  }
+
+  /**
+   * 格式化进度信息
+   */
+  formatProgress(message) {
+    console.log(chalk.cyan(`\n${message}`));
+  }
+
+  /**
+   * 格式化错误信息
+   */
+  formatError(message) {
+    console.error(chalk.red(`\n❌ ${message}`));
+  }
+
+  /**
+   * 格式化成功信息
+   */
+  formatSuccess(message) {
+    console.log(chalk.green(`\n✅ ${message}`));
+  }
+
+  /**
+   * 格式化警告信息
+   */
+  formatWarning(message) {
+    console.warn(chalk.yellow(`\n⚠️  ${message}`));
+  }
+}
+
+module.exports = ConsoleFormatter;

package/src/formatters/json-formatter.js

@@ -0,0 +1,189 @@
+const fs = require('fs').promises;
+const path = require('path');
+const chalk = require('chalk');
+
+class JSONFormatter {
+  constructor(config) {
+    this.config = config;
+  }
+
+  /**
+   * 生成 JSON 报告
+   */
+  async generate(results, issues) {
+    const report = {
+      timestamp: new Date().toISOString(),
+      summary: {
+        totalFiles: results.length,
+        totalIssues: issues.length,
+        bySeverity: this.groupBySeverity(issues),
+        byCategory: this.groupByCategory(issues)
+      },
+      files: results.map(r => ({
+        path: r.file,
+        summary: r.summary,
+        issues: r.issues || [],
+        metrics: r.metrics || {},
+        error: r.error || null,
+        duration: r.duration || 0
+      })),
+      issues: issues
+    };
+
+    const filename = this.getFilename();
+    const filepath = path.join(this.config.output.file.path, filename);
+
+    await this.ensureDirectory();
+    await fs.writeFile(filepath, JSON.stringify(report, null, 2));
+
+    console.log(`\n📄 报告已生成: ${chalk.cyan(filepath)}`);
+  }
+
+  /**
+   * 按严重级别分组
+   */
+  groupBySeverity(issues) {
+    return {
+      error: issues.filter(i => i.severity === 'error').length,
+      warning: issues.filter(i => i.severity === 'warning').length,
+      info: issues.filter(i => i.severity === 'info').length
+    };
+  }
+
+  /**
+   * 按类别分组
+   */
+  groupByCategory(issues) {
+    const groups = {};
+    issues.forEach(issue => {
+      groups[issue.category] = (groups[issue.category] || 0) + 1;
+    });
+    return groups;
+  }
+
+  /**
+   * 生成文件名
+   */
+  getFilename() {
+    const now = new Date();
+    let filename = this.config.output.file.filename;
+
+    // 替换时间戳占位符
+    filename = filename.replace('{timestamp}', Date.now());
+    filename = filename.replace('{date}', now.toISOString().split('T')[0]);
+    filename = filename.replace('{time}', now.toTimeString().split(' ')[0]);
+    filename = filename.replace(
+      '{datetime}',
+      now.toISOString().replace(/[:.]/g, '-')
+    );
+
+    // 确保文件名以 .json 结尾
+    if (!filename.endsWith('.json')) {
+      filename += '.json';
+    }
+
+    return filename;
+  }
+
+  /**
+   * 确保输出目录存在
+   */
+  async ensureDirectory() {
+    const dir = this.config.output.file.path;
+    try {
+      await fs.access(dir);
+    } catch {
+      await fs.mkdir(dir, { recursive: true });
+    }
+  }
+
+  /**
+   * 生成 Markdown 报告 (可选功能)
+   */
+  async generateMarkdown(results, issues) {
+    const report = this.buildMarkdownReport(results, issues);
+    const filename = this.getFilename().replace('.json', '.md');
+    const filepath = path.join(this.config.output.file.path, filename);
+
+    await this.ensureDirectory();
+    await fs.writeFile(filepath, report);
+
+    console.log(`\n📄 Markdown 报告已生成: ${chalk.cyan(filepath)}`);
+  }
+
+  /**
+   * 构建 Markdown 报告内容
+   */
+  buildMarkdownReport(results, issues) {
+    const lines = [];
+
+    lines.push('# 代码审查报告\n');
+    lines.push(`**生成时间**: ${new Date().toLocaleString('zh-CN')}\n`);
+    lines.push('---\n');
+
+    // 总结部分
+    lines.push('## 📊 总结\n');
+    lines.push(`- **审查文件数**: ${results.length}`);
+    lines.push(`- **发现问题数**: ${issues.length}`);
+    lines.push(`  - ❌ 错误: ${issues.filter(i => i.severity === 'error').length}`);
+    lines.push(`  - ⚠️  警告: ${issues.filter(i => i.severity === 'warning').length}`);
+    lines.push(`  - ℹ️  提示: ${issues.filter(i => i.severity === 'info').length}`);
+    lines.push('\n---\n');
+
+    // 问题分类
+    lines.push('## 🔍 问题分类\n');
+    const byCategory = this.groupByCategory(issues);
+    Object.entries(byCategory).forEach(([category, count]) => {
+      const labels = {
+        quality: '代码质量',
+        security: '安全问题',
+        performance: '性能问题',
+        naming: '命名规范',
+        'best-practices': '最佳实践'
+      };
+      lines.push(`- **${labels[category] || category}**: ${count}`);
+    });
+    lines.push('\n---\n');
+
+    // 文件详情
+    lines.push('## 📁 文件详情\n');
+
+    results.forEach(result => {
+      lines.push(`### ${result.file}\n`);
+
+      if (result.error) {
+        lines.push(`**错误**: ${result.error}\n`);
+      } else if (result.issues && result.issues.length > 0) {
+        result.issues.forEach(issue => {
+          const icon =
+            issue.severity === 'error'
+              ? '❌'
+              : issue.severity === 'warning'
+              ? '⚠️'
+              : 'ℹ️';
+          lines.push(
+            `${icon} **Line ${issue.line}** [${issue.severity.toUpperCase()}]: ${issue.message}`
+          );
+
+          if (issue.suggestion) {
+            lines.push(`  - 💡 建议: ${issue.suggestion}`);
+          }
+
+          if (issue.code) {
+            lines.push(`  - 代码:\n    \`\`\`\n    ${issue.code}\n    \`\`\``);
+          }
+
+          lines.push('');
+        });
+      } else {
+        lines.push('✅ 通过\n');
+      }
+
+      lines.push('---\n');
+    });
+
+    return lines.join('\n');
+  }
+}
+
+module.exports = JSONFormatter;

package/src/utils/error-handler.js

@@ -0,0 +1,183 @@
+const chalk = require('chalk');
+
+class ErrorHandler {
+  /**
+   * 处理错误
+   */
+  static handle(error, context = {}) {
+    const errorType = this.classifyError(error);
+    const errorInfo = {
+      type: errorType,
+      message: error.message,
+      context,
+      timestamp: new Date().toISOString()
+    };
+
+    switch (errorType) {
+      case 'API_ERROR':
+        return this.handleAPIError(errorInfo);
+      case 'NETWORK_ERROR':
+        return this.handleNetworkError(errorInfo);
+      case 'CONFIG_ERROR':
+        return this.handleConfigError(errorInfo);
+      case 'GIT_ERROR':
+        return this.handleGitError(errorInfo);
+      case 'FILE_ERROR':
+        return this.handleFileError(errorInfo);
+      default:
+        return this.handleUnknownError(errorInfo);
+    }
+  }
+
+  /**
+   * 分类错误
+   */
+  static classifyError(error) {
+    if (
+      error.code === 'ENOTFOUND' ||
+      error.code === 'ECONNREFUSED' ||
+      error.code === 'ETIMEDOUT'
+    ) {
+      return 'NETWORK_ERROR';
+    }
+
+    if (
+      error.message?.includes('API') ||
+      error.message?.includes('认证') ||
+      error.status === 401 ||
+      error.status === 403
+    ) {
+      return 'API_ERROR';
+    }
+
+    if (
+      error.message?.includes('Git') ||
+      error.message?.includes('仓库') ||
+      error.message?.includes('暂存')
+    ) {
+      return 'GIT_ERROR';
+    }
+
+    if (error.code === 'ENOENT' || error.code === 'EACCES') {
+      return 'FILE_ERROR';
+    }
+
+    if (
+      error.message?.includes('配置') ||
+      error.message?.includes('Config')
+    ) {
+      return 'CONFIG_ERROR';
+    }
+
+    return 'UNKNOWN_ERROR';
+  }
+
+  /**
+   * 处理 API 错误
+   */
+  static handleAPIError(error) {
+    console.error(chalk.red('\n❌ API 调用失败'));
+    console.error(chalk.red(`   错误: ${error.message}`));
+
+    if (error.message.includes('认证') || error.context?.status === 401) {
+      console.error(chalk.yellow('\n💡 建议:'));
+      console.error(chalk.yellow('   1. 检查 GEMINI_API_KEY 是否正确'));
+      console.error(chalk.yellow('   2. 确认 API Key 已启用 Gemini API'));
+      console.error(chalk.yellow('   3. 检查 API Key 是否有足够的配额'));
+    }
+
+    return { shouldExit: true, exitCode: 1 };
+  }
+
+  /**
+   * 处理网络错误
+   */
+  static handleNetworkError(error) {
+    console.error(chalk.red('\n❌ 网络连接失败'));
+    console.error(chalk.red(`   错误: ${error.message}`));
+
+    console.error(chalk.yellow('\n💡 建议:'));
+    console.error(chalk.yellow('   1. 检查网络连接'));
+    console.error(chalk.yellow('   2. 检查是否需要配置代理'));
+    console.error(chalk.yellow('   3. 稍后重试'));
+
+    return { shouldExit: true, exitCode: 2 };
+  }
+
+  /**
+   * 处理配置错误
+   */
+  static handleConfigError(error) {
+    console.error(chalk.red('\n❌ 配置文件错误'));
+    console.error(chalk.red(`   错误: ${error.message}`));
+
+    console.error(chalk.yellow('\n💡 建议:'));
+    console.error(chalk.yellow('   1. 检查配置文件格式是否正确'));
+    console.error(chalk.yellow('   2. 运行 `ai-review init` 重新生成配置文件'));
+    console.error(chalk.yellow('   3. 参考文档检查配置项'));
+
+    return { shouldExit: true, exitCode: 3 };
+  }
+
+  /**
+   * 处理 Git 错误
+   */
+  static handleGitError(error) {
+    console.error(chalk.red('\n❌ Git 操作失败'));
+    console.error(chalk.red(`   错误: ${error.message}`));
+
+    console.error(chalk.yellow('\n💡 建议:'));
+    console.error(chalk.yellow('   1. 确保在 Git 仓库中运行'));
+    console.error(chalk.yellow('   2. 检查是否有文件已暂存'));
+    console.error(chalk.yellow('   3. 运行 `git status` 查看状态'));
+
+    return { shouldExit: true, exitCode: 4 };
+  }
+
+  /**
+   * 处理文件错误
+   */
+  static handleFileError(error) {
+    console.error(chalk.red('\n❌ 文件操作失败'));
+    console.error(chalk.red(`   错误: ${error.message}`));
+
+    console.error(chalk.yellow('\n💡 建议:'));
+    console.error(chalk.yellow('   1. 检查文件路径是否正确'));
+    console.error(chalk.yellow('   2. 检查文件权限'));
+    console.error(chalk.yellow('   3. 确保文件存在'));
+
+    return { shouldExit: false, exitCode: 0 };
+  }
+
+  /**
+   * 处理未知错误
+   */
+  static handleUnknownError(error) {
+    console.error(chalk.red('\n❌ 未知错误'));
+    console.error(chalk.red(`   错误: ${error.message}`));
+
+    if (process.env.DEBUG) {
+      console.error(chalk.gray('\n📋 详细信息:'));
+      console.error(chalk.gray(JSON.stringify(error, null, 2)));
+    }
+
+    console.error(chalk.yellow('\n💡 建议:'));
+    console.error(chalk.yellow('   1. 查看错误日志'));
+    console.error(chalk.yellow('   2. 设置 DEBUG=1 环境变量获取详细信息'));
+    console.error(chalk.yellow('   3. 提交 Issue 到 GitHub'));
+
+    return { shouldExit: true, exitCode: 1 };
+  }
+
+  /**
+   * 显示错误堆栈 (调试模式)
+   */
+  static showStack(error) {
+    if (process.env.DEBUG) {
+      console.error(chalk.gray('\n📋 堆栈信息:'));
+      console.error(chalk.gray(error.stack));
+    }
+  }
+}
+
+module.exports = ErrorHandler;

package/src/utils/git.js

@@ -0,0 +1,164 @@
+const { execSync } = require('child_process');
+
+class GitUtils {
+  /**
+   * 检查是否在 Git 仓库中
+   */
+  static isGitRepo() {
+    try {
+      execSync('git rev-parse --is-inside-work-tree', {
+        encoding: 'utf-8',
+        stdio: 'pipe'
+      });
+      return true;
+    } catch (error) {
+      return false;
+    }
+  }
+
+  /**
+   * 获取暂存区的文件列表
+   */
+  static getStagedFiles() {
+    try {
+      const output = execSync(
+        'git diff --cached --name-only --diff-filter=ACM',
+        {
+          encoding: 'utf-8',
+          stdio: 'pipe'
+        }
+      );
+      return output.trim().split('\n').filter(Boolean);
+    } catch (error) {
+      throw new Error(`获取暂存文件失败: ${error.message}`);
+    }
+  }
+
+  /**
+   * 获取变更的文件列表
+   */
+  static getChangedFiles(base = 'HEAD') {
+    try {
+      const output = execSync(`git diff --name-only ${base}`, {
+        encoding: 'utf-8',
+        stdio: 'pipe'
+      });
+      return output.trim().split('\n').filter(Boolean);
+    } catch (error) {
+      throw new Error(`获取变更文件失败: ${error.message}`);
+    }
+  }
+
+  /**
+   * 获取文件差异
+   */
+  static getFileDiff(filePath, base = 'HEAD') {
+    try {
+      const output = execSync(`git diff ${base} -- ${filePath}`, {
+        encoding: 'utf-8',
+        stdio: 'pipe'
+      });
+      return output;
+    } catch (error) {
+      // 文件可能是新文件,没有差异
+      return '';
+    }
+  }
+
+  /**
+   * 获取暂存区文件差异
+   */
+  static getStagedFileDiff(filePath) {
+    try {
+      const output = execSync(`git diff --cached -- ${filePath}`, {
+        encoding: 'utf-8',
+        stdio: 'pipe'
+      });
+      return output;
+    } catch (error) {
+      // 文件可能是新文件,没有差异
+      return '';
+    }
+  }
+
+  /**
+   * 获取文件内容
+   */
+  static getFileContent(filePath, base = 'HEAD') {
+    try {
+      const output = execSync(`git show ${base}:${filePath}`, {
+        encoding: 'utf-8',
+        stdio: 'pipe'
+      });
+      return output;
+    } catch (error) {
+      throw new Error(`获取文件内容失败: ${error.message}`);
+    }
+  }
+
+  /**
+   * 检查文件是否存在
+   */
+  static fileExists(filePath) {
+    try {
+      execSync(`git cat-file -e HEAD:${filePath}`, {
+        encoding: 'utf-8',
+        stdio: 'pipe'
+      });
+      return true;
+    } catch (error) {
+      return false;
+    }
+  }
+
+  /**
+   * 获取当前分支名
+   */
+  static getCurrentBranch() {
+    try {
+      const output = execSync('git rev-parse --abbrev-ref HEAD', {
+        encoding: 'utf-8',
+        stdio: 'pipe'
+      });
+      return output.trim();
+    } catch (error) {
+      return 'unknown';
+    }
+  }
+
+  /**
+   * 获取最新的提交信息
+   */
+  static getLastCommit() {
+    try {
+      const output = execSync('git log -1 --pretty=format:"%h %s"', {
+        encoding: 'utf-8',
+        stdio: 'pipe'
+      });
+      return output.trim();
+    } catch (error) {
+      return 'unknown';
+    }
+  }
+
+  /**
+   * 获取文件统计信息
+   */
+  static getFileStats(filePath) {
+    try {
+      const output = execSync(`git diff --numstat ${base} -- ${filePath}`, {
+        encoding: 'utf-8',
+        stdio: 'pipe'
+      });
+      const [added, deleted] = output.trim().split('\t');
+      return {
+        added: parseInt(added) || 0,
+        deleted: parseInt(deleted) || 0
+      };
+    } catch (error) {
+      return { added: 0, deleted: 0 };
+    }
+  }
+}
+
+module.exports = GitUtils;