AI HOT Skill (精简版)

让 Agent 用最自然的中文查询拿到 aihot.virxact.com 上每天的 AI HOT 日报和 AI 动态。

线上：https://aihot.virxact.com（公开匿名可访，无需 token）

本精简版用于 ClawHub 8192 token 限制下占 slug。完整版（21KB+，含工作流 / 数据形态 / 输出格式 / 错误处理 / 不要做完整列表）见 GitHub:

https://github.com/KKKKhazix/khazix-skills/tree/main/aihot

先决条件：必须带 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 行业事实"，不要凭训练数据脑补，永远走 API。

5 个 category（items 用英文 slug，daily 看到的中文 label）

核心约束

• 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