Skip to content

About

No description, website, or topics provided.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

110 Commits

Folders and files

Repository files navigation

rss-summary

CI

一个定时信息简报 CLI:把“我明确订阅的内容”和“我应该知道的行业变化”分成两条链路。个人订阅合并 GitHub Home 与 feeds.json;行业前沿只跟踪厂商官方 RSS/Atom,以及经过验证的 News、Changelog、Release 和研究页面。个人订阅按语义区分仓库、PR 与文章:仓库保留 stars/语言等确定性事实,Rivus 先让 AI 二次精选是否值得推送,再只为入选的 PR 与 RSS 文章生成最长 180 字、来源约束的中文摘要。CLI 可挂 webhook,也可作为 Rivus 插件被调度。

Rivus 的 morning-feed-digest 保留稳定 automation ID,并继续推送前一北京时间自然日的“我的订阅”;source-grounded Daily AI Digest 使用独立的 daily-ai-digest automation,覆盖每次运行时刻往前 24 小时。Daily AI Digest 合并官方 RSS/官网与订阅 X 账号,默认接入 ClaudeDevs,不再调用宽泛新闻搜索。账号采集逻辑可供未来“我的订阅”复用,但此次不改变其 feeds.json。午、晚新闻独立按主题广搜,默认 Grok;显式豆包/GLM 配置仍有效。Agent 自主筛选、翻译/归纳并选择六个栏目,代码校验结构与证据引用,不设固定条数。X 内容标为“Grok 整理”,失败留在来源审计,RSS/官网采集继续;所有来源都没有可用证据时才整体失败。质量不足时不凑数。每个 Automation 同时产出 Markdown 兼容视图与渠道无关的展示 IR:插件决定栏目、条目和来源,Rivus Renderer 决定飞书卡片组件与视觉样式。具体时间由 Rivus manifest 分别绑定,避免两类产品互相覆盖。

豆包搜索可以通过 NEWS_SEARCH_MODE=hybrid 启用 GLM 补查:供应商额度耗尽或查询没有合格结果时,从配置的可信来源搜索并读取原文,再通过同一时间与主题校验;详见 混合搜索配置。新闻请求另受持久的每日、每月预算和原始响应缓存约束;本地预算或状态失败不会转用 GLM,命中缓存也不补查。搜索预算与部署说明集中说明额度计算、配置、覆盖限制与状态恢复。

午间、晚间新闻与 Daily AI 默认使用已登录的 Grok CLI 进行原生 X 搜索,显式设置的 NEWS_SEARCH_MODE 优先。默认每轮最多一次调用,保留原生工具与 CLI 用量记录;结果明确标注为模型整理、未独立核验。需要豆包时设置 NEWS_SEARCH_MODE=doubao;Grok 失败不会自动切换提供方。Grok X 搜索配置包含试用步骤、查询语言与限制。

示例输出

我的订阅(rss-summary digest)

# 我的订阅 · 2026-08-09

12 条更新 · GitHub Home + 个人博客 · 2026-08-08 +08:00

**重点摘要**

