openclaw-config/workspace-resume/weekly-reports/归档总结.md

📊 周报归档系统总结

✅ 已完成（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
      ✅ 邮件已存入草稿箱，请去钉钉邮箱确认发送

方式二：手动运行脚本

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"

月度/年度考核

月度汇总：

cd weekly-reports
python3 summarize_reports.py --month 2026-08
# 生成 summary_20260831_174000.md

年度汇总：

python3 summarize_reports.py --year 2026
# 生成 summary_20261231_174000.md

自定义范围：

python3 summarize_reports.py --range 2026-07-01 2026-09-30
# 生成 Q3 季度总结

---

📋 归档格式标准

文件命名

• 格式：YYYY-Www-周报.md
• 示例：2026-W35-周报.md

文件内容

# 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)*

---

📊 汇总报告示例

# 工作总结报告

**时间范围：** 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 文件，按周归档

可选迁移

如需统一格式，可运行：

cd weekly-reports
python3 migrate_legacy_reports.py --migrate

但非必需，因为：

1. 旧文件已是有效归档
2. 汇总工具可读取新格式文件
3. 旧文件可按需手动整理

---

💡 最佳实践

1. 每周固定流程

周五 17:00 → 生成周报 → 自动归档 → 存入草稿箱 → 确认发送

2. 月度考核准备

每月最后一天 → 运行汇总工具 → 生成月度报告 → 用于考核

3. 年度考核准备

每年年底 → 运行年度汇总 → 生成年度报告 → 用于考核

4. 快速检索

# 查找某项目的所有周报
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