congsh
4286731348
- 添加 HTTP 代理支持（国内直连、外网走代理） - 外部 API 新增全文搜索、源健康度/错误筛选、未读筛选 - 修复 APScheduler 线程静默崩溃（_safe_fetch 异常保护） - 健康检查暴露调度器状态 - Dashboard 新增每日文章数柱状图（按 published_at） - 文章列表 API 补上 content 字段，日期筛选修复时间范围 - 修复外部 API 双重 external 前缀 - User-Agent 改为 Chrome 标识缓解 403 - 添加完整 API 接口文档 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
rssKeeper
RSS 抓取、管理与检索系统。支持 Docker 部署，包含 Web UI 和 REST API。
功能特性
- 📡 RSS 源管理 — 添加、编辑、删除 RSS 源，支持自动发现 feed URL
- 📄 文章管理 — 自动抓取、去重、分类，全文搜索
- 🩺 健康度监控 — 实时展示每个 RSS 源的成功率、最后更新、文章数量
- 🔍 全文检索 — 基于 SQLite FTS5 的全文搜索
- 🐳 Docker 部署 — 单容器部署，数据持久化
- 🔌 对外 API — RESTful API 供 AI 或外部系统调用
快速开始
Docker 部署（推荐）
# 克隆项目
git clone <repo-url>
cd rssKeeper
# 启动（服务运行在 7329 端口）
docker-compose up -d --build
# 访问 http://localhost:7329
开发模式
# 后端
cd backend
pip install -r requirements.txt
uvicorn main:app --reload --port 7329
# 前端（另开终端，运行在 7330 端口）
cd frontend
npm install
npm run dev
对外 API
获取最近文章（供 AI 分析）
# 获取最近 24 小时的文章
curl "http://localhost:7329/api/v1/external/recent?hours=24&limit=50"
# 指定 RSS 源
curl "http://localhost:7329/api/v1/external/recent?feed_id=1&hours=48"
# 指定分类
curl "http://localhost:7329/api/v1/external/recent?category=科技&hours=24"
获取源列表
curl "http://localhost:7329/api/v1/external/feeds"
按源获取文章
curl "http://localhost:7329/api/v1/external/feeds/1/articles?limit=100"
获取每日摘要
curl "http://localhost:7329/api/v1/external/summary?date=2024-06-01"
技术栈
- 后端: Python 3.12 + FastAPI + SQLAlchemy + APScheduler
- 数据库: SQLite（FTS5 全文搜索）
- 前端: Vue 3 + Element Plus + Vite
- 部署: Docker + docker-compose