Weekly Report - 周报自动生成系统
自动化工作周报生成工具，支持从周报系统获取数据、AI 智能总结、生成 Word 文档。
快速开始
1. 环境准备
首次使用前，运行自动安装脚本配置环境：
Windows (PowerShell):
cd skills/weekly-report/scripts
./setup.ps1
macOS / Linux (Bash):
cd skills/weekly-report/scripts
chmod +x setup.sh
./setup.sh
安装脚本会自动检测并安装：
- Python 3.10+ (需要预先安装)
- uv 包管理器
- Python 依赖包
- Playwright Chromium 浏览器
<details> <summary>手动安装（可选）</summary>国内用户: 脚本会自动检测网络环境，在无法访问 Google 时使用国内镜像源加速下载。
如果不想使用自动脚本，可以手动安装：
# 安装 uv (Windows)
irm https://astral.sh/uv/install.ps1 | iex
# 安装 uv (macOS/Linux)
curl -LsSf https://astral.sh/uv/install.sh | sh
# 安装依赖
cd skills/weekly-report/scripts
uv sync
# 安装 Playwright Chromium
uv run playwright install chromium
uv run playwright install-deps chromium # Linux 需要
2. 配置环境变量
export WEEKLY_REPORT_USERNAME="your_username"
export WEEKLY_REPORT_PASSWORD="your_password"
export DEEPSEEK_API_KEY="your_api_key"
3. 生成周报
# 生成本周周报
uv run python generate.py --week today
# 生成上周周报
uv run python generate.py --week last
# 生成指定日期所在周的周报
uv run python generate.py --week 2026-03-07
命令说明
generate.py - 生成周报
主脚本，执行完整的周报生成流程。
python generate.py [OPTIONS]
选项：
--week, -w: 周日期，支持today（本周）、last（上周）、YYYY-MM-DD（指定日期）--team, -t: 团队名称，默认使用配置中的团队--output, -o: 输出文件名，不指定则自动生成--force-login, -f: 强制重新登录，不使用缓存的 token--headless: 无头模式运行浏览器--verbose, -v: 详细输出模式
输出格式（JSON）：
{
"success": true,
"output_file": "output/周报_科创研发组_2026-03-02-2026-03-08.docx",
"items_count": 25,
"filtered_count": 25,
"week_range": "2026.03.02-2026.03.08"
}
login.py - 登录管理
单独执行登录操作，用于获取和缓存认证 token。
python login.py [OPTIONS]
选项：
--force, -f: 强制重新登录--headless, -H: 无头模式
输出格式（JSON）：
{
"success": true,
"message": "Login successful, token cached"
}
工作分类说明
周报内容按以下分类整理：
| 分类 | 说明 |
|---|---|
| 人才转型 | AI培训、技能学习、人才培养 |
| 自主开发 | 自主开发的应用、工具、系统 |
| 科创支撑 | 专利申报、创新项目、科创制度 |
| AI架构及网运安全自智规划 | AI架构、监控智能化、态势感知 |
| 系统需求规划建设 | 系统需求分析、平台建设、系统规划 |
| 综合工作 | 日常运维、综合事务、其他 |
团队成员配置
可在 config/settings.yaml 或通过 --team-members 参数配置团队成员列表，只有列表中的成员周报会被包含在最终文档中。
示例用法
# 生成科创研发组本周周报
uv run python generate.py --team "科创研发组" --week today
# 强制重新登录后生成上周周报
uv run python generate.py --week last --force-login
# 无头模式生成周报（适用于 CI/CD）
uv run python generate.py --week today --headless
# 指定输出文件名
uv run python generate.py --week today --output "周报_2026年第10周.docx"