API 契约

当前站点依赖的运行时 JSON 文件由脚本生成到 public/api/，并同步发布到 docs/public/api/。

在 news.rowkin.xyz 这样的自定义根域名下，接口路径直接以 /api/ 开头即可。 如果未来还要兼容子路径部署，可以在构建时设置 SITE_BASE=/news-base/。

核心接口

路径	用途	被谁消费
/api/overview.json	首页概览数据	NewsMetrics.vue
/api/latest.json	今日总览和完整新闻列表	NewsDashboard.vue
/api/categories/{id}.json	单个专区数据	NewsBoard.vue
/api/daily/{date}.json	按日期归档数据	归档与自动化脚本
/api/stats.json	统计数据与标签分布	后续分析页可复用
/api/sources.json	来源字典和补充说明	文档与调试工具可复用

overview.json

{
  "date": "2026-03-24",
  "generatedAt": "2026-03-24T21:10:00+08:00",
  "total": 20,
  "sourceCount": 15,
  "categories": [
    {
      "id": "tech",
      "name": "科技资讯",
      "count": 4,
      "topHeadline": "企业级 Agent 产品开始进入流程重构阶段"
    }
  ]
}

latest.json

{
  "date": "2026-03-24",
  "generatedAt": "2026-03-24T21:10:00+08:00",
  "total": 20,
  "summary": "本次更新采用真实源优先策略，并对失败来源启用了分类兜底。",
  "categories": {
    "global": 4,
    "domestic": 4,
    "investment": 4,
    "tech": 4,
    "github": 4
  },
  "items": []
}

兼容性约束

• 页面组件只依赖字段名，不依赖抓取来源。
• 新来源接入时优先扩展 news_sources.json，而不是先改页面。
• 如果需要增加字段，优先追加而不是修改已有字段含义。