工作流

1) 确定范围与配置

• 统计范围：按周或按月
• 仓库范围：单仓库或多仓库
• 作者：可指定 user.name 或 user.email（支持逗号分隔或数组）
• 运行环境：需要 Node.js 18+

全局配置文件（用于覆盖脚本默认值）：

• 读取顺序：
  1. 环境变量 WEEKLY_REPORT_CONFIG
  2. 当前目录 weekly.config.json
  3. ~/.config/weekly-report/config.json
  4. ~/.weekly-report.json
• 字段示例见 resources/config.example.json
• 还可用 WEEKLY_REPORT_REPO_ROOTS 临时指定仓库根目录列表（用系统路径分隔符分隔）
• 首次运行若未找到配置，会自动生成默认配置到 ~/.config/weekly-report/config.json（repo_roots 默认当前目录），并立即退出（不会继续执行统计）
• 当输出包含 CONFIG_INIT_REQUIRED 时，必须停止后续流程，仅提示用户去修改配置后再运行