@zdthfhxh/ai-code-review-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,121 @@
+# AI Code Review
+
+> AI 代码审查 CLI 工具 — 在终端里审查代码改动，支持 DeepSeek、OpenAI、Ollama
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](package.json)
+
+## 为什么做这个？
+
+代码审查很重要，但找人 review 很慢，自己 review 容易漏掉问题。AI Code Review 从你的 git diff 自动分析代码，找出潜在的问题，就像有一个资深的代码审查专家随时待命。
+
+**参考框架：** Open Core 模式（开源核心 + 付费高级功能）
+**对标项目：** reviewdog（8.4k stars）+ pr-agent（5k stars）+ code-review-gpt（1.8k stars）
+
+## 特性
+
+| 功能 | 免费版 | Pro 版 |
+|:---|:---:|:---:|
+| 代码审查（AI 分析） | ✅ | ✅ |
+| 多 Provider 支持（DeepSeek/OpenAI/Ollama） | ✅ | ✅ |
+| 终端输出 | ✅ | ✅ |
+| JSON/SARIF 输出 | ✅ | ✅ |
+| 指定文件审查 | ✅ | ✅ |
+| 指定 commit 审查 | ✅ | ✅ |
+| 严重级别过滤 | ❌ | ✅ |
+| 团队规范检查 | ❌ | ✅ |
+| CI/CD 集成（GitHub Action） | ❌ | ✅ |
+| 自动修复建议 | ❌ | ✅ |
+
+## 快速开始
+
+### 安装
+
+```bash
+# 全局安装
+npm install -g ai-code-review
+
+# 或者直接运行
+npx ai-code-review
+```
+
+### 配置
+
+```bash
+# 设置 API 密钥（DeepSeek 默认）
+ai-review config set AI_API_KEY sk-your-key
+
+# 或者使用 OpenAI
+ai-review config set AI_API_KEY sk-your-openai-key
+ai-review config set AI_PROVIDER openai
+ai-review config set AI_API_BASE https://api.openai.com/v1
+```
+
+### 使用
+
+```bash
+# 审查当前分支的改动
+ai-review
+
+# 审查指定文件
+ai-review src/index.js
+
+# 审查已暂存的改动
+ai-review --staged
+
+# 审查指定 commit
+ai-review --commit abc123
+
+# 使用 OpenAI
+ai-review --provider openai --model gpt-4
+
+# 输出 JSON 格式
+ai-review --output json
+
+# 查看 AI 会收到什么（不实际调用）
+ai-review --dry-run
+```
+
+### 环境变量
+
+所有配置项也可以通过环境变量设置：
+
+```
+AI_REVIEW_AI_API_KEY=sk-your-key
+AI_REVIEW_AI_PROVIDER=deepseek
+AI_REVIEW_AI_MODEL=deepseek-chat
+AI_REVIEW_REVIEW_LANGUAGE=zh
+```
+
+## 输出示例
+
+```
+📋 代码审查报告
+──────────────────────────────────────────────────
+  发现 5 个问题，其中 1 个严重，2 个高优先级
+──────────────────────────────────────────────────
+
+🔴 [严重] SQL 注入风险：用户输入未经过滤直接拼接
+   📁 src/user.js:42
+   用户输入直接用于数据库查询，存在 SQL 注入风险
+   💡 使用参数化查询代替字符串拼接
+
+🟠 [高] 未处理的 Promise 错误
+   📁 src/api.js:15
+   async 函数中没有 try-catch，错误会导致进程崩溃
+   💡 添加 try-catch 或使用 .catch()
+```
+
+## 对比
+
+| 工具 | 类型 | AI | Price | CLI |
+|:----|:----|:--:|:-----:|:---:|
+| **ai-code-review** | CLI | ✅ | 免费 + Pro $9/月 | ✅ |
+| CodeRabbit | GitHub App | ✅ | $12/月 | ❌ |
+| pr-agent | GitHub App | ✅ | 免费 + $49/月 | ❌ |
+| reviewdog | CLI | ❌ | 免费 | ✅ |
+| code-review-gpt | CLI | ✅ | 免费 | ✅ |
+
+## 许可证
+
+MIT

