Weekly Report - 自动整理周报

---

name: weekly-report

description: 自动整理周报工具。支持从多个数据源（GitHub、飞书文档、日历）汇总工作内容，生成Markdown周报。支持保存历史、AI摘要、导出PDF/HTML、发送邮件、写入飞书文档。适用于需要定期总结工作成果的用户。

---

# Weekly Report - 自动整理周报

功能概述

自动从多个数据源汇总一周工作内容，生成结构化的Markdown周报，支持多种输出方式。

支持的数据源

1. GitHub / GitLab

2. 飞书文档/知识库

3. 日历事件

4. 手动输入

输出功能

1. Markdown周报

生成标准格式周报，包含：

2. 历史保存

3. 导出功能

4. 邮件发送

5. 飞书文档

使用方式

手动触发

用户说"生成周报"、"整理本周工作"时执行。

定时执行

配置cron任务，每周五下午自动执行。

脚本列表

| 脚本 | 功能 |

|------|------|

| `generate_report.py` | 生成Markdown周报 |

| `github_fetcher.py` | 获取GitHub数据 |

| `feishu_fetcher.py` | 获取飞书文档 |

| `calendar_fetcher.py` | 获取日历事件 |

| `feishu_writer.py` | 写入飞书文档 |

| `email_sender.py` | 发送邮件 |

| `export_pdf.py` | 导出PDF/HTML |

| `history_manager.py` | 历史周报管理 |

配置项

| 配置项 | 说明 | 必填 |

|--------|------|------|

| github_token | GitHub访问Token | 否 |

| github_repos | 监控的仓库列表 | 否 |

| feishu_token | 飞书Access Token | 否 |

| feishu_docs | 监控的文档/知识库 | 否 |

| smtp_host | SMTP服务器 | 否 |

| smtp_port | SMTP端口 | 否 |

| smtp_username | 邮箱账号 | 否 |

| smtp_password | 邮箱授权码 | 否 |

| user_name | 用户姓名 | 否 |

示例命令

# 生成周报
python3 generate_report.py --user "张三" --github data.json --manual "本周工作..."

# 获取GitHub数据
python3 github_fetcher.py --token $GITHUB_TOKEN --repos "user/repo" --since "2026-03-16" --until "2026-03-22"

# 发送邮件
python3 email_sender.py --smtp-host smtp.qq.com --smtp-port 465 --username "user@qq.com" --password "xxx" --to "boss@company.com" --subject "第12周周报" --content "$MARKDOWN" --html

# 写入飞书
python3 feishu_writer.py --token $FEISHU_TOKEN --title "第12周周报" --content "$MARKDOWN"

# 导出PDF
python3 export_pdf.py --input report.md --output report.pdf --format pdf

# 保存历史
python3 history_manager.py --action save --week-start "2026-03-16" --week-end "2026-03-22" --content "$MARKDOWN"

# 查看历史
python3 history_manager.py --action list --limit 5