Global Macro Morning Brief

一个每天早上自动更新的全球宏观与跨资产市场晨报系统。

项目会采集公开 RSS、主要市场行情、加密资产、港股、A 股指数、FRED、SEC 披露和用户自有研报文件，生成结构化数据、Markdown/HTML 报告、图表，并自动导出 GitHub Pages 可直接打开的 public/index.html。

Not financial advice / 非投资建议。
本项目仅用于个人学习、研究和信息整理，不提供投资建议，不做自动交易，不绕过任何付费墙。

GitHub Pages 设置

在 GitHub 仓库中进入：

Settings -> Pages

选择：

Source: Deploy from a branch
Branch: main
Folder: /public

保存后，GitHub Pages 会把 public/index.html 作为站点首页。项目每日自动运行后，public/index.html 会被更新并提交，Pages 首页也会跟着更新。

Pages 链接：

https://georgeorange-crypto.github.io/FinTech/

自动运行

工作流文件：

.github/workflows/daily-brief.yml

触发方式：

每天 Asia/Taipei 06:00 自动运行
支持 workflow_dispatch 手动运行
推送核心代码或配置时自动运行

GitHub Actions 的 cron 使用 UTC，因此配置为：

cron: "0 22 * * *"

这等价于 Asia/Taipei 每天 06:00。

功能概览

公开 RSS 新闻采集、去重、关键词过滤
新闻事件分类：宏观数据、央行决策、央行讲话、财政政策、监管、地缘风险、财报、商品供给、加密市场结构、金融稳定、研究论文、普通公告等
新闻重要性分桶：Tier 1 / Tier 2 / Tier 3
Top 10 新闻限制低价值背景材料数量，避免普通研究论文挤占头条
为每条重要新闻生成自然语言“为什么重要”
为新闻生成逐资产影响解释：资产、资产类别、方向、强度、原因
采集 Yahoo Finance、CoinGecko、AKShare、FRED、SEC 数据
计算 1D、5D、1M、YTD、20D 波动率、MA20、MA60、RSI14 和趋势标签
识别跨资产市场状态：risk_on、risk_off、rates_shock、inflation_shock、dollar_liquidity_tightening、crypto_specific、mixed、unknown
生成 PNG 图表和资产组 summary chart
生成结构化事件数据库和历史 JSONL
导出 GitHub Pages 可用静态站点

目录结构

config/                  配置文件
src/                     核心代码
  collectors/            数据采集
  analyzers/             新闻、资产影响、市场状态分析
  charts/                图表生成
  reports/               Markdown/HTML/Public 首页生成
  models/                Pydantic 数据结构
  utils/                 工具函数
reports/                 每日 Markdown 和 HTML 报告
charts/                  每日图表
data/processed/          每日结构化数据
data/history/            事件和行情历史 JSONL
public/                  GitHub Pages 静态站点输出
tests/                   pytest 测试

配置文件

核心配置都在 config/：

assets.yml：资产分组
rss_feeds.yml：公开 RSS 源
macro_series.yml：FRED 宏观序列
watchlist_cik.yml：SEC watchlist
importance_rules.yml：事件分类、tier、routine 规则
asset_impact_rules.yml：资产影响方向、强度和原因
report_profile.yml：晨报偏好

示例 report_profile.yml：

language: zh
top_news_limit: 10
include_background_materials: true
max_tier3_in_top_news: 2
focus_regions:
  - US
  - China
  - Hong Kong
  - EU
  - Japan
focus_assets:
  - SPY
  - QQQ
  - TLT
  - DXY
  - GC=F
  - CL=F
  - BTC
  - ETH
  - ^HSI
  - 沪深300

本地运行

python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
python -m src.main --date today --no-llm

常用命令：

python -m src.main --date today
python -m src.main --date 2026-05-22
python -m src.main --no-llm
python -m src.main --only-market
python -m src.main --only-news
python -m src.main --build-index

today 默认使用 Asia/Taipei 日期，避免 GitHub runner 的 UTC 日期导致晨报日期偏差。

Secrets

在 Settings -> Secrets and variables -> Actions 中按需配置：

FRED_API_KEY
COINGECKO_API_KEY
TUSHARE_TOKEN
LLM_PROVIDER
LLM_API_KEY
SEC_USER_AGENT

没有这些 key 时，相关模块会跳过或降级，不会中断主流程。

数据合规

不绕过 WSJ、Bloomberg、FT、Reuters 等付费墙
对付费媒体只使用公开 RSS 标题、摘要、链接和发布时间
不复制长篇原文
用户自有研报可放入 inputs/reports/
所有输出必须标注 Not financial advice / 非投资建议
本项目不做自动交易

开发检查

pytest
ruff check .
python -m src.main --date today --no-llm
python -m src.main --build-index

外部数据源失败会写入：

data/processed/YYYY-MM-DD/warnings.json

不会导致整个晨报失败。

Roadmap

RAG research archive
event-to-market reaction database
economic calendar integration
earnings calendar
interactive dashboard
bilingual report