# 📋 周报持久化归档使用指南

## ✅ 已实现功能

### 1. 自动归档
每周五生成周报时，脚本会**自动**执行两步操作：
- ✅ 存入钉邮草稿箱（用于发送）
- ✅ 保存到 `weekly-reports/YYYY/YYYY-Www-周报.md`（用于归档）

### 2. 汇总工具
支持按周/月/年/自定义范围汇总工作内容，用于月度、年度考核。

---

## 🚀 使用方法

### 方式一：使用周报技能（推荐）

当你需要生成周报时，只需告诉我：

> "生成本周周报" 或 "写周报"

我会：
1. 询问你本周的工作内容（或从日记中提取）
2. 按标准格式生成周报
3. **自动归档**到 `weekly-reports/` 目录
4. 存入钉邮草稿箱
5. 通知你去钉钉邮箱确认发送

### 方式二：手动运行脚本

```bash
cd /home/yangxuan/.openclaw/workspace-resume

# 生成并发送周报（自动归档）
python3 send_weekly_report.py \
  --project G5 \
  --plain "项目名称： 维云智造 G5
主要任务： 本周主要任务

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

存在问题
无" \
  --html "<p>HTML 版本正文</p>" \
  --date-range "2026-08-25 ~ 2026-08-29"

# 如果只想发送邮件，不归档（不推荐）
python3 send_weekly_report.py --no-archive ...
```

### 方式三：查看历史周报

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

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

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

---

## 📊 汇总工具使用

### 按月汇总（月度考核）

```bash
cd weekly-reports
python3 summarize_reports.py --month 2026-07
```

生成文件：`summary_20260731_174000.md`

### 按年汇总（年度考核）

```bash
python3 summarize_reports.py --year 2026
```

### 按周查看

```bash
python3 summarize_reports.py --week 2026-W31
```

### 自定义日期范围

```bash
python3 summarize_reports.py --range 2026-07-01 2026-09-30
```

---

## 📁 文件结构

```
weekly-reports/
├── README.md                  # 归档说明文档
├── 使用指南.md                # 本文件
├── summarize_reports.py       # 汇总工具脚本
├── 2025/                      # 2025 年周报
│   ├── 2025-08/
│   ├── 2025-09/
│   └── ...
├── 2026/                      # 2026 年周报
│   ├── 2026-W29.md
│   ├── 2026-W31-周报.md
│   ├── 2026-W35-周报.md      # 最新归档
│   └── summary_*.md          # 生成的汇总报告
└── ...
```

---

## 🔍 汇总报告示例

运行汇总工具后，会生成类似以下的报告：

```markdown
# 工作总结报告

**时间范围：** 2026-07-01 ~ 2026-07-31
**生成时间：** 2026-07-31 17:40
**包含周报数：** 4 周

## 📊 项目汇总

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

## ⚠️ 存在问题汇总

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

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

## 📋 原始周报记录

### 2026-W27 (2026-07-01 ~ 2026-07-05)
文件：weekly-reports/2026/2026-W27-周报.md
...
```

---

## 💡 最佳实践

### 1. 每周五固定流程
```
1. 收集本周工作内容（从日记或记忆）
2. 生成周报（通过对话或脚本）
3. 自动归档 + 存入草稿箱
4. 去钉钉邮箱确认发送
```

### 2. 月度考核准备
```bash
# 每月最后一天运行
python3 summarize_reports.py --month 2026-XX
```

### 3. 年度考核准备
```bash
# 每年年底运行
python3 summarize_reports.py --year 2026
```

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

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

---

## ❓ 常见问题

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

### Q: 如何查看某个月的所有工作？
A: 使用汇总工具：`python3 summarize_reports.py --month 2026-07`

### Q: 历史周报（2025 年）有归档吗？
A: 有，已整理到 `weekly-reports/2025-XX/` 各月目录中

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

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

---

## 📞 需要帮助？

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

我会帮你处理！