# 短剧-公众号信息源 - 使用示例

## 基础用法

### 1. 查询今日短剧公众号日报

```bash
python3 "$SKILL_PATH/assets/daily_report.py" --latest
```

**使用场景**:用户想了解今天公众号上最火的短剧内容

**预期输出**:
- HTML日报文件:`~/Downloads/QoderReports/短剧公众号日报_2026-06-17.html`
- 终端输出题材分类表格
- 自动浏览器打开日报

---

### 2. 查询指定日期

```bash
python3 "$SKILL_PATH/assets/daily_report.py" --date 2026-06-10
```

**使用场景**:回顾某天的短剧爆款内容

**注意事项**:
- 如果指定日期数据未更新,会提示并询问是否切换
- 历史日期已有数据无需确认

---

### 3. 自定义题材查询

```bash
# 查询穿越题材
python3 "$SKILL_PATH/assets/daily_report.py" --topics "穿越,时空,重生"

# 查询霸总/甜宠题材
python3 "$SKILL_PATH/assets/daily_report.py" --topics "霸总,甜宠,总裁,虐恋"

# 查询悬疑/反转题材
python3 "$SKILL_PATH/assets/daily_report.py" --topics "悬疑,推理,反转,惊悚"
```

**使用场景**:用户关注特定题材方向的短剧内容

**查询逻辑**:
- 所有题材通过批量接口一次性查询
- 结果自动去重
- 题材聚类基于查询结果生成

---

### 4. 时间范围查询

```bash
# 查询6月短剧爆款
python3 "$SKILL_PATH/assets/daily_report.py" \
  --start-time "2026-06-01 00:00:00" \
  --end-time "2026-06-30 23:59:59"

# 查询近7天短剧
python3 "$SKILL_PATH/assets/daily_report.py" \
  --start-time "2026-06-10 00:00:00" \
  --end-time "2026-06-17 23:59:59"
```

**使用场景**:分析一段时间内的短剧趋势

---

### 5. 组合查询

```bash
# 查询穿越题材6月短剧
python3 "$SKILL_PATH/assets/daily_report.py" \
  --topics "穿越" \
  --start-time "2026-06-01 00:00:00" \
  --end-time "2026-06-30 23:59:59"
```

**使用场景**:精准定位特定题材+时间范围的内容

---

## 订阅功能

### 开启每日订阅

```bash
python3 "$SKILL_PATH/assets/daily_report.py" --subscribe
```

**效果**:
- 每日自动产出短剧公众号日报
- 日报自动保存至 `~/Downloads/QoderReports/`
- 文件名格式:`短剧公众号日报_2026-06-17.html`

### 取消订阅

```bash
python3 "$SKILL_PATH/assets/daily_report.py" --unsubscribe
```

---

## 高级用法

### 使用缓存数据

```bash
python3 "$SKILL_PATH/assets/daily_report.py" --from-cache
```

**使用场景**:快速查看最近查询的结果,避免重复调用接口

**缓存说明**:
- 缓存路径:`~/.workbuddy/cache/playlet_gzh_data.json`
- 缓存时间:1小时
- 超过1小时自动失效

---

### 指定API Key

```bash
python3 "$SKILL_PATH/assets/daily_report.py" --api-key ak_your_key_here
```

**使用场景**:使用个人API Key而非环境变量

---

### 扩大扫描范围

```bash
python3 "$SKILL_PATH/assets/daily_report.py" --count 300
```

**使用场景**:想看到更多热门短剧文章

**默认值**:200篇

---

## 常见对话示例

### 场景1:查询今日日报

```
用户:查询今天的短剧公众号日报
Agent:⚠️2026-06-16数据尚未更新
      数据更新规则:每日15:00更新前一天的数据
      当前可查询的最新日期:2026-06-14
      
      是否需要查询2026-06-14的数据?
用户:好的
Agent:(执行脚本,生成日报)
```

---

### 场景2:查询特定题材

```
用户:我想看穿越题材的短剧公众号文章
Agent:(执行脚本 --topics "穿越")
📊 共扫描 86 篇短剧文章,聚类 5 个题材方向
...
```

---

### 场景3:查询历史数据

```
用户:6月10号的短剧公众号日报有吗?
Agent:(执行脚本 --date 2026-06-10)
📊 共扫描 152 篇短剧文章,聚类 7 个题材方向
...
```

---

### 场景4:时间范围分析

```
用户:这个月的短剧趋势怎么样?
Agent:(执行脚本,计算本月时间范围)
📊 共扫描 456 篇短剧文章,聚类 9 个题材方向
...
```

---

## 输出格式说明

### 终端输出

```
## 短剧-公众号信息源 · 2026-06-17 日报

**扫描 186 篇热门短剧文章,聚类 8 个题材方向**

---

### 题材概览

| 题材 | 数量 | 占比 | 爆款亮点 |
|------|------|------|---------|
| #重生 | 45篇 | 24.2% | 《重生之我在AI圈写短剧》32.8w阅读 |
| #穿越 | 38篇 | 20.4% | 《穿越之霸总爱上我》21.5w阅读 |
| ... | ... | ... | ... |
```

### HTML日报

- 深色主题设计
- 题材卡片布局
- 每篇文章展示:封面图、标题、公众号名称、阅读量、点赞数、分享数
- 统计面板:题材数、文章数、平均阅读、总阅读

---

## 注意事项

1. **日期规则**:每日15:00更新前一天数据,查询前必须先确认日期有效性
2. **API Key**:必须配置 `REDFOX_API_KEY` 环境变量或使用 `--api-key` 参数
3. **去重机制**:基于photoId自动去重,避免重复内容
4. **题材聚类**:每天题材分类由内容动态决定,不固化
5. **平台标识**:公众号platform=2,与抖音platform=1不同