RSS 资讯聚合与 AI 摘要展示项目。
frontend：Vue 3 + Vite，读取静态 JSON 或 Supabase 数据。backend：Python 抓取任务，读取 RSS、生成摘要，并写入 JSON 或 Supabase/Postgres。
需要 Node.js ^20.19.0 || >=22.12.0。
cd frontend
npm install需要 Python 3.11+。
cd backend
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txtWindows Git Bash 激活虚拟环境：
source .venv/Scripts/activate如果已安装 uv，后端脚本会优先使用 uv run。
本地默认使用静态 JSON 数据。创建 frontend/.env.local：
VITE_DATA_MODE=static
VITE_STATIC_NEWS_LIST_BASE_URL=/data/newscd frontend
npm run dev后端是离线抓取任务，不需要常驻 API 服务。创建 backend/.env：
DATABASE_URL=postgresql://postgres.<project-ref>:<password>@<region>.pooler.supabase.com:5432/postgres?sslmode=require
OPENAI_API_KEY=
OPENAI_BASE_URL=
OPENAI_MODEL=说明：
- 写入 Supabase/Postgres 时需要
DATABASE_URL。 - 生成 AI 摘要时需要
OPENAI_API_KEY。 - RSS 源配置在
backend/sources/*.yml。
前端通过 VITE_DATA_MODE 切换数据源：
| 模式 | 配置 | 数据来源 |
|---|---|---|
| 静态 JSON | VITE_DATA_MODE=static |
frontend/public/data/news/*.json |
| Supabase | VITE_DATA_MODE=supabase |
public.public_news_items |
Supabase 模式还需要：
VITE_SUPABASE_URL=https://<project-ref>.supabase.co
VITE_SUPABASE_PUBLISHABLE_KEY=<publishable-key>静态 JSON 文件：
| 文件 | 说明 |
|---|---|
all.json |
全量资讯 |
<category>.json |
分类资讯，例如 ai.json、community.json |
curated-today.json |
今日精选 |
抓取并写入 Supabase/Postgres：
cd backend
sh fetch_news_to_db.sh抓取并导出静态 JSON：
cd backend
sh fetch_news_to_json.sh常用参数：
sh fetch_news_to_db.sh 5
sh fetch_news_to_db.sh community.yml
sh fetch_news_to_db.sh 5 community.yml
sh fetch_news_to_json.sh 5
sh fetch_news_to_json.sh community.yml
sh fetch_news_to_json.sh 5 community.yml也可以直接运行 Python 入口：
python -m app.jobs.fetch_news_to_db --max-entries 5 community.yml
python -m app.jobs.fetch_news_to_json --max-entries 5 community.yml构建前按部署方式设置环境变量：
- 静态 JSON：
VITE_DATA_MODE=static - Supabase：
VITE_DATA_MODE=supabase，并配置VITE_SUPABASE_URL、VITE_SUPABASE_PUBLISHABLE_KEY
cd frontend
npm run build构建产物在 frontend/dist。
推荐用定时任务运行抓取脚本。仓库已有 GitHub Actions：
.github/workflows/corn.yml
需要配置 GitHub Secrets：
DATABASE_URL
OPENAI_API_KEY
OPENAI_BASE_URL
OPENAI_MODEL
工作流会执行数据库迁移并抓取数据：
python -m alembic upgrade head
python -m app.jobs.fetch_news_to_db --max-entries 20如果上线静态 JSON 链路，将定时任务改为：
python -m app.jobs.fetch_news_to_json --max-entries 20