goodiffer 1.0.0

package/README.md

@@ -0,0 +1,137 @@
+# Goodiffer
+
+AI-powered git diff analyzer for code review - 基于 AI 的 Git Diff 智能分析工具
+
+[![npm version](https://badge.fury.io/js/goodiffer.svg)](https://www.npmjs.com/package/goodiffer)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- 🤖 支持 Claude (Anthropic) 和 GPT (OpenAI) 模型
+- 🔍 自动分析 git diff，识别潜在问题
+- 📊 生成结构化的代码审查报告
+- 🔗 检测代码关联性风险
+- 📋 生成可复制的修复提示词，方便在 Claude Code / Codex 中使用
+- 🌐 支持第三方 API 代理
+
+## Installation
+
+```bash
+npm install -g goodiffer
+```
+
+## Quick Start
+
+```bash
+# 1. 初始化配置
+goodiffer init
+
+# 2. 分析最近一次 commit
+goodiffer
+
+# 3. 查看帮助
+goodiffer --help
+```
+
+## Usage
+
+### 初始化配置
+
+```bash
+goodiffer init
+```
+
+交互式配置：
+- 选择 API Host (Anthropic/OpenAI/PackyAPI/自定义)
+- 输入 API Key
+- 选择模型 (claude-sonnet-4-5/gpt-4o/自定义)
+
+### 分析命令
+
+```bash
+# 分析最近一次 commit (默认)
+goodiffer
+
+# 分析暂存区
+goodiffer -s
+goodiffer --staged
+
+# 分析指定 commit
+goodiffer -c <commit-sha>
+goodiffer --commit <commit-sha>
+
+# 分析 commit 范围
+goodiffer --from <start-sha> --to <end-sha>
+```
+
+### 配置管理
+
+```bash
+# 查看当前配置
+goodiffer config list
+
+# 设置配置项
+goodiffer config set apiHost https://api.anthropic.com
+goodiffer config set model claude-sonnet-4-5-20250929
+
+# 清除配置
+goodiffer config clear
+```
+
+## Output Example
+
+```
+╭──────────────────────────────────────────────────────────╮
+│  Goodiffer Analysis Report                               │
+╰──────────────────────────────────────────────────────────╯
+
+📝 Commit: feat: add user authentication
+
+📊 Summary: 添加用户认证功能，包含登录表单和 API 调用
+
+🎯 Commit 匹配: ✓ 代码修改符合 commit 描述
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🔴 ERRORS (1)
+
+[E001] src/auth/login.js:45-52
+问题: 未处理 API 调用失败的情况
+
+📋 修复提示词 (复制到 cc/codex):
+┌────────────────────────────────────────────────────────┐
+│ 在 src/auth/login.js 第45行添加 try-catch 处理异常    │
+└────────────────────────────────────────────────────────┘
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📈 统计: 1 errors 0 warnings 0 info 0 risks
+```
+
+## Supported API Providers
+
+| Provider | API Host | Models |
+|----------|----------|--------|
+| Anthropic | https://api.anthropic.com | claude-sonnet-4-5, claude-3-opus |
+| OpenAI | https://api.openai.com | gpt-4o, gpt-4-turbo |
+| PackyAPI | https://www.packyapi.com | claude-*, gpt-* |
+| Custom | 自定义 URL | 任意模型 |
+
+## Configuration
+
+配置文件存储在 `~/.config/goodiffer-nodejs/config.json`
+
+可配置项：
+- `apiHost` - API 服务地址
+- `apiKey` - API 密钥
+- `model` - 模型名称
+- `provider` - 提供商 (claude/openai/custom)
+
+## Requirements
+
+- Node.js >= 18.0.0
+- Git
+
+## License
+
+MIT

package/bin/goodiffer.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { program } from '../src/index.js';
+
+program.parse(process.argv);

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "goodiffer",
+  "version": "1.0.0",
+  "description": "AI-powered git diff analyzer for code review - 智能代码审查工具",
+  "type": "module",
+  "bin": {
+    "goodiffer": "./bin/goodiffer.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node bin/goodiffer.js"
+  },
+  "keywords": [
+    "git",
+    "diff",
+    "code-review",
+    "ai",
+    "cli",
+    "claude",
+    "openai",
+    "gpt",
+    "anthropic",
+    "code-analysis",
+    "developer-tools"
+  ],
+  "author": "kris",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kris/goodiffer"
+  },
+  "homepage": "https://github.com/kris/goodiffer#readme",
+  "bugs": {
+    "url": "https://github.com/kris/goodiffer/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "conf": "^12.0.0",
+    "inquirer": "^9.2.15",
+    "openai": "^4.70.0",
+    "ora": "^8.0.1",
+    "simple-git": "^3.22.0"
+  }
+}

package/src/commands/analyze.js

