常见问题
以下汇集了用户在使用 TrendRadar 过程中最常遇到的问题和解答。 如果你的问题不在此列，可以在 GitHub Issues 中搜索或提问。
入门常识
了解 TrendRadar 的基本信息
QTrendRadar 的数据从哪里来？
A
热榜新闻数据来自 newsnow 项目的 API，它聚合了多个平台的实时热点数据， 包括知乎、微博、抖音、百度、B站等主流平台。
RSS 数据则来自你自己配置的 RSS/Atom 订阅源。你可以添加任何提供标准 RSS/Atom feed 的网站。
所有数据处理都在本地完成。TrendRadar 不会将你的数据上传到任何第三方服务器。
Q没有服务器，可以使用 TrendRadar 吗？
A
可以。GitHub Actions 部署方式完全不需要服务器。GitHub 提供免费的计算资源来运行你的任务， 你只需要一个 GitHub 账号即可。
唯一的限制是 GitHub Actions 有 7 天活跃检测机制（需要定期签到来保持工作流运行）， 以及时间控制的精度不如 Docker 部署（GitHub Actions 的定时任务存在约 15 分钟的误差）。
QAI 功能会产生费用吗？
A
AI 分析、翻译和智能过滤功能都需要使用 AI 服务提供商的 API Key。 调用 API 会产生一定费用，但通常非常低廉。
推荐使用 DeepSeek 作为 AI 提供商，性价比最高。 单次分析的费用通常只有几分钱，日常使用的月度费用极低。
具体费用取决于你的使用频率和选择的模型。如果不使用 AI 功能，TrendRadar 完全免费。
功能使用
使用过程中的常见疑问
Q选了增量模式，但好几个小时没收到推送，是不是坏了？
A
增量模式只会在出现新的匹配新闻时才推送。如果你一直没收到推送， 说明在你监控的平台上，暂时没有新出现的、匹配你关键词的热点内容。这是正常行为。
你可以尝试以下方法排查：
- 扩大关键词范围，添加更多你感兴趣的话题
- 增加监控的平台数量，覆盖更多数据来源
- 临时切换到「当前热点」（current）模式，验证系统是否正常工作。 如果 current 模式可以正常推送，说明系统没有问题，只是暂时没有匹配增量条件的新内容
Q可以添加默认列表中没有的平台吗？
A
可以。热榜数据来源于 newsnow 项目，支持的平台远多于 TrendRadar 的默认列表。
访问 https://newsnow.busiyi.world/，点击「更多」可以查看所有可用的平台。找到你需要的平台后， 将其对应的 ID 添加到
config.yaml 的平台列表中即可。社区整理的完整平台列表可以在 GitHub Issues #95 中找到。
Q可以同时推送到多个渠道吗？
A
可以。只需要配置好多个推送渠道的 Secret 或环境变量即可。 TrendRadar 会自动向所有已配置的渠道发送推送消息。
例如你可以同时配置企业微信和 Telegram，每次推送时两个渠道都会收到消息。
如果需要向同一渠道的多个账号推送（例如两个不同的企业微信群）， 可以在对应的 Secret 中使用英文分号（
;）分隔多个地址。部署运维
部署、升级与日常运维
Q如何升级到新版本？
A
升级方式取决于你的部署方式：
GitHub Actions 部署：如果你使用的是 "Use this template" 方式创建的仓库， 需要手动将原始仓库的更新文件复制到你自己的仓库中。具体需要更新哪些文件，请查阅每个版本的更新日志。
Docker 部署：升级非常简单，只需执行以下命令即可拉取最新镜像并重启：
cd docker
docker compose pull
docker compose up -d提示
升级前建议先备份你的配置文件（config/ 目录），以防新版本引入了配置格式变更。
Q配置了 MCP 但 AI 说找不到数据，怎么办？
A
MCP 分析的是本地
output/ 目录中的数据， 而不是实时的互联网数据。如果 AI 提示找不到数据，请逐项检查：- 确认已运行过主程序：MCP 需要主程序先完成数据采集。 检查
output/目录中是否存在.db数据库文件。 - 检查查询日期范围：确保你查询的日期范围内有已采集的数据。 例如今天刚部署，就只有今天的数据，无法查询昨天的内容。
- 检查目录挂载：如果使用 Docker 部署，确保
config/和output/目录已正确挂载到容器内。
Q为什么推送时间不太准确？
A
如果你使用的是 GitHub Actions 部署方式，这是正常现象。 GitHub Actions 的定时任务（cron）存在约 15 分钟的时间误差， 这是 GitHub 平台的固有限制，无法消除。
如果你需要更精确的推送时间控制，建议切换到 Docker 部署方式，在自己的服务器上运行。
另外，请检查
config.yaml 中的时区设置是否正确。 默认值为 Asia/Shanghai（东八区），如果你在其他时区使用，需要相应调整。Q如何配置代理？
A
在
config/config.yaml 的 advanced 段中配置代理：advanced:
crawler:
use_proxy: true
default_proxy: "http://127.0.0.1:10801"将
use_proxy 设为 true，并将 default_proxy 改为你的代理地址。 注意：GitHub Actions 环境下代理配置不会生效，代理仅在本地和 Docker 部署时有效。安全与调试
安全防护、配置排查与问题诊断
QWebhook 地址泄露了怎么办？
A
请立即在对应平台（企业微信、飞书、钉钉等）上重新生成 Webhook 地址。 旧的地址会立即失效，泄露的地址将无法继续使用。
安全提醒
如果你的 GitHub 仓库是公开的（public），不要将 Webhook URL 直接写在
config.yaml 中。请使用 GitHub Secrets 或 Docker 的 .env 文件来存放敏感信息。泄露的 Webhook 地址可能被恶意利用， 向你的群聊发送垃圾消息。Q如何检查配置是否正确？
A
运行
--doctor 命令可以对环境和配置进行一键体检：uv run python -m trendradar --doctor该命令会检查 Python 版本、配置文件是否存在、配置能否正确加载、调度配置是否有效、AI 配置是否完整、存储后端是否可用、通知渠道是否正确配置以及输出目录是否可写。 检查结果以通过/警告/失败三种状态展示，帮助你快速定位问题。
Q如何测试推送是否配通？
A
运行
--test-notification 命令可以向所有已配置的推送渠道发送一条测试消息：uv run python -m trendradar --test-notification如果你的推送渠道收到了测试消息，说明配置已经正确。如果没有收到，请检查对应渠道的 Webhook 地址或 API Key 是否正确。
Q如何查看运行日志？
A
根据部署方式不同，查看日志的方法也不同：
- GitHub Actions：进入仓库的 Actions 页面，点击对应的运行记录查看详细日志
- Docker：执行
docker logs -f trendradar查看实时日志 - 本地部署：日志直接输出到终端
Q环境变量和 config.yaml 哪个优先？
A
环境变量的优先级高于
config.yaml 文件。也就是说，如果同时在环境变量和配置文件中设置了同一项， 环境变量的值会覆盖配置文件中的值。这个机制在 Docker 和 GitHub Actions 部署中特别有用，可以将敏感信息 （如 API Key、Webhook URL）放在环境变量中，而不必写入配置文件。