纯小白,只懂简单 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;
/* 其他颜色变量... */
}