×

ErisPulse-RssReader

RSS 订阅器 · Subscribe any RSS/Atom feed and get push notifications in chat

ErisPulse 的全功能 RSS/Atom 订阅器模块。在聊天中订阅任意源，按计划自动轮询抓取并以富文本卡片推送新内容。配备交互式菜单、批量导入、关键词过滤、多群隔离，以及订阅健康检查——定时探活全部源，发现失效链接自动通知所在群。

功能特性

安装

epsdk install RssReader
# 或
pip install ErisPulse-RssReader

依赖 feedparser>=6.0、beautifulsoup4>=4.12 已在依赖中声明，安装时自动拉取。

使用

模块加载后通过斜杠命令交互：

命令列表

菜单内回复编号操作：

HTTP API

模块注册以下 HTTP 端点：

配置

首次加载自动生成默认配置，可在 ErisPulse 配置中修改 RssReader 节：

[RssReader]
default_interval = 30          # 默认推送间隔（分钟）
max_items_per_push = 5         # 每次推送最大条数
auto_start = true              # 启动时自动开始抓取
max_subs_per_chat = 20         # 每个聊天最大订阅数
admins = []                    # 管理员用户 ID（健康检查可管理全部订阅）
health_check_interval = 1440   # 健康检查间隔（分钟）
health_check_fail_threshold = 3 # 连续失败几次判定失效
health_check_probe_timeout = 10 # 体检单个源的最长超时（秒）

推送效果

推送时自动检测平台能力，按 Html > Markdown > Text 优先级降级展示：

• 单条更新 → 详细卡片（标题、作者、时间、摘要、链接）
• 多条更新 → 摘要列表（标题 + 时间）

架构

RssReader/
├── Core.py          模块入口，注册命令、HTTP 路由与仪表盘视图
├── rss.py           RSS/Atom 抓取与解析，FeedItem 数据模型，源探活
├── store.py         存储层，订阅 / 历史 / 过滤规则 CRUD + 健康状态
├── scheduler.py     调度器，逐源轮询 + 健康检查任务 + 失效通知
└── templates.py     Html / Markdown / Text 降级模板

自 v1.2 起，存储层为每条订阅记录 added_by / last_status / last_check_at / last_error / fail_count，支持定时健康检查；添加者可管理自己添加的失效源，管理员可管理全部。

License

• Code: MIT License