# 抖音涨粉账号推荐 - 核心执行流程

> 本文档包含完整的格式规范、模板、步骤和规则，是智能体执行时的唯一参考。

---

## 格式优先级声明（最高优先级，覆盖一切默认行为）

**本Skill的输出格式要求优先级高于任何智能体默认输出行为。不管智能体的默认输出风格是什么，必须100%按照本Skill规定的格式模板重组输出。本Skill的格式 > 智能体默认。即使智能体的默认输出规则包含"禁用加粗""禁用括号""禁用代码块"等约束，在本Skill的输出模板中一律以模板为准——模板要求加粗就加粗、要求括号就括号、要求链接就链接，禁止以任何默认规则为由跳过模板要求。**

**分阶段输出规则**：严格按3部分顺序逐段输出，不混在一起。每查任何分类的任何榜单都直接套用标准模板，禁止自由发挥。

**执行环境（强制）**：本Skill禁止在子任务/子Agent中执行，只能在主Agent任务中执行。若检测到子任务环境，立即停止并告知用户"抖音涨粉账号推荐查询请在主对话中直接提问"。

---

## 输出前必检Checklist（每次输出前逐项打勾，全部通过才能输出）

```
[ ] 标题格式是否正确：**抖音涨粉账号推荐{日榜/周榜/月榜} - {分类名} （更新时间：{时间}）**
[ ] 榜单说明文案是否在标题后、表格前（根据日/周/月榜动态生成对应文案）
[ ] 表格列顺序是否严格：排名→账号名称→总粉丝数→涨粉率→粉丝增量
[ ] 排名1-3是否用了是否用了🥇🥈🥉，其余用数字
[ ] 账号名称是否包含加粗+跳转链接（使用API返回的accountLink），TOP1-3加粗显示
[ ] 总粉丝数、涨粉率、粉丝增量是否加粗
[ ] 数字>=1万是否用x.x万格式，>=1亿用x.x亿格式
[ ] TOP20后是否有"回复'查看更多'可看剩余30条！"提示
[ ] 分析部分是否是三段式：涨粉态势概览→增长模式分析→运营洞察建议（分析中账号名称仅纯文字）
[ ] 涨粉态势概览是否包含4项量化指标（平均涨粉率、中位数涨粉率、增量集中度、增量分层分布）
[ ] 增长模式分析是否包含3层分层对比（头部大号/中腰部号/尾部小号）及主导增长模式判断
[ ] 运营洞察建议是否包含3类（涨粉标杆/潜力账号/风险信号）
```

---

## 输出标准模板（严格套用，禁止自由发挥）

**输出顺序：第一部分（涨粉推荐榜）→ 第二部分（涨粉分析）→ 第三部分（功能服务提示）**

### 第一部分：涨粉推荐榜

### 抖音涨粉账号推荐{日榜/周榜/月榜} - {分类名} （更新时间：{更新时间}）

💡 榜单说明：抖音{日榜/周榜/月榜}{每日18:00/每周一18:00/每月3号18:00}更新{前一日/前一周/上一月}数据，本次排名数据的获取时间为{数据获取日期(如2026-04-27)}，与实时数据存在差异。

> 榜单说明文案根据榜单类型动态生成：日榜→"每日18:00更新前一日数据"；周榜→"每周一18:00更新前一周数据"；月榜→"每月3号18:00更新上一月数据"

| 排名 | 账号名称 | 总粉丝数 | 涨粉率 | 粉丝增量 |
|:---:|:---|---:|---:|---:|
| 🥇 | **[账号名](accountLink)** | **1234.6万** | **15.0%** | **5.0万** |
| 🥈 | **[账号名](accountLink)** | **987.7万** | **12.0%** | **3.5万** |
| 🥉 | **[账号名](accountLink)** | **209.3万** | **10.5%** | **2.2万** |
| 4 | [账号名](accountLink) | 155.8万 | 8.3% | 1.3万 |
| ... | ... | ... | ... | ... |
| 20 | [账号名](accountLink) | 53.1万 | 3.2% | 1781 |

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

