## 任务目标

- 本 Skill 用于：获取小红书七日爆款笔记数据
- 能力包含：
  - 七日爆款笔记数据获取（按分类查询）
  - 七日热门笔记智能分析
  - 冷门爆款笔记挖掘（关键词匹配分类）
  - 订阅服务（每日定时推送）
- 触发条件：用户询问小红书热门内容、爆款笔记、各领域趋势分析

## 数据接口更新规则

- **更新时间**：每天19:00更新昨天的榜单数据
- **数据范围**：往前7天的热门笔记TOP50
- **分类覆盖**：25个垂直领域分类

## 调用 Key 说明

Agent 调用脚本时必须按以下参数规范执行：

| 参数 | 适用脚本 | 必填 | 说明 |
|------|----------|------|------|
| `--keyword` | 两者 | 推荐 | 用户输入关键词，用于自动匹配分类 |
| `--category` | 两者 | 否 | 直接指定分类名（25 个分类之一），与 `--keyword` 二选一或配合使用 |
| `--rank_date` | 两者 | 否 | 查询日期，格式 `YYYY-MM-DD`；未指定则按日期判断规则自动推断 |
| `--top_n` | `xhs_weekly_fetcher.py` | 否 | 返回条数，执行时固定传 `50` |
| `--top` | `gen_xhs_html.py` | 否 | HTML 展示条数：首次输出 `20`，用户「查看更多」后传 `50` 或实际数据条数 |
| `--output` | `gen_xhs_html.py` | 否 | HTML 输出文件路径，未指定则使用脚本默认路径 |
| `--list_categories` | `xhs_weekly_fetcher.py` | 否 | 列出所有可用分类（调试时使用） |

**调用示例**：

```bash
# 获取榜单数据（固定 top_n=50）
python scripts/xhs_weekly_fetcher.py --keyword "睫毛膏" --top_n 50

# 首次生成 HTML（top=20）
python scripts/gen_xhs_html.py --keyword "睫毛膏" --top 20

# 查看更多后生成完整 HTML（top=50）
python scripts/gen_xhs_html.py --keyword "睫毛膏" --top 50

# 指定日期与分类
python scripts/xhs_weekly_fetcher.py --rank_date "2026-04-15" --category "时尚穿搭" --top_n 50
python scripts/gen_xhs_html.py --rank_date "2026-04-15" --category "时尚穿搭" --top 20
```

## 输出规范（强制执行）

**数据一致性要求（重要）**：

- 七日爆款笔记表格与HTML页面数据必须完全一致（相同排序、相同内容）
- 两个脚本使用相同的API接口和排序逻辑（互动数优先，备用计算：点赞+收藏*2+评论*3+分享\*5）
- 禁止胡乱渲染或使用不同数据源

**输出内容必须严格包含以下三部分，禁止遗漏或胡乱输出：**

- **七日爆款笔记（更新时间）**：必须直接输出，禁止折叠
- **七日热门笔记分析**：必须直接输出，禁止折叠
- **功能询问（HTML+订阅）**：必须在分析之后立即输出，禁止跳过

**输出格式要求（强制执行）**：

- **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出
- **禁止输出文件**：除HTML文件包外，禁止输出任何其他文件（如CSV、JSON、TXT等）
- **HTML文件包必须输出实际文件，禁止只输出文件路径，禁止折叠输出**

**输出顺序（严格按此顺序执行，禁止混乱输出，禁止遗漏）**：

1. 🔥 七日爆款笔记（含更新时间）
2. 📊 七日热门笔记分析（3个模块：热门内容分析、爆款标题分析、最高数据作品分析）
3. 功能询问（HTML生成 + 订阅服务，分析完成后立即展示，禁止等待用户回复）

### 第一部分：七日爆款笔记（必须包含更新时间）

**输出要求**：

- 必须直接完整输出表格内容
- 禁止折叠、隐藏或展开表格
- 禁止输出为文件格式
- **表格字段和数据必须加载完整，加载失败则再次尝试**

- 标题格式：**🔥 【{分类名称}】七日爆款笔记 （更新时间：YYYY-MM-DD HH:MM:SS）**（标题整体加粗）
- 标题示例：**🔥 【化妆美容】七日爆款笔记 （更新时间：2025-01-15 10:30:00）**