@@ -0,0 +1,137 @@
+import ora from 'ora';
+import chalk from 'chalk';
+import { getConfig, isConfigured } from '../utils/config-store.js';
+import logger from '../utils/logger.js';
+import { isGitRepo, getLastCommitInfo, getCommitInfo, getDiff, getChangedFiles } from '../services/git.js';
+import { AIClient } from '../services/ai-client.js';
+import { buildReviewPrompt } from '../prompts/review-prompt.js';
+import { parseAIResponse, printReport } from '../services/reporter.js';
+
+export async function analyzeCommand(options = {}) {
+  // 检查是否在 git 仓库中
+  if (!await isGitRepo()) {
+    logger.error('当前目录不是 git 仓库');
+    process.exit(1);
+  }
+
+  // 检查配置
+  if (!isConfigured()) {
+    logger.error('尚未配置 API。请先运行: goodiffer init');
+    process.exit(1);
+  }
+
+  const config = getConfig();
+
+  // 获取 commit 信息
+  let commitInfo;
+  if (options.commit) {
+    commitInfo = await getCommitInfo(options.commit);
+  } else if (options.staged) {
+    commitInfo = {
+      sha: 'staged',
+      message: '(暂存区变更)',
+      author: '',
+      date: new Date().toISOString()
+    };
+  } else {
+    commitInfo = await getLastCommitInfo();
+  }
+
+  if (!commitInfo && !options.staged) {
+    logger.error('无法获取 commit 信息');
+    process.exit(1);
+  }
+
+  // 获取 diff
+  const spinner = ora('获取代码变更...').start();
+
+  const diff = await getDiff({
+    staged: options.staged,
+    commit: options.commit,
+    from: options.from,
+    to: options.to
+  });
+
+  if (!diff || diff.trim().length === 0) {
+    spinner.fail('没有找到代码变更');
+    process.exit(0);
+  }
+
+  const changedFiles = await getChangedFiles({
+    staged: options.staged,
+    commit: options.commit,
+    from: options.from,
+    to: options.to
+  });
+
+  spinner.succeed(`找到 ${changedFiles.length} 个文件变更`);
+
+  // 检查 diff 大小
+  const diffLines = diff.split('\n').length;
+  if (diffLines > 2000) {
+    logger.warn(`diff 较大 (${diffLines} 行)，分析可能需要较长时间`);
+  }
+
+  // 构建提示词
+  const prompt = buildReviewPrompt(commitInfo.message, diff, changedFiles);
+
+  // 创建 AI 客户端
+  const aiClient = new AIClient(config);
+
+  // 流式分析
+  console.log(chalk.cyan('\n🤖 AI 分析中...\n'));
+  console.log(chalk.gray('─'.repeat(60)));
+
+  let fullResponse = '';
+  let isShowingStream = true;
+
+  try {
+    fullResponse = await aiClient.analyzeStream(prompt, (chunk) => {
+      if (isShowingStream) {
+        process.stdout.write(chalk.gray(chunk));
+      }
+    });
+
+    console.log(chalk.gray('\n' + '─'.repeat(60)));
+
+    // 解析响应
+    const report = parseAIResponse(fullResponse);
+
+    if (report) {
+      // 打印格式化报告
+      printReport(commitInfo, report);
+    } else {
+      logger.error('无法解析 AI 响应，请查看上方原始输出');
+    }
+
+  } catch (error) {
+    console.log('');
+    const errMsg = error.message || String(error);
+
+    if (errMsg.includes('401') || errMsg.includes('API key') || errMsg.includes('Unauthorized')) {
+      logger.error('API Key 无效或已过期。请运行 goodiffer init 重新配置');
+    } else if (errMsg.includes('403') || errMsg.includes('blocked') || errMsg.includes('Forbidden')) {
+      logger.error('API 请求被拒绝 (403)');
+      logger.info('可能原因:');
+      logger.info('  1. API Key 无效或无权限');
+      logger.info('  2. 模型名称不正确 (第三方 API 可能使用不同名称)');
+      logger.info('  3. 账户余额不足或已过期');
+      logger.info(`当前配置: apiHost=${config.apiHost}, model=${config.model}`);
+      logger.info('请运行 goodiffer init 检查配置');
+    } else if (errMsg.includes('404')) {
+      logger.error('API 端点不存在 (404)');
+      logger.info(`当前端点: ${config.apiHost}/v1/chat/completions`);
+      logger.info('请检查 API Host 是否正确');
+    } else if (errMsg.includes('rate limit') || errMsg.includes('429')) {
+      logger.error('API 请求频率超限，请稍后重试');
+    } else if (errMsg.includes('ENOTFOUND') || errMsg.includes('ECONNREFUSED')) {
+      logger.error('无法连接到 API 服务器');
+      logger.info(`当前 API Host: ${config.apiHost}`);
+    } else {
+      logger.error(`分析失败: ${errMsg}`);
+    }
+    process.exit(1);
+  }
+}
+
+export default analyzeCommand;

package/src/commands/config.js

