中文文档 | English Documentation

😋FeedMe

用 AI 重新定义你的 RSS 阅读体验，轻松部署到 GitHub Pages / Docker

---

🍱 轻量、智能、为你定制

• 🪶 告别臃肿：拒绝强制登录与 App 下载，一个响应式静态页面解决信息流阅读需求

• 🤖 效率至上：AI 自动生成文章摘要，把握重点

• ⚙️ 为你定制：无论是订阅源还是 AI 配置，一切设置权归你所有

• 🚀 自由部署：零成本部署至 GitHub Pages 或 Docker

✨ 功能

• 聚合摘要：一站式整合多源 RSS，通过 LLM 自动生成摘要

• 自动更新：GitHub Actions / Cron 定时保持内容鲜活

• 灵活部署：GitHub Pages 零成本静态托管 / Docker 私有化部署

• 现代体验：响应式设计，明暗主题

---

---

🚀 部署

方式一：GitHub Pages 部署

本项目使用 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)：

• 触发条件：
  • 定时执行（每 3 小时一次）
  • 推送代码
  • 手动触发
• 执行内容：
  • 单次构建流程：一次性获取 RSS 内容、生成摘要并构建静态网站
  • 多平台部署：
    • 自动部署到 GitHub Pages
    • 将构建产物推送到 deploy 分支，供 Vercel 等平台监控部署

自定义部署配置

• 自定义 RSS 源： 编辑 src/config/rss-config.js 文件以修改或添加 RSS 源。每个源需要包含：

  • 名称
  • URL
  • 分类

• 修改更新频率: 编辑 .github/workflows/update-deploy.yml 中的 cron 表达式

  # 例如，改为每天凌晨更新一次
  cron: '0 0 * * *'
  

• 调整保留条目数: 修改 src/config/rss-config.js 中的 maxItemsPerFeed 值

• 自定义摘要生成： 如果需要自定义摘要生成方法，比如遵循特定格式或切换摘要语言，请修改 scripts/update-feeds.js 中的 prompt 变量

方式二：Vercel 部署

1. 前往 Vercel 导入页面，选择 "GitHub" 并授权访问
2. 选择你 fork 的 FeedMe 仓库，点击 "Deploy"，这时部署失败是正常的，因为默认部署分支为 main
3. 参考 Deploying Git Repositories with Vercel 将生产分支改为 deploy，设置仅构建生产分支，并重新部署

GitHub Actions 每次构建后会自动推送到 deploy 分支，Vercel 会自动检测并部署。

方式三：阿里云 ESA Pages 部署

1. 前往 阿里云 ESA 控制台，进入 Pages 服务
2. 点击"新建应用"，选择 "GitHub" 并授权访问
3. 选择你 fork 的 FeedMe 仓库，配置如下：
   • 生产分支：deploy
   • 静态资源目录：.（一个英文句号）
   • 安装命令：留空
   • 构建命令：留空
4. 点击"部署"即可

GitHub Actions 每次构建后会自动推送到 deploy 分支，阿里云 ESA Pages 会自动检测并部署。得益于阿里云 ESA 的边缘加速能力，应用在全球范围内均可获得极速访问体验。

方式四：Docker 本地部署

此方式使用 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=使用的模型名称
   

   这些环境变量用于配置文章摘要生成功能，需要从 LLM 服务提供商获取

3. 构建并启动 Docker 容器

   docker-compose up --build
   

4. 访问应用 应用将在 http://localhost:3000 上可用。

5. 自动更新 容器将根据 src/config/crontab-docker 中的配置（默认为每 3 小时）自动执行 pnpm update-feeds 和 pnpm build，并重新启动服务。 如需修改更新频率，请编辑 src/config/crontab-docker 文件中的 cron 表达式（例如 0 */6 * * * 表示每 6 小时执行一次）。

💻 开发

1. 克lon仓库

   git clone https://github.com/Seanium/feedme.git
   cd feedme
   

2. 安装依赖

   pnpm install
   

3. 配置环境变量

   复制环境变量示例文件并编辑：

   cp .env.example .env
   

   填入以下内容：

   LLM_API_KEY=你的 API 密钥
   LLM_API_BASE=LLM服务的 API 基础 URL（例如：https://api.siliconflow.cn/v1）
   LLM_NAME=使用的模型名称（例如：THUDM/GLM-4-9B-0414）
   

   这些环境变量用于配置文章摘要生成功能，需要从 LLM 服务提供商获取