- **表格输出格式（严格按此格式执行，使用标准 Markdown 表格格式）**：

| 排名 | 笔记信息                               |      互动数       |       点赞        |       评论       |       收藏       |       分享        |
| :--: | :------------------------------------- | :---------------: | :---------------: | :--------------: | :--------------: | :---------------: |
|  🥇  | [笔记标题链接]<br>[作者名链接] 粉丝数+ | 22w+<br>↑新增23w+ | 22w+<br>↑新增21w+ | 893<br>↑新增21w+ | 1w+<br>↑新增21w+ | 1w+<br>↑新增21w+  |
|  🥈  | [笔记标题链接]<br>[作者名链接] 粉丝数+ | 20w+<br>↑新增18w+ | 18w+<br>↑新增16w+ | 756<br>↑新增18w+ | 8k+<br>↑新增16w+ | 900+<br>↑新增16w+ |
|  🥉  | [笔记标题链接]<br>[作者名链接] 粉丝数+ | 18w+<br>↑新增15w+ | 15w+<br>↑新增13w+ | 621<br>↑新增15w+ | 7k+<br>↑新增13w+ | 800+<br>↑新增13w+ |

**字段详细说明**：

- **排名**：1-3名显示🥇🥈🥉，其余显示数字
- **笔记信息**：
  - 第一行：笔记标题（可点击跳转）
  - 第二行：[作者名链接] 粉丝数+（作者名可点击跳转到作者主页，字号与标题一样大）
- **互动数**：
  - 第一行：累计互动数（格式：数字w+ 或 纯数字）
  - 第二行：↑新增数字w+（"↑新增"字号小一号，正常文字颜色，不换行）
- **点赞**：
  - 第一行：累计点赞数（格式：数字w+ 或 纯数字）
  - 第二行：↑新增数字w+（"↑新增"字号小一号，正常文字颜色，不换行）
- **评论**：
  - 第一行：累计评论数（格式：数字w+ 或 纯数字）
  - 第二行：↑新增数字w+（"↑新增"字号小一号，正常文字颜色，不换行）
- **收藏**：
  - 第一行：累计收藏数（格式：数字w+ 或 纯数字）
  - 第二行：↑新增数字w+（"↑新增"字号小一号，正常文字颜色，不换行）
- **分享**：
  - 第一行：累计分享数（格式：数字w+ 或 纯数字）
  - 第二行：↑新增数字w+（"↑新增"字号小一号，正常文字颜色，不换行）
  - **分享字段必须展示且不能出错**

**重要说明**：

- 使用标准 Markdown 表格格式
- 单元格内使用 `<br>` 换行显示累计数据和新增数据
- 累计数据：大于等于1万显示"数字w+"，小于1万显示纯数字（不显示"累计："文案）
- 新增数据格式：累计数据 <br> ↑新增数字w+ 或 ↑新增纯数字（"↑新增"字号小一号，正常文字颜色）
- 每个数据单元格占两行：第一行累计数据，第二行"↑新增数值"（不换行）
- "↑新增"文案字号比累计数据小一号
- "↑新增数值"使用正常文字颜色显示，与累计数据在同一行

**数据输出逻辑（必须严格执行）**：

- **首次输出**：
  - 七日爆款笔记表格：显示TOP1到TOP20
  - HTML页面：显示TOP1到TOP20（与热榜表格保持一致）
  - **"查看更多"提示逻辑**（必须严格执行）：
    - 如果返回数据 ≤ 20条：不展示"查看更多"提示
    - 如果返回数据 > 20条：展示"回复"查看更多"可看剩余{数量}条！✨"（显示剩余数据条数）
    - 如果返回数据 = 50条：展示"回复"查看更多"可看剩余30条！✨"（固定30条）
- **用户输入"查看更多"后**：
  - 七日爆款笔记表格：输出TOP21到实际数据末尾（延续之前的TOP20）
  - HTML页面：输出TOP1到实际数据末尾（完整数据，覆盖之前的HTML文件）

### 第二部分：七日热门笔记分析

**输出要求**：