@@ -0,0 +1,85 @@
+import { getConfig, setConfig, clearConfig } from '../utils/config-store.js';
+import logger from '../utils/logger.js';
+
+export function configCommand(action, key, value) {
+  switch (action) {
+    case 'list':
+      listConfig();
+      break;
+    case 'get':
+      getConfigValue(key);
+      break;
+    case 'set':
+      setConfigValue(key, value);
+      break;
+    case 'clear':
+      clearAllConfig();
+      break;
+    default:
+      logger.error(`未知操作: ${action}`);
+      logger.info('可用操作: list, get, set, clear');
+  }
+}
+
+function listConfig() {
+  const config = getConfig();
+  logger.title('当前配置');
+
+  console.log(`  apiHost:  ${config.apiHost || '(未设置)'}`);
+  console.log(`  provider: ${config.provider || '(未设置)'}`);
+  console.log(`  model:    ${config.model || '(未设置)'}`);
+  console.log(`  apiKey:   ${config.apiKey ? '*'.repeat(8) + '...' + config.apiKey.slice(-4) : '(未设置)'}`);
+
+  // 显示实际 API 端点
+  if (config.apiHost) {
+    console.log('');
+    // 根据模型名称判断端点
+    if (config.model && config.model.toLowerCase().startsWith('claude')) {
+      console.log(`  端点:     ${config.apiHost}/v1/messages`);
+    } else {
+      console.log(`  端点:     ${config.apiHost}/v1/chat/completions`);
+    }
+  }
+}
+
+function getConfigValue(key) {
+  if (!key) {
+    logger.error('请指定配置项名称');
+    return;
+  }
+  const config = getConfig();
+  if (key === 'apiKey' && config[key]) {
+    console.log('*'.repeat(8) + '...' + config[key].slice(-4));
+  } else {
+    console.log(config[key] || '(未设置)');
+  }
+}
+
+function setConfigValue(key, value) {
+  if (!key || value === undefined) {
+    logger.error('用法: goodiffer config set <key> <value>');
+    return;
+  }
+
+  const validKeys = ['provider', 'apiHost', 'apiKey', 'model'];
+  if (!validKeys.includes(key)) {
+    logger.error(`无效的配置项: ${key}`);
+    logger.info(`可用配置项: ${validKeys.join(', ')}`);
+    return;
+  }
+
+  if (key === 'provider' && !['claude', 'openai', 'custom'].includes(value)) {
+    logger.error('provider 必须是 claude、openai 或 custom');
+    return;
+  }
+
+  setConfig(key, value);
+  logger.success(`已设置 ${key}`);
+}
+
+function clearAllConfig() {
+  clearConfig();
+  logger.success('配置已清除');
+}
+
+export default configCommand;

package/src/commands/init.js

