congsh 68bba3d9e0 feat: 深色主题UI、错误分类、批量抓取、健康度筛选
- 修复 datetime 时区不一致导致所有API 500错误的问题
- Feeds/Dashboard 页面改为深色表格主题,高对比度文字
- 添加错误类型自动分类(URL失效/被拒绝/超时/DNS失败/SSL错误等12种)
- 新增"下次抓取时间"列,从APScheduler获取
- 新增健康度筛选下拉,修复分页后过滤失效的bug
- "全部抓取"改为同步并发执行,基于当前筛选条件获取所有匹配源
- 新增数据库自动迁移机制,处理增量列变更

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-06-11 17:44:54 +08:00
2026-06-11 14:31:29 +08:00

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
  • 数据库: SQLiteFTS5 全文搜索)
  • 前端: Vue 3 + Element Plus + Vite
  • 部署: Docker + docker-compose
S
Description
No description provided
Readme 145 KiB
Languages
Python 52.4%
Vue 42.8%
JavaScript 3.5%
Dockerfile 1%
HTML 0.3%