- 必须直接完整输出3个模块内容（热门内容分析、爆款标题分析、最高数据作品分析）
- 禁止折叠、隐藏或展开任何模块
- 禁止输出为文件格式
- 所有分析内容都基于获取到的所有数据
- **表格字段和数据必须加载完整，加载失败则再次尝试**
- **必须包含3个模块，禁止遗漏**

- 标题格式：**📊 七日热门笔记分析（Top{数据条数}）**
- 示例：**📊 七日热门笔记分析（Top50）**

以下内容分析基于获取的全部数据（Top{数据条数}）进行~

**💡热门内容分析**

| 内容分类 | 内容特征                                                                                                                                                                           | 实际效果      | 参考笔记                           |
| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ | :--------------------------------- |
| 封面设计 | 采用高清摄影或设计软件精心制作的封面图，画面构图饱满、色彩搭配协调，同时加入醒目的文字标题或标签，突出核心卖点或吸引眼球的元素，通过强烈的视觉冲击力在用户快速浏览时瞬间抓住注意力 | 点击率提升45% | [笔记标题链接1]<br>[笔记标题链接2] |
| 内容创作 | 围绕用户痛点或情感共鸣点展开叙事，采用第一人称视角分享真实经历或心得，结合表情符号和分段排版增强可读性，适当设置悬念或反转，激发用户的情感共鸣和参与欲望                           | 互动率提升50% | [笔记标题链接3]<br>[笔记标题链接4] |
| 内容价值 | 提供具体可操作的步骤、方法或技巧，配合清晰的图片展示和简明的文字说明，确保用户看完后能够直接复用或实践，内容具有较高的实用价值和参考意义，值得用户收藏备查                         | 收藏率提升55% | [笔记标题链接5]<br>[笔记标题链接6] |
| 热点结合 | 紧跟当前热门话题、节日或社会热点，将自身内容与热点元素巧妙结合，使用相关话题标签增加曝光机会，借助热点的流量优势快速提升笔记的传播范围和影响力                                     | 曝光率提升40% | [笔记标题链接7]<br>[笔记标题链接8] |

**📈爆款标题分析**

| 标题类型 | 标题特征                                                                                                           | 标题模版         | 发布规律             | 参考标题                 |
| :------- | :----------------------------------------------------------------------------------------------------------------- | :--------------- | :------------------- | :----------------------- |
| 提问式   | 标题以疑问句开头，设置悬念或提出用户关心的问题，引发用户的好奇心和思考欲望，激发点击阅读或评论互动                 | "你还在XX吗？"   | 工作日早高峰效果最佳 | 这个方法你还在用吗？     |
| 数字式   | 标题中包含具体的数字、数量或统计数据，利用人们对量化信息的偏好，增强内容的可信度和专业感，让用户觉得内容有价值     | "XX个XX技巧"     | 午餐时间点击率高     | 5个快速提升XX的技巧      |
| 情绪词   | 使用具有强烈情感色彩的词汇或网络流行语，如"绝了"、"太XX了"等，直接触发用户的情绪反应，引发点赞、评论或分享行为     | "太XX了！忍不住" | 晚间黄金时段转化高   | 太好用了！忍不住分享给你 |
| 利益点   | 直接在标题中明确承诺用户可以获得的具体利益或效果，如"XX天就能XX"、"省XX元"等，降低用户决策成本，提高点击率和收藏率 | "XX天就能XX"     | 深夜发布收藏率最高   | 7天就能看到明显效果      |

**✨最高数据作品分析**

| 维度     | 核心特征分析                                                                     | 参考笔记       |
| :------- | :------------------------------------------------------------------------------- | :------------- |
| 最高点赞 | 风格：具体风格描述<br>特征：详细特征说明<br>数据效果：效果数据<br>建议：具体建议 | [笔记标题链接] |
| 最高收藏 | 风格：具体风格描述<br>特征：详细特征说明<br>数据效果：效果数据<br>建议：具体建议 | [笔记标题链接] |
| 最高评论 | 风格：具体风格描述<br>特征：详细特征说明<br>数据效果：效果数据<br>建议：具体建议 | [笔记标题链接] |
| 最高互动 | 风格：具体风格描述<br>特征：详细特征说明<br>数据效果：效果数据<br>建议：具体建议 | [笔记标题链接] |

### 第三部分：功能询问（HTML生成 + 订阅服务）

