§0 快速开始
触发 → 收集三源(git + calendar + memory) → 聚合 → 模板渲染 → 写入文件
降级：任一数据源不可用时自动降级，不阻塞流程
§1 执行流程
阶段1：参数确认
从用户输入提取：
- 报告类型：周报/月报
- 时间范围：本周/本月/指定日期区间
- git 仓库路径：默认当前目录，可多仓库
- 输出路径：默认 output/ 目录
- 日历源：自动读取 / 手动输入 / 跳过
若关键参数缺失，一次性询问后继续。
阶段2：数据采集
依次调用 report_generator.py 的三个采集模式：
| 命令 | 采集内容 |
|---|---|
--mode git |
git log：commit hash / author / date / message / changed files |
--mode calendar |
日历事件：从用户提供或连接器读取 |
--mode memory |
从上下文提取关键决策和讨论 |
阶段3：跨源聚合
将三源数据按时间线对齐，自动匹配：
- commit 和 calendar event 的时间重合 → 标注关联
- 同一模块的多条 commit → 合并为一条工作项
- 无 git 覆盖但 calendar/memory 有记录 → 标记为「非代码工作」
阶段4：模板渲染
# [类型] 时间范围
## 一、完成
（按模块分组，关联 commit/calendar）
## 二、进行中
（标注进度和预计完成时间）
## 三、风险与阻塞
## 四、下周期计划
阶段5：写入文件
输出到指定路径，格式为 周报_YYYY-WXX.md 或 月报_YYYY-MM.md
§2 参数规格
| 参数 | 必填 | 默认值 | 说明 |
|---|---|---|---|
| --type | 是 | weekly | weekly / monthly |
| --start | 否 | 本周一/本月1日 | 起始日期 YYYY-MM-DD |
| --end | 否 | 本周日/本月末日 | 结束日期 |
| --repo | 否 | 当前目录 | git 仓库路径，可多个 |
| --author | 否 | git config user.name | 只统计指定作者 |
| --output | 否 | output/ | 输出目录 |
| --calendar | 否 | 无 | 日历事件文本或文件路径 |
| --template | 否 | 内置模板 | 自定义模板文件路径 |
§3 降级逻辑
| 条件 | 行为 |
|---|---|
| 指定路径非 git 仓库 | 跳过 git 采集，提示用户 |
| 多仓库中部分非 git | 只采集有效仓库 |
| 无日历数据 | 日历段留空或标注「手动补充」 |
| 无对话上下文 | memory 段标注「暂无记录」 |
§A 错误码
| 错误码 | 含义 | 处理 |
|---|---|---|
| E1.1 | 所有指定路径非 git 仓库 | 提示 + 询问是否纯手动填写 |
| E1.2 | 输出目录不可写 | 检查权限 + 提示备选路径 |
| E2.1 | 时间范围无任何提交 | 生成空模板（标注无代码提交） |
| E2.2 | 日历解析失败 | 降级为「手动补充」 |
§F 版本
v1.0（2026-07-24）· 初始化
（内容由AI生成，仅供参考）
