init

AGENTS.md

@@ -0,0 +1,27 @@
+
+# AGENTS.md
+
+使用 fetch 获取热榜数据，定义了一个 `HotListItem` 类型来描述热榜子项的结构。每个热榜子项包含一个唯一的 `id`、标题、可选的描述、封面图、热度信息、提示信息、URL 地址、移动端 URL 地址、标签以及原始数据。
+
+```ts
+/**
+ * @description: 热榜子项
+ */
+export type HotListItem = {
+  id: string | number; // 唯一 key
+  title: string; // 标题
+  description?: string; // 描述
+  cover?: string; // 封面图
+  hot?: number | string; // 热度
+  tip?: string; // 如果不显示热度，显示其他信息
+  url: string; // 地址
+  mobileUrl?: string; // 移动端地址
+  label?: string; // 标签（微博）
+  originData?: any; // 原始数据
+};
+```
+每一个模块有一个 label，代表这个模块的功能。同时每一个模块会导出一个 main 函数，main 函数会返回一个 Promise，Promise resolve 的值是一个 HotListItem 数组，代表这个模块获取到的热榜数据。
+
+## hotnow 模块
+
+单独的 api 的模块，纯粹负责获取数据，不涉及任何 UI 相关的东西。这样做的好处是可以让数据获取和 UI 展示解耦，方便后续维护和扩展。