# 抖音 live 模式

## 默认规则

- 先检查 token
- 样本量保持小
- 没 token 时给充值链接，不要暴露 403
- 余额不足时也给充值链接，不要暴露底层错误
- 用户只需要看到“怎么继续”

## 推荐默认参数

- `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 字以内，保留品类、问题、人群/场景。
- 上游返回 `社交平台接口请求错误`：先换成更自然的短关键词重试一次。

推荐格式：

```text
品类 + 价格/问题 + 人群/场景
```

示例：

```text
茶饮 18元 22元
茶饮 性价比 新客
奶茶 套餐 点单 避坑
```

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