Info Pulse AI

一个智能 RSS 阅读器，使用 AI 分析和筛选高质量内容，提供清爽的阅读体验。

✨ 功能特点

• 📰 RSS 订阅管理 - 支持添加、编辑、删除 RSS 源，OPML 导入
• 🤖 AI 智能分析 - 自动评估文章质量和重要性，生成摘要和标签
• 📖 已读标记 - 自动标记已读文章，显示未读数量
• 🎨 现代 UI - 基于 Folo 风格的简洁界面设计
• 📱 侧边栏管理 - 支持拖拽调整宽度和折叠
• ⭐ 收藏功能 - 本地收藏喜欢的文章
• 🔍 文章筛选 - 按来源、重要性、标签筛选

🛠️ 技术栈

后端

• Python 3.11+ - 核心语言
• FastAPI - Web 框架
• SQLite - 数据库
• OpenAI API - AI 分析
• feedparser - RSS 解析

前端

• Vue 3 - 前端框架
• TypeScript - 类型安全
• Element Plus - UI 组件库
• Pinia - 状态管理
• Vite - 构建工具

🚀 快速开始

前置要求

• Python 3.11+
• Node.js 18+
• pnpm (推荐) 或 npm
• OpenAI API Key

安装

1. 克隆项目

git clone <repository-url>
cd info_pulse_ai

2. 配置后端

cd backend

# 安装依赖
pip install -r requirements.txt
# 或使用 uv
uv pip install -r requirements.txt

# 配置文件
cp config_simple.yaml config.yaml
# 编辑 config.yaml，填入你的 OpenAI API Key

3. 配置前端

cd frontend

# 安装依赖
pnpm install

# 配置环境变量（可选）
cp .env.example .env

运行

后端：

cd backend
task start
# 或
python api_server.py

前端：

cd frontend
pnpm dev

访问 http://localhost:5173 查看应用。

📁 项目结构

info_pulse_ai/
├── backend/              # 后端服务
│   ├── modules/          # 核心模块
│   │   ├── database.py   # 数据库操作
│   │   ├── ai_analyzer.py # AI 分析
│   │   ├── rss_fetcher.py # RSS 抓取
│   │   └── feed_service.py # 订阅服务
│   ├── api_server.py     # API 服务
│   ├── main.py           # 主程序
│   └── config.yaml       # 配置文件
│
├── frontend/             # 前端应用
│   ├── src/
│   │   ├── api/          # API 接口
│   │   ├── components/   # Vue 组件
│   │   ├── stores/       # 状态管理
│   │   ├── views/        # 页面
│   │   └── types/        # TypeScript 类型
│   └── package.json
│
├── data/                 # 数据目录（被 gitignore）
└── reports/              # 报告目录（被 gitignore）

📖 使用说明

添加 RSS 源

1. 点击侧边栏顶部的 ➕ 按钮
2. 输入 RSS 源的 URL 和标题
3. 可选择分类
4. 点击保存

导入 OPML

1. 在设置页面选择"导入 OPML"
2. 选择 OPML 文件
3. 系统自动导入所有订阅源

AI 分析

后端会定期抓取 RSS 文章并使用 AI 分析：

• 质量评分 (0-10)
• 重要性评分 (0-10)
• 标签提取
• AI 摘要

阅读体验

• 点击文章自动标记为已读
• 未读数量实时显示在侧边栏
• 支持收藏和筛选

⚙️ 配置说明

后端配置 (config.yaml)

ai:
  provider: "openai"
  api_key: "your-api-key"
  model: "gpt-4o-mini"

database:
  path: "./data/rss_reader.db"

rss:
  fetch_interval: 3600  # 抓取间隔（秒）

前端配置 (.env)

VITE_API_BASE_URL=http://localhost:8000

🎨 界面特性

• 极简设计 - 清爽的 Folo 风格界面
• 响应式布局 - 三栏布局，可调整侧边栏宽度
• 未读标记 - 橙色气泡显示未读数量
• 流畅动画 - 平滑的过渡效果
• 暗色模式 - 即将支持

🔧 开发命令

后端

# 启动服务
task start

# 仅抓取文章
task fetch

# 仅分析文章
task analyze-only

# 完整流程
task run

前端

# 开发模式
pnpm dev

# 构建
pnpm build

# 预览
pnpm preview

📝 API 文档

API 运行后访问 http://localhost:8000/docs 查看 Swagger 文档。

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

MIT License

🙏 致谢

• UI 设计灵感来自 Folo RSS Reader
• 基于 OpenAI GPT 模型进行内容分析

---

Happy Reading! 📚✨