FeedFlow — RSS 博客阅读器

一个全栈 RSS 阅读器，基于 Next.js 16 + React 19 + Tailwind 4 + Prisma 7 + PostgreSQL (Neon)，支持 GitHub 登录、订阅管理、文章流阅读、收藏与已读状态、定时抓取。

功能

• 🔐 GitHub OAuth 多用户登录（数据库会话）
• 📡 订阅任意 RSS/Atom 源，自动解析标题、站点图标
• 🧰 内置「官方博客源库」：30+ 主流框架/语言/平台博客，勾选一键批量订阅；定时任务还会自动发现并收录新源
• 📰 文章流：全部 / 未读 / 收藏 / 按源筛选
• ✨ 文章详情：消毒后的 HTML 正文直接渲染，阅读即标记，支持收藏；摘要太短可「加载全文」
• 🔄 手动刷新 + 定时抓取（Vercel Cron，每日一次）
• 🩺 订阅源健康校验：定时探测，连续失败自动标记「可能失效」
• 🔍 自动发现：定时抓取官网主页并用标准的 <link rel="alternate"> 探测出真实 RSS 端点，自动收录新源
• 🖥️ 响应式侧边栏布局

技术栈

层	技术
框架	Next.js 16 (App Router, Turbopack)
语言	TypeScript
样式	Tailwind CSS 4 + @tailwindcss/typography
ORM	Prisma 7 (driver adapter)
数据库	PostgreSQL (Neon / 任意 PG)
认证	NextAuth v4 + GitHub + Prisma adapter
RSS 解析	rss-parser + 代理感知的抓取层

快速开始

pnpm install
cp .env.example .env        # 填入真实值
pnpm db:push                # 建表
pnpm dev

打开 http://localhost:3000

环境变量

见 .env.example。生产环境（Vercel）需要配置：

• DATABASE_URL — PostgreSQL 连接串
• GITHUB_ID / GITHUB_SECRET — GitHub OAuth App
• NEXTAUTH_SECRET — 签名密钥
• NEXTAUTH_URL — 站点完整 URL
• CRON_SECRET（可选）— 保护定时抓取端点

数据库迁移

pnpm postinstall        # 生成 Prisma Client
pnpm db:push            # 开发：直接同步表结构
# 生产构建时会自动执行: prisma migrate deploy

部署

项目已连接 Vercel + GitHub，推送 main 分支即自动部署。

• 生产地址由 Vercel 分配（如 https://blog-reader-self.vercel.app）
• 构建脚本会在部署时自动执行 prisma migrate deploy
• 定时抓取：vercel.json 配置每天 02:30 触发 /api/cron/fetch（抓取文章 + 校验健康 + 自动发现）

官方博客源库

位于 src/lib/preset-feeds.ts，按「前端框架 / 后端与语言 / 数据库与基础设施 / 移动与浏览器 / 平台与工程博客」分类。 所有地址均已实测可用。运行时通过 ensurePresetSeeds() 幂等灌入 PresetFeed 表（在订阅源管理页首次打开、以及定时任务运行时各自动执行一次），无需手动种库。

健康校验与自动发现

定时任务 /api/cron/fetch（每日 02:30）在抓取文章之外，还执行：

1. 订阅源健康校验 — 抓取用户订阅源时累计 consecutiveFailures，连续失败达到 3 次即标记 isHealthy=false，管理页显示「可能失效」标记与最后一次错误。
2. 官方源库校验 — 逐个探测 PresetFeed，失效的源 isValid=false，在源库中置灰、暂不可订阅。
3. 自动发现新源 — 从 src/lib/discovery-candidates.ts 的站点种子池（存的是稳定的站点主页域名，而非脆弱的 RSS 路径）抓取主页，用标准 <link rel="alternate"> 提取真实 RSS 端点；无声明的站点退而探测常见路径兜底。经 parseFeed 真实解析通过的端点自动收录，标记为「新发现」，官方改版后也能自动跟随到新的 RSS 路径。

GitHub OAuth 回调地址

GitHub OAuth App 的 Authorization callback URL 只能填一个值（不支持同时填多个不同主机）。

• Homepage URL：https://blog-reader-self.vercel.app
• Authorization callback URL：https://blog-reader-self.vercel.app/api/auth/callback/github

本地开发时如需测试登录，临时把 Authorization callback URL 改为 http://localhost:3000/api/auth/callback/github 即可，测完恢复生产地址。