资讯与行情源

资讯 API、聚合流与定时任务写入的关系。

概览

资讯主要在 /api/news/*,服务 src/services/news-data.ts,类型 src/types/news-data.ts。src/lib/news-data-middleware.ts 提供 withFallback、sanitizeNewsItems 等。

典型路由

路径作用
GET /api/news/items列表(分类、标签、语言、推荐、优先级、搜索、排序)
GET /api/news/items/[uuid]单条
home、all、articles、search、dual-language、chinese-crypto、newsflash-combined、binance-alpha、twitter、channels、stats、health 等首页流、聚合、渠道、统计与健康检查

与 Cron 的关系

  • /api/cron/crypto-news 等定时任务负责拉取/刷新外部数据;/api/news/* 面向前端的查询层。详见 content/docs/architecture/cron。

数据流

  1. Cron/后台写入资讯存储。
  2. 前端 GET /api/news/...。
  3. Service 过滤;必要时 middleware 兜底。

关键文件

  • src/app/api/news/**
  • src/services/news-data.ts
  • src/lib/news-data-middleware.ts

Dependencies

环境变量

  • DATABASE_URL — 读路径主要走库(getNewsDataService)。
  • 写入侧 的 RSS/第三方密钥在 Cron 与抓取逻辑中(见 Cron),不一定在 GET 处理器里。

数据库(src/db/schema.ts)

  • news_items_cache、binance_alpha_news_cache、articles_cache、twitter_accounts_cache、channels_cache
资讯与行情源 | 追踪狗文档