让 Agent 直接使用 AIHOT

让当前 Agent 校验完整包后原子替换它正在使用的同一目录。不要复制默认命令去猜另一个平台的目录；如果发现 ~/.codex/skills/aihot、~/.gemini/skills/aihot 等旧目录，先确认重复副本，再使用安装器的 --migrate-legacy 显式迁移。

请把我已安装的 AIHOT Skill 更新到最新版：https://aihot.virxact.com/aihot-skill/README.md

先告诉我它现在装在哪个目录、是否存在重复副本，再替换同一目录。
更新后开启新会话，用“过去 24 小时 AI 圈最重要的 5 件事是什么？”验证。

• 原生时间窗只有过去 24 小时和最近 7 天；超过 7 天的普通历史搜索暂不保证。
• “最近一周精选”不等于编辑成品周报；正式 周报／月报目前只有网页，尚无 Skill／MCP／API／RSS 合同。
• 返回摘要、站内阅读页和第三方原文链接；当前没有按 ID 获取单篇正文的 API。

1. 文件名严格是 SKILL.md，且在当前 Agent 支持的 skills 目录。
2. 关掉旧会话，新开一个，再问上面的验证问题。
3. 让 Agent 列出它发现的 skills，确认里面有 aihot。
4. 仍失败：把平台、版本和安装路径提交反馈页，别发 token 或本地文件。

# 首次请求：保存响应里的 ETag
curl -i 'https://aihot.virxact.com/api/v1/items?mode=selected&window=24h&limit=20'

# 后续请求同一个完整 URL；304 表示内容没有变化
curl -i -H 'If-None-Match: <上次响应的 ETag>' 'https://aihot.virxact.com/api/v1/items?mode=selected&window=24h&limit=20'

同一个完整 URL 返回的 ETag 会覆盖公开响应；新增、撤选、重排或标题摘要等原地编辑都能被下一次条件请求发现。

400

参数不合法；按 OpenAPI 和稳定 code 修正，不要自动改成宽查询。无效或跨查询 cursor 不会静默回到第一页； 滚动窗口滑过 cursor 锚点（例如隔天再用昨天的书签）同样返回 invalid_cursor，从第一页重来，不会静默给一页空。

409

snapshot_required：增量游标无法安全续传，重新取一次完整快照。

429

严格遵守 Retry-After，不要增加并发重试。

5xx

指数退避并使用上次成功缓存；公开服务不提供 SLA。

/api/public/* 会在 2026 年 12 月 31 日停止服务，替代品是同样匿名只读的 /api/v1/*。 迁移时不要复用旧 cursor 或 ETag：普通列表从 v1 首屏开始， 完整精选从 v1 snapshot 重建一次。

已经装了 Skill 的怎么办

已安装的 Skill 1.x 本来就走 v1，不用动；0.x 版 Skill 调的是旧 /api/public/*，在停服范围内——它每次会话会自检版本并提示升级，按提示重装即可。

让 Agent 帮你改

我的项目还在调用 AIHOT 的旧接口 /api/public/*，它会在 2026 年 12 月 31 日 停止服务。

请读取 https://aihot.virxact.com/llms.txt 和 https://aihot.virxact.com/openapi-v1.json，然后：
1. 在我的代码里找出所有调用 /api/public/ 的地方，列给我看；
2. 按 v1 的字段映射改写，注意 url→links.original、permalink→links.aihot、title_en→originalTitle、source→source.name；
3. 不要复用旧的 cursor 或 ETag；精选同步要重新取一次 v1 snapshot；
4. 改完告诉我哪些地方需要我人工确认。

路径对照

字段对照

• items／hot-topics／精选同步对象里原本存在的公共字段按以下方式迁移：url 改读 links.original，permalink 改读 links.aihot，title_en 改读 originalTitle，source 改读 source.name。
• 只有 items 的顶层 count／hasNext／nextCursor 改读 page.count／page.hasMore／page.nextCursor； selected changes 继续读取顶层 hasMore 和 cursor。错误改为标准 Problem JSON。
• 所有返回 attribution 的 v1 对象，都从 { source, canonical } 改读 { name, url }。
• items 参数迁移：take 改为 limit；since 改选能覆盖目标范围的 window=24h|7d，再按 publishedAt 本地收窄。旧 fields=minimal 在 v1 items 没有直接等价参数，必须移除； selected snapshot 仍支持 fields，changes 沿用 snapshot cursor 绑定的字段模式，不再传 fields。
• 日报响应迁移：latest 和指定日期的 v1 响应增加稳定外层，报告本体改从 report 读取；条目里的 sourceName／sourceUrl／permalink 分别改读 source.name／links.original／links.aihot。v1 在日报索引项与报告顶层新增必有的 links.aihot； 旧客户端若曾用 attribution.canonical 作为日报站内地址， 改读这个字段。
• v1 只接受 OpenAPI 声明且不重复的参数；旧客户端使用的 _ cache-buster、未知参数或重复参数必须移除，否则会返回 400。

这些不用改

• RSS 订阅地址与 GUID 长期稳定，不参加本次停服。
• /api/public/feed 是站内网页翻页接口，不属于外部 API 停服对象。
• /api/public/version 会继续作为旧 0.x Skill 的轻量升级发现桥，不纳入本轮停服；1.x 在稳定 v1 合同内继续工作，普通后端更新不要求反复安装。

迁移遇到阻塞怎么办

从公告到停服有 159 天。 如果你的项目确实来不及，请通过 反馈页说明用途和阻塞点，我们会单独确认延期方案，而不是让你的服务直接中断。