thysrael--horizon
wehub-resource-sync
389 行
21 KiB
Markdown
389 行
21 KiB
Markdown
<div align="center">
|
||
|
||
<h1>🌅 Horizon</h1>
|
||
|
||
<p><strong>你只需享受新闻，剩下交给 Horizon。</strong></p>
|
||
|
||
<a href="https://trendshift.io/repositories/22864?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-22864" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/22864/daily" alt="Thysrael%2FHorizon | Trendshift" width="250" height="55"/></a>
|
||
<a href="https://trendshift.io/repositories/22864?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-22864" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/22864/weekly?language=Python" alt="Thysrael%2FHorizon | Trendshift" width="250" height="55"/></a>
|
||
<a href="https://hellogithub.com/repository/Thysrael/Horizon" target="_blank"><img src="https://abroad.hellogithub.com/v1/widgets/recommend.svg?rid=7a4b606e28e4477998d35851cf4fdddf&claim_uid=rtjnLkYT7ziQJUG" alt="Featured｜HelloGitHub" style="width: 250px; height: 54px;" width="250" height="54" /></a>
|
||
<br>
|
||
|
||
[](LICENSE)
|
||
[](https://github.com/astral-sh/uv)
|
||
[](https://www.horizon1123.top/)
|
||
[](https://thysrael.github.io/Horizon/)
|
||
[](https://github.com/Thysrael/Horizon/commits/main)
|
||
[](https://github.com/Thysrael/Horizon/pulls)
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
📡 构建你专属的 AI 新闻雷达，生成中英双语日报。 | Your own AI-powered news radar.
|
||
|
||
[📖 在线演示](https://thysrael.github.io/Horizon/) · [📋 配置指南](https://thysrael.github.io/Horizon/configuration) · [English](README.md) · [日本語](README_ja.md)
|
||
|
||
</div>
|
||
|
||
## 截图
|
||
|
||
<table>
|
||
<tr>
|
||
<td width="50%">
|
||
<p align="center"><strong>按优先级排序的日报</strong></p>
|
||
<img src="docs/assets/overview_zh.png" alt="日报总览" />
|
||
</td>
|
||
<td width="50%">
|
||
<p align="center"><strong>背景、总结与评论</strong></p>
|
||
<img src="docs/assets/one_news_zh.png" alt="新闻详情" />
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
|
||
<details>
|
||
<summary><strong>More Screenshots</strong></summary>
|
||
<br>
|
||
<table>
|
||
<tr>
|
||
<td width="33.33%">
|
||
<p align="center"><strong>终端输出</strong></p>
|
||
<img src="docs/assets/terminal_log.png" alt="终端输出" />
|
||
</td>
|
||
<td width="33.33%">
|
||
<p align="center"><strong>飞书通知</strong></p>
|
||
<img src="docs/assets/feishu_zh.png" alt="飞书通知" />
|
||
</td>
|
||
<td width="33.33%">
|
||
<p align="center"><strong>邮件推送</strong></p>
|
||
<img src="docs/assets/email.png" alt="邮件推送" />
|
||
</td>
|
||
</tr>
|
||
</table>
|
||
</details>
|
||
|
||
## 为什么需要 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 配置中定制信息源、阈值、模型、语言和分发方式
|
||
|
||
## 工作原理
|
||
|
||
```mermaid
|
||
%%{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
|
||
```
|
||
|
||
1. **定义** — 用一个 JSON 配置好信息源、阈值、模型、语言和分发方式。
|
||
2. **抓取** — 并发拉取所有已配置信息源的最新内容。
|
||
3. **去重** — 合并来自不同平台、指向同一故事或 URL 的内容。
|
||
4. **打分与过滤** — 用 AI 对内容排序，只保留超过阈值的条目。
|
||
5. **丰富** — 为重要内容补充搜索得到的背景信息和社区讨论。
|
||
6. **总结** — 生成结构化的 Markdown 日报，包含摘要、标签和参考链接。
|
||
7. **分发** — 将结果发布到 GitHub Pages、邮件、飞书等 webhook、MCP 或本地文件。
|
||
|
||
## 赞助
|
||
|
||
Horizon 是一个业余时间维护的开源项目。如果你愿意支持这个项目，或希望出现在这里，欢迎[创建一个 Issue](https://github.com/Thysrael/Horizon/issues/new) 或[发邮件](mailto:thysrael@163.com)联系我。
|
||
|
||
| 支持方 | 说明 |
|
||
|--------|------|
|
||
| [<img src="docs/assets/compshare-logo.png" alt="Compshare / 优云智算" width="220" />](https://www.compshare.cn/?ytag=GPU_YY_git_Horizon) | 优云智算目前正在支持 Horizon。优云智算是 UCloud 旗下 AI 云平台，主打包月、按次的高性价比国模 Agent Plan 套餐，低至 49 元/月起，同时提供官转稳定海外模型。支持接入 Claude Code、Codex 及 API 调用，支持企业高并发、7*24 技术支持和自助开票。<br><br>通过其[链接](https://www.compshare.cn/?ytag=GPU_YY_git_Horizon)注册，可获得 5 元平台体验金。 |
|
||
|
||
## 快速开始
|
||
|
||
### 1. 安装
|
||
|
||
#### 方式 A：本地安装
|
||
|
||
```bash
|
||
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：
|
||
|
||
```bash
|
||
uv sync --extra openbb
|
||
```
|
||
|
||
如果 `openbb` 在你的机器上会拉到缺少 wheel 的依赖，建议改用只安装二进制包：
|
||
|
||
```bash
|
||
uv pip install --only-binary=:all: openbb openbb-benzinga
|
||
```
|
||
|
||
#### 方式 B：Docker
|
||
|
||
```bash
|
||
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：交互式向导（推荐）**
|
||
|
||
```bash
|
||
uv run horizon-wizard
|
||
```
|
||
|
||
向导会询问你的兴趣（如"LLM 推理"、"嵌入式"、"web 安全"），自动推荐并生成 `data/config.json`，还可选让 AI 补充推荐小众源。若你想分享信息源，请前往 [horizon1123.top](https://horizon1123.top/)。
|
||
|
||
**方式 B：手动配置**
|
||
|
||
```bash
|
||
cp .env.example .env # 添加 API 密钥
|
||
cp data/config.example.json data/config.json # 自定义信息源
|
||
```
|
||
|
||
最小手动配置示例：
|
||
|
||
```jsonc
|
||
{
|
||
"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` 等信息源配置。
|
||
|
||
```jsonc
|
||
{
|
||
"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 地址或自定义请求头模板等字段。
|
||
|
||
完整配置参考请查看[配置指南](docs/configuration.md)。
|
||
|
||
### 3. 运行
|
||
|
||
#### 本地安装
|
||
|
||
```bash
|
||
uv run horizon # 使用默认 24 小时窗口
|
||
uv run horizon --hours 48 # 抓取最近 48 小时的内容
|
||
```
|
||
|
||
#### 使用 Docker
|
||
|
||
```bash
|
||
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/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 助手调用 |
|
||
|
||
具体配置见[配置指南](docs/configuration.md)。MCP 工具说明和客户端接入见 [`src/mcp/README.md`](src/mcp/README.md) 与 [`src/mcp/integration.md`](src/mcp/integration.md)。
|
||
|
||
## 文档
|
||
|
||
| 文档 | 内容 |
|
||
|------|------|
|
||
| [配置指南](docs/configuration.md) | AI 模型、信息源、过滤、邮件、Webhook、GitHub Pages 和 MCP 配置 |
|
||
| [评分机制](docs/scoring.md) | Horizon 如何评估和排序新闻 |
|
||
| [抓取器](docs/scrapers.md) | 信息源抓取器说明和扩展细节 |
|
||
| [内容提取器](docs/extractors.md) | RSS 信息源的全文提取 |
|
||
| [MCP 工具](src/mcp/README.md) | MCP 客户端可调用的工具说明 |
|
||
|
||
## 项目状态
|
||
|
||
Horizon 已经支持完整的日报流程：多源抓取、AI 打分、去重、背景补充、评论摘要、双语生成、GitHub Pages 发布、邮件分发、Webhook 推送、Docker 部署、MCP 集成和配置向导。
|
||
|
||
计划中的改进：
|
||
|
||
- 更多信息源类型，例如 Discord
|
||
- 按信息源自定义打分 Prompt
|
||
- 在 GitHub 上发布 Release
|
||
- 发布到 PyPI，支持通过 `pip install` 安装
|
||
|
||
## 贡献
|
||
|
||
欢迎贡献！请随时提交 Issue 或 Pull Request。
|
||
|
||
### 分享信息源
|
||
|
||
想把有价值的信息源分享给 Horizon 社区？请直接前往 **[horizon1123.top](https://horizon1123.top)** 提交。
|
||
|
||
欢迎提交：你所在领域里优质的小众 RSS 发现、活跃 subreddit 的趋势、值得关注的 GitHub 动态，或 Telegram 频道精选内容。
|
||
|
||
## 鸣谢
|
||
|
||
- 特别感谢 [LINUX.DO](https://linux.do/) 提供的宣传平台。
|
||
- 特别感谢 [HelloGitHub](https://hellogithub.com/) 提供的指导意见。
|
||
- 特别感谢 [AIGC Link](https://xhslink.com/m/80ngts127cA) 提供的小红书和微信公众号宣传。
|
||
|
||
## 许可证
|
||
|
||
[MIT](LICENSE)
|