wehub/thysrael--horizon

Fork 0

Files

T

wehub-resource-sync 2db9672445 docs: make Chinese README the default

2026-07-13 10:15:42 +00:00

21 KiB

Raw Permalink Blame History

Note

本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
English · 原始项目 · 上游 README
原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。

🌅 Horizon

你只需享受新闻，剩下交给 Horizon。

📡 构建你专属的 AI 新闻雷达，生成中英双语日报。 | Your own AI-powered news radar.

📖 在线演示 · 📋 配置指南 · English · 日本語

截图

按优先级排序的日报

背景、总结与评论

More Screenshots

终端输出

飞书通知

邮件推送

为什么需要 Horizon？

好新闻分散在各处，坏信息却源源不断。Horizon 为你先完成第一轮筛选：从 Hacker News、Reddit、Telegram、RSS、Twitter/X、GitHub 和 OpenBB 抓取内容，合并重复新闻，用 AI 打分过滤，并为重要内容补充背景解释和社区讨论。

但 Horizon 不只是又一个摘要工具。AI 很擅长降低噪声，但新闻仍然需要人的品味：你信任哪些信息源，哪些评论改变了你对事件的理解，哪些小众来源值得被更多人看见。Horizon 通过可定制的信息源、筛选标准、模型、语言、分发方式、评论摘要和社区信息源官网，把这层“人味”保留下来。

功能特性

📡 关注你的信息源 — 将 Hacker News、RSS、Reddit、Telegram、Twitter/X、GitHub Release / 用户动态，以及 OpenBB 金融新闻观察列表纳入同一条 pipeline
🤖 把噪声变成阅读清单 — 使用 Claude、GPT、Gemini、DeepSeek、豆包、MiniMax 或任意 OpenAI 兼容 API，为每条内容评分 0-10
🔗 合并重复新闻 — 在生成日报前自动合并来自不同平台的相同故事
🔍 补全背景知识 — 为陌生概念、公司、项目和技术术语补充网络搜索得到的背景解释
💬 读到社区声音 — 收集并总结 Hacker News、Reddit 等来源的评论讨论
🌐 生成双语日报 — 基于同一组信息源生成英文和中文日报
📝 发布日报站点 — 将生成的 Markdown 发布为 GitHub Pages 静态日报站点
📧 邮件分发 — 运行自托管 SMTP/IMAP 邮件列表，自动处理订阅与退订
🔔 推送到聊天和自动化工具 — 将模板化结果发送到飞书、钉钉、Slack、Discord 或自定义 Webhook
🧙 从兴趣开始配置 — 通过交互式向导根据你的兴趣生成个性化信息源配置
⚙️ 调校你的新闻雷达 — 在单个 JSON 配置中定制信息源、阈值、模型、语言和分发方式

工作原理

%%{init: {
  "theme": "base",
  "themeVariables": {
    "fontFamily": "ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, Segoe UI, sans-serif",
    "fontSize": "18px",
    "primaryTextColor": "#2d2a3e",
    "primaryBorderColor": "#e0dbd3",
    "lineColor": "#7c7891",
    "tertiaryColor": "#faf8f5",
    "clusterBkg": "#f3f0eb",
    "clusterBorder": "#e0dbd3"
  }
}}%%
flowchart LR
    classDef config fill:#fbbf24,stroke:#d4a017,color:#2d2a3e,stroke-width:1.5px;
    classDef source fill:#ede7fb,stroke:#6d4aaa,color:#2d2a3e,stroke-width:1.5px;
    classDef process fill:#ffe8db,stroke:#e0652e,color:#2d2a3e,stroke-width:1.5px;
    classDef output fill:#f9d7e5,stroke:#be185d,color:#2d2a3e,stroke-width:1.5px;

    config["⚙️ 配置<br/>信息源、阈值、模型、输出方式"]

     subgraph sources["已配置的信息源"]
         rss["📡 RSS"]
         hn["📰 Hacker News"]
         reddit["💬 Reddit"]
         telegram["✈️ Telegram"]
         twitter["🐦 Twitter / X"]
         github["🐙 GitHub"]
         openbb["💹 OpenBB"]
      end

    fetch["📥 抓取"]
    dedup["🧹 新闻去重"]
    score["🤖 AI 打分与过滤"]
    enrich["🔎 内容丰富"]
    summary["📝 总结生成"]

    subgraph outputs["输出形式"]
        direction TB
        site["🌐 Pages"]
        email["📧 邮件"]
        webhook["🔔 Webhook"]
        mcp["🧩 MCP"]
    end

     config --> fetch
     rss --> fetch
     hn --> fetch
     reddit --> fetch
      telegram --> fetch
      twitter --> fetch
      github --> fetch
      openbb --> fetch

    fetch --> dedup --> score --> enrich --> summary
    config --> score
    config --> summary
    config --> outputs

    summary --> site
    summary --> email
    summary --> webhook
    summary --> mcp

    class config config
    class rss,hn,reddit,telegram,twitter,github,openbb source
    class fetch,dedup,score,enrich,summary process
    class site,email,webhook,mcp output

定义 — 用一个 JSON 配置好信息源、阈值、模型、语言和分发方式。
抓取 — 并发拉取所有已配置信息源的最新内容。
去重 — 合并来自不同平台、指向同一故事或 URL 的内容。
打分与过滤 — 用 AI 对内容排序，只保留超过阈值的条目。
丰富 — 为重要内容补充搜索得到的背景信息和社区讨论。
总结 — 生成结构化的 Markdown 日报，包含摘要、标签和参考链接。
分发 — 将结果发布到 GitHub Pages、邮件、飞书等 webhook、MCP 或本地文件。

赞助

Horizon 是一个业余时间维护的开源项目。如果你愿意支持这个项目，或希望出现在这里，欢迎创建一个 Issue 或发邮件联系我。

支持方	说明
	优云智算目前正在支持 Horizon。优云智算是 UCloud 旗下 AI 云平台，主打包月、按次的高性价比国模 Agent Plan 套餐，低至 49 元/月起，同时提供官转稳定海外模型。支持接入 Claude Code、Codex 及 API 调用，支持企业高并发、7*24 技术支持和自助开票。通过其链接注册，可获得 5 元平台体验金。

快速开始

1. 安装

方式 A：本地安装

git clone https://github.com/Thysrael/Horizon.git
cd horizon

# 使用 uv 安装（推荐）
uv sync

# 需要测试/开发依赖时
uv sync --extra dev

# 或使用 pip
pip install -e .

当前 dev 在 pyproject.toml 中定义为 optional extra，因此安装 pytest 等开发依赖时应使用 uv sync --extra dev。

如果你要启用可选的 OpenBB 金融新闻源，还需要安装对应 extra：

uv sync --extra openbb

如果 openbb 在你的机器上会拉到缺少 wheel 的依赖，建议改用只安装二进制包：

uv pip install --only-binary=:all: openbb openbb-benzinga

方式 B：Docker

git clone https://github.com/Thysrael/Horizon.git
cd horizon

# 配置环境
cp .env.example .env
cp data/config.example.json data/config.json
# 编辑 .env 和 data/config.json，填入你的 API 密钥和偏好设置

# 使用 Docker Compose 运行
docker compose run --rm horizon

# 或自定义时间窗口
docker compose run --rm horizon --hours 48

2. 配置

方式 A：交互式向导（推荐）

uv run horizon-wizard

向导会询问你的兴趣（如"LLM 推理"、"嵌入式"、"web 安全"），自动推荐并生成 data/config.json，还可选让 AI 补充推荐小众源。若你想分享信息源，请前往 horizon1123.top。

方式 B：手动配置

cp .env.example .env          # 添加 API 密钥
cp data/config.example.json data/config.json  # 自定义信息源

最小手动配置示例：

{
  "ai": {
    "provider": "openai",
    "model": "gpt-4",
    "api_key_env": "OPENAI_API_KEY"
  },
  "sources": {
    "rss": [
      { "name": "Simon Willison", "url": "https://simonwillison.net/atom/everything/" }
    ]
  },
  "filtering": {
    "ai_score_threshold": 6.0
  }
}

均衡日报（可选）

可以限制日报总条数，并避免单一类别占据过多内容。类别来自 sources.rss[].category 等信息源配置。

{
  "filtering": {
    "ai_score_threshold": 6.0,
    "max_items": 20,
    "category_groups": {
      "ai": {
        "limit": 5,
        "categories": ["ai-news", "ai-tools", "machine-learning"]
      },
      "finance": {
        "limit": 5,
        "categories": ["finance", "business", "equities"]
      }
    },
    "default_group": "other",
    "default_group_limit": 3
  }
}

分组限额在 AI 分数过滤之后、内容补充之前执行。未配置 category_groups 和 max_items 时，筛选行为保持不变。

data/config.json 里的任意字符串值都可以通过 ${VAR_NAME} 引用环境变量。这适合用于 ai.base_url、私有 RSS 链接、Webhook 地址或自定义请求头模板等字段。

完整配置参考请查看配置指南。

3. 运行

本地安装

uv run horizon              # 使用默认 24 小时窗口
uv run horizon --hours 48   # 抓取最近 48 小时的内容

使用 Docker

docker compose run --rm horizon              # 使用默认 24 小时窗口
docker compose run --rm horizon --hours 48   # 抓取最近 48 小时的内容

生成的日报将保存在 data/summaries/ 目录中。

4. 自动化（可选）

Horizon 非常适合作为 GitHub Actions 定时任务运行。查看 .github/workflows/daily-summary.yml 获取现成的工作流配置，可自动生成日报并部署到 GitHub Pages。

支持的信息源

信息源	抓取内容	评论收集
Hacker News	按分数排序的热门文章	支持（前 N 条评论）
RSS / Atom	任意 RSS 或 Atom 订阅源	—
Reddit	Subreddit 帖子 + 用户动态	支持（前 N 条评论）
Telegram	公开频道消息	—
Twitter / X	特定用户的推文	支持（前 N 条回复）
GitHub	用户动态 & 仓库 Release	—
OpenBB	按观察列表 / provider 抓取金融公司新闻	—

日报可以去哪里

Horizon 支持通过多种方式发布和分发生成的日报：

方式	作用
GitHub Pages 日报站点	将生成的 Markdown 复制到 `docs/`，通过 GitHub Pages 发布为每日更新的静态日报站点
邮件订阅	通过 SMTP/IMAP 向订阅者发送日报，并自动处理订阅/退订请求
Webhook 通知	在成功或失败时将结果推送到飞书、钉钉、Slack、Discord 或任意 Webhook 端点
MCP Server	将抓取、打分、过滤、富化、摘要和完整 pipeline 暴露为工具，供 AI 助手调用

具体配置见配置指南。MCP 工具说明和客户端接入见 src/mcp/README.md 与 src/mcp/integration.md。

文档

文档	内容
配置指南	AI 模型、信息源、过滤、邮件、Webhook、GitHub Pages 和 MCP 配置
评分机制	Horizon 如何评估和排序新闻
抓取器	信息源抓取器说明和扩展细节
内容提取器	RSS 信息源的全文提取
MCP 工具	MCP 客户端可调用的工具说明

项目状态

Horizon 已经支持完整的日报流程：多源抓取、AI 打分、去重、背景补充、评论摘要、双语生成、GitHub Pages 发布、邮件分发、Webhook 推送、Docker 部署、MCP 集成和配置向导。

计划中的改进：

更多信息源类型，例如 Discord
按信息源自定义打分 Prompt
在 GitHub 上发布 Release
发布到 PyPI，支持通过 pip install 安装

贡献

欢迎贡献！请随时提交 Issue 或 Pull Request。

分享信息源

想把有价值的信息源分享给 Horizon 社区？请直接前往 horizon1123.top 提交。

欢迎提交：你所在领域里优质的小众 RSS 发现、活跃 subreddit 的趋势、值得关注的 GitHub 动态，或 Telegram 频道精选内容。

鸣谢

特别感谢 LINUX.DO 提供的宣传平台。
特别感谢 HelloGitHub 提供的指导意见。
特别感谢 AIGC Link 提供的小红书和微信公众号宣传。

许可证

MIT

21 KiB Raw Permalink Blame History Unescape Escape