@@ -0,0 +1,137 @@
+import inquirer from 'inquirer';
+import { setAllConfig, getConfig } from '../utils/config-store.js';
+import logger from '../utils/logger.js';
+
+// 预设的模型列表
+const MODEL_CHOICES = [
+  { name: 'claude-sonnet-4-5 (Claude)', value: 'claude-sonnet-4-5' },
+  { name: 'claude-sonnet-4-20250514 (Claude)', value: 'claude-sonnet-4-20250514' },
+  { name: 'gpt-5.1-high (OpenAI)', value: 'gpt-5.1-high' },
+  { name: 'gpt-4o (OpenAI)', value: 'gpt-4o' },
+  { name: 'gpt-4-turbo (OpenAI)', value: 'gpt-4-turbo' },
+  { name: 'deepseek-chat (DeepSeek)', value: 'deepseek-chat' },
+  { name: '自定义模型...', value: '__custom__' }
+];
+
+// 预设的 API Host 列表
+const API_HOST_CHOICES = [
+  { name: 'Anthropic 官方 (api.anthropic.com)', value: 'https://api.anthropic.com' },
+  { name: 'OpenAI 官方 (api.openai.com)', value: 'https://api.openai.com' },
+  { name: 'PackyAPI (packyapi.com)', value: 'https://www.packyapi.com' },
+  { name: '自定义 API Host...', value: '__custom__' }
+];
+
+export async function initCommand() {
+  logger.title('Goodiffer 初始化配置');
+
+  const currentConfig = getConfig();
+
+  const answers = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'apiHostChoice',
+      message: '选择 API Host:',
+      choices: API_HOST_CHOICES,
+      default: () => {
+        if (currentConfig.apiHost) {
+          const found = API_HOST_CHOICES.find(c => c.value === currentConfig.apiHost);
+          return found ? found.value : '__custom__';
+        }
+        return 'https://api.anthropic.com';
+      }
+    },
+    {
+      type: 'input',
+      name: 'customApiHost',
+      message: '输入自定义 API Host (例如 https://api.example.com):',
+      when: (answers) => answers.apiHostChoice === '__custom__',
+      default: currentConfig.apiHost || '',
+      validate: (input) => {
+        if (!input || !input.startsWith('http')) {
+          return '请输入有效的 URL (以 http:// 或 https:// 开头)';
+        }
+        return true;
+      }
+    },
+    {
+      type: 'password',
+      name: 'apiKey',
+      message: 'API Key:',
+      mask: '*',
+      validate: (input) => {
+        if (!input || input.length < 10) {
+          return '请输入有效的 API Key';
+        }
+        return true;
+      }
+    },
+    {
+      type: 'list',
+      name: 'modelChoice',
+      message: '选择模型:',
+      choices: MODEL_CHOICES,
+      default: () => {
+        if (currentConfig.model) {
+          const found = MODEL_CHOICES.find(c => c.value === currentConfig.model);
+          return found ? found.value : '__custom__';
+        }
+        return 'claude-sonnet-4-5';
+      }
+    },
+    {
+      type: 'input',
+      name: 'customModel',
+      message: '输入自定义模型名称:',
+      when: (answers) => answers.modelChoice === '__custom__',
+      default: currentConfig.model || '',
+      validate: (input) => {
+        if (!input || input.length < 1) {
+          return '请输入模型名称';
+        }
+        return true;
+      }
+    }
+  ]);
+
+  // 处理选择结果
+  const apiHost = answers.apiHostChoice === '__custom__'
+    ? answers.customApiHost
+    : answers.apiHostChoice;
+
+  const model = answers.modelChoice === '__custom__'
+    ? answers.customModel
+    : answers.modelChoice;
+
+  // 根据 API Host 和 Model 自动判断 provider
+  let provider = 'custom';
+  if (apiHost.includes('anthropic.com') || model.startsWith('claude')) {
+    provider = 'claude';
+  } else if (apiHost.includes('openai.com') || model.startsWith('gpt')) {
+    provider = 'openai';
+  }
+
+  const configToSave = {
+    provider,
+    apiHost: apiHost.replace(/\/+$/, ''), // 移除末尾斜杠
+    apiKey: answers.apiKey,
+    model
+  };
+
+  setAllConfig(configToSave);
+
+  logger.success('配置已保存!');
+  logger.info(`API Host: ${configToSave.apiHost}`);
+  logger.info(`Provider: ${configToSave.provider}`);
+  logger.info(`模型: ${configToSave.model}`);
+  logger.info(`API Key: ${'*'.repeat(8)}...${answers.apiKey.slice(-4)}`);
+
+  // 显示实际 API 端点
+  console.log('');
+  if (provider === 'claude' && apiHost.includes('anthropic.com')) {
+    logger.info(`API 端点: ${configToSave.apiHost}/v1/messages`);
+  } else {
+    logger.info(`API 端点: ${configToSave.apiHost}/v1/chat/completions`);
+  }
+}
+
+export default initCommand;

package/src/index.js

@@ -0,0 +1,35 @@
+import { Command } from 'commander';
+import { initCommand } from './commands/init.js';
+import { configCommand } from './commands/config.js';
+import { analyzeCommand } from './commands/analyze.js';
+
+export const program = new Command();
+
+program
+  .name('goodiffer')
+  .description('AI-powered git diff analyzer for code review')
+  .version('1.0.0');
+
+// 初始化命令
+program
+  .command('init')
+  .description('初始化配置 (设置 AI 提供商和 API Key)')
+  .action(initCommand);
+
+// 配置管理命令
+program
+  .command('config <action> [key] [value]')
+  .description('配置管理 (list/get/set/clear)')
+  .action(configCommand);
+
+// 分析命令
+program
+  .command('analyze', { isDefault: true })
+  .description('分析 git diff (默认命令)')
+  .option('-s, --staged', '分析暂存区的变更')
+  .option('-c, --commit <sha>', '分析指定 commit')
+  .option('--from <sha>', '分析 commit 范围 (起始)')
+  .option('--to <sha>', '分析 commit 范围 (结束)')
+  .action(analyzeCommand);
+
+export default program;

package/src/prompts/review-prompt.js

