AI HOT Skill (精简版)
让 Agent 用最自然的中文查询拿到 aihot.virxact.com 上每天的 AI HOT 日报和 AI 动态。
线上：https://aihot.virxact.com（公开匿名可访，无需 token）
本精简版用于 ClawHub 8192 token 限制下占 slug。完整版（21KB+，含工作流 / 数据形态 / 输出格式 / 错误处理 / 不要做完整列表）见 GitHub:
先决条件：必须带 User-Agent（仅 API 端点）
/api/public/* 走 nginx UA 黑名单挡商业爬虫，默认 curl/X.Y UA 会被 403。调 API 时所有 curl 都必须带浏览器 UA：
UA="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36"
curl -sH "User-Agent: $UA" "https://aihot.virxact.com/api/public/daily"
/aihot-skill/{install.sh,SKILL.md,README.md} 安装入口 nginx 上特意豁免 UA 黑名单（设计前提就是给 curl -fsSL ... | bash 一行装用）。
路由优先级（第一原则）
默认走精选 items?mode=selected——它是 AI HOT 每天精挑细选的"主菜单"，覆盖用户关心的事且数据新鲜。
- 仅当用户在话里明确说出"日报" 二字才走
daily（编辑成品，按 UTC 整日切片，跟"过去 24 小时 / 今天"等滚动窗口对不上） - 仅当用户明确说"全部 / 完整 / 所有 / 全量" 才走
mode=all（含未精选的次要条目，量大但杂） - "今天 AI 圈"、"过去 24 小时大新闻"、"最近 AI 圈有啥" 等宽问题 = 默认精选 + 时间窗（since），不要默认走日报或全部
什么时候用
| 用户在说 | 应该走的接口 |
|---|---|
| 默认（宽问题）："今天 AI 圈有什么"、"过去 24 小时大新闻"、"最近 AI 圈" | GET /api/public/items?mode=selected&since=<语义时间窗> |
| 明确说"日报"："AI 日报"、"今天的日报"、"看下日报" | GET /api/public/daily 或 daily/{YYYY-MM-DD} |
| 明确说"全部 / 完整 / 所有 / 全量" | GET /api/public/items?mode=all |
| "最近的模型发布"、"AI 论文"、"AI 行业动态" | GET /api/public/items?mode=selected&category=...&since=<7d 前> |
| "OpenAI/Anthropic 最近发的"、"Sora 相关"、"RAG 论文" | GET /api/public/items?q=<关键词>（server-side 关键词搜索） |
| "看下精选 50 条"、"AI HOT 精选" | GET /api/public/items?mode=selected&take=50 |
| "列一下日报有哪些"、"日报存档" | GET /api/public/dailies?take=N |
通用启发：用户问的是"现在的 AI 行业事实"，不要凭训练数据脑补，永远走 API。
5 个 category（items 用英文 slug，daily 看到的中文 label）
items?category= | daily.sections[].label |
|---|---|
ai-models | 模型发布/更新 |
ai-products | 产品发布/更新 |
industry | 行业动态 |
paper | 论文研究 |
tip | 技巧与观点 |
核心约束
since限最近 7 天：不传等同since=now-7d（服务端兜底硬上限）；早于 7 天前自动截到 7 天前；未来时间 → 400。需要更深历史走日报存档/api/public/daily/{date}take≤ 100，更多走 cursor 翻页cursor是 opaque token，原样回传给下一次请求；不要尝试解析、递增、跨端点复用q至少 2 字符，最长 200 字（超出截断），跟其它参数正交叠加- 限流 600 req/min/IP，串行调用不要并发猛拉
- 完整 OpenAPI 3.1 规范：
https://aihot.virxact.com/openapi.yaml
工作流示例
UA="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36"
# 默认：拉过去 24 小时精选（用户问"过去 24 小时大新闻"）
since=$(date -u -v-24H +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || date -u -d '24 hours ago' +%Y-%m-%dT%H:%M:%SZ)
curl -sH "User-Agent: $UA" "https://aihot.virxact.com/api/public/items?mode=selected&since=$since&take=50"
# 明确日报
curl -sH "User-Agent: $UA" "https://aihot.virxact.com/api/public/daily"
# 明确全部（用户说"全部 / 所有"）
curl -sH "User-Agent: $UA" "https://aihot.virxact.com/api/public/items?mode=all&since=$since&take=100"
# 关键词（OpenAI 最近发的，server-side 全池搜索）
curl -sH "User-Agent: $UA" "https://aihot.virxact.com/api/public/items?q=OpenAI&take=30"
给用户的输出格式
核心原则：直接展示给用户的最终内容必须 markdown + 排版好 + 普通人能看懂的人话。所有"端点路径 /
mode=selected这种 raw 参数 / 限流 / nginx 缓存 / cursor / hasNext"等基础设施细节都不能出现在用户输出里。
列表式输出（items 端点时）
按 category 分组 + 全局编号；每条带 title / source / 时间转人话 / summary / url：
**AI HOT — 过去 24 小时精选**（共 N 条）
## 模型发布/更新
1. **<title>** — <source>
2 小时前 / 今天上午 09:48
<summary>
<url>
## 产品发布/更新
2. ...
日报式输出（daily 端点时）
按 5 版块顺序展开（模型发布/更新 → 产品发布/更新 → 行业动态 → 论文研究 → 技巧与观点）。
时间转人话：2026-05-08T01:48:00.000Z → "今天上午 09:48" / "2 小时前"，不要直接展示 ISO 字符串。
不要做（核心几条）
- 不要把"今天 AI 圈"、"过去 24 小时大新闻"等宽问题路由到 daily — 滚动时间窗 vs UTC 整日切片对不上。默认
mode=selected + since=<语义窗> - 不要在用户没说"全部 / 完整 / 所有 / 全量"时默认走
mode=all— 默认mode=selected - 不要客户端 grep 公司维度 — 用 server-side
?q=<词>，覆盖全池 - 不要在用户输出暴露端点路径 / raw 参数 / 限流 / cursor — 这些是开发者细节，用户看不懂
- 不要丢每条的 sourceUrl — 跨日 / 跨版块压缩输出也必须保留 url（标题后或单独一行），否则信息不可信
- 不要凭训练数据脑补 — AI HOT 比训练截止日新得多，永远走 API
完整文档（工作流 / 数据形态 / 错误处理 / 完整 do/don't）见： https://github.com/KKKKhazix/khazix-skills/tree/main/aihot