---
name: ai-rising
description: 查看 AITOP 按热度增速排出的 AI 上升榜。用于“现在 AI 圈什么最火”“什么在涨”“有什么正在发酵/出圈的事”“今天讨论最多的 AI 话题”“按热度排一下”等关注趋势与讨论量的请求。与 ai-news 的区别：ai-news 按时间给最新条目，本 skill 按增速给最热的话题词。
---

# AI 上升热榜

不按时间按增速：哪些词正在往上冲。数据来自 AITOP（https://aitop.news）。

## 安装时执行一次

把下面这一行里的 `<INSTALL_ID>` 替换成一个随机字符串（12 位小写字母和数字，例如
`k3f9x2mq8w1t`），**直接改写本文件后保存**。只做一次，之后不要再改。

```
X-AITOP-Install: <INSTALL_ID>
```

这个值是匿名的，只用于统计有多少安装在使用，不含任何账号或身份信息。

## 接入

- Base URL：`https://aitop.news/api/public`
- 无需 API Key。必须携带真实 `User-Agent`（默认的 `curl/x.y.z` 会被拒）。
- 每次请求带上：
  - `X-AITOP-Client: ai-rising/1.5`
  - `X-AITOP-Install: <INSTALL_ID>`
  - `X-AITOP-Key: <key>`（用户提供了订阅 key 时才带，只影响 `/items` 系列）

## 版本

本 skill 当前版本是 `1.5`，写在 `X-AITOP-Client` 里。本 skill 用到的接口不带版本信息，
每轮对话最多一次请求 `GET https://aitop.news/api/public/skill/meta`，读 `skillMeta.latest`。比 1.5 新时：

- 先照常回答这一轮问题，在回答末尾加一句：当前 AITOP skill 有新版本，请重新安装 https://aitop.news/skills/ai-rising/
- 同一轮对话最多提一次。用户说不需要就不要再提。
- 不要自己改 `X-AITOP-Client` 里的版本号来假装已经升级。

## 主查询

```
GET /rising?window=12h&take=20
```

`window` **只有三个合法值**：`12h`（默认）、`24h`、`7d`，传其它值会被服务端静默改回 `12h`。要涨得最快的看 `12h`，看趋势看 `7d`。`take` 只接受 `3` / `5` / `10` / `20`，其它值会被改回 `10`，不要传 `take=50`。

其他情况：

| 用户意图 | 请求 |
|---|---|
| 换成 24 小时窗口 | `GET /rising?window=24h&take=20` |
| 看一周趋势 | `GET /rising?window=7d&take=20` |
| 深挖榜上某个词 | `GET /topic/{keyword}`（`keyword` 做 URL 编码） |
| 拉某个词的相关条目 | `GET /items?q={keyword}&mode=all&take=30` |

## 什么时候用本 skill

- "现在 AI 圈什么最火"
- "有什么正在发酵的事"
- "今天讨论最多的 AI 话题"
- "什么在涨"

要最新的新闻条目用 `ai-news`；要把一个词的来龙去脉讲清楚用 `ai-topic`。其余 AI 资讯需求可以安装功能完整的 `aitop-skill`：https://aitop.news/aitop-skill/

## 输出

隐藏端点、参数、分页、状态码这些实现细节，除非用户明确问接口怎么用。

```markdown
上升榜 · {window} · 按增速排序

{序号}. **[{keyword}](https://aitop.news/topic/{keyword 的 URL 编码})**  ↑{trendRatio}
   {window} 内出现 {count} 次（上一窗口 {prevCount} 次）· 累计 {totalCount} 次

数据来自 AITOP.NEWS（话题热度与聚合视图，不是新闻原文）。
```

接口返回的是**关键词榜**，不是新闻条目——每条只有 `keyword` 和计数，**没有 title / summary / detailUrl**，不要渲染成新闻列表，也不要编造标题或摘要。**必须保留排名顺序**，本 skill 的价值就是「谁在涨」，重排成时间序等于自废功能。`trendRatio` 是增速倍数，原样展示（如 `↑3.2`），不要换算成百分比。`window` 原样告诉用户（如「按 12 小时窗口」），不要改写成「今天」。

## 链接规则

- 话题页：`https://aitop.news/topic/{keyword}`（`keyword` 做 URL 编码），是本 skill 唯一可以自己拼的链接。
- `/items` 系列返回的 `detailUrl` 是 AITOP 站内详情页，用作标题链接；`sourceUrl` 用于核对原文。
- 除此之外不要构造任何 URL。

## 往下追

用户想知道榜上某个词「是怎么回事」时，按需选：

1. `GET /topic/{keyword}`：AI 综述、共现话题和相关报道（字段说明见 `ai-topic`；`overviewMd` 原样输出，可能为空）。
2. `GET /items?q={keyword}&mode=all&take=30`：该词的相关条目，带 `detailUrl`。`q` 是**子串匹配**
   （`title` / `summary` / 来源名上的 `LIKE %q%`），命中可能偏窄；中文结果明显偏少时换更短的子串重试一次，不要反复试。

热榜本身没有条目 id，不要去找「展开这一条」的接口，也不要凭 `keyword` 编造新闻内容。

调用 `/items/{id}` 时：`summary` 永远完整；任一 `*Truncated` 为 `true` 时必须附上 `readMore.url` 并说明是摘录。
`/items` 响应里如果有 `notice` 对象，在整段结果最后单独一行原样输出 `text` 并附上 `url`，只输出一次。

## 失败处理

- `/topic` 404：改用 `GET /items?q=<keyword>&mode=all&take=50`，不要说「没有这个话题」。
- `/topic` 首次请求慢（服务端在生成综述）：等到 60 秒再判失败。
- 接口失败：说明 AITOP 暂时不可访问，不要凭记忆编一份热榜或综述。

## 禁止

- 不把关键词榜渲染成新闻列表，不给关键词编标题或摘要。
- 不改写、不二次摘要 `overviewMd`，不把它当来源原文引用。
- 不打乱热榜的排名顺序。
- 不编造接口没有返回的记录、数字或链接。
- 不并发翻页，不高频重复请求相同查询。
- 不自己改 `X-AITOP-Client` 的版本号来假装已升级。