项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 63539
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- 支持 Windows / Mac / Linux 系统
- 本地部署走 uv 方案,无需预装 Python(uv 自动管理版本)
- Docker 方案需自备服务器、NAS 或长期运行的电脑
- GitHub Actions 方案需配置远程云存储,并每 7 天签到续期
安装与启动步骤
-
1安装 uv 工具
macOS/Linux 用下方命令;Windows 改用 PowerShell 执行 irm 安装脚本
curl -LsSf https://astral.sh/uv/install.sh | sh -
2克隆并进入项目
从 GitHub 拉取 TrendRadar 源码,并切换到项目根目录
git clone https://github.com/sansan0/TrendRadar.git cd TrendRadar -
3同步项目依赖
uv 会自动安装所需 Python 版本和全部依赖,无需手动装 Python
uv sync -
4填写配置文件
编辑 config/config.yaml 填写推送渠道等配置,默认配置已可正常使用
-
5启动运行
在项目根目录运行,开始定时抓取新闻并按配置推送
uv run python -m trendradar
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
config/config.yaml | 是 | 主配置文件:推送模式、时间窗口、平台列表、热点权重等 | config/config.yaml |
config/frequency_words.txt | 否 | 关键词文件:设置关心的词汇,用于筛选推送内容 | 人工智能 |
config/ai_analysis_prompt.txt | 否 | AI 提示词模板:自定义 AI 分析师角色和分析维度 | config/ai_analysis_prompt.txt |
.github/workflows/crawler.yml | 否 | 执行频率:控制多久运行一次,README 提醒谨慎修改 | .github/workflows/crawler.yml |
S3_BUCKET_NAME | 否 | 远程云存储桶名称,配齐 4 项才启用完整云存储模式 | trendradar-data |
SORT_BY_POSITION_FIRST | 否 | 排序优先级:true 按配置位置优先,false 按热点条数优先 | true |
如何确认成功
运行后项目根目录生成 index.html,用浏览器打开即为完整的新闻报告页面。
常见问题
Q:GitHub Actions 上服务被挂起怎么办?
A:引入活跃度检测后有效期为 7 天,到期自动挂起。进入仓库 Actions 页面手动触发 Check In workflow 即可重置 7 天有效期。
Q:Docker 和 GitHub Actions 该选哪个?
A:Docker 更稳定、数据本地存储、无需云存储,适合有服务器或 NAS 的用户;GitHub Actions 无需服务器但数据存远程云存储,且需定期签到续期。
Q:不配置云存储会有什么影响?
A:GitHub Actions 每次运行都是全新环境,不配置云存储将运行在轻量模式,没有增量推送和历史追踪;Docker 与本地部署默认把数据存本地硬盘。
Q:不想手写 YAML 配置有办法吗?
A:可用官方在线可视化配置编辑器,通过表单完成所有配置项的修改与导出后,再放回 config 目录使用。
Q:生成的新闻报告怎么发布到网上?
A:运行后根目录会生成 index.html,可点击 Use this template 创建仓库,部署到 Cloudflare Pages 或 GitHub Pages 等静态托管平台。
注意事项
- README 推荐 Docker 部署(镜像 wantcat/trendradar 为必选的新闻推送服务,wantcat/trendradar-mcp 为 AI 分析服务),但节选中未给出完整 docker run 命令,请以官网文档为准。
- Cloudflare Pages 自动部署需在仓库添加 CLOUDFLARE_API_TOKEN、CLOUDFLARE_ACCOUNT_ID、CLOUDFLARE_PROJECT_NAME 三个 Secrets,缺任意一个会自动跳过且不影响推送功能。
- Windows 用户可双击 setup-windows.bat 一键安装依赖,Mac 用户可执行 bash setup-mac.sh 代替 uv sync。
- 项目强调以轻量、易部署为目标,README 建议先查看官网最新文档,确保配置步骤是最新的。
核心亮点
- 多平台热点与 RSS 聚合,覆盖广泛信息源
- AI 智能筛选、翻译与摘要,提升信息处理效率
- 支持 MCP 架构,可自然语言交互分析趋势
不足之处
- 依赖外部 AI 服务,可能产生 API 费用
- 配置复杂度较高,新手需一定学习成本
- 文档/社区待观察
适用场景
- 个人用户追踪每日热点与行业动态
- 媒体或运营团队监控舆情与竞品趋势
- 企业集成到内部系统,实现智能预警
替代项目
RSSHub、Hugging Face Spaces、Newspipe
同类项目推荐
keep
开源
统一管理监控告警,智能降噪,让运维不再被警报淹没。
The open-source AIOps and alert management platform
ai-job
开源
AI 分身替你 7×24 小时聊 HR,批量投简历不错过机会
找工作,用AI工作猎手!让AI帮您找工作!【DeepSeek+ChatGpt】赋能,ai助理作为您的求职者···
alpaca-skills
开源
让 AI 助手直接会写 Alpaca 交易接口代码
Agent skills for Alpaca's Trading API and Broker API: drop-in SKILL.md files for AI ···
opentakeoff
开源
浏览器里从PDF图纸量房算料,AI可直接调用
Open-source (AGPL-3.0) PDF takeoff for construction & flooring — the first engine a···
gptibo
开源
自托管 AI 服务小店,前台后台后端一套带走
Self-hosted GPTibo storefront, admin and Go backend — sanitized MIT source
comic-translate
开源
一键自动翻译漫画,多格式多语言,省去手动修图。
AI comic and manga translator app/browser extension for automatically translating co···
ecg-fm
开源
用预训练心电图模型,快速构建精准的心脏疾病AI诊断应用
An electrocardiogram analysis foundation model.
Auto-Analyst
开源
说句话就能完成数据分析,自动建模出报告
Open-source AI-powered data science platform.
MyRecipeBook
开源
用 ChatGPT 管食谱,DDD 架构轻松部署 Azure
API REST de gerenciamento de receitas em .NET com DDD e Clean Architecture. Autentic···