**[owner/useful-tool](https://github.com/owner/useful-tool)**

⭐ 12.3k · TypeScript

面向 Agent 的开发工具仓库。
来源:followee-a

**[owner/useful-tool #42 · Add resumable runs](https://github.com/owner/useful-tool/pull/42)**

为长任务增加可恢复检查点;进程中断后可从最近状态继续,而不是重新执行。
来源:contributor-b

**[A useful post](https://example.com/post)**

文章梳理新的运行时能力,并解释升级对现有 TypeScript 工作流的影响。
来源:Example Blog

行业前沿(rss-summary industry)

# 行业前沿 · 2026-08-09

6 条动态 · 2026-08-09 +08:00

**值得展开**

**[New agent release](https://example.com/release)**

新增可靠工具调用与可审计执行产物。
来源:Vendor Changelog

**动态速览**

- Vendor Blog 发布了「API update」。[查看原文](https://example.com/update)

Quick Start

pnpm install --frozen-lockfile && pnpm build
pnpm link --global
rss-summary github-home login            # 浏览器登录 GitHub 后回车,会话存到 .state/
GITHUB_USERNAME=<your-username> FEED_DAY="$(TZ=Asia/Shanghai date +%F)" \
  rss-summary digest --dry-run           # 打印今日早报到终端

目录

Setup · Commands · Configuration · Scheduling · Rivus Plugin · Architecture · Development · License

Setup

CLI 只读取进程环境变量,不会自动加载 .env。上面的快速开始使用命令行内联变量;如需 .env,从配置参考的 dotenv 代码块中选取所需变量创建文件,不要直接复制 Markdown 文档。每次运行都需要显式加载,例如在仓库根目录完成构建后:

node --env-file=.env ./dist/app/cli/main.js digest --dry-run

其他命令同理:将 rss-summary 替换为 node --env-file=.env ./dist/app/cli/main.js,后面的子命令和参数保持不变。也可以通过 shell 或进程管理器提供环境变量,再直接运行 rss-summary。

pnpm install --frozen-lockfile && pnpm build && pnpm link --global
rss-summary github-home login

rss-summary github-home login 打开浏览器,登录 GitHub、确认 github.com 显示 Home 后回车,登录态存入 .state/github-home-storage.json(不入 git)。默认用本机 Chrome;机器没有 Chrome 时跑 pnpm exec playwright install chromium 并取消 GITHUB_HOME_BROWSER_CHANNEL。

可选:从你的 GitHub 账号建一个细粒度 token 放 GH_FEED_TOKEN,用于 API 补全 PR 详情或 GITHUB_FEED_SOURCE=events 回退。最小权限 Events: Read-only,仓库访问按需(默认公开仓库)。

RSS 源维护在受版本控制的 feeds.json,用 rss-summary feeds ... 改动并通过 PR 提交。

Commands

# 我的订阅:当日 GitHub Home + 明确订阅的个人 RSS
GITHUB_USERNAME=<your-username> FEED_DAY="$(TZ=Asia/Shanghai date +%F)" \
  rss-summary digest --only-new

# 行业前沿:官方 RSS/Atom + 显式配置的 News/Changelog 页面;论文只进入研究队列
rss-summary industry --day "$(TZ=Asia/Shanghai date +%F)" --only-new --dry-run

# 给 feed-research skill 的行业候选 JSON(含最多 8 篇 abstract 匹配论文)
rss-summary industry --json --day "$(TZ=Asia/Shanghai date +%F)" --only-new --dry-run

# 管理 RSS 源
rss-summary feeds add --url "https://github.blog/feed" --name "GitHub Blog" --tags "github,ai"
rss-summary feeds list

# 检查每次 CLI 抓取、筛选和投递产物
rss-summary runs list
rss-summary runs failures
rss-summary runs show <run-label>

更多选项 rss-summary <command> --help。深度研究流水线:加 --json --only-new --dry-run 输出候选 JSON,配合 prompts/feed-research.md 或 skills/feed-research-digest 生成最终简报。

个人 RSS 可以收录文章和视频混合的订阅源。定时简报的 research-article 会把 YouTube 及 MP4、WebM 等视频链接交给 Summarize:优先读取字幕,没有字幕时转写音频,再抽取最多 6 张关键帧交给视觉模型分析代码、图表和画面文字。只接受实际字幕、转写及已完成的看图记录,不会把视频简介或图片路径当成内容。普通 CLI digest 仍只收集订阅信息,视频研究由定时简报或 Agent 调用研究工具完成。

视频研究需要安装 Summarize CLI(已验证 0.25.1)及媒体工具;官方 summarize skill 可供 Agent 直接调用,但只安装技能不会安装底层工具。在 macOS 上安装 npm install -g @steipete/summarize@0.25.1 和 brew install yt-dlp ffmpeg whisper-cpp,再按 Whisper 模型说明 下载多语言 ggml-base.bin 到 ~/.summarize/cache/whisper-cpp/models/,即可本地转写而不依赖付费 API。运行自动简报的机器也需要这些依赖。

画面分析默认通过 Summarize 调用已登录的 Codex CLI;运行机器需要可用的图片理解模型,也可用 RSS_VIDEO_VISION_CLI 或 RSS_VIDEO_VISION_MODEL 指定其他 Summarize 支持的后端。可选安装 tesseract 保留 OCR 文字;OCR 成功不代表视觉分析成功。该过程在研究工具内部完成,不需要给 Rivus 定时任务开放文件读取权限。

研究结果保留原视频链接、画面时间点和视觉模型标识。完整转录、关键帧、OCR 与看图记录存入 .state/video-research/(可通过 RSS_VIDEO_RESEARCH_DIR 修改,不提交 Git);模型使用的精简证据最多 5,500 字符,长转录会明确标为覆盖开头至结尾的节选。画面是抽样分析,不能宣称逐帧看完;部分或全部看图失败时分别标记 partial / unavailable,摘要只能使用实际取得的证据。直接媒体下载限制为 1 GB;转录和画面研究各有 10 分钟超时,单帧看图最多 2 分钟,临时视频文件会清理。抓取或转写失败的条目仍会取消推送。

Configuration

变量 作用 默认
GITHUB_FEED_SOURCE home(精确,默认)或 events(REST 回退) home
GITHUB_USERNAME 要抓 Home feed 的账号 —
FEED_DAY 日报日 YYYY-MM-DD(本地日历) 滚动窗口
FEED_TIMEZONE_OFFSET 时区偏移 +00:00
FEED_WINDOW_HOURS 滚动窗口小时(FEED_DAY 未设时) 36
GITHUB_HOME_FETCH conduit(默认)或 browser conduit
RSS_ARTICLE_BROWSER_CHANNEL 浏览器研究使用的 Chrome channel;不可用时回退 Playwright Chromium chrome
RSS_ARTICLE_BROWSER_HEADLESS 浏览器研究是否无头运行 true
RSS_ARTICLE_BROWSER_TIMEOUT_MS 单条浏览器研究超时(毫秒) 30000
GH_FEED_TOKEN GitHub token(API 补全 PR 详情 / events 回退) —
DOUBAO_SEARCH_API_KEY 午/晚间新闻搜索 —
NOTIFY_WEBHOOK_URL 推送 webhook(POST { "text": markdown }) —
RSS_FEEDS_FILE RSS 订阅文件 feeds.json
INDUSTRY_SOURCES_FILE 行业官方 RSS/Atom 与页面来源文件;覆盖路径必须存在 包内 industry-feeds.json
INDUSTRY_STATE_FILE 行业简报去重/调研状态 .state/industry-state.json
FEED_MAX_PAPERS 每次进入深度调研队列的论文硬上限 8
FEED_RUN_LOG_DIR CLI 运行审计产物目录 .state/runs

完整列表与默认值见 docs/reference/configuration.md。GitHub Home 的 conduit / 浏览器回退机制见 docs/architecture/architecture.md。

Scheduling

0 9 * * * cd /path/to/rss-summary && FEED_DAY="$(TZ=Asia/Shanghai date +\%F)" \
  GITHUB_FEED_SOURCE=home GITHUB_USERNAME=<your-username> RSS_FEEDS_FILE=feeds.json \
  rss-summary digest --only-new >> /tmp/feed-digest.log 2>&1

机器身份无关,使用其 Home feed 的那个 GitHub 账号的浏览器登录态决定可见性。

Rivus Plugin

本仓库导出 rss-summary/rivus-plugin:一个 Agent profile(rss-digest)+ 五个观察型 Tool(generate-digest / research-article / generate-daily-ai-digest / generate-news-brief / generate-industry-brief)及对应调度模板。它们不发送消息或写业务 seen 状态;新闻采集会持久化请求预算与响应缓存。订阅和行业 Tool 携带 source/candidate audit;research-article 只对 Agent 选中的公开 URL 做浏览器优先、HTTP 回退的正文抓取,返回受限、可追溯的研究证据;新闻 Tool 携带逐查询召回、淘汰原因、去重和配额漏斗。Automation 的 createPresentation 把最终 Markdown 投影为标题、元信息、栏目、条目、说明和来源链接;它不直接构造飞书 CardKit JSON。Rivus 自己的 Renderer、trace 与投递 ledger 分别负责渠道展示和后续卡片投递证据。行业 Tool 不直接发布未研究论文,只报告待调研数量。安装、manifest 绑定、环境调用约定见 docs/development/rivus-plugin.md。

industry-feeds.json 中缺省类型仍是 RSS/Atom;type: "page" 只用于已验证的官方列表页,并要求同源文章路径与显式日期。不是每个网站都有 /news,也不会自动猜路径或绕过站点抓取政策。设计与准入条件见 Official Web Page Sources RFC。旧的 INDUSTRY_FEEDS / INDUSTRY_FEEDS_FILE 环境变量继续作为兼容别名。 未设置来源文件变量时始终读取 npm 包内的注册表,不依赖进程工作目录;显式配置的文件不存在时会直接报错,避免静默生成缺少官方来源的简报。

Architecture

模块化 DDD 结构:kernel(共享工具)+ 四个业务模块 acquisition(采集)/ reading(读原文)/ editorial(编辑规则,纯计算)/ delivery(投递与记忆),每个模块内部分 domain → application → infra;app 组装五个产品并作为唯一运行 Effect 的层。完整数据流、审计产物和扩展点见 docs/architecture/architecture.md,技术选型与取舍见 docs/architecture/technology-decisions.md。

Development

pnpm verify            # test:layout + check + duplicates + knip + test + build + package:check
pnpm duplicates        # 检出任何一处重复都会失败。
pnpm duplicates:audit  # 只生成报告,发现重复也不会拦截。
pnpm knip              # 检出未使用的文件、导出、依赖,或出现配置、标签提示时,CI 失败。

main 受保护。在功能分支上改,开 PR,等 Verify + Coverage 通过后再合并。

便携 agent skills(跨 Codex / Claude Code 等)在 skills/:$github-feed-digest(配置/运行)、$feed-research-digest(深度研究)、$rss-feed-management(源管理)。

License

本项目采用 GNU General Public License v3.0 only(GPL-3.0-only),与 Rivus 保持一致。

package.json 的 private: true 用于防止误发布到 npm,不影响 GitHub 仓库的公开状态或源码许可证。.state/、.env、token 等本地机密不入 git。

About

No description, website, or topics provided.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages