Thysrael/Horizon

项目介绍

Horizon 是一个用 Python 写的个人新闻简报流水线。它从 RSS/Atom、Hacker News、Reddit、Telegram、X、GitHub、OpenBB、OSS Insight、GDELT 和 Google News 拉取内容，再交给 LLM 打分、去重、摘要，并补充背景资料和社区讨论，最终生成中英文 Markdown 简报，可发布到 GitHub Pages，或通过邮件、Webhook、微信投递。

核心抽象是 profile：一组可复用的编辑规则，决定什么内容该收、什么值得保留、以及写成什么样。内置的 tech-news、tech-blog、ai-creator 等 profile 给出不同处理方式；可以给每个来源指定 profile，让 AI 自动匹配，或限定只在某几个 profile 中匹配。每个 profile 的分数阈值和去重设置放在 processing.profile_settings，不写在 profile 文件里。

快速使用

前提：安装 uv（推荐）或 pip 的 Python 环境，以及一个受支持模型服务的 API Key。

1. 克隆并安装：

git clone https://github.com/Thysrael/Horizon.git
cd Horizon
uv sync

开发依赖用 uv sync --extra dev；可选的 OpenBB 财经新闻源需要 uv sync --extra openbb。

2. 配置。交互式向导会生成 data/config.json：

uv run horizon-wizard

也可以手动把 .env.example 复制为 .env 填入 API Key，把 data/config.example.json 复制为 data/config.json 并修改来源。最小配置需要设置 ai.provider、ai.model 和 ai.api_key_env（这里填环境变量名，例如 OPENAI_API_KEY），再加一个来源，例如：

"sources": {
  "rss": [
    { "name": "Simon Willison", "url": "https://simonwillison.net/atom/everything/", "profile": "tech-news" }
  ]
}

3. 运行流水线：

uv run horizon

常用参数包括 --hours N（默认 24）、--data-dir PATH（默认 data）、--config PATH 和 --log-level。生成的简报保存在 data/summaries/ 下。

也可以改用 Docker：先 docker compose build，再 docker compose run --rm horizon。

使用约束

• 必须配置 LLM 服务商和 API Key；README 列出的服务商包括 OpenAI、Gemini 等。
• X/Twitter 来源依赖 Apify，twitter extra 还需要 Playwright 浏览器和系统依赖，当前 Dockerfile 不会安装这些。
• 邮件投递走 SMTP/IMAP；微信投递通过 iLink Bot，需要扫码登录并先发消息，且受微信回复限制。
• --data-dir 会改变状态目录（简报、订阅者、默认配置位置），--config 只改配置文件。
• GitHub Actions 的每日工作流模板默认禁用，需要改名为 daily-summary.yml 才能启用。
• 许可证为 MIT。

HotRepo 点评

Horizon 在 GitHub 全部语言日榜上的最好名次为第 14；2026-11-04 的日榜快照显示新增 121 Star，当前共 12,298 Star、1,803 Fork。README 展示的是一条完整链路——多源采集、profile 驱动的分析、去重、双语输出、多种投递方式，而不是单一脚本。profile 设计是它最有辨识度的地方：把编辑意图和 Python 代码分开，调整某类来源的处理方式通常不用改流水线。README 里也有模型平台的付费赞助链接，但它们和实际的安装、配置文档并存，而不是替代后者。

项目源码与说明