抖音 live 模式

默认规则

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

推荐默认参数

keywordLimit = 1
videosPerKeyword = 1
maxCommentPages = 1
cacheAssets = true

失败提示

当 live 失败时，优先区分：

没有 token
token 无效
额度不足
没有采到有效样本

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

抖音关键词快速修复

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

空关键词：要求补一个明确关键词，不要自动使用默认词假装采集成功。
紧凑关键词：加空格，例如 茶饮18元22元 -> 茶饮 18元 22元。
过长关键词：缩短到 60 字以内，保留品类、问题、人群/场景。
上游返回 社交平台接口请求错误：先换成更自然的短关键词重试一次。

推荐格式：

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

示例：

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

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