quotedance-rss-digest

RSS Digest - 资讯流聚合技能#

基于你自己的 quotedance-service Feeds API 和本地 RSSHub (http://localhost:1200)，为 Agent 提供一个「最近几天资讯流」的聚合能力。

• 默认：先从 quotedance-service 获取你已启用的订阅源，再由本地逐个抓取 RSS，生成 Markdown 资讯流。
• 可选：支持按 资讯源名称关键字 过滤，例如“只看 少数派 / 机核网 / 某个专栏”。
• 支持简单的 本地缓存，在配置的 TTL 内重复调用不会频繁打服务端和 RSS 源站。

---

配置#

配置文件： skills/quotedance-rss-digest/config.json

json

{
  "serviceUrl": "https://quotedance.api.gapgap.cc",
  "apiKey": "与 qutedance-quotes 相同的 API Key",
  "rsshubUrl": "http://localhost:1200",
  "defaults": {
    "recentDays": 3,
    "limit": 100,
    "cacheTtlMinutes": 30,
    "sourceCacheTtlMinutes": 15
  }
}

• serviceUrl：quotedance-service 的线上地址（与你现在使用的一致）
• apiKey：和 qutedance-quotes/config.json 中一致，通过 X-API-Key 鉴权
• rsshubUrl：你本地 RSSHub 服务地址（当订阅源 rss_url 为相对路径时会自动拼接）
• defaults.recentDays：默认拉取「最近几天」的天数
• defaults.limit：最终输出的最大文章数量
• defaults.cacheTtlMinutes：缓存有效期，分钟
• defaults.sourceCacheTtlMinutes：订阅源列表缓存有效期，分钟（默认建议 15）

---

能力#

1️⃣ 全部订阅源资讯流

• 调用 quotedance-service：
  • GET /feeds/registry
  • 通过 X-API-Key 自动识别用户，返回该用户 已启用的订阅源列表
• 脚本在本地做：
  • 逐个抓取订阅源的 rss_url（支持 RSS / Atom）
  • 本地聚合并去重（优先按链接去重）
  • 只保留最近 recentDays 天内的文章
  • 截断为最多 limit 条
  • 格式化为 Markdown 列表（标题、来源、时间、链接）
  • 结果写入简单缓存文件（同一参数组合在 TTL 内重复调用直接命中缓存）

2️⃣ 按资讯源名称筛选

• 用户可以在对话中描述：
  • “看下少数派最近几天的文章”
  • “只看机核网的更新”
• 脚本会：
  • 先从 /feeds/registry 拉取该用户订阅源
  • 本地抓取这些订阅源的 RSS 内容并聚合
  • 在本地用 资讯源名称关键字 做模糊过滤（例如匹配 source_name / feed_title / source.name 等字段）
  • 同样支持最近 N 天过滤与缓存

注意：由于服务端的数据结构可能调整，脚本在取“来源名称”时做了多种字段兜底，只要大致有个 source/name/title 字段就能工作。

---

在对话中如何使用#

当用户说：

• “帮我汇总下最近几天的资讯流”
• “看下我订阅源最近 3 天有啥值得看的”
• “只看 少数派 的更新”
• “汇总最近 5 天我所有订阅源的新文章”

Agent 应该：

1. 选择本技能 rss-digest
2. 推断参数：
   • 若用户没有提天数 → 使用 defaults.recentDays
   • 若用户提到“最近 N 天 / 两三天 / 一周左右” → 转成具体天数
   • 若提到具体资讯源名称 → 作为 name 关键字过滤
3. 调用脚本生成 Markdown 资讯流，并直接展示给用户，必要时做少量总结。

---

手动脚本用法#

从 workspace-quotedance 目录运行：

bash

cd ~/.openclaw/workspace-quotedance

# 默认：最近 defaults.recentDays 天，全部源
node skills/quotedance-rss-digest/scripts/rss-digest.js

# 指定最近 N 天
node skills/quotedance-rss-digest/scripts/rss-digest.js --days 5

# 只看某个资讯源（按名称关键字模糊匹配）
node skills/quotedance-rss-digest/scripts/rss-digest.js --name 少数派

# 同时指定天数和输出数量
node skills/quotedance-rss-digest/scripts/rss-digest.js --days 7 --limit 50

# 强制刷新（忽略文章缓存和订阅源缓存）
node skills/quotedance-rss-digest/scripts/rss-digest.js --refresh

# 只刷新订阅源列表（文章缓存仍按原规则）
node skills/quotedance-rss-digest/scripts/rss-digest.js --refresh-sources

# 清空缓存并立即重新抓取
node skills/quotedance-rss-digest/scripts/rss-digest.js --clear-cache

---

目录结构#

text

skills/quotedance-rss-digest/
├── SKILL.md
├── config.json
├── scripts/
│   └── rss-digest.js
└── memory/
    └── rss-cache-*.json   # 本地缓存（脚本运行时自动创建）

---

实现概要#

• 从 config.json 读取：

  • serviceUrl / apiKey / rsshubUrl / defaults

• 请求 quotedance-service：

  • 使用 X-API-Key 做鉴权
  • 调用 /feeds/registry 获取当前用户已启用订阅源

• 本地处理：

  • 先读取订阅源缓存（ sourceCacheTtlMinutes），超时后重新请求 /feeds/registry
  • 对每个订阅源抓取 RSS/Atom（ rss_url 为相对路径时会拼接 rsshubUrl）
  • 聚合、去重并按发布时间倒序排序
  • 根据 recentDays 过滤最近几天的文章
  • 可选按 name 关键字过滤资讯源
  • 限制输出为 limit 条
  • 生成结构化 Markdown 文本
  • 结合 cacheTtlMinutes 做文章缓存（按 days + name + limit 组合区分）