4. 更新 RSS 数据

   pnpm update-feeds
   

   此命令会抓取 RSS 源并生成摘要，保存到 public/data 目录

5. 启动开发服务器

   pnpm dev
   

   访问 http://localhost:3000 查看应用

Star 趋势

FeedMe 快速上手指南

FeedMe 是一个轻量、智能的 AI RSS 阅读器，支持通过 LLM 自动生成文章摘要。本项目支持零成本部署至 GitHub Pages、Vercel、阿里云 ESA，也可通过 Docker 私有化部署。

环境准备

在开始之前，请确保你的环境满足以下要求：

• 操作系统：Linux / macOS / Windows
• Node.js：建议版本 v18+ (推荐使用 fnm 或 nvm 管理)
• 包管理器：pnpm (推荐) 或 npm/yarn
• LLM API：需准备一个大语言模型服务的 API 密钥（如 SiliconFlow, OpenAI 等）
  • LLM_API_KEY: API 密钥
  • LLM_API_BASE: API 基础 URL (例如：https://api.siliconflow.cn/v1)
  • LLM_NAME: 模型名称 (例如：THUDM/GLM-4-9B-0414)
• 可选依赖：
  • Docker & Docker Compose：若选择本地容器化部署
  • Git：用于克隆代码仓库

安装步骤

你可以根据需求选择 本地开发/运行 或 云端自动部署。

方式一：本地运行 (Docker 推荐)

适合希望私有化部署、不依赖 GitHub Actions 的用户。

1. 克隆仓库

   git clone https://github.com/Seanium/feedme.git
   cd feedme
   

2. 配置环境变量 复制示例文件并填入你的 LLM 配置：

   cp .env.example .env
   

   编辑 .env 文件：

   LLM_API_KEY=你的_API_密钥
   LLM_API_BASE=LLM 服务的 API 基础 URL
   LLM_NAME=使用的模型名称
   

3. 启动服务 使用 Docker Compose 构建并启动容器（内置定时任务自动更新数据）：

   docker-compose up --build
   

4. 访问应用 打开浏览器访问 http://localhost:3000。

---

方式二：本地开发模式

适合开发者进行二次开发或调试。

1. 克隆与安装依赖

   git clone https://github.com/Seanium/feedme.git
   cd feedme
   pnpm install
   

2. 配置环境变量

   cp .env.example .env
   

   编辑 .env 填入 LLM_API_KEY, LLM_API_BASE, LLM_NAME。

3. 获取初始数据 手动执行一次数据抓取和摘要生成：

   pnpm update-feeds
   

4. 启动开发服务器

   pnpm dev
   

   访问 http://localhost:3000 预览。

---

方式三：GitHub Pages 自动部署 (零成本托管)

适合希望全自动运行、无需维护服务器的用户。

1. Fork 仓库 将本仓库 Fork 到你的 GitHub 账号下。

2. 配置 Secrets 进入仓库 Settings -> Secrets and variables -> Actions，添加以下密钥：

   • LLM_API_KEY: 你的 API 密钥
   • LLM_API_BASE: API 基础 URL
   • LLM_NAME: 模型名称

3. 启用 Pages 进入仓库 Settings -> Pages，Build and deployment 来源选择 GitHub Actions。

4. 触发部署 进入 Actions 标签页，手动运行 更新数据并部署 工作流。完成后，你的站点将通过 https://<用户名>.github.io/<仓库名> 访问。 注：默认每 3 小时自动更新一次，可在 .github/workflows/update-deploy.yml 中修改 cron 表达式。

基本使用

部署完成后，你可以通过以下方式定制你的阅读体验：

1. 自定义订阅源 编辑 src/config/rss-config.js 文件，添加或修改 RSS 源配置：

   export const rssConfig = [
     {
       name: "示例博客",
       url: "https://example.com/feed.xml",
       category: "技术"
     },
     // 添加更多源...
   ];
   

   修改后需重新运行 pnpm update-feeds (本地) 或等待 GitHub Actions 自动触发。

2. 调整更新频率

   • GitHub Actions: 编辑 .github/workflows/update-deploy.yml 中的 cron 字段。
   • Docker: 编辑 src/config/crontab-docker 文件中的 cron 表达式。

3. 自定义摘要提示词 若需改变 AI 生成摘要的风格或语言，编辑 scripts/update-feeds.js 中的 prompt 变量。

4. 限制条目数量 在 src/config/rss-config.js 中修改 maxItemsPerFeed 值，控制每个源保留的文章数量。