把 AICue 接进你的 Agent

在资讯请求中加上 category，只取对应分类；不传则包含全部分类。返回条目的 category 也使用下表中的值。

1. 01
   开压缩

   curl 加 --compressed，其他客户端打开 gzip 或 br。JSON 压缩后只有原来的 1/4 到 1/8。

2. 02
   带上 ETag

   保存响应里的 ETag，下次带 If-None-Match；内容没变时返回 304，不传正文。

3. 03
   按节奏取

   资讯和热点最快一分钟一次；日报每天 08:00 后取一次，周报、月报出刊后取一次；往回翻页翻到已有的那条就停。

内容多久变一次：新资讯全天陆续进来，精选每天变几次到几十次，日报每天 08:00、周报每周一 10:00、月报每月 1 日 10:30（北京时间）各一期。

# 第一次：保存响应头里的 ETag
curl --compressed -i 'https://news.daico.cc/api/v1/items?mode=selected&window=24h&limit=20'
# 之后最快每分钟一次，带上 ETag；返回 304 就是没变化
curl --compressed -i -H 'If-None-Match: <上次的 ETag>' 'https://news.daico.cc/api/v1/items?mode=selected&window=24h&limit=20'

需要往回翻页时，把 page.nextCursor 作为 cursor 传回去，翻到已经有的那条就停，不要每次把 7 天重翻一遍。

400

参数不对：按 OpenAPI 和返回的 code 修正，不要自动换成更宽的查询。cursor 无效或滑出时间窗返回 invalid_cursor，从第一页重来。

409

snapshot_required：增量没法安全续上，重新取一次完整快照。

429

请求太密：按 Retry-After 等待，不要并发重试。

5xx

指数退避，先用上次成功的结果；公开服务不承诺 SLA。

能匿名调用不等于所有用途都获许可，见使用规则。

我的项目还在调用原站的旧接口 /api/public/*。
请读取 https://news.daico.cc/llms.txt 和 https://news.daico.cc/openapi-v1.json，然后：
1. 在我的代码里找出所有调用 /api/public/ 的地方，列给我看；
2. 按 v1 的字段映射改写，注意 url→links.original、permalink→links.aihot、title_en→originalTitle、source→source.name；接入地址使用 https://news.daico.cc；
3. 不要复用旧 cursor 或 ETag；精选同步重新取一次 v1 snapshot；
4. 请求加上压缩和 If-None-Match，轮询间隔不短于 60 秒；
5. 改完告诉我哪些地方需要人工确认。

字段对照：url 改读 links.original，permalink 改读 links.aihot，title_en 改读 originalTitle，source 改读 source.name；items 顶层的 count／hasNext／nextCursor 改读 page.count／page.hasMore／page.nextCursor；attribution 从 { source, canonical } 改为 { name, url }；错误统一为 Problem JSON。

v1 只接受 OpenAPI 里声明且不重复的参数；旧客户端带的 _ 防缓存参数、未知参数或重复参数要去掉，否则返回 400。

原站迁移时间与历史兼容范围以原站迁移说明为准。