# 案例 7：live 采集常见错误修复

## 这个案例解决什么问题

当真实采集失败时，知道怎么判断下一步，而不是停在错误提示里。

## 你需要准备什么

- 已安装 VOC 技能包
- 一个测试采集任务
- 如需 live，准备可用 VOC_TOKEN

## 常见状态

| 状态 | 含义 | 处理方式 |
| --- | --- | --- |
| `needs_token` | 没检测到 token | 配置 `.env.local` |
| `needs_valid_token` | token 无效 | 重新配置有效 token |
| `needs_recharge` | 确实需要开通或充值 | 打开充值链接 |
| `needs_keyword_fix` | 关键词或搜索入参问题 | 换短关键词重试 |
| `no_live_samples` | 没采到有效样本 | 换关键词或扩大范围 |

## 抖音关键词修复示例

| 原关键词 | 修复后 |
| --- | --- |
| `茶饮18元22元` | `茶饮 18元 22元` |
| `茶饮价格性价比新客套餐点单避坑评论区问题很多` | `茶饮 性价比 新客` |
| `奶茶第一次来不知道怎么点怕踩雷` | `奶茶 点单 避坑` |

## 换行业怎么填

这篇默认修复茶饮关键词。换成其它行业时，保留“短关键词、加空格、小规模重试”的方法，把关键词换成 `品类 + 问题词`。  
例如把“茶饮 券后价”换成“宠物医院 绝育 价格”，把“茶饮 会不会踩雷”换成“轻医美 避坑”。

## 操作步骤

> 截图保存到 `docs/5.30/task/case-guides/screenshots/case-07-live-error-fix/`

### 第 1 步：截取错误状态输出

先保留工具返回的状态、提示语和平台，不要急着重跑。

![待补充截图](screenshots/case-07-live-error-fix/01-error-status.png)

截图说明：

### 第 2 步：判断状态类型

根据状态判断是 token、余额、关键词、无样本还是平台返回异常。

![待补充截图](screenshots/case-07-live-error-fix/02-status-diagnosis.png)

截图说明：

### 第 3 步：修改关键词或入参

如果是 `needs_keyword_fix`，优先把长关键词拆短，并在数字、品类、问题词之间加空格。

```text
这次抖音 live 采集返回 needs_keyword_fix，或疑似把关键词/入参错误误判成余额不足。
请不要直接当成充值问题处理。

业务目标：提升茶饮新客转化。
价格带：18-22 元。
当前想补采的问题：
1. 券后价 / 首单优惠 / 团购 / 套餐 / 划算吗；
2. 口味稳不稳 / 甜度 / 茶底 / 配料表；
3. 点单 / 怎么点 / 会不会踩雷 / 外卖到手体验。

请先帮我把原本过长或没有空格的关键词，改成适合抖音搜索接口的短关键词。
要求：
1. 每个关键词控制在 2-4 个词；
2. 数字、品类、问题词之间加空格；
3. 先给 6 个关键词；
4. 再用修复后的关键词重新做小规模 live 采集；
5. 如果仍失败，请判断是 token、余额、关键词、无样本还是平台接口异常。
```

![待补充截图](screenshots/case-07-live-error-fix/03-keyword-fix.png)

截图说明：

### 第 4 步：重新小规模采集

用修复后的关键词重新采集，先跑小样本，确认接口能正常返回。

![待补充截图](screenshots/case-07-live-error-fix/04-rerun-live.png)

截图说明：

### 第 5 步：确认修复后成功输出

看到样本数、评论数、证据样本后，再继续进入问题池或报告流程。

![待补充截图](screenshots/case-07-live-error-fix/05-fixed-output.png)

截图说明：

## 完成标准

- 能区分 token、余额、关键词、无样本。
- `needs_keyword_fix` 不走充值。
- 修复后能继续采集或给出可执行下一步。