用 AI 重新定义 RSS 阅读体验FeedMe

😋FeedMe

轻量、自由、为你定制

• 希望能够一站式了解各个信息源的新鲜事。又嫌市面上产品太”重”（不想注册登录/下载 APP/启动桌面软件…），一个静态页面正合适（响应式 / 亮暗主题，电脑手机都方便浏览）。
• 希望能够 TLDR 式地速览，于是做了 AI 摘要。
• 自由配置 RSS 源、AI 模型、更新频率。
• 开源、方便 Fork、零成本、轻松自部署。

本项目使用 GitHub Actions 自动部署到 GitHub Pages，使用工作流处理数据更新和网站部署。

1. Fork 或克隆仓库到你的 GitHub 账号
2. 设置 GitHub Secrets在项目顶端 Settings – 左侧 Secrets and variables -> Actions 中添加以下密钥（Secrets）：
- • LLM_API_KEY: 用于 AI 摘要生成的 API 密钥
- • LLM_API_BASE: LLM 服务的 API 基础 URL
- • LLM_NAME: 使用的模型名称
3. 启用 GitHub Pages在仓库设置中，选择从 GitHub Actions 部署
4. 手动触发工作流（可选）在 GitHub 仓库的 Actions 页面手动触发”更新数据并部署”工作流

更新数据并部署 (update-deploy.yml)：

• 自定义 RSS 源：
编辑 config/rss-config.js 文件以修改或添加 RSS 源。每个源需要包含：
- • 名称
- • URL
- • 分类
• 修改更新频率: 编辑 .github/workflows/update-deploy.yml 中的 cron 表达式
# 例如，改为每天凌晨更新一次 cron: '0 0 * * *'
• 调整保留条目数: 修改 config/rss-config.js 中的 maxItemsPerFeed 值
• 自定义域名配置:
请按照以下内容设置，避免出现页面资源加载异常：
- • 不使用自定义域名: 请删除目录下的 CNAME 文件
- • 使用自定义域名: 在仓库设置的 GitHub Pages 部分添加自定义域名，并修改 CNAME 文件内容为自定义域名
- • 多平台部署: 系统会自动处理不同平台（GitHub Pages/Vercel）的路径差异:
  - • GitHub Pages: 自动使用 /{仓库名} 为 basePath
  - • 自定义域名: 不会添加 basePath
  - • Vercel: 不会添加 basePath
• 自定义摘要生成：
如果需要自定义摘要生成方法，比如遵循特定格式或切换摘要语言，请修改 scripts\update-feeds.js 中的 prompt 变量

将你的 GitHub 仓库导入到 Vercel：

配置自动更新：

1. 完成 Vercel 部署后，获取以下信息:
- • VERCEL_TOKEN: 从 Vercel Tokens 创建
- • VERCEL_ORG_ID: 从账户设置 > 常规 > 页面底部获取
- • VERCEL_PROJECT_ID: 从 Vercel Dashboard > 你的项目 > 设置 > 常规 > 页面底部获取
2. 添加上述信息到仓库密钥（Secrets）（位置：Settings -> Secrets and variables -> Actions -> Secrets）
3. 添加仓库变量（Variables） ENABLE_VERCEL_DEPLOYMENT 并设为 true（位置：Settings -> Secrets and variables -> Actions -> Variables）

此方式使用 Docker 在本地或服务器上运行 FeedMe，并通过容器内的 Cron 任务自动更新数据和重建，不依赖 GitHub Actions。

1. 克隆仓库
git clone https://github.com/Seanium/feedme.git cd feedme
2. 配置环境变量
复制 .env.example 文件为 .env 并填入必要的 API 密钥：
cp .env.example .env
编辑 .env 文件：
LLM_API_KEY=你的_API_密钥 LLM_API_BASE=LLM服务的API基础URL LLM_NAME=使用的模型名称
3. 构建并启动 Docker 容器
docker-compose up --build
4. 访问应用
应用将在 http://localhost:3000 上可用。
5. 自动更新
容器将根据 config/crontab-docker 中的配置（默认为每 3 小时）自动执行 pnpm update-feeds 和 pnpm build，并重新启动服务。
如需修改更新频率，请编辑 config/crontab-docker 文件中的 cron 表达式（例如 0 */6 * * * 表示每 6 小时执行一次）。