# 抖音 live 模式

## 默认规则

- 样本量保持小
- 计费/充值口径走简版：缺 token 先恢复凭证，不直接甩充值链接、不要暴露 401/403；只有真 `402` 才透传工具生成的 Tokenized Balance 链接或二维码。**完整口径见 voc-api-catalog 技能的「错误码速查」references/error-codes.md**
- 用户只需要看到“怎么继续”

## 推荐默认参数

- `keywordLimit = 1`
- `videosPerKeyword = 1`
- `maxCommentPages = 1`
- `cacheAssets = true`

## 失败提示

当 live 失败时，优先区分：

1. 没有 token
2. token 无效
3. 额度不足
4. 没有采到有效样本

不要把底层接口报错直接丢给用户。

## 抖音关键词快速修复

如果状态是 `needs_keyword_fix`，这不是充值问题。Claude Code 应该先快速修复关键词：

- 空关键词：要求补一个明确关键词，不要自动使用默认词假装采集成功。
- 紧凑关键词：加空格，例如 `<品类>18元22元` -> `<品类> 18元 22元`。
- 过长关键词：缩短到 60 字以内，保留品类、问题、人群/场景。
- 上游返回 `社交平台接口请求错误` / 5xx / `fetch failed` / 超时：这是上游不稳定（工具返回 `upstream_unstable`），不是关键词也不是类目问题；原样转述提示并重试同样的 live 命令即可，不要换关键词。

推荐格式：

```text
<任何行业的品类/服务> + 价格/问题 + 人群/场景（任何行业都适用）
```

示例：

```text
<品类/服务> <价格区间> <目标人群>
<品类/服务> 性价比 新客
<品类/服务> 避坑 怎么选
(示例仅为格式；律师、法律、医美、教育等任何行业同样适用)
```

只有 `needs_token`、`needs_recharge`、`needs_valid_token` 才展示充值/开通链接。