107 lines
2.2 KiB
Markdown
107 lines
2.2 KiB
Markdown
# 周报归档说明
|
||
|
||
## 📁 目录结构
|
||
|
||
```
|
||
weekly-reports/
|
||
├── 2025/
|
||
│ ├── 2025-W32.md # 2025 年第 32 周周报
|
||
│ └── ...
|
||
├── 2026/
|
||
│ ├── 2026-W29.md # 2026 年第 29 周周报
|
||
│ ├── 2026-W31-周报.md
|
||
│ └── ...
|
||
└── README.md # 本文件
|
||
```
|
||
|
||
## 📝 归档规则
|
||
|
||
### 文件命名
|
||
- 格式：`YYYY-Www.md` 或 `YYYY-Www-周报.md`
|
||
- 示例：`2026-W31.md`、`2026-W31-周报.md`
|
||
|
||
### 文件内容结构
|
||
```markdown
|
||
# G5 开发周报 (2026-W31)
|
||
|
||
**日期范围：** 2026-07-27 ~ 2026-07-31
|
||
|
||
## 基本信息
|
||
- **项目：** 维云智造 G5
|
||
- **主要任务：** <本周主要任务>
|
||
|
||
## 本周工作内容
|
||
|
||
### 周一（2026-07-27）
|
||
- xxx
|
||
- xxx
|
||
|
||
### 周二（2026-07-28）
|
||
- xxx
|
||
|
||
### 周三（2026-07-29）
|
||
- xxx
|
||
|
||
### 周四（2026-07-30）
|
||
- xxx
|
||
|
||
### 周五（2026-07-31）
|
||
- xxx
|
||
|
||
## 存在问题
|
||
无
|
||
|
||
---
|
||
*归档时间：2026-07-31*
|
||
```
|
||
|
||
## 🔍 快速检索
|
||
|
||
### 按月份查看
|
||
```bash
|
||
# 查看某年所有周报
|
||
ls weekly-reports/2026/
|
||
|
||
# 查看某月周报（通过 grep 过滤日期）
|
||
grep -l "2026-07" weekly-reports/2026/*.md
|
||
```
|
||
|
||
### 按关键词搜索
|
||
```bash
|
||
# 搜索包含特定关键词的周报
|
||
grep -r "库存预警" weekly-reports/
|
||
|
||
# 搜索某时间段的所有周报
|
||
grep -l "2026-0[1-3]" weekly-reports/2026/*.md
|
||
```
|
||
|
||
## 📊 月度/年度汇总
|
||
|
||
使用汇总脚本生成指定时间范围的工作总结：
|
||
|
||
```bash
|
||
# 生成月度汇总
|
||
python3 summarize_reports.py --month 2026-07
|
||
|
||
# 生成年度汇总
|
||
python3 summarize_reports.py --year 2026
|
||
```
|
||
|
||
## 🔄 与邮件草稿的关系
|
||
|
||
- **本地归档**：`weekly-reports/` 目录下的 Markdown 文件，用于长期保存和检索
|
||
- **邮件草稿**：通过 `send_weekly_report.py` 存入钉邮草稿箱，用于每周发送
|
||
- **两者互补**：本地归档便于检索汇总，邮件草稿用于正式汇报
|
||
|
||
## 📌 注意事项
|
||
|
||
1. 每周五生成周报时，**同时**执行：
|
||
- 存入钉邮草稿箱（发送用）
|
||
- 保存到 `weekly-reports/YYYY/YYYY-Www.md`（归档用）
|
||
|
||
2. 归档文件应包含完整的工作内容，不要删减
|
||
|
||
3. 存在问题部分如实记录，便于后续回顾
|
||
|
||
4. 年度目录按自然年划分，便于年度考核使用
|