@@ -0,0 +1,78 @@
+export function buildReviewPrompt(commitMessage, diff, changedFiles) {
+  return `你是一个专业的 Code Reviewer，专注于代码质量和潜在问题分析。
+
+## 任务
+
+1. **理解 Commit 意图**: 首先仔细阅读并理解以下 commit message，它描述了这次修改的目的和内容。
+2. **分析代码变更**: 检查 diff 中的代码修改是否准确实现了 commit 描述的意图。
+3. **识别潜在问题**: 检查代码中可能存在的问题，包括:
+   - 编译/运行时错误风险
+   - 逻辑错误或边界情况未处理
+   - 类型错误或空值处理问题
+   - 关联性 bug (修改可能影响其他模块或功能)
+
+## Commit Message
+\`\`\`
+${commitMessage}
+\`\`\`
+
+## 变更文件列表
+${changedFiles.map(f => `- ${f}`).join('\n')}
+
+## 代码 Diff
+\`\`\`diff
+${diff}
+\`\`\`
+
+## 输出要求
+
+请以 JSON 格式输出分析结果，格式如下:
+
+\`\`\`json
+{
+  "summary": "简要概述这次变更的内容和目的 (1-2句话)",
+  "commitAlignment": {
+    "aligned": true/false,
+    "comment": "代码修改是否符合 commit 描述的意图的说明"
+  },
+  "issues": [
+    {
+      "level": "error|warning|info",
+      "type": "compile|runtime|logic|security|association",
+      "file": "文件路径",
+      "line": "行号或行号范围 (如 45 或 45-52)",
+      "code": "问题代码片段",
+      "description": "问题的详细描述",
+      "suggestion": "修复建议",
+      "fixPrompt": "可以直接复制到 Claude Code 或 Codex 中的修复提示词"
+    }
+  ],
+  "associationRisks": [
+    {
+      "changedFile": "被修改的文件路径",
+      "relatedFiles": ["可能受影响的文件1", "可能受影响的文件2"],
+      "risk": "潜在的关联风险描述",
+      "checkPrompt": "用于检查关联问题的提示词"
+    }
+  ],
+  "suggestions": [
+    "其他改进建议 (可选)"
+  ]
+}
+\`\`\`
+
+## 问题级别说明
+- **error**: 会导致编译失败、运行时崩溃或严重 bug 的问题
+- **warning**: 可能导致问题或不符合最佳实践的代码
+- **info**: 建议性的改进，不影响功能
+
+## 注意事项
+1. 只报告实际存在的问题，不要过度警告
+2. fixPrompt 应该简洁明确，方便用户直接复制使用
+3. 关联风险只报告真正可能受影响的情况
+4. 如果代码没有问题，issues 和 associationRisks 可以为空数组
+
+请仅输出 JSON，不要包含其他解释文字。`;
+}
+
+export default buildReviewPrompt;

package/src/services/ai-client.js

@@ -0,0 +1,184 @@
+import OpenAI from 'openai';
+
+export class AIClient {
+  constructor(config) {
+    this.provider = config.provider;
+    this.apiKey = config.apiKey;
+    this.apiHost = config.apiHost;
+    this.model = config.model;
+
+    // 根据模型名称判断使用哪种 API 格式
+    this.useAnthropicFormat = this.model && this.model.toLowerCase().startsWith('claude');
+
+    if (!this.useAnthropicFormat) {
+      // OpenAI 兼容格式 API
+      const baseUrl = this.buildOpenAIBaseUrl();
+      this.client = new OpenAI({
+        apiKey: this.apiKey,
+        baseURL: baseUrl
+      });
+    }
+  }
+
+  buildOpenAIBaseUrl() {
+    if (!this.apiHost) {
+      return 'https://api.openai.com/v1';
+    }
+
+    let host = this.apiHost.replace(/\/+$/, '');
+
+    if (!host.endsWith('/v1')) {
+      host = `${host}/v1`;
+    }
+
+    return host;
+  }
+
+  async analyzeStream(prompt, onChunk) {
+    if (this.useAnthropicFormat) {
+      return this.analyzeWithClaudeFetch(prompt, onChunk);
+    } else {
+      return this.analyzeWithOpenAI(prompt, onChunk);
+    }
+  }
+
+  // 使用原生 fetch 调用 Claude API (绕过 SDK 的 Cloudflare 问题)
+  async analyzeWithClaudeFetch(prompt, onChunk) {
+    const baseUrl = (this.apiHost || 'https://api.anthropic.com').replace(/\/+$/, '');
+    const url = `${baseUrl}/v1/messages`;
+
+    const response = await fetch(url, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'x-api-key': this.apiKey,
+        'anthropic-version': '2023-06-01'
+      },
+      body: JSON.stringify({
+        model: this.model || 'claude-sonnet-4-20250514',
+        max_tokens: 8192,
+        stream: true,
+        messages: [
+          {
+            role: 'user',
+            content: prompt
+          }
+        ]
+      })
+    });
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`${response.status} ${errorText}`);
+    }
+
+    let fullContent = '';
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+
+      const chunk = decoder.decode(value, { stream: true });
+      const lines = chunk.split('\n');
+
+      for (const line of lines) {
+        if (line.startsWith('data: ')) {
+          const data = line.slice(6);
+          if (data === '[DONE]') continue;
+
+          try {
+            const parsed = JSON.parse(data);
+            if (parsed.type === 'content_block_delta' && parsed.delta?.text) {
+              const text = parsed.delta.text;
+              fullContent += text;
+              if (onChunk) {
+                onChunk(text);
+              }
+            }
+          } catch {
+            // 忽略解析错误
+          }
+        }
+      }
+    }
+
+    return fullContent;
+  }
+
+  async analyzeWithOpenAI(prompt, onChunk) {
+    let fullContent = '';
+
+    const stream = await this.client.chat.completions.create({
+      model: this.model || 'gpt-4o',
+      messages: [
+        {
+          role: 'user',
+          content: prompt
+        }
+      ],
+      stream: true
+    });
+
+    for await (const chunk of stream) {
+      const text = chunk.choices[0]?.delta?.content || '';
+      if (text) {
+        fullContent += text;
+        if (onChunk) {
+          onChunk(text);
+        }
+      }
+    }
+
+    return fullContent;
+  }
+
+  // 非流式分析 (备用)
+  async analyze(prompt) {
+    if (this.useAnthropicFormat) {
+      const baseUrl = (this.apiHost || 'https://api.anthropic.com').replace(/\/+$/, '');
+      const url = `${baseUrl}/v1/messages`;
+
+      const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'x-api-key': this.apiKey,
+          'anthropic-version': '2023-06-01'
+        },
+        body: JSON.stringify({
+          model: this.model || 'claude-sonnet-4-20250514',
+          max_tokens: 8192,
+          messages: [
+            {
+              role: 'user',
+              content: prompt
+            }
+          ]
+        })
+      });
+
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`${response.status} ${errorText}`);
+      }
+
+      const data = await response.json();
+      return data.content[0].text;
+    } else {
+      const response = await this.client.chat.completions.create({
+        model: this.model || 'gpt-4o',
+        messages: [
+          {
+            role: 'user',
+            content: prompt
+          }
+        ]
+      });
+      return response.choices[0].message.content;
+    }
+  }
+}
+
+export default AIClient;

