纯小白,只懂简单 py 语法,之前一直想要一个 RSS 阅读器,自从 TG 被封之后没找到喜欢的,于是用 cursor 写了一个,一早上就写出来了,仿照 hacknewser 的方式,评论放在 issues ,其余纯 html/css/js ,喜欢无后端的东西(自己菜)
在线体验: https://yuanj.top/RSS/
GitHub 地址: https://github.com/imjiaoyuan/RSS
功能特点
-
每 6 小时自动更新 RSS 源
-
使用 GitHub Issues 作为评论系统
-
支持文章收藏功能
-
自动适配深色/浅色模式
-
响应式设计,支持移动端
-
按时间分类展示文章
-
支持自定义 RSS 源
技术栈
-
Python (feedparser) - RSS 解析
-
GitHub Actions - 自动化部署
-
GitHub Pages - 静态页面托管
-
GitHub Issues - 评论系统
-
HTML/CSS/Javascript - 前端展示
快速开始
-
Fork 本仓库
-
修改配置
编辑 index.html 中的 GITHUB_REPO 变量为你的仓库名:
const GITHUB_REPO = '你的用户名/仓库名'; - 添加 RSS 源
编辑 feed.list 文件,每行一个 RSS 源地址。
- 本地测试
# 安装依赖 pip install -r requirements.txt # 抓取 RSS 源 python fetch_feeds.py # 启动本地服务器 python -m http.server 8000 - 启用 GitHub Pages
在仓库设置中启用 GitHub Pages ,选择 main 分支作为源。
自动更新
项目通过 GitHub Actions 实现自动更新:
-
每 6 小时自动运行一次
-
可以在 Actions 页面手动触发更新
-
更新后自动提交变更到仓库
自定义主题
编辑 static/style.css 文件中的 CSS 变量来自定义主题颜色:
:root { --primary-color: #2c3e50; --bg-color: #f8f9fa; /* 其他颜色变量... */ } 