周报自动化采集

使用 Playwright 自动采集 FineBI 和 Grafana 数据，按模板生成周报 Markdown。

通过 npx 使用

无需克隆仓库，直接运行：

npx oe-weekly

指定日期范围：

npx oe-weekly --start=2026-04-24 --end=2026-04-30

首次运行时，如果未检测到 Chrome 或 Playwright Chromium，会提示是否自动安装。

环境要求

• Node.js 18+
• macOS
• 可访问 FineBI 和 Grafana

安装

npm install
cp .env.example .env

.env 里主要用到这些配置：

• REPORT_USERNAME：填写自己finebi 账号
• REPORT_PASSWORD：填写自己finebi 密码
• HEADLESS
• GRAFANA_SESSION：可不填

首次使用

FineBI 和 Grafana 至少要完成一次登录态准备。

• FineBI：设置 REPORT_USERNAME和REPORT_PASSWORD即可自动登录，也可以运行时传入 --finebi-username=账号 --finebi-password=密码；未传账号密码时，可在自动打开的浏览器里手动登录。
• Grafana： 可以设置 GRAFANA_SESSION，或首次运行时在自动打开的浏览器里完成谷歌登录（登录态会写入 .auth/grafana.json），后续无需登录

使用方式

不传日期时，默认采集本周范围。

npm run report

运行时会打印本次采集日期范围，例如：

本次采集日期范围：2026-03-28～2026-04-03

也可以显式指定区间：

npm run report -- --start=2026-03-28 --end=2026-04-03

通过 npx 传入 FineBI 账号密码：

npx oe-weekly --finebi-username=your_name --finebi-password=your_password

参数规则：

• --start 和 --end 必须同时传入
• 格式固定为 YYYY-MM-DD
• start 不能晚于 end

输出结果

每次执行后会生成这些内容：

• 结构化结果： dist/weekly-report-result-<日期范围>.json
• 周报 Markdown： dist/开放生态研发周会-<日期范围>.md
• 所有截图： dist/screenshots/

成功执行时不会生成中间日志文件。失败执行时会生成一个排查日志文件：

• logs/failed-<时间戳>.json

当前已接入的截图服务

• constrictor
• hawk
• oauth2
• puffer
• cobra
• vicuna
• webhook