221 lines
4.6 KiB
Markdown
221 lines
4.6 KiB
Markdown
# 📋 周报持久化归档使用指南
|
||
|
||
## ✅ 已实现功能
|
||
|
||
### 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 月份的工作"
|
||
- "查找关于库存的周报"
|
||
- "生成年终总结"
|
||
|
||
我会帮你处理！
|