auto: sync OpenClaw config 2026-08-27 11:17

2026-08-27 11:17:10 +08:00
parent 0269b99815
commit 7a5ca9f1a7
94 changed files with 4497 additions and 2088 deletions
@@ -0,0 +1,220 @@
+# 📋 周报持久化归档使用指南
+
+## ✅ 已实现功能
+
+### 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 月份的工作"
+- "查找关于库存的周报"
+- "生成年终总结"
+
+我会帮你处理！