# 📌 周报归档快速参考

## 🎯 核心功能

✅ **自动归档** - 每次生成周报时自动保存到 `weekly-reports/YYYY/YYYY-Www-周报.md`  
✅ **汇总工具** - 按周/月/年汇总，用于月度/年度考核  
✅ **双重保障** - 邮件草稿（发送）+ 本地归档（检索）

---

## 🚀 快速使用

### 生成周报（每周五）

**推荐方式：直接对话**
```
你：生成本周周报
我：自动完成归档 + 存入草稿箱
```

**手动方式：**
```bash
python3 send_weekly_report.py \
  --project G5 \
  --plain "项目名称：...\n主要任务：...\n..." \
  --html "<p>...</p>" \
  --date-range "2026-08-25 ~ 2026-08-29"
```

### 汇总报告（考核用）

```bash
cd weekly-reports

# 月度汇总
python3 summarize_reports.py --month 2026-08

# 年度汇总
python3 summarize_reports.py --year 2026

# 自定义范围
python3 summarize_reports.py --range 2026-07-01 2026-09-30
```

---

## 📁 文件位置

```
weekly-reports/
├── README.md           # 详细说明
├── 使用指南.md         # 完整教程
├── 归档总结.md         # 系统总结
├── summarize_reports.py # 汇总工具
├── 2026/               # 2026 年周报
│   ├── 2026-W29.md
│   ├── 2026-W31-周报.md
│   └── ...
└── 2025-XX/            # 2025 年历史周报
```

---

## 🔍 快速检索

```bash
# 查看某年所有周报
ls weekly-reports/2026/

# 搜索关键词
grep -r "库存预警" weekly-reports/ --include="*.md"

# 查看特定周报
cat weekly-reports/2026/2026-W31-周报.md
```

---

## 📞 需要帮助？

直接说：
- "生成本周周报"
- "汇总 7 月工作"
- "查找库存相关周报"
- "生成年终总结"

---

*详细文档见 `README.md` 和 `使用指南.md`*