**强制要求（必须严格遵守）**：

- 必须在七日热门笔记分析输出完成后立即展示，不得提前或插入其他内容
- 不需要等待用户回复，分析完成后立即执行
- 用户可选择生成 HTML 文件包、订阅推送或两者都选
- **禁止跳过，禁止遗漏**

**询问内容**：

```
技能还支持以下功能：
1️⃣ 支持订阅小红书七日爆款笔记。订阅后将在每日19:30为您推送小红书七日爆款笔记TOP50。直接回复"订阅或 1"即可订阅相关内容。
2️⃣ 可生成小红书风格的html文件包。支持导出PDF，方便阅读、保存和分享。
```

回复对应的数字即可。

**HTML 生成逻辑**：

- 用户回复 `2` 或 "html" 或 "生成" 后，执行 HTML 生成
- HTML 生成时**禁止再次调用 API**，必须从已获取的数据中读取
- 脚本 `xhs_weekly_fetcher.py` 在获取数据后会**自动保存** JSON 到 `scripts/../.cache/xhs_weekly_{分类}_{日期}.json`，并输出保存路径
- Agent 从 fetcher 输出中提取 JSON 文件路径，直接传给 `gen_xhs_html.py --data_file <JSON文件路径> --top N`
- HTML 文件名格式：`小红书七日爆款笔记_{分类}_{唯一时间戳}.html`

**执行命令**：

- 首次生成：`python scripts/gen_xhs_html.py --data_file <已获取的JSON数据文件> --category "{分类}" --top 20`
- 查看更多后：`python scripts/gen_xhs_html.py --data_file <已获取的JSON数据文件> --category "{分类}" --top 50`

**文件特点**：

- 可独立打开的HTML文件
- 支持直接点击链接跳转
- 支持导出图片和PDF功能（导出结果与页面显示完全一致）
- HTML页面样式：页面宽度700px，前三名序号更大（36px），互动数据与头像边界对齐，新增数据显示为"↑新增数值"格式
- 数据展示：包含排名、标题、作者、粉丝数、互动数、点赞、评论、收藏、分享（含新增数据）

**订阅逻辑**：

- 用户回复 `1` 或 "订阅" 后，创建每日 19:30 推送的自动化任务
- 小红书七日爆款笔记推荐TOP50，按每日19:30更新

## 数据输出逻辑详解

**核心原则**：

- 七日爆款笔记表格与HTML页面必须保持数据一致性
- HTML 生成时从已获取的数据文件读取，**禁止再次调用 API**

### 阶段一：首次输出

1. **七日爆款笔记表格**：
   - 调用脚本获取数据（最多50条），脚本会自动保存 JSON 到 `.cache/` 目录
   - Agent 从脚本输出中提取 JSON 缓存路径（`原始数据已保存到: ...`）
   - 展示TOP1到TOP20（前20条）
   - **"查看更多"提示逻辑（根据实际数据量动态调整）**：
     - 如果返回数据 ≤ 20条：不展示"查看更多"提示
     - 如果返回数据 > 20条且 < 50条：展示"回复"查看更多"可看剩余{实际剩余数量}条！✨"
     - 如果返回数据 = 50条：展示"回复"查看更多"可看剩余30条！✨"（固定30条）

2. **功能询问**：
   - 在七日分析完成后立即展示功能询问（HTML生成 + 订阅服务）
   - 等待用户回复后再执行对应操作

3. **HTML生成（用户选择后）**：
   - 从第一步自动保存的 JSON 缓存文件读取，**禁止再次调用 API**
   - 执行命令：`python scripts/gen_xhs_html.py --data_file <自动缓存的JSON路径> --category "{分类}" --top 20`
   - 生成 HTML 文件，文件名格式：`小红书七日爆款笔记_{分类}_{时间戳}.html`
   - **生成后必须立即调用 `preview_url` 展示页面**，输出文件路径并自动预览；若未正常展示则用 `open_result_view` 兜底

### 阶段二：用户输入"查看更多"

1. **七日爆款笔记表格**：
   - 继续展示TOP21到实际数据末尾（根据实际数据量）
   - 延续首次输出的数据，不重复TOP1-20