package/src/services/git.js

@@ -0,0 +1,136 @@
+import { simpleGit } from 'simple-git';
+import logger from '../utils/logger.js';
+
+const git = simpleGit();
+
+export async function isGitRepo() {
+  try {
+    await git.revparse(['--git-dir']);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export async function getLastCommitInfo() {
+  try {
+    const log = await git.log({ maxCount: 1 });
+    if (log.latest) {
+      return {
+        sha: log.latest.hash,
+        message: log.latest.message,
+        author: log.latest.author_name,
+        date: log.latest.date
+      };
+    }
+    return null;
+  } catch (error) {
+    logger.error(`获取 commit 信息失败: ${error.message}`);
+    return null;
+  }
+}
+
+export async function getCommitInfo(sha) {
+  try {
+    const log = await git.log({ from: sha, to: sha, maxCount: 1 });
+    if (log.latest) {
+      return {
+        sha: log.latest.hash,
+        message: log.latest.message,
+        author: log.latest.author_name,
+        date: log.latest.date
+      };
+    }
+    return null;
+  } catch (error) {
+    logger.error(`获取 commit ${sha} 信息失败: ${error.message}`);
+    return null;
+  }
+}
+
+export async function getDiff(options = {}) {
+  try {
+    const { staged, commit, from, to } = options;
+
+    if (staged) {
+      // 暂存区 diff
+      return await git.diff(['--cached']);
+    }
+
+    if (commit) {
+      // 指定 commit 的 diff
+      return await git.diff([`${commit}^`, commit]);
+    }
+
+    if (from && to) {
+      // commit 范围
+      return await git.diff([from, to]);
+    }
+
+    // 默认: 最近一次 commit 的 diff
+    const log = await git.log({ maxCount: 1 });
+    if (log.latest) {
+      return await git.diff([`${log.latest.hash}^`, log.latest.hash]);
+    }
+
+    return '';
+  } catch (error) {
+    // 如果是首次 commit，没有父 commit
+    if (error.message.includes('unknown revision')) {
+      try {
+        // 尝试获取首次 commit 的全部内容
+        return await git.diff(['--cached', 'HEAD']);
+      } catch {
+        return await git.diff(['HEAD']);
+      }
+    }
+    logger.error(`获取 diff 失败: ${error.message}`);
+    return '';
+  }
+}
+
+export async function getChangedFiles(options = {}) {
+  try {
+    const { staged, commit, from, to } = options;
+
+    if (staged) {
+      const status = await git.status();
+      return status.staged;
+    }
+
+    if (commit) {
+      const result = await git.diff(['--name-only', `${commit}^`, commit]);
+      return result.trim().split('\n').filter(Boolean);
+    }
+
+    if (from && to) {
+      const result = await git.diff(['--name-only', from, to]);
+      return result.trim().split('\n').filter(Boolean);
+    }
+
+    // 默认: 最近一次 commit
+    const log = await git.log({ maxCount: 1 });
+    if (log.latest) {
+      const result = await git.diff(['--name-only', `${log.latest.hash}^`, log.latest.hash]);
+      return result.trim().split('\n').filter(Boolean);
+    }
+
+    return [];
+  } catch (error) {
+    logger.error(`获取变更文件列表失败: ${error.message}`);
+    return [];
+  }
+}
+
+export async function getStagedDiff() {
+  return getDiff({ staged: true });
+}
+
+export default {
+  isGitRepo,
+  getLastCommitInfo,
+  getCommitInfo,
+  getDiff,
+  getChangedFiles,
+  getStagedDiff
+};

package/src/services/reporter.js

@@ -0,0 +1,155 @@
+import chalk from 'chalk';
+import logger from '../utils/logger.js';
+
+export function parseAIResponse(content) {
+  try {
+    // 尝试从响应中提取 JSON
+    const jsonMatch = content.match(/```json\s*([\s\S]*?)\s*```/);
+    if (jsonMatch) {
+      return JSON.parse(jsonMatch[1]);
+    }
+
+    // 尝试直接解析
+    const trimmed = content.trim();
+    if (trimmed.startsWith('{')) {
+      return JSON.parse(trimmed);
+    }
+
+    throw new Error('无法解析 AI 响应');
+  } catch (error) {
+    logger.error(`解析 AI 响应失败: ${error.message}`);
+    return null;
+  }
+}
+
+export function printReport(commitInfo, report) {
+  console.log('\n');
+
+  // 标题
+  console.log(chalk.cyan('╭' + '─'.repeat(58) + '╮'));
+  console.log(chalk.cyan('│') + chalk.bold.white('  Goodiffer Analysis Report').padEnd(66) + chalk.cyan('│'));
+  console.log(chalk.cyan('╰' + '─'.repeat(58) + '╯'));
+
+  // Commit 信息
+  console.log(chalk.blue('\n📝 Commit: ') + chalk.white(commitInfo.message.split('\n')[0]));
+  console.log(chalk.gray(`   SHA: ${commitInfo.sha.substring(0, 8)} | ${commitInfo.author} | ${commitInfo.date}`));
+
+  // Summary
+  if (report.summary) {
+    console.log(chalk.green('\n📊 Summary: ') + chalk.white(report.summary));
+  }
+
+  // Commit Alignment
+  if (report.commitAlignment) {
+    const aligned = report.commitAlignment.aligned;
+    const icon = aligned ? chalk.green('✓') : chalk.red('✗');
+    console.log(chalk.yellow('\n🎯 Commit 匹配: ') + icon + ' ' + report.commitAlignment.comment);
+  }
+
+  logger.divider();
+
+  // Issues
+  const issues = report.issues || [];
+  const errors = issues.filter(i => i.level === 'error');
+  const warnings = issues.filter(i => i.level === 'warning');
+  const infos = issues.filter(i => i.level === 'info');
+
+  if (errors.length > 0) {
+    console.log(chalk.red.bold(`\n🔴 ERRORS (${errors.length})`));
+    errors.forEach((issue, idx) => printIssue(issue, `E${String(idx + 1).padStart(3, '0')}`));
+  }
+
+  if (warnings.length > 0) {
+    console.log(chalk.yellow.bold(`\n🟡 WARNINGS (${warnings.length})`));
+    warnings.forEach((issue, idx) => printIssue(issue, `W${String(idx + 1).padStart(3, '0')}`));
+  }
+
+  if (infos.length > 0) {
+    console.log(chalk.blue.bold(`\n🔵 INFO (${infos.length})`));
+    infos.forEach((issue, idx) => printIssue(issue, `I${String(idx + 1).padStart(3, '0')}`));
+  }
+
+  if (issues.length === 0) {
+    console.log(chalk.green.bold('\n✅ 未发现代码问题'));
+  }
+
+  // Association Risks
+  const risks = report.associationRisks || [];
+  if (risks.length > 0) {
+    logger.divider();
+    console.log(chalk.magenta.bold(`\n🔗 ASSOCIATION RISKS (${risks.length})`));
+    risks.forEach(printRisk);
+  }
+
+  // Suggestions
+  const suggestions = report.suggestions || [];
+  if (suggestions.length > 0) {
+    logger.divider();
+    console.log(chalk.cyan.bold('\n💡 建议'));
+    suggestions.forEach((s, idx) => {
+      console.log(chalk.gray(`  ${idx + 1}. `) + chalk.white(s));
+    });
+  }
+
+  // 统计
+  logger.divider();
+  console.log(chalk.gray('\n📈 统计: ') +
+    chalk.red(`${errors.length} errors `) +
+    chalk.yellow(`${warnings.length} warnings `) +
+    chalk.blue(`${infos.length} info `) +
+    chalk.magenta(`${risks.length} risks`));
+
+  console.log('');
+}
+
+function printIssue(issue, code) {
+  console.log('');
+  console.log(chalk.gray(`[${code}] `) + chalk.white(`${issue.file}:${issue.line}`));
+  console.log(chalk.gray('类型: ') + chalk.white(issue.type));
+  console.log(chalk.gray('问题: ') + chalk.white(issue.description));
+
+  if (issue.code) {
+    console.log(chalk.gray('代码:'));
+    console.log(chalk.gray('  ┌─'));
+    issue.code.split('\n').forEach(line => {
+      console.log(chalk.gray('  │ ') + chalk.red(line));
+    });
+    console.log(chalk.gray('  └─'));
+  }
+
+  if (issue.suggestion) {
+    console.log(chalk.gray('建议: ') + chalk.green(issue.suggestion));
+  }
+
+  if (issue.fixPrompt) {
+    console.log(chalk.magenta('\n📋 修复提示词 (复制到 cc/codex):'));
+    console.log(chalk.gray('┌' + '─'.repeat(56) + '┐'));
+    issue.fixPrompt.split('\n').forEach(line => {
+      const paddedLine = line.length > 54 ? line.substring(0, 51) + '...' : line;
+      console.log(chalk.gray('│ ') + chalk.yellow(paddedLine.padEnd(54)) + chalk.gray(' │'));
+    });
+    console.log(chalk.gray('└' + '─'.repeat(56) + '┘'));
+  }
+}
+
+function printRisk(risk) {
+  console.log('');
+  console.log(chalk.white('修改文件: ') + chalk.cyan(risk.changedFile));
+  console.log(chalk.white('可能影响: ') + chalk.yellow(risk.relatedFiles?.join(', ') || '(未知)'));
+  console.log(chalk.white('风险: ') + chalk.red(risk.risk));
+
+  if (risk.checkPrompt) {
+    console.log(chalk.magenta('\n📋 检查提示词:'));
+    console.log(chalk.gray('┌' + '─'.repeat(56) + '┐'));
+    risk.checkPrompt.split('\n').forEach(line => {
+      const paddedLine = line.length > 54 ? line.substring(0, 51) + '...' : line;
+      console.log(chalk.gray('│ ') + chalk.yellow(paddedLine.padEnd(54)) + chalk.gray(' │'));
+    });
+    console.log(chalk.gray('└' + '─'.repeat(56) + '┘'));
+  }
+}
+
+export default {
+  parseAIResponse,
+  printReport
+};

package/src/utils/config-store.js

@@ -0,0 +1,54 @@
+import Conf from 'conf';
+
+const config = new Conf({
+  projectName: 'goodiffer',
+  schema: {
+    provider: {
+      type: 'string',
+      enum: ['claude', 'openai', 'custom'],
+      default: 'custom'
+    },
+    apiHost: {
+      type: 'string',
+      default: ''
+    },
+    apiKey: {
+      type: 'string',
+      default: ''
+    },
+    model: {
+      type: 'string',
+      default: ''
+    }
+  }
+});
+
+export function getConfig() {
+  return {
+    provider: config.get('provider'),
+    apiHost: config.get('apiHost'),
+    apiKey: config.get('apiKey'),
+    model: config.get('model')
+  };
+}
+
+export function setConfig(key, value) {
+  config.set(key, value);
+}
+
+export function setAllConfig(settings) {
+  for (const [key, value] of Object.entries(settings)) {
+    config.set(key, value);
+  }
+}
+
+export function isConfigured() {
+  const apiKey = config.get('apiKey');
+  return apiKey && apiKey.length > 0;
+}
+
+export function clearConfig() {
+  config.clear();
+}
+
+export default config;

package/src/utils/logger.js

@@ -0,0 +1,45 @@
+import chalk from 'chalk';
+
+export const logger = {
+  info: (msg) => console.log(chalk.blue('ℹ'), msg),
+  success: (msg) => console.log(chalk.green('✔'), msg),
+  warn: (msg) => console.log(chalk.yellow('⚠'), msg),
+  error: (msg) => console.log(chalk.red('✖'), msg),
+
+  title: (msg) => console.log(chalk.bold.cyan(`\n${msg}\n`)),
+
+  box: (title, content) => {
+    const width = 50;
+    const top = '╭' + '─'.repeat(width - 2) + '╮';
+    const bottom = '╰' + '─'.repeat(width - 2) + '╯';
+    const line = (text) => '│ ' + text.padEnd(width - 4) + ' │';
+
+    console.log(chalk.cyan(top));
+    console.log(chalk.cyan(line(chalk.bold(title))));
+    console.log(chalk.cyan(bottom));
+    if (content) {
+      console.log(content);
+    }
+  },
+
+  divider: () => console.log(chalk.gray('━'.repeat(50))),
+
+  code: (code, language = '') => {
+    console.log(chalk.gray('┌' + '─'.repeat(48) + '┐'));
+    code.split('\n').forEach(line => {
+      console.log(chalk.gray('│ ') + chalk.white(line));
+    });
+    console.log(chalk.gray('└' + '─'.repeat(48) + '┘'));
+  },
+
+  prompt: (text) => {
+    console.log(chalk.magenta('\n📋 修复提示词 (复制到 cc/codex):'));
+    console.log(chalk.gray('┌' + '─'.repeat(48) + '┐'));
+    text.split('\n').forEach(line => {
+      console.log(chalk.gray('│ ') + chalk.yellow(line));
+    });
+    console.log(chalk.gray('└' + '─'.repeat(48) + '┘'));
+  }
+};
+
+export default logger;