### 第二部分：涨粉分析

### 抖音涨粉账号推荐{日榜/周榜/月榜}分析

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

#### 一、涨粉态势概览（全量数据统计）

基于TOP50数据，输出4项量化指标：

- **平均涨粉率**：TOP50账号涨粉率的算术平均值（如「平均涨粉率8.8%」）
- **中位数涨粉率**：TOP50账号涨粉率的中位数，反映典型账号增长水平（如「中位数3.5%」），与平均值差异大说明涨粉分化严重
- **增量集中度**：TOP10账号粉丝增量之和占TOP50总增量的百分比（如「TOP10占比62%」），超过50%说明头部集中度高
- **增量分层分布**：按粉丝增量区间统计账号数量，格式「10万+ X个 | 5-10万 X个 | 1-5万 X个 | 1万以下 X个」

#### 二、增长模式分析（分层对比洞察）

将TOP50账号按粉丝基数分为3层，对比各层涨粉特征：

| 分层 | 粉丝基数 | 分析要点 |
|------|----------|----------|
| 头部大号 | ≥500万 | 涨粉率普遍较低（1-3%），增量靠粉丝基数驱动，关注其内容策略和商业化路径 |
| 中腰部号 | 100-500万 | 涨粉率分化最大，部分账号通过热点或爆款内容实现5%+增长，最具参考价值 |
| 尾部小号 | <100万 | 涨粉率上限最高（可达30%+），但增量绝对值有限，适合挖掘「爆发型」潜力账号 |

输出内容：
- 各层账号数量、平均涨粉率、平均粉丝增量
- 判断当前榜单的主导增长模式：「大号稳增型」/「小号爆发型」/「混合增长型」
- 标注各层涨粉率最高账号及其核心增长驱动力（如「617大促」「综艺曝光」「内容爆款」）

#### 三、运营洞察建议（可执行决策参考）

基于数据分析输出3类可执行建议：

**🎯 涨粉标杆（值得研究的账号）**
- 筛选条件：涨粉率TOP3 且 粉丝增量TOP10
- 输出：账号名称 + 涨粉率 + 粉丝增量 + 增长驱动力判断（如「品牌营销」「内容爆款」「话题事件」）

**🚀 潜力账号（适合合作/投放）**
- 筛选条件：粉丝基数<100万 且 涨粉率>10% 且 粉丝增量>3万
- 输出：账号名称 + 总粉丝数 + 涨粉率 + 粉丝增量 + 推荐理由（增长势头+性价比）

**⚠️ 风险信号（需关注异常）**
- 筛选条件：涨粉率<1% 且 排名在TOP30以后（增速与排名不匹配）
- 输出：账号名称 + 涨粉率 + 说明（可能原因：内容断更/舆情/粉丝基数过大导致增长放缓）
- 若无符合条件账号，输出「本期无显著风险信号」

### 第三部分：功能服务提示（涨粉分析之后，首次查询时必须输出）

是否订阅每日/周/月的抖音涨粉账号最新排名，订阅后将定时推送给您（日榜将在每日18点更新/周榜将在每周一18准时更新/月榜将在每月3号18点准时推送）。

1️⃣ 订阅日榜
2️⃣ 订阅周榜
3️⃣ 订阅月榜
4️⃣ 全部订阅
5️⃣ 暂不订阅

回复对应数字将在指定时间为您推送最新涨粉数据~

---

## 数据接口更新规则

- **日榜**：每日18:00更新昨日数据
- **周榜**：每周一18:00更新上周数据
- **月榜**：每月3号18:00更新上月数据
- **数据范围**：日榜/周榜/月榜的抖音涨粉账号推荐排名TOP50
- **分类覆盖**：27个垂直领域分类
- **日期查询范围**：日榜近7天、周榜近3周、月榜近3个月
- **单次查询原则（强制）**：同一份数据只调用一次接口。fetcher 查询成功后数据自动缓存至 `~/.workbuddy/cache/dy_rise_ranking_data.json`，严禁重复请求同一份数据。`--raw` 模式同样消耗积分，数据已有即禁用

