Weekly Report - 周报自动生成系统

自动化工作周报生成工具，支持从周报系统获取数据、AI 智能总结、生成 Word 文档。

快速开始

1. 环境准备

首次使用前，运行自动安装脚本配置环境：

Windows (PowerShell):
powershell
cd skills/weekly-report/scripts
./setup.ps1

macOS / Linux (Bash):
bash
cd skills/weekly-report/scripts
chmod +x setup.sh
./setup.sh

安装脚本会自动检测并安装：

• - Python 3.10+ (需要预先安装)
• uv 包管理器
• Python 依赖包
• Playwright Chromium 浏览器

国内用户: 脚本会自动检测网络环境，在无法访问 Google 时使用国内镜像源加速下载。

手动安装（可选）

如果不想使用自动脚本，可以手动安装：

bash

安装 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. 配置环境变量

bash
export WEEKLYREPORTUSERNAME=your_username
export WEEKLYREPORTPASSWORD=your_password
export DEEPSEEKAPIKEY=yourapikey

3. 生成周报

bash

生成本周周报

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 - 生成周报

主脚本，执行完整的周报生成流程。

bash
python generate.py [OPTIONS]

选项：

• - --week, -w: 周日期，支持 today（本周）、last（上周）、YYYY-MM-DD（指定日期）
• --team, -t: 团队名称，默认使用配置中的团队
• --output, -o: 输出文件名，不指定则自动生成
• --force-login, -f: 强制重新登录，不使用缓存的 token
• --headless: 无头模式运行浏览器
• --verbose, -v: 详细输出模式

输出格式（JSON）：
json
{
success: true,
outputfile: 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。

bash
python login.py [OPTIONS]

选项：

• - --force, -f: 强制重新登录
• --headless, -H: 无头模式

输出格式（JSON）：
json
{
success: true,
message: Login successful, token cached
}

工作分类说明

周报内容按以下分类整理：

分类	说明
人才转型	AI培训、技能学习、人才培养
自主开发

自主开发的应用、工具、系统 |
| 科创支撑 | 专利申报、创新项目、科创制度 |
| AI架构及网运安全自智规划 | AI架构、监控智能化、态势感知 |
| 系统需求规划建设 | 系统需求分析、平台建设、系统规划 |
| 综合工作 | 日常运维、综合事务、其他 |

团队成员配置

可在 config/settings.yaml 或通过 --team-members 参数配置团队成员列表，只有列表中的成员周报会被包含在最终文档中。

示例用法

bash

生成科创研发组本周周报

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

详细文档

• - 配置说明
• 工作流程