# 📊 周报归档系统总结

## ✅ 已完成（2026-08-27）

### 1. 自动归档功能
- ✅ `send_weekly_report.py` 脚本已升级
- ✅ 每次生成周报时**自动保存**到 `weekly-reports/YYYY/YYYY-Www-周报.md`
- ✅ 同时存入钉邮草稿箱（用于发送）

### 2. 汇总工具
- ✅ `summarize_reports.py` 支持按周/月/年/自定义范围汇总
- ✅ 用于月度考核、年度考核时快速提取工作内容
- ✅ 生成 Markdown 格式报告，包含项目汇总、问题汇总、原始记录

### 3. 文档
- ✅ `README.md` - 归档说明
- ✅ `使用指南.md` - 详细使用教程
- ✅ `MEMORY.md` - 已更新归档规则

### 4. 测试验证
- ✅ 测试归档功能正常（2026-W35 周报）
- ✅ 测试汇总工具正常

---

## 📁 文件结构

```
weekly-reports/
├── README.md                  # 归档说明
├── 使用指南.md                # 使用教程
├── 归档总结.md                # 本文件
├── send_weekly_report.py      # 周报发送脚本（含自动归档）
├── summarize_reports.py       # 汇总工具
├── migrate_legacy_reports.py  # 历史数据迁移工具（可选）
├── 2025-*/                    # 2025 年历史周报（旧格式 .txt）
├── 2026-*/                    # 2026 年历史周报（旧格式 .txt）
└── 2026/                      # 2026 年新格式周报（.md）
    ├── 2026-W29.md
    ├── 2026-W31-周报.md
    └── 2026-W35-周报.md       # 测试归档
```

---

## 🚀 使用流程

### 每周五生成周报

**方式一：通过对话（推荐）**
```
用户：生成本周周报
助手：好的，请告诉我本周的工作内容，或者我从你的日记中提取。
      ...
      ✅ 周报已归档到 weekly-reports/2026/2026-W35-周报.md
      ✅ 邮件已存入草稿箱，请去钉钉邮箱确认发送
```

**方式二：手动运行脚本**
```bash
cd /home/yangxuan/.openclaw/workspace-resume
python3 send_weekly_report.py \
  --project G5 \
  --plain "项目名称：维云智造 G5\n主要任务：...\n..." \
  --html "<p>...</p>" \
  --date-range "2026-08-25 ~ 2026-08-29"
```

### 月度/年度考核

**月度汇总：**
```bash
cd weekly-reports
python3 summarize_reports.py --month 2026-08
# 生成 summary_20260831_174000.md
```

**年度汇总：**
```bash
python3 summarize_reports.py --year 2026
# 生成 summary_20261231_174000.md
```

**自定义范围：**
```bash
python3 summarize_reports.py --range 2026-07-01 2026-09-30
# 生成 Q3 季度总结
```

---

## 📋 归档格式标准

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

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

**日期范围：** 2026-08-25 ~ 2026-08-29

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

## 本周工作内容

周一（2026-08-25）
 - 工作内容 1
 - 工作内容 2

周二（2026-08-26）
 - ...

...

## 存在问题
无

---
*归档时间：2026-08-27 09:42*
*原始邮件主题：G5 开发周报 (2026-08-25 ~ 2026-08-29)*
```

---

## 📊 汇总报告示例

```markdown
# 工作总结报告

**时间范围：** 2026-08-01 ~ 2026-08-31
**生成时间：** 2026-08-27 09:42
**包含周报数：** 4 周

## 📊 项目汇总

### 维云智造 G5
**参与周次：** 2026-W31, 2026-W32, 2026-W33, 2026-W34
**主要任务：**
- 2026-W31: 库存预警模块开发
- 2026-W32: 出入库流程优化
- 2026-W33: 生产领料功能测试
- 2026-W34: 版本发布支持

## ⚠️ 存在问题汇总

### 2026-W32
- 历史数据迁移存在兼容性问题

### 2026-W34
- 测试环境不稳定

## 📋 原始周报记录
...
```

---

## 🔄 历史数据处理

### 现状
- 2025-08 ~ 2026-05：旧格式 `.txt` 文件，按月目录存放
- 2026-07 起：新格式 `.md` 文件，按周归档

### 可选迁移
如需统一格式，可运行：
```bash
cd weekly-reports
python3 migrate_legacy_reports.py --migrate
```

但**非必需**，因为：
1. 旧文件已是有效归档
2. 汇总工具可读取新格式文件
3. 旧文件可按需手动整理

---

## 💡 最佳实践

### 1. 每周固定流程
```
周五 17:00 → 生成周报 → 自动归档 → 存入草稿箱 → 确认发送
```

### 2. 月度考核准备
```
每月最后一天 → 运行汇总工具 → 生成月度报告 → 用于考核
```

### 3. 年度考核准备
```
每年年底 → 运行年度汇总 → 生成年度报告 → 用于考核
```

### 4. 快速检索
```bash
# 查找某项目的所有周报
grep -r "G5" weekly-reports/ --include="*.md" -l

# 查找包含关键词的周报
grep -r "库存预警" weekly-reports/ --include="*.md" -A 5
```

---

## ❓ 常见问题

**Q: 归档文件在哪里？**  
A: `weekly-reports/YYYY/YYYY-Www-周报.md`

**Q: 如何查看某个月的所有工作？**  
A: `python3 summarize_reports.py --month 2026-07`

**Q: 历史周报（2025 年）有归档吗？**  
A: 有，在 `weekly-reports/2025-XX/` 各月目录中（.txt 格式）

**Q: 可以手动修改归档文件吗？**  
A: 可以，归档文件是普通 Markdown 文件，可随时编辑

**Q: 如果忘记归档怎么办？**  
A: 手动创建文件到对应目录，命名格式：`YYYY-Www-周报.md`

---

## 📞 需要帮助？

直接告诉我：
- "帮我生成本周周报"
- "汇总 7 月份的工作"
- "查找关于库存的周报"
- "生成年终总结"

我会帮你处理！

---

*最后更新：2026-08-27*