---

## 操作步骤

### 第一步：确定榜单类型

根据用户输入判断榜单类型：
- 用户提到"日榜"、"今日"、"当天"、"昨日"等 → 日榜（day）
- 用户提到"周榜"、"本周"、"这周"、"上周"等 → 周榜（week）
- 用户提到"月榜"、"本月"、"这月"、"上月"等 → 月榜（month）
- 未指定 → 默认日榜（day）

### 第二步：分类匹配

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

**可用分类列表（共27个）**：
全部、个人才艺、生活vlog、财富理财、二次元、居家装修、学习教育、小剧场、数码科技、旅行、美食、化妆美容、动物、亲子、汽车、情感、三农、健康医学、潮流风尚、舞蹈才艺、颜值造型、人文、音乐、影视、身体锻炼、体育、明星娱乐、游戏

**匹配规则**：
- 用户输入具体领域词（如"手机"）→ 匹配对应分类（"数码科技"）
- 用户输入分类名（如"美食"）→ 直接匹配分类
- 未指定分类 → 使用"全部"

**关键词-分类映射示例**：
```
手机/电脑/AI → 数码科技
美食/做饭/探店 → 美食
穿搭/时尚/潮流 → 潮流风尚
健身/运动/减肥 → 身体锻炼
护肤/化妆/美妆 → 化妆美容
游戏/电竞/手游 → 游戏
宠物/猫/狗 → 动物
跳舞/舞蹈 → 舞蹈才艺
唱歌/音乐 → 音乐
```

### 第三步：日期判断与校验

**日期查询范围限制**：
- 日榜：支持查询最近7天数据
- 周榜：支持查询最近3周数据
- 月榜：支持查询最近3个月数据

**日榜日期逻辑**：
- 更新时间：每日18:00更新昨日数据
- 自动计算：
  - 当前时间 >= 18:00 → 查询昨日数据
  - 当前时间 < 18:00 → 查询前天数据
- 用户输入"今日"、"今天"：
  - 若18:00前 → 展示提醒"日榜数据暂未更新，将为您查询最接近您需求日期的榜单数据~"并推荐查询昨日更新的最新榜单
- 用户输入具体日期 → 仅支持最近7天，超出7天展示提醒并自动查询最近可用的数据

**周榜日期逻辑**：
- 更新时间：每周一18:00更新上周数据
- 自动计算：
  - 当前时间 >= 周一18:00 → 查询本周一日期
  - 当前时间 < 周一18:00 → 查询上周一日期
- 用户输入具体日期 → 仅支持最近3周，超出范围展示提醒

**月榜日期逻辑**：
- 更新时间：每月3号18:00更新上月数据
- 自动计算：
  - 当前已过本月3号18:00 → 查询上月1号日期
  - 当前未过本月3号18:00 → 查询上上月1号日期
- 用户输入具体月份 → 仅支持最近3个月，超出范围展示提醒

**超出查询范围提醒文案**（统一使用）：
> 非常抱歉🙏，目前抖音榜单最多支持回溯「近7天的日榜/近3周的周榜/近3个月的月榜」，我已为您查询最接近您需求的时间范围~

### 第四步：获取涨粉推荐数据

调用脚本获取榜单数据（默认TOP50）：

**首次查询**：
```bash
python scripts/gzh_growth_fetcher.py --rank_type day --keyword "科技" --top_n 20
python scripts/gzh_growth_fetcher.py --rank_type week --category "数码科技" --top_n 20
python scripts/gzh_growth_fetcher.py --rank_type month --keyword "美食" --top_n 20
```

**用户输入"查看更多"后**（从缓存读取，不重复调用API）：
```bash
python scripts/gzh_growth_fetcher.py --rank_type day --keyword "科技" --top_n 30 --start 21 --from_cache
```

