# 周报归档说明

## 📁 目录结构

```
weekly-reports/
├── 2025/
│   ├── 2025-W32.md          # 2025 年第 32 周周报
│   └── ...
├── 2026/
│   ├── 2026-W29.md          # 2026 年第 29 周周报
│   ├── 2026-W31-周报.md
│   └── ...
└── README.md                # 本文件
```

## 📝 归档规则

### 文件命名
- 格式：`YYYY-Www.md` 或 `YYYY-Www-周报.md`
- 示例：`2026-W31.md`、`2026-W31-周报.md`

### 文件内容结构
```markdown
# G5 开发周报 (2026-W31)

**日期范围：** 2026-07-27 ~ 2026-07-31

## 基本信息
- **项目：** 维云智造 G5
- **主要任务：** <本周主要任务>

## 本周工作内容

### 周一（2026-07-27）
- xxx
- xxx

### 周二（2026-07-28）
- xxx

### 周三（2026-07-29）
- xxx

### 周四（2026-07-30）
- xxx

### 周五（2026-07-31）
- xxx

## 存在问题
无

---
*归档时间：2026-07-31*
```

## 🔍 快速检索

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

# 查看某月周报（通过 grep 过滤日期）
grep -l "2026-07" weekly-reports/2026/*.md
```

### 按关键词搜索
```bash
# 搜索包含特定关键词的周报
grep -r "库存预警" weekly-reports/

# 搜索某时间段的所有周报
grep -l "2026-0[1-3]" weekly-reports/2026/*.md
```

## 📊 月度/年度汇总

使用汇总脚本生成指定时间范围的工作总结：

```bash
# 生成月度汇总
python3 summarize_reports.py --month 2026-07

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

## 🔄 与邮件草稿的关系

- **本地归档**：`weekly-reports/` 目录下的 Markdown 文件，用于长期保存和检索
- **邮件草稿**：通过 `send_weekly_report.py` 存入钉邮草稿箱，用于每周发送
- **两者互补**：本地归档便于检索汇总，邮件草稿用于正式汇报

## 📌 注意事项

1. 每周五生成周报时，**同时**执行：
   - 存入钉邮草稿箱（发送用）
   - 保存到 `weekly-reports/YYYY/YYYY-Www.md`（归档用）

2. 归档文件应包含完整的工作内容，不要删减

3. 存在问题部分如实记录，便于后续回顾

4. 年度目录按自然年划分，便于年度考核使用