4.6 KiB
4.6 KiB
📋 周报持久化归档使用指南
✅ 已实现功能
1. 自动归档
每周五生成周报时，脚本会自动执行两步操作：
- ✅ 存入钉邮草稿箱（用于发送）
- ✅ 保存到
weekly-reports/YYYY/YYYY-Www-周报.md（用于归档）
2. 汇总工具
支持按周/月/年/自定义范围汇总工作内容，用于月度、年度考核。
🚀 使用方法
方式一：使用周报技能（推荐）
当你需要生成周报时，只需告诉我：
"生成本周周报" 或 "写周报"
我会：
- 询问你本周的工作内容（或从日记中提取）
- 按标准格式生成周报
- 自动归档到
weekly-reports/目录 - 存入钉邮草稿箱
- 通知你去钉钉邮箱确认发送
方式二：手动运行脚本
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 ...
方式三：查看历史周报
# 查看某年所有周报
ls weekly-reports/2026/
# 查看特定周报内容
cat weekly-reports/2026/2026-W31-周报.md
# 搜索包含关键词的周报
grep -r "库存预警" weekly-reports/
📊 汇总工具使用
按月汇总（月度考核）
cd weekly-reports
python3 summarize_reports.py --month 2026-07
生成文件：summary_20260731_174000.md
按年汇总（年度考核）
python3 summarize_reports.py --year 2026
按周查看
python3 summarize_reports.py --week 2026-W31
自定义日期范围
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 # 生成的汇总报告
└── ...
🔍 汇总报告示例
运行汇总工具后，会生成类似以下的报告：
# 工作总结报告
**时间范围：** 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. 月度考核准备
# 每月最后一天运行
python3 summarize_reports.py --month 2026-XX
3. 年度考核准备
# 每年年底运行
python3 summarize_reports.py --year 2026
4. 快速检索
# 查找某个项目的所有周报
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 月份的工作"
- "查找关于库存的周报"
- "生成年终总结"
我会帮你处理！