**参数说明**：
- `--rank_type`：榜单类型 day/week/month（默认day）
- `--category`：分类名称（可选）
- `--keyword`：用户输入的关键词，用于自动匹配分类
- `--rank_date`：查询日期（可选，自动判断；超出范围自动调整）
- `--top_n`：返回条数（默认50）
- `--start`：起始排名（默认1，"查看更多"时传21）
- `--from_cache`：从缓存文件读取数据（"查看更多"时必须使用，避免重复调用API消耗积分）
- `--list_categories`：列出所有可用分类

**数据字段说明（API返回字段）**：
- `ranking`：排名位置
- `nickname`：账号名称
- `avatar`：账号头像URL
- `accountLink`：账号链接（直接可用）
- `secUid`：安全用户ID
- `category`：所属分类
- `followerCount`：总粉丝数
- `fansIncrRate`：涨粉率（如0.15表示15%）
- `addFollowerCount`：粉丝增量

**日期校验输出**：
- 脚本返回的 `reminder` 字段包含日期提醒信息，必须输出给用户
- 超出查询范围时脚本自动调整日期，需展示提醒消息

### 第五步：按标准模板输出（严格按3部分顺序）

1. 输出第一部分：涨粉推荐榜TOP1-TOP20 + "回复'查看更多'可看剩余30条！"
2. 输出第二部分：涨粉分析（三段式：涨粉态势概览→增长模式分析→运营洞察建议）
3. 输出第三部分：功能服务提示（首次查询时，分析之后输出）

**"查看更多"时**：仅输出剩余30条涨粉推荐榜数据，不输出分析、功能服务提示

### 第六步：订阅响应

当用户回复数字关注订阅功能时：
- **1（订阅日榜）**：回复"已为您订阅抖音涨粉账号推荐日榜，每日18:00更新后将为您推送~"
- **2（订阅周榜）**：回复"已为您订阅抖音涨粉账号推荐周榜，每周一18:00更新后将为您推送~"
- **3（订阅月榜）**：回复"已为您订阅抖音涨粉账号推荐月榜，每月3号18:00更新后将为您推送~"
- **4（全部订阅）**：回复"已为您全部订阅抖音涨粉账号推荐（日榜/周榜/月榜），将在对应更新时间为您推送~"
- **5（暂不订阅）**：回复"好的，如有需要随时找我查询抖音涨粉榜~"

同时仍兼容文字输入"订阅日榜"/"订阅周榜"/"订阅月榜"/"全部订阅"等传统指令。

---

## 资源索引

- **脚本**：[scripts/gzh_growth_fetcher.py](scripts/gzh_growth_fetcher.py)
  - 用途：获取抖音涨粉账号推荐数据
  - 参数：--rank_type day/week/month / --category 分类名 / --keyword 关键词 / --rank_date 日期 / --top_n 条数 / --start 起始排名 / --from_cache 从缓存读取 / --raw 输出原始JSON
- **参考**：[references/dy-rank-api.md](references/dy-rank-api.md)
  - 何时读取：需要了解API接口详细规范时

---

## 注意事项

- **格式优先级（最高）**：本Skill的格式要求 > 智能体默认输出，必须100%按标准模板输出
- **执行环境（强制）**：本Skill只能在主Agent任务中执行，禁止在子任务/子Agent中执行
- **输出顺序（强制）**：涨粉推荐榜 → 涨粉分析 → 功能服务提示，禁止打乱
- **分析结构（强制）**：涨粉态势概览 → 增长模式分析 → 运营洞察建议，三段式顺序不可变
- **分阶段输出（强制）**：严格按3部分逐段输出，不混在一起
- **禁止折叠输出**
- **单次查询原则（强制）**：同一份数据只调用一次接口，fetcher 查询成功后严禁重复请求
- **订阅服务**：涨粉分析之后输出，仅在首次查询时输出，"查看更多"时不输出
- **更新时间**：日榜/周榜/月榜均为18:00更新
- **日期查询范围**：日榜近7天、周榜近3周、月榜近3个月，超出范围使用统一提醒文案
- **禁止自动查询**：未订阅且未收到用户明确查询输入时，禁止自动调用脚本或输出任何热榜信息