package/bin/ai-review

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/**
+ * ai-review CLI 入口
+ *
+ * 参考框架：commander（最流行的 Node.js CLI 框架）
+ * 参考项目：ai-commit-message（复用 CLI 架构）
+ * 新增：reviewdog 风格的管道架构支持
+ */
+
+const { program } = require('commander');
+const pkg = require('../package.json');
+
+program
+  .name('ai-review')
+  .description('AI 代码审查工具 — 在终端里审查代码改动')
+  .version(pkg.version)
+  .argument('[file]', '指定要审查的文件路径（可选，默认审查所有改动）')
+  .option('-s, --staged', '只审查已暂存（staged）的改动')
+  .option('-c, --commit <hash>', '审查指定 commit 的改动')
+  .option('--dry-run', '只查看 AI 会收到什么内容，不实际调用 AI')
+  .option('--model <model>', '指定 AI 模型（默认从配置读取）')
+  .option('--provider <provider>', '指定 AI 提供商（deepseek/openai/ollama）')
+  .option('--output <format>', '输出格式（terminal/json/sarif）', 'terminal')
+  .option('--severity <level>', '最低显示严重级别（low/medium/high/critical），默认显示全部')
+  .action(async (file, options) => {
+    const { run } = require('../src/index.js');
+    try {
+      await run(file, options);
+    } catch (err) {
+      console.error('❌ 错误:', err.message);
+      process.exit(1);
+    }
+  });
+
+program.parse(process.argv);

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@zdthfhxh/ai-code-review-cli",
+  "version": "0.1.0",
+  "description": "AI-powered code review CLI — 在终端里审查代码，支持 DeepSeek、OpenAI、Ollama",
+  "main": "src/index.js",
+  "bin": {
+    "ai-review": "./bin/ai-review"
+  },
+  "scripts": {
+    "vercel-build": "echo 'Static site - no build needed'",
+    "start": "node src/index.js",
+    "dev": "node src/index.js --dry-run"
+  },
+  "keywords": [
+    "code-review",
+    "ai",
+    "cli",
+    "git",
+    "deepseek",
+    "openai",
+    "ollama"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^12.0.0",
+    "conf": "^12.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/src/analyzer.js

@@ -0,0 +1,166 @@
+/**
+ * Analyzer 阶段 — AI 代码审查引擎
+ *
+ * 参考框架：pr-agent 的审查提示词设计（结构化多维度分析）
+ *           OpenAI 的 function calling 模式（结构化输出）
+ *
+ * 参考：pr-agent (6.5k ⭐) — 多维审查提示词、few-shot 示例、结构化输出
+ *       OpenAI API — chat completions 标准格式
+ */
+
+const provider = require('./provider/index.js');
+const config = require('./config.js');
+
+/**
+ * 构建审查提示词
+ * @param {string} diff - git diff 内容
+ * @param {Object} ctx - 上下文（branch, files, stats 等）
+ * @param {string} language - 输出语言（zh/en）
+ * @returns {Array} 消息数组
+ */
+function buildReviewPrompt(diff, ctx, language = 'zh') {
+  const langInstruction = language === 'zh'
+    ? '请用中文回复。'
+    : 'Please respond in English.';
+
+  const systemPrompt = `你是一个资深的代码审查专家。你的任务是审查代码 diff，找出潜在的问题。
+
+${langInstruction}
+
+## 审查维度
+
+请从以下 5 个维度审查代码：
+
+1. **正确性 (correctness)** — 是否有逻辑错误？边界条件处理不当？竞态条件？并发问题？
+2. **安全性 (security)** — 是否有安全漏洞？SQL注入？XSS？CSRF？敏感信息泄露？权限校验缺失？
+3. **性能 (performance)** — 是否有性能问题？不必要的循环？内存泄漏？N+1查询？未使用缓存？
+4. **可维护性 (maintainability)** — 代码是否清晰？命名是否合理？是否有重复代码？复杂度是否过高？
+5. **最佳实践 (best-practice)** — 是否遵循了当前语言/框架的最佳实践？是否有过时的 API 使用？
+
+## 严重级别定义
+
+- **critical**：可能导致生产事故或安全漏洞，必须修复
+- **high**：明显的问题，强烈建议修复
+- **medium**：需要注意的问题，建议修复
+- **low**：小问题或改进建议
+- **note**：仅供参考，非必须修复
+
+## 审查规则
+
+1. 只审查 diff 中改动的代码，不要审查未改动的代码
+2. 如果某个问题只出现在新增代码中，标明行号
+3. 对于每个问题，必须给出具体的修改建议
+4. 如果确实没有发现问题，issues 数组可以为空
+5. 不要过度报告：只报告真正的问题，不要为了凑数而报告
+
+## 输出格式
+
+请严格按照以下 JSON 格式输出，不要添加其他内容：
+
+\`\`\`json
+{
+  "summary": "审查总结（一句话概括）",
+  "issues": [
+    {
+      "severity": "critical | high | medium | low | note",
+      "category": "correctness | security | performance | maintainability | best-practice",
+      "file": "文件名",
+      "line": 行号（不确定就填 null）,
+      "title": "问题标题（简短，不超过 20 字）",
+      "description": "问题描述（说明为什么这是个问题）",
+      "suggestion": "修改建议（具体可操作的建议）"
+    }
+  ],
+  "positive": ["值得肯定的地方（可选，1-3条）"],
+  "stats": {
+    "totalIssues": 总问题数,
+    "critical": 严重问题数,
+    "high": 高优先级数,
+    "medium": 中优先级数,
+    "low": 低优先级数
+  }
+}
+\`\`\`
+
+如果没有发现问题，请返回：
+\`\`\`json
+{
+  "summary": "代码审查通过，未发现明显问题",
+  "issues": [],
+  "positive": ["代码质量良好"],
+  "stats": { "totalIssues": 0, "critical": 0, "high": 0, "medium": 0, "low": 0 }
+}
+\`\`\``;
+
+  // 构建上下文信息
+  const contextInfo = [];
+  if (ctx.branch) contextInfo.push(`分支: ${ctx.branch}`);
+  if (ctx.files && ctx.files.length > 0) {
+    contextInfo.push(`改动文件: ${ctx.files.map(f => `${f.file} (${f.status})`).join(', ')}`);
+  }
+  const contextStr = contextInfo.length > 0 ? `\n## 上下文信息\n\n${contextInfo.join('\n')}\n` : '';
+
+  return [
+    { role: 'system', content: systemPrompt },
+    { role: 'user', content: `请审查以下代码 diff：\n\n${contextStr}\`\`\`diff\n${diff}\n\`\`\`` }
+  ];
+}
+
+/**
+ * 解析 AI 回复为结构化审查结果
+ * @param {string} content - AI 回复内容
+ * @returns {Object} 审查结果对象
+ */
+function parseReviewResult(content) {
+  try {
+    // 尝试从 ```json ... ``` 中提取
+    const jsonMatch = content.match(/```(?:json)?\s*(\{[\s\S]*?\})\s*```/);
+    if (jsonMatch) {
+      return JSON.parse(jsonMatch[1]);
+    }
+    // 尝试直接解析
+    return JSON.parse(content);
+  } catch {
+    // AI 回复不是 JSON 格式，包装成简单结构
+    return {
+      summary: 'AI 回复格式异常',
+      issues: [{
+        severity: 'note',
+        category: 'maintainability',
+        file: '',
+        line: null,
+        title: 'AI 回复格式异常',
+        description: 'AI 没有按预期格式返回 JSON，以下是原始回复：\n' + content,
+        suggestion: '请检查 AI 模型是否支持 JSON 格式输出，或尝试更换模型'
+      }],
+      positives: [],
+      stats: { totalIssues: 1, critical: 0, high: 0, medium: 0, low: 0 }
+    };
+  }
+}
+
+/**
+ * Analyzer 阶段：调用 AI 分析代码 diff
+ * @param {Object} context - 管道上下文
+ * @returns {Object} 更新后的上下文，包含审查结果
+ */
+async function analyzer(context) {
+  const { diff, options } = context;
+
+  if (!diff || diff.length === 0) {
+    return { reviewResult: null };
+  }
+
+  const language = options.language || config.get('REVIEW_LANGUAGE');
+
+  const messages = buildReviewPrompt(diff, context, language);
+  const content = await provider.callAI(messages, {
+    provider: options.provider,
+    model: options.model
+  });
+  const reviewResult = parseReviewResult(content);
+
+  return { reviewResult };
+}
+
+module.exports = { analyzer, buildReviewPrompt, parseReviewResult };

package/src/config.js

@@ -0,0 +1,85 @@
+/**
+ * 配置管理
+ *
+ * 参考框架：conf（最流行的 Node.js 配置管理库）
+ * 参考项目：ai-commit-message（复用配置模式）
+ */
+
+const Conf = require('conf').default;
+
+const schema = {
+  AI_API_KEY: {
+    type: 'string',
+    default: '',
+    description: 'AI API 密钥'
+  },
+  AI_API_BASE: {
+    type: 'string',
+    default: 'https://api.deepseek.com',
+    description: 'AI API 地址'
+  },
+  AI_MODEL: {
+    type: 'string',
+    default: 'deepseek-chat',
+    description: 'AI 模型名'
+  },
+  AI_PROVIDER: {
+    type: 'string',
+    default: 'deepseek',
+    description: 'AI 提供商（deepseek/openai/ollama）'
+  },
+  REVIEW_LANGUAGE: {
+    type: 'string',
+    default: 'zh',
+    description: '审查输出语言（zh/en）'
+  },
+  SEVERITY_THRESHOLD: {
+    type: 'string',
+    default: 'low',
+    description: '最低显示严重级别（low/medium/high/critical）'
+  }
+};
+
+const config = new Conf({ schema, projectName: 'ai-code-review' });
+
+/**
+ * 获取配置值
+ * 优先级：环境变量 > 配置文件 > 默认值
+ */
+function get(key) {
+  const envKey = `AI_REVIEW_${key}`;
+  if (process.env[envKey]) return process.env[envKey];
+  return config.get(key);
+}
+
+/**
+ * 设置配置值
+ */
+function set(key, value) {
+  config.set(key, value);
+}
+
+/**
+ * 获取所有配置
+ */
+function getAll() {
+  const all = {};
+  for (const key of Object.keys(schema)) {
+    all[key] = get(key);
+  }
+  return all;
+}
+
+/**
+ * 获取提供商对应的默认 API 地址
+ */
+function getDefaultBaseUrl(provider) {
+  const urls = {
+    deepseek: 'https://api.deepseek.com',
+    openai: 'https://api.openai.com/v1',
+    ollama: 'http://localhost:11434'
+  };
+  return urls[provider] || urls.deepseek;
+}
+
+module.exports = { get, set, getAll, getDefaultBaseUrl };

package/src/filter.js

@@ -0,0 +1,89 @@
+/**
+ * Filter 阶段 — 过滤、排序、去重审查结果
+ *
+ * 参考框架：reviewdog 的 Filter 阶段
+ * reviewdog 的 Filter 阶段负责按 diff 过滤结果（只显示改动行的结果）
+ * 我们的 Filter 负责按严重级别过滤、去重、排序
+ *
+ * 参考：reviewdog (8.2k ⭐) 的 Filter 设计
+ *       eslint 的输出过滤逻辑（按严重级别）
+ */
+
+/**
+ * 严重级别排序权重
+ */
+const SEVERITY_ORDER = { critical: 0, high: 1, medium: 2, low: 3, note: 4 };
+
+/**
+ * 去重 key 生成
+ */
+function issueKey(issue) {
+  return `${issue.file || ''}:${issue.line || ''}:${issue.title}`;
+}
+
+/**
+ * 是否通过严重级别阈值
+ * @param {string} severity - 问题严重级别
+ * @param {string} threshold - 阈值（low/medium/high/critical）
+ * @returns {boolean}
+ */
+function passesThreshold(severity, threshold) {
+  const sev = SEVERITY_ORDER[severity] ?? 999;
+  const thr = SEVERITY_ORDER[threshold] ?? 0;
+  return sev >= thr;
+}
+
+/**
+ * Filter 阶段：过滤、排序、去重
+ * @param {Object} context - 管道上下文
+ * @returns {Object} 更新后的上下文，包含过滤后的审查结果
+ */
+async function filter(context) {
+  const { reviewResult, options } = context;
+
+  if (!reviewResult || !reviewResult.issues) {
+    return { filteredResult: null };
+  }
+
+  const threshold = options.severity || 'low';
+  const seen = new Set();
+
+  // 过滤：按严重级别 + 去重
+  const filteredIssues = reviewResult.issues
+    .filter(issue => {
+      // 按严重级别阈值过滤
+      if (!passesThreshold(issue.severity, threshold)) return false;
+
+      // 去重
+      const key = issueKey(issue);
+      if (seen.has(key)) return false;
+      seen.add(key);
+      return true;
+    })
+    // 排序：严重级别从高到低
+    .sort((a, b) => {
+      const orderA = SEVERITY_ORDER[a.severity] ?? 999;
+      const orderB = SEVERITY_ORDER[b.severity] ?? 999;
+      return orderA - orderB;
+    });
+
+  // 重新计算统计
+  const stats = {
+    totalIssues: filteredIssues.length,
+    critical: filteredIssues.filter(i => i.severity === 'critical').length,
+    high: filteredIssues.filter(i => i.severity === 'high').length,
+    medium: filteredIssues.filter(i => i.severity === 'medium').length,
+    low: filteredIssues.filter(i => i.severity === 'low').length
+  };
+
+  return {
+    filteredResult: {
+      summary: reviewResult.summary,
+      issues: filteredIssues,
+      positives: reviewResult.positive || reviewResult.positives || [],
+      stats
+    }
+  };
+}
+
+module.exports = { filter };

package/src/git.js

@@ -0,0 +1,100 @@
+/**
+ * Git 操作模块
+ *
+ * 读取 git diff 和文件内容，用于 AI 审查
+ *
+ * 参考框架：child_process（Node.js 标准库）+ git 命令
+ * 参考项目：ai-commit-message（复用 git diff 读取逻辑）
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * 检查当前目录是否是 git 仓库
+ */
+function isGitRepo() {
+  try {
+    execSync('git rev-parse --git-dir', { stdio: 'ignore', encoding: 'utf-8' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 获取 git diff
+ * @param {Object} options - { staged: boolean, commit: string, file: string }
+ * @returns {string} diff 内容
+ */
+function getDiff(options = {}) {
+  const { staged, commit, file } = options;
+
+  let args = ['diff'];
+  if (staged) args.push('--staged');
+  if (commit) args = ['diff', `${commit}^..${commit}`];
+  if (file) args.push(file);
+  args.push('--unified=10'); // 上下文行数
+
+  try {
+    return execSync(`git ${args.join(' ')}`, { encoding: 'utf-8', maxBuffer: 10 * 1024 * 1024 });
+  } catch (err) {
+    throw new Error(`获取 git diff 失败: ${err.message}`);
+  }
+}
+
+/**
+ * 获取改动文件的列表
+ * @param {Object} options - { staged: boolean, commit: string }
+ * @returns {Array<{file: string, status: string}>}
+ */
+function getChangedFiles(options = {}) {
+  const { staged, commit } = options;
+
+  let args = ['diff', '--name-status'];
+  if (staged) args.push('--staged');
+  if (commit) args = ['diff', '--name-status', `${commit}^..${commit}`];
+
+  try {
+    const output = execSync(`git ${args.join(' ')}`, { encoding: 'utf-8' });
+    const files = [];
+    for (const line of output.trim().split('\n')) {
+      if (!line) continue;
+      const [status, file] = line.split('\t');
+      files.push({ file, status });
+    }
+    return files;
+  } catch (err) {
+    throw new Error(`获取文件列表失败: ${err.message}`);
+  }
+}
+
+/**
+ * 获取当前分支名
+ */
+function getCurrentBranch() {
+  try {
+    return execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf-8' }).trim();
+  } catch {
+    return 'unknown';
+  }
+}
+
+/**
+ * 获取文件内容的上下文（用于 AI 理解代码结构）
+ * @param {string} filePath - 文件路径
+ * @param {number} contextLines - 上下文行数
+ */
+function getFileContext(filePath, contextLines = 5) {
+  try {
+    const fullPath = path.resolve(filePath);
+    if (!fs.existsSync(fullPath)) return '';
+    const content = fs.readFileSync(fullPath, 'utf-8');
+    return content;
+  } catch {
+    return '';
+  }
+}
+
+module.exports = { isGitRepo, getDiff, getChangedFiles, getCurrentBranch, getFileContext };

package/src/index.js

@@ -0,0 +1,81 @@
+/**
+ * 主入口 — 管道编排器
+ *
+ * 组合 Runner → Analyzer → Filter → Reporter 四个阶段
+ *
+ * 参考框架：reviewdog 的 3 阶段管道架构（Runner → Filter → Report）
+ *           pr-agent 的 AI 集成模式
+ *
+ * 参考：reviewdog (8.2k ⭐) — 管道架构
+ *       pr-agent (6.5k ⭐) — AI 集成
+ *       Pieter Levels — 快速 MVP 模式
+ */
+
+const { runPipeline } = require('./pipeline.js');
+const { runner } = require('./runner.js');
+const { analyzer } = require('./analyzer.js');
+const { filter } = require('./filter.js');
+const reporter = require('./reporter/index.js');
+const config = require('./config.js');
+
+/**
+ * 运行代码审查
+ * @param {string} file - 指定文件（可选）
+ * @param {Object} options - 命令行选项
+ */
+async function run(file, options) {
+  // 组合管道阶段（不含 analyzer 和 filter，dry-run 不需要）
+  const phases = [runner];
+
+  if (!options.dryRun) {
+    phases.push(analyzer, filter);
+  }
+
+  // 初始上下文
+  const initialContext = {
+    options: {
+      file,
+      staged: options.staged,
+      commit: options.commit,
+      provider: options.provider || config.get('AI_PROVIDER'),
+      model: options.model || config.get('AI_MODEL'),
+      language: config.get('REVIEW_LANGUAGE'),
+      severity: options.severity || config.get('SEVERITY_THRESHOLD'),
+      output: options.output || 'terminal'
+    }
+  };
+
+  // 执行管道
+  const context = await runPipeline(phases, initialContext);
+
+  // 没有 diff 的情况
+  if (!context.diff || context.diff.length === 0) {
+    console.log('✅ 没有检测到代码改动，无需审查。');
+    return;
+  }
+
+  // Dry-run 模式：只显示 diff 内容，不调用 AI
+  if (options.dryRun) {
+    console.log('\n📄 [Dry Run] 以下内容将发送给 AI：');
+    console.log('─'.repeat(50));
+    console.log(context.diff.slice(0, 2000));
+    console.log('─'.repeat(50));
+    console.log(`(共 ${context.diff.length} 字符，已显示前 2000 字符)`);
+    console.log(`\n📊 统计: ${context.stats.fileCount} 个文件, +${context.stats.additions}/-${context.stats.deletions} 行\n`);
+    return;
+  }
+
+  // 显示审查进度信息
+  console.log(`\n🔍 正在审查代码...`);
+  console.log(`   分支: ${context.branch}`);
+  console.log(`   文件: ${context.stats.fileCount} 个文件改动 (+${context.stats.additions}/-${context.stats.deletions} 行)`);
+  console.log(`   Provider: ${initialContext.options.provider}`);
+  console.log(`   模型: ${initialContext.options.model}`);
+  console.log(`\n⏳ AI 正在分析，请稍候...\n`);
+
+  // 输出结果
+  const format = options.output || 'terminal';
+  reporter.report(context.filteredResult, format);
+}
+
+module.exports = { run };

package/src/pipeline.js

@@ -0,0 +1,26 @@
+/**
+ * 管道执行引擎
+ *
+ * 参考框架：reviewdog 的 3 阶段管道架构（Runner → Filter → Report）
+ * 每个阶段是一个纯异步函数，接收上下文并返回更新后的上下文
+ * 管道按顺序执行，一个阶段的输出是下一个阶段的输入
+ *
+ * 参考：reviewdog (8.2k ⭐) 的 ARCHITECTURE.md — 3 阶段设计
+ *       Unix 管道哲学 — 每个阶段做一件事，做好它
+ */
+
+/**
+ * 执行管道
+ * @param {Array<Function>} phases - 阶段函数数组，每个函数接收 context 返回 context
+ * @param {Object} initialContext - 初始上下文
+ * @returns {Object} 最终上下文
+ */
+async function runPipeline(phases, initialContext = {}) {
+  let context = { ...initialContext };
+  for (const phase of phases) {
+    context = { ...context, ...(await phase(context)) };
+  }
+  return context;
+}
+
+module.exports = { runPipeline };

package/src/provider/deepseek.js

@@ -0,0 +1,66 @@
+/**
+ * DeepSeek Provider
+ *
+ * 参考框架：OpenAI API 格式（DeepSeek 完全兼容）
+ * DeepSeek 使用与 OpenAI 相同的 API 格式，只需修改 base URL
+ */
+
+const https = require('https');
+
+/**
+ * 调用 DeepSeek API
+ * @param {Array} messages - 消息数组
+ * @param {Object} options - { model, apiKey, apiBase }
+ * @returns {Promise<string>} AI 回复内容
+ */
+function callAI(messages, options) {
+  const { model, apiKey, apiBase } = options;
+
+  return new Promise((resolve, reject) => {
+    const body = JSON.stringify({
+      model: model || 'deepseek-chat',
+      messages: messages,
+      temperature: 0.3,
+      max_tokens: 4096
+    });
+
+    const url = new URL((apiBase || 'https://api.deepseek.com') + '/chat/completions');
+    const req = https.request({
+      hostname: url.hostname,
+      port: url.port || 443,
+      path: url.pathname,
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${apiKey}`,
+        'Content-Length': Buffer.byteLength(body)
+      }
+    }, (res) => {
+      let data = '';
+      res.on('data', chunk => data += chunk);
+      res.on('end', () => {
+        if (res.statusCode !== 200) {
+          try {
+            const err = JSON.parse(data);
+            reject(new Error(err.error?.message || `API 返回 ${res.statusCode}`));
+          } catch {
+            reject(new Error(`API 返回 ${res.statusCode}: ${data.slice(0, 200)}`));
+          }
+          return;
+        }
+        try {
+          const result = JSON.parse(data);
+          resolve(result.choices[0].message.content);
+        } catch (err) {
+          reject(new Error(`解析 DeepSeek 回复失败: ${err.message}`));
+        }
+      });
+    });
+
+    req.on('error', reject);
+    req.write(body);
+    req.end();
+  });
+}
+
+module.exports = { callAI };

package/src/provider/index.js

@@ -0,0 +1,60 @@
+/**
+ * Provider 工厂 — 选择并创建 AI 提供商实例
+ *
+ * 参考框架：pr-agent 的 Provider 抽象层
+ * pr-agent 支持多个 AI 提供商（OpenAI、Anthropic、Cohere 等），
+ * 通过统一的接口抽象，让上层代码不关心具体提供商
+ *
+ * 参考：pr-agent (6.5k ⭐) 的 provider 抽象设计
+ */
+
+const config = require('../config.js');
+
+const providers = {
+  deepseek: require('./deepseek.js'),
+  openai: require('./openai.js'),
+  ollama: require('./ollama.js')
+};
+
+/**
+ * 获取提供商实例
+ * @param {string} name - 提供商名称
+ * @returns {Object} 提供商对象，包含 callAI 方法
+ */
+function getProvider(name) {
+  const provider = providers[name];
+  if (!provider) {
+    throw new Error(`不支持的 AI 提供商: ${name}。支持的提供商: ${Object.keys(providers).join(', ')}`);
+  }
+  return provider;
+}
+
+/**
+ * 获取所有支持的提供商列表
+ * @returns {Array<string>}
+ */
+function getSupportedProviders() {
+  return Object.keys(providers);
+}
+
+/**
+ * 调用 AI 的统一入口
+ * @param {Array} messages - 消息数组
+ * @param {Object} options - { provider, model, apiKey, apiBase }
+ * @returns {Promise<string>} AI 回复内容
+ */
+async function callAI(messages, options = {}) {
+  const providerName = options.provider || config.get('AI_PROVIDER');
+  const model = options.model || config.get('AI_MODEL');
+  const apiKey = options.apiKey || config.get('AI_API_KEY');
+  const apiBase = options.apiBase || config.get('AI_API_BASE') || config.getDefaultBaseUrl(providerName);
+
+  if (!apiKey && providerName !== 'ollama') {
+    throw new Error(`未配置 API 密钥。请设置环境变量 AI_REVIEW_AI_API_KEY 或运行: ai-review config set AI_API_KEY <你的密钥>`);
+  }
+
+  const provider = getProvider(providerName);
+  return provider.callAI(messages, { model, apiKey, apiBase });
+}
+
+module.exports = { callAI, getProvider, getSupportedProviders };

package/src/provider/ollama.js

@@ -0,0 +1,70 @@
+/**
+ * Ollama Provider
+ *
+ * 参考框架：Ollama API 格式（本地模型）
+ * Ollama 也兼容 OpenAI API 格式，但默认地址是 localhost:11434
+ * 不需要 API 密钥
+ */
+
+const http = require('http');
+
+/**
+ * 调用 Ollama API
+ * @param {Array} messages - 消息数组
+ * @param {Object} options - { model, apiBase }
+ * @returns {Promise<string>} AI 回复内容
+ */
+function callAI(messages, options) {
+  const { model, apiBase } = options;
+
+  return new Promise((resolve, reject) => {
+    const body = JSON.stringify({
+      model: model || 'codellama',
+      messages: messages,
+      temperature: 0.3,
+      stream: false
+    });
+
+    const url = new URL((apiBase || 'http://localhost:11434') + '/api/chat');
+    const transport = url.protocol === 'https:' ? require('https') : http;
+    const defaultPort = url.protocol === 'https:' ? 443 : 80;
+
+    const req = transport.request({
+      hostname: url.hostname,
+      port: url.port || defaultPort,
+      path: url.pathname,
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(body)
+      }
+    }, (res) => {
+      let data = '';
+      res.on('data', chunk => data += chunk);
+      res.on('end', () => {
+        if (res.statusCode !== 200) {
+          reject(new Error(`Ollama 返回 ${res.statusCode}: ${data.slice(0, 200)}`));
+          return;
+        }
+        try {
+          const result = JSON.parse(data);
+          resolve(result.message?.content || '');
+        } catch (err) {
+          reject(new Error(`解析 Ollama 回复失败: ${err.message}`));
+        }
+      });
+    });
+
+    req.on('error', (err) => {
+      if (err.code === 'ECONNREFUSED') {
+        reject(new Error('无法连接到 Ollama，请确保 Ollama 正在运行 (http://localhost:11434)'));
+      } else {
+        reject(err);
+      }
+    });
+    req.write(body);
+    req.end();
+  });
+}
+
+module.exports = { callAI };

package/src/provider/openai.js

@@ -0,0 +1,66 @@
+/**
+ * OpenAI Provider
+ *
+ * 参考框架：OpenAI API 格式（标准实现）
+ * 使用 OpenAI 的 chat completions API
+ */
+
+const https = require('https');
+
+/**
+ * 调用 OpenAI API
+ * @param {Array} messages - 消息数组
+ * @param {Object} options - { model, apiKey, apiBase }
+ * @returns {Promise<string>} AI 回复内容
+ */
+function callAI(messages, options) {
+  const { model, apiKey, apiBase } = options;
+
+  return new Promise((resolve, reject) => {
+    const body = JSON.stringify({
+      model: model || 'gpt-4o-mini',
+      messages: messages,
+      temperature: 0.3,
+      max_tokens: 4096
+    });
+
+    const url = new URL((apiBase || 'https://api.openai.com/v1') + '/chat/completions');
+    const req = https.request({
+      hostname: url.hostname,
+      port: url.port || 443,
+      path: url.pathname,
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${apiKey}`,
+        'Content-Length': Buffer.byteLength(body)
+      }
+    }, (res) => {
+      let data = '';
+      res.on('data', chunk => data += chunk);
+      res.on('end', () => {
+        if (res.statusCode !== 200) {
+          try {
+            const err = JSON.parse(data);
+            reject(new Error(err.error?.message || `API 返回 ${res.statusCode}`));
+          } catch {
+            reject(new Error(`API 返回 ${res.statusCode}: ${data.slice(0, 200)}`));
+          }
+          return;
+        }
+        try {
+          const result = JSON.parse(data);
+          resolve(result.choices[0].message.content);
+        } catch (err) {
+          reject(new Error(`解析 OpenAI 回复失败: ${err.message}`));
+        }
+      });
+    });
+
+    req.on('error', reject);
+    req.write(body);
+    req.end();
+  });
+}
+
+module.exports = { callAI };

package/src/reporter/index.js

@@ -0,0 +1,40 @@
+/**
+ * Reporter 工厂 — 选择并创建输出格式化器
+ *
+ * 参考框架：reviewdog 的 Reporter 设计
+ * reviewdog 的 Reporter 支持多种输出目标（GitHub Checks、GitLab MR、本地文件等），
+ * 通过统一的 reporter 接口实现可插拔
+ *
+ * 参考：reviewdog (8.2k ⭐) 的 Reporter 设计
+ *       eslint 的 formatter 模式
+ */
+
+const reporters = {
+  terminal: require('./terminal.js'),
+  json: require('./json.js'),
+  sarif: require('./sarif.js')
+};
+
+/**
+ * 输出审查结果
+ * @param {Object} result - 审查结果（filtered 后的）
+ * @param {string} format - 输出格式（terminal/json/sarif）
+ */
+function report(result, format = 'terminal') {
+  const reporter = reporters[format];
+  if (!reporter) {
+    console.error(`不支持的输出格式: ${format}，使用 terminal`);
+    return reporters.terminal.print(result);
+  }
+  return reporter.print(result);
+}
+
+/**
+ * 获取所有支持的输出格式
+ * @returns {Array<string>}
+ */
+function getSupportedFormats() {
+  return Object.keys(reporters);
+}
+
+module.exports = { report, getSupportedFormats };

package/src/reporter/json.js

@@ -0,0 +1,15 @@
+/**
+ * JSON Reporter — 以 JSON 格式输出审查结果
+ *
+ * 适用于程序化处理，如 CI/CD 管道中的后续处理
+ */
+
+/**
+ * 输出 JSON 格式
+ * @param {Object} result - 审查结果
+ */
+function print(result) {
+  console.log(JSON.stringify(result, null, 2));
+}
+
+module.exports = { print };

package/src/reporter/sarif.js

@@ -0,0 +1,73 @@
+/**
+ * SARIF Reporter — 以 SARIF 格式输出审查结果
+ *
+ * SARIF (Static Analysis Results Interchange Format) 是 OASIS 标准，
+ * 兼容 GitHub Code Scanning、Visual Studio 等工具
+ *
+ * 参考：OASIS SARIF 规范 v2.1.0
+ *       https://docs.oasis-open.org/sarif/sarif/v2.1.0/sarif-v2.1.0.html
+ *       reviewdog 的 SARIF 输出实现
+ *       GitHub Code Scanning 的 SARIF 格式要求
+ */
+
+/**
+ * SARIF 级别映射
+ */
+const severityToLevel = {
+  critical: 'error',
+  high: 'warning',
+  medium: 'warning',
+  low: 'note',
+  note: 'note'
+};
+
+/**
+ * 输出 SARIF 格式
+ * @param {Object} result - 审查结果
+ */
+function print(result) {
+  if (!result || !result.issues) {
+    console.log(JSON.stringify({ version: '2.1.0', runs: [] }, null, 2));
+    return;
+  }
+
+  const sarif = {
+    version: '2.1.0',
+    runs: [{
+      tool: {
+        driver: {
+          name: 'ai-review',
+          informationUri: 'https://github.com/2446573/ai-code-review',
+          version: require('../../package.json').version
+        }
+      },
+      results: result.issues.map(issue => {
+        const sarifResult = {
+          ruleId: `${issue.category}/${issue.severity}`,
+          level: severityToLevel[issue.severity] || 'note',
+          message: {
+            text: `${issue.title}: ${issue.description}${issue.suggestion ? `\n建议: ${issue.suggestion}` : ''}`
+          }
+        };
+
+        if (issue.file) {
+          sarifResult.locations = [{
+            physicalLocation: {
+              artifactLocation: { uri: issue.file },
+              region: {}
+            }
+          }];
+          if (issue.line) {
+            sarifResult.locations[0].physicalLocation.region.startLine = issue.line;
+          }
+        }
+
+        return sarifResult;
+      })
+    }]
+  };
+
+  console.log(JSON.stringify(sarif, null, 2));
+}
+
+module.exports = { print };

package/src/reporter/terminal.js

@@ -0,0 +1,80 @@
+/**
+ * Terminal Reporter — 在终端中以彩色方式输出审查结果
+ *
+ * 参考框架：eslint 的终端输出风格（颜色编码 + 严重级别图标）
+ *           reviewdog 的格式化输出
+ *
+ * 参考：eslint 的 stylish formatter（颜色编码风格）
+ *       reviewdog 的 CheckStyle 输出格式
+ */
+
+/**
+ * 严重级别对应的样式
+ */
+const SEVERITY_STYLES = {
+  critical: { icon: '🔴', color: '\x1b[31m', label: '严重' },
+  high:     { icon: '🟠', color: '\x1b[33m', label: '高' },
+  medium:   { icon: '🟡', color: '\x1b[33m', label: '中' },
+  low:      { icon: '🔵', color: '\x1b[36m', label: '低' },
+  note:     { icon: '⚪', color: '\x1b[90m', label: '建议' }
+};
+
+const RESET = '\x1b[0m';
+const BOLD = '\x1b[1m';
+const GRAY = '\x1b[90m';
+const GREEN = '\x1b[32m';
+const SEPARATOR = '─';
+
+/**
+ * 在终端输出审查结果
+ * @param {Object} result - 审查结果
+ */
+function print(result) {
+  if (!result || !result.issues || result.issues.length === 0) {
+    console.log(`\n${GREEN}✅ 审查完成，未发现问题。${RESET}\n`);
+    return;
+  }
+
+  // 标题
+  console.log(`\n${BOLD}📋 代码审查报告${RESET}`);
+  console.log(`${GRAY}${SEPARATOR.repeat(50)}${RESET}`);
+  console.log(`  ${result.summary || '审查完成'}`);
+  console.log(`${GRAY}${SEPARATOR.repeat(50)}${RESET}`);
+
+  // 统计信息
+  const stats = result.stats || {};
+  const statParts = [];
+  if (stats.critical) statParts.push(`\x1b[31m${stats.critical} 严重${RESET}`);
+  if (stats.high) statParts.push(`\x1b[33m${stats.high} 高${RESET}`);
+  if (stats.medium) statParts.push(`\x1b[33m${stats.medium} 中${RESET}`);
+  if (stats.low) statParts.push(`\x1b[36m${stats.low} 低${RESET}`);
+  const total = stats.totalIssues || result.issues.length;
+  console.log(`  共 ${total} 个问题: ${statParts.join(', ')}\n`);
+
+  // 逐条输出问题
+  for (const issue of result.issues) {
+    const style = SEVERITY_STYLES[issue.severity] || SEVERITY_STYLES.note;
+    const location = issue.file
+      ? `${issue.file}${issue.line ? `:${issue.line}` : ''}`
+      : '';
+
+    console.log(`${style.icon} ${BOLD}[${style.label}]${RESET} ${issue.title}`);
+    if (location) console.log(`   ${GRAY}📁 ${location}${RESET}`);
+    console.log(`   ${issue.description}`);
+    if (issue.suggestion) {
+      console.log(`   ${GREEN}💡 ${issue.suggestion}${RESET}`);
+    }
+    console.log('');
+  }
+
+  // 值得肯定的地方
+  if (result.positives && result.positives.length > 0) {
+    console.log(`${GREEN}✅ 值得肯定的地方:${RESET}`);
+    for (const p of result.positives) {
+      console.log(`   • ${p}`);
+    }
+    console.log('');
+  }
+}
+
+module.exports = { print };

package/src/runner.js

@@ -0,0 +1,61 @@
+/**
+ * Runner 阶段 — 读取 git diff 和文件上下文
+ *
+ * 参考框架：reviewdog 的 Runner 阶段
+ * reviewdog 的 Runner 负责运行 linter 并读取结果
+ * 我们的 Runner 负责读取 git diff 和文件内容
+ *
+ * 参考：
+ *   reviewdog 的 Runner 设计：运行工具 → 读取结果 → 传递给下一阶段
+ *   ai-commit-message 的 git diff 读取逻辑（复用）
+ */
+
+const git = require('./git.js');
+
+/**
+ * Runner 阶段：读取 git diff 和文件上下文
+ * @param {Object} context - 管道上下文
+ * @param {Object} context.options - 命令行选项
+ * @returns {Object} 更新后的上下文，包含 diff、files、branch、stats
+ */
+async function runner(context) {
+  const options = context.options || {};
+
+  if (!git.isGitRepo()) {
+    throw new Error('当前目录不是 git 仓库，请先在 git 仓库中运行 ai-review');
+  }
+
+  const diff = git.getDiff({
+    staged: options.staged,
+    commit: options.commit,
+    file: options.file
+  });
+
+  if (!diff || diff.trim().length === 0) {
+    return { diff: '', files: [], branch: 'unknown', stats: { fileCount: 0, additions: 0, deletions: 0, diffLength: 0 } };
+  }
+
+  const files = git.getChangedFiles({
+    staged: options.staged,
+    commit: options.commit
+  });
+
+  const branch = git.getCurrentBranch();
+
+  // 统计增删行数
+  let additions = 0;
+  let deletions = 0;
+  for (const line of diff.split('\n')) {
+    if (line.startsWith('+') && !line.startsWith('+++')) additions++;
+    if (line.startsWith('-') && !line.startsWith('---')) deletions++;
+  }
+
+  return {
+    diff,
+    files,
+    branch,
+    stats: { fileCount: files.length, additions, deletions, diffLength: diff.length }
+  };
+}
+
+module.exports = { runner };