2. **HTML重新生成（如用户选择）**：
   - 从第一步自动缓存的 JSON 文件读取完整数据
   - 执行命令：`python scripts/gen_xhs_html.py --data_file <临时JSON文件> --category "{分类}" --top 50`
   - 覆盖之前的 HTML 文件

### 数据一致性保障

- 两个脚本使用相同的API接口
- 相同的排序逻辑（互动数优先，备用计算）
- 相同的数据字段和格式
- 确保表格和HTML页面的排名、数据完全一致

## 操作步骤

### 标准流程

#### 第一步：分类匹配

根据用户输入自动匹配合适的分类：

**可用分类列表（共25个）**：
综合全部、出行代步、休闲爱好、影视娱乐、数码科技、医疗保健、综合杂项、星座情感、时尚穿搭、婚庆婚礼、拍摄记录、学习教育、化妆美容、居家装修、旅行度假、亲子育儿、个人护理、美味佳肴、职业发展、宠物天地、潮流鞋包、日常生活、科学探索、新闻资讯、体育锻炼

**匹配规则**：

- 用户输入具体产品词（如"睫毛膏"）→ 匹配对应分类（"化妆美容"）
- 用户输入领域词（如"穿搭"、"美食"）→ 直接匹配分类
- 未指定分类 → 使用"综合全部"

**关键词-分类映射示例**：

```
睫毛膏/口红/粉底 → 化妆美容
穿搭/衣服/时尚 → 时尚穿搭
美食/做饭/探店 → 美味佳肴
猫/狗/宠物 → 宠物天地
游戏/王者/电竞 → 休闲娱乐
```

#### 第二步：查询冷门爆款笔记

- 用户输入关键词后，自动匹配对应分类（**不告知用户匹配到的分类名称**）
- 查询该分类下的冷门爆款笔记（最多50条）
- **根据实际数据量动态展示**：
  - 如果返回数据 ≤ 20条：默认展示全部数据，不展示"查看更多"提示
  - 如果返回数据 > 20条：默认展示TOP20，展示"回复"查看更多"可看剩余{数量}条！✨"提示
  - 如果返回数据 = 50条：默认展示TOP20，展示"回复"查看更多"可看剩余30条！✨"提示

#### 第三步：日期判断

根据用户输入和当前时间确定查询日期：

**判断规则**：

1. **用户指定了日期** → 直接使用指定日期
2. **用户未指定日期**：
   - 当前时间 >= 19:00 → 查询**昨日**数据（当日19:00已更新）
   - 当前时间 < 19:00 → 查询**前天**数据（等待当日19:00更新）

#### 第四步：获取七日爆款笔记数据

调用脚本获取榜单数据：

```bash
python scripts/xhs_weekly_fetcher.py --keyword "睫毛膏" --top_n 50
```

参数详见上方「调用 Key 说明」。

**自动保存 JSON 数据**：脚本获取数据后会自动将原始 JSON 保存到 `.cache/` 目录，并输出保存路径（如 `原始数据已保存到: .../xhs_weekly_化妆美容_2026-05-26.json`）。Agent 需记住此路径，供后续 HTML 生成使用。

**数据完整性要求**：

- 确保表格所有字段和数据完整加载
- 如果数据加载失败或字段缺失，必须重新调用脚本再次尝试
- 直到所有字段（排名、笔记信息、互动数、点赞、评论、收藏、分享）都有完整数据
- **分享字段使用正确的API字段名**：`AnaAddBean.useShareCount`（累计分享数）、`AnaAddBean.addShareCount`（新增分享数）
- **确保分享数值正确输出，避免使用错误的字段名导致数值不对**

#### 第五步：输出七日爆款笔记和七日分析

按照输出规范，依次输出：

1. 七日爆款笔记（含更新时间）
2. 七日热门笔记分析（3个模块）

#### 第六步：展示功能询问

**重要要求：必须在七日分析输出完成后立即展示，不需要等待用户回复**

展示内容：

```
技能还支持以下功能：
1️⃣ 支持订阅小红书七日爆款笔记。订阅后将在每日19:30为您推送小红书七日爆款笔记TOP50。直接回复"订阅或 1"即可订阅相关内容。
2️⃣ 可生成小红书风格的html文件包。支持导出PDF，方便阅读、保存和分享。
```

回复对应的数字即可。

