Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Git 工作负载分析器

这个工具通过调用 Google Generative AI 对 Git 提交的 diff 进行分析，提取任务事项并生成 Markdown 报告。

功能特性

  • 支持分析指定作者的 Git 提交；若不指定作者则分析所有提交
  • 对每个提交的文件级变更进行 AI 分析
  • 提取可交付的任务事项（含中文估算人天），输出 Markdown
  • 进度条展示与失败重试（可配置最大重试与延迟）
  • 通过命令行参数配置代理（无需环境变量）

安装依赖

pnpm install

配置

  1. 创建 .env 文件并配置 Google Gemini API 密钥（或通过命令行 --apiKey 传入）：
GEMINI_API_KEY=your_gemini_api_key_here

无需设置代理相关环境变量，若需代理，请在运行时使用 --proxyUrl 指定。

使用方法

# 基本用法（指定作者）
pnpm start --repoPath /path/to/repo --author "作者名或邮箱" --outputFile /absolute/path/analysis.md --apiKey your_api_key

# 分析所有作者（不传 --author）
pnpm start --repoPath /path/to/repo --outputFile /absolute/path/analysis.md --apiKey your_api_key

# 使用代理（通过参数而非环境变量）
pnpm start --repoPath /path/to/repo --author "作者名" --outputFile /absolute/path/analysis.md --apiKey your_api_key --proxyUrl http://proxy:8080

# 自定义重试参数
pnpm start --repoPath /path/to/repo --author "作者名" --outputFile /absolute/path/analysis.md --apiKey your_api_key --maxRetries 5 --retryDelay 2000

参数说明

  • --repoPath, -r: Git 仓库路径（必需）
  • --author: 作者名称或邮箱（可选；不传则分析所有提交）
  • --outputFile, -o: 输出 Markdown 文件路径（必需，建议使用绝对路径）
  • --apiKey: Gemini API 密钥（可选；若未传则读取环境变量 GEMINI_API_KEY）
  • --proxyUrl: 代理服务器 URL（可选；通过 undici 全局代理生效）
  • --maxRetries: 最大重试次数（默认：3）
  • --retryDelay: 重试延迟毫秒数（默认：3000）

注意事项

  • 确保有足够的API配额
  • 大型仓库可能需要较长的分析时间
  • 建议在分析前先测试小范围的提交
  • 代理请通过 --proxyUrl 参数设置；当前不读取代理相关环境变量
  • 默认模型为 gemini-2.0-flash-001