#### 第七步：用户选择后执行对应操作

**用户回复 1 / "订阅"**：
- 创建每日 19:30 推送的自动化任务
- 推送内容：小红书七日爆款笔记推荐TOP50

**用户回复 2 / "html" / "生成"**：
- **禁止再次调用 API**，从已获取的数据文件中读取
- 首次生成（TOP20）：`python scripts/gen_xhs_html.py --data_file <临时JSON文件> --category "{分类}" --top 20`
- 查看更多后生成（完整数据）：`python scripts/gen_xhs_html.py --data_file <临时JSON文件> --category "{分类}" --top 50`
- HTML 文件名格式：`小红书七日爆款笔记_{分类}_{唯一时间戳}.html`
- **HTML 生成后必须立即调用 `preview_url` 直接展示页面**，让用户无需手动查找文件即可浏览报告

**输出格式**：

HTML 生成后，Agent 必须执行以下步骤：
1. 优先调用 `preview_url` 工具直接展示 HTML 页面，让用户在对话中即可浏览完整报告
2. 若 `preview_url` 未能正常展示（用户反馈看不到），立即改用 `open_result_view` 兜底展示
3. 同时输出文件路径，方便用户后续查找

```
📁 HTML文件包已生成 路径：/path/to/小红书七日爆款笔记_综合_20260528160530.html
```

## 订阅服务说明

### 订阅内容

**小红书七日热门笔记推荐TOP50**

- 每日19:30更新
- 推送往前7天的50篇热门内容
- 包含完整分析和HTML文件

### 订阅输出格式

📅 小红书七日热门笔记推荐（2026-04-15 19:30每日更新往前7天的50篇内容）

**🔥 【综合全部】七日爆款笔记** （更新时间：2026-04-15 19:30:00）

| 排名 | 笔记信息                         |     互动数      |       点赞        |       评论        |       收藏        |       分享        |
| :--: | :------------------------------- | :-------------: | :---------------: | :---------------: | :---------------: | :---------------: |
|  🥇  | [笔记标题链接]<br>作者名 粉丝数+ | 8w+<br>↑新增1w+ | 5w+<br>↑新增5000+ | 2w+<br>↑新增2000+ | 1w+<br>↑新增1000+ | 800+<br>↑新增500+ |

回复"查看更多"可看剩余30条！✨

**📊 七日热门笔记分析（Top50）**

以下内容分析基于获取的全部数据（Top50）进行~

**💡热门内容分析**

| 内容分类 | 内容特征                                                                                                                                                                           | 实际效果      | 参考笔记                           |
| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ | :--------------------------------- |
| 封面设计 | 采用高清摄影或设计软件精心制作的封面图，画面构图饱满、色彩搭配协调，同时加入醒目的文字标题或标签，突出核心卖点或吸引眼球的元素，通过强烈的视觉冲击力在用户快速浏览时瞬间抓住注意力 | 点击率提升45% | [笔记标题链接1]<br>[笔记标题链接2] |
| 内容创作 | 围绕用户痛点或情感共鸣点展开叙事，采用第一人称视角分享真实经历或心得，结合表情符号和分段排版增强可读性，适当设置悬念或反转，激发用户的情感共鸣和参与欲望                           | 互动率提升50% | [笔记标题链接3]<br>[笔记标题链接4] |
| 内容价值 | 提供具体可操作的步骤、方法或技巧，配合清晰的图片展示和简明的文字说明，确保用户看完后能够直接复用或实践，内容具有较高的实用价值和参考意义，值得用户收藏备查                         | 收藏率提升55% | [笔记标题链接5]<br>[笔记标题链接6] |
| 热点结合 | 紧跟当前热门话题、节日或社会热点，将自身内容与热点元素巧妙结合，使用相关话题标签增加曝光机会，借助热点的流量优势快速提升笔记的传播范围和影响力                                     | 曝光率提升40% | [笔记标题链接7]<br>[笔记标题链接8] |

**📈爆款标题分析**

| 标题类型 | 标题特征                                                                                                           | 标题模版         | 发布规律             | 参考标题                 |
| :------- | :----------------------------------------------------------------------------------------------------------------- | :--------------- | :------------------- | :----------------------- |
| 提问式   | 标题以疑问句开头，设置悬念或提出用户关心的问题，引发用户的好奇心和思考欲望，激发点击阅读或评论互动                 | "你还在XX吗？"   | 工作日早高峰效果最佳 | 这个方法你还在用吗？     |
| 数字式   | 标题中包含具体的数字、数量或统计数据，利用人们对量化信息的偏好，增强内容的可信度和专业感，让用户觉得内容有价值     | "XX个XX技巧"     | 午餐时间点击率高     | 5个快速提升XX的技巧      |
| 情绪词   | 使用具有强烈情感色彩的词汇或网络流行语，如"绝了"、"太XX了"等，直接触发用户的情绪反应，引发点赞、评论或分享行为     | "太XX了！忍不住" | 晚间黄金时段转化高   | 太好用了！忍不住分享给你 |
| 利益点   | 直接在标题中明确承诺用户可以获得的具体利益或效果，如"XX天就能XX"、"省XX元"等，降低用户决策成本，提高点击率和收藏率 | "XX天就能XX"     | 深夜发布收藏率最高   | 7天就能看到明显效果      |

**✨最高数据作品分析**

| 维度     | 核心特征分析                                                                     | 参考笔记       |
| :------- | :------------------------------------------------------------------------------- | :------------- |
| 最高点赞 | 风格：具体风格描述<br>特征：详细特征说明<br>数据效果：效果数据<br>建议：具体建议 | [笔记标题链接] |
| 最高收藏 | 风格：具体风格描述<br>特征：详细特征说明<br>数据效果：效果数据<br>建议：具体建议 | [笔记标题链接] |
| 最高评论 | 风格：具体风格描述<br>特征：详细特征说明<br>数据效果：效果数据<br>建议：具体建议 | [笔记标题链接] |
| 最高互动 | 风格：具体风格描述<br>特征：详细特征说明<br>数据效果：效果数据<br>建议：具体建议 | [笔记标题链接] |

**📁 HTML文件包**

```

**订阅服务（是否需要订阅小红书七日热门笔记推荐？）**
1. 每日19:30-推送小红书七日热门笔记TOP50
2. 暂不需要-仅本次查询

请回复数字或"取消"。

## 使用示例

### 示例1：关键词查询（数据=50条）
- **场景/输入**："帮我查一下睫毛膏相关的爆款笔记"
- **执行流程**：
  1. 匹配分类：睫毛膏 → 化妆美容
  2. 查询化妆美容分类，返回50条数据，保存JSON到临时文件
  3. 七日爆款笔记表格展示TOP1-20
  4. 展示"回复"查看更多"可看剩余30条！✨"提示
  5. 输出完整分析（热门内容分析、爆款标题分析、最高数据作品分析）
  6. **展示功能询问**（HTML生成 + 订阅服务）
  7. 用户选择后执行对应操作（HTML从临时JSON文件读取，不再调用API）

### 示例2：泛查询热门内容（数据=30条）
- **场景/输入**："最近小红书有什么热门内容"
- **执行流程**：
  1. 使用"综合全部"分类
  2. 查询后返回30条数据，保存JSON到临时文件
  3. 七日爆款笔记表格展示TOP1-20
  4. 展示"回复"查看更多"可看剩余10条！✨"提示
  5. 输出完整分析（热门内容分析、爆款标题分析、最高数据作品分析）
  6. **展示功能询问**（HTML生成 + 订阅服务）

### 示例3：数据不足20条（数据=15条）
- **场景/输入**："查询某个冷门分类"
- **执行流程**：
  1. 匹配对应分类
  2. 查询后返回15条数据，保存JSON到临时文件
  3. 七日爆款笔记表格展示TOP1-15（全部数据）
  4. 不展示"查看更多"提示（数据未超过20条）
  5. 输出完整分析（热门内容分析、爆款标题分析、最高数据作品分析）
  6. **展示功能询问**（HTML生成 + 订阅服务）

### 示例4：查看更多内容
- **场景/输入**：用户回复"查看更多"
- **执行流程**：
  1. 七日爆款笔记表格展示TOP21-实际数据末尾（延续之前的数据）
  2. 如用户选择生成HTML，从临时JSON文件读取完整数据重新生成

## 资源索引
- **脚本**：见 [scripts/xhs_weekly_fetcher.py](scripts/xhs_weekly_fetcher.py)
  - 用途：获取小红书七日爆款笔记数据
  - 参数：详见上方「调用 Key 说明」
- **脚本**：见 [scripts/gen_xhs_html.py](scripts/gen_xhs_html.py)
  - 用途：生成可视化HTML页面
  - 参数：详见上方「调用 Key 说明」

## 注意事项
- 数据每日19:00更新昨天的榜单
- **输出内容（强制，禁止遗漏，禁止胡乱输出）**：必须严格包含七日爆款笔记（更新时间）+ 七日热门笔记分析 + 功能询问
  - 🔥 七日爆款笔记（必须包含更新时间）
  - 📊 七日热门笔记分析（3个模块：热门内容分析、爆款标题分析、最高数据作品分析）
  - 功能询问（HTML生成 + 订阅服务，分析完成后立即展示）
  - **禁止输出遗漏，禁止胡乱输出，必须严格按照此3项内容输出**
- **输出格式要求（强制）**：
  - **禁止折叠输出**：所有内容必须直接完整输出，禁止使用折叠、隐藏、展开等任何形式的折叠输出
  - **禁止输出文件**：除HTML文件包外，禁止输出任何其他文件（如CSV、JSON、TXT等）
  - **输出顺序**：严格按照七日爆款笔记 → 七日分析 → HTML文件包 → 订阅服务的顺序执行，禁止混乱输出
- **输出顺序（严格按此顺序执行，禁止混乱输出）**：
  1. **🔥 七日爆款笔记**（含更新时间，展示互动数/点赞/评论/收藏及新增数据，**不显示匹配到的分类名称**）
  2. **📊 七日热门笔记分析**（💡热门内容分析、📈爆款标题分析、✨最高数据作品分析）
  3. **功能询问**（必须在分析之后展示，提供HTML生成和订阅推送选项）
- **HTML文件包输出要求（强制）**：
  - 必须在用户选择生成后才执行，不得自动生成
  - **禁止再次调用 API**，必须从已获取的数据文件中读取
  - HTML 文件名格式：`小红书七日爆款笔记_{分类}_{唯一时间戳}.html`
  - **生成后必须立即调用 `preview_url` 在对话中直接展示页面**，禁止只输出文件路径
  - **若 `preview_url` 未正常展示（含中文路径等兼容问题），立即改用 `open_result_view` 兜底**
  - **PDF和图片导出内容一定是正确的**
- **功能询问输出要求（强制，必须执行）**：
  - 必须在七日分析输出完成后立即展示
  - **禁止跳过，禁止遗漏，禁止等待用户回复**
  - 提供两个选项：订阅推送 或 生成HTML文件包
  - 用户可回复数字或关键词选择对应功能
- **数据一致性要求**：七日爆款笔记表格与HTML页面必须使用相同的数据源和排序逻辑，确保完全一致
- **数据完整性要求（强制）**：
  - 表格所有字段和数据必须完整加载
  - 如果数据加载失败或字段缺失，必须重新调用脚本再次尝试
  - 直到所有字段都有完整数据（七日爆款笔记7个字段、七日分析所有表格字段）
- **数据输出逻辑（必须严格执行）**：
  - 首次输出：七日爆款笔记TOP1-20，HTML页面TOP1-20（保持一致）
  - 查看更多：七日爆款笔记TOP21-实际数据末尾，HTML页面TOP1-实际数据末尾（完整数据）
  - **"查看更多"提示逻辑**：
    - 数据 ≤ 20条：不展示
    - 数据 > 20条且 < 50条：展示"回复"查看更多"可看剩余{数量}条！✨"
    - 数据 = 50条：展示"回复"查看更多"可看剩余30条！✨"
- 表格字段：排名、笔记信息、互动数（新增互动）、点赞（新增点赞）、评论（新增评论）、收藏（新增收藏）、分享（新增分享，**必须展示且不能出错，避免胡乱输出**）
- 七日分析包含：热门内容分析、爆款标题分析、最高数据作品分析
- 七日分析标题后显示"以下内容分析基于获取的全部数据（Top{数据条数}）进行~"
- 分析内容从创作者视角出发，提供可执行建议