# VOC Live 采集手动验收清单

这份清单用于发布前或课程现场前确认真实采集链路可用。自动 smoke 不默认跑 live，因为 live 依赖上游余额、token 状态和平台接口稳定性。

## 验收前准备

- 当前工作区存在 `.env.local`，并配置 `VOC_TOKEN=<服务方提供的 session token>`。
- 不依赖 `~/.openclaw/voc-credentials.json`。
- 如果使用全局配置，只允许使用 `~/.claude/voc-credentials.json`。
- 上游余额充足，且充值入口可打开：
  `https://app.fmode.cn/dev/apig-pay/?apigid=Vo3ROWEvDy&fun_id=HOkkX72PMF`

## 小红书 live 最小验收

```bash
node ".claude/plugins/voc-intelligence/mcp/src/tools/xiaohongshu-trend-run.js" --collection-mode live --industry "家居定制" --keywords "全屋定制,家居定制怎么选" --keyword-limit 1 --notes-per-keyword 1 --max-comment-pages 1 --output "outputs/live-acceptance-xhs" --result-prefix XHS_TREND_RESULT
```

验收标准：

- `status` 为 `ok`，或在无 token/余额不足时返回友好充值提示。
- 不出现原始 `403`、权限栈、接口响应体。
- 报告里有证据样本、原帖链接、评论证据。
- `files` 中包含 Markdown、JSON，若有图片则包含本地 `assets`。

## 抖音 live 最小验收

```bash
node ".claude/plugins/voc-intelligence/mcp/src/tools/douyin-trend-run.js" --collection-mode live --industry "家居定制" --keywords "全屋定制,家居定制怎么选" --keyword-limit 1 --videos-per-keyword 1 --max-comment-pages 1 --output "outputs/live-acceptance-douyin" --result-prefix DOUYIN_TREND_RESULT
```

验收标准：

- `status` 为 `ok`，或在无 token/余额不足时返回友好充值提示。
- 不出现原始 `403`、权限栈、接口响应体。
- 报告里有视频证据、原视频链接、评论证据。
- 输出内容仍是“第一轮初步判断 / 机会假设 / 待确认问题”，不能把首轮样本写成最终结论。

## 抖音搜索错误快速验收

用于确认“搜索请求错误误报余额不足”的问题已经被拦住：

```bash
node ".claude/plugins/voc-intelligence/mcp/src/tools/douyin-trend-run.js" --collection-mode live --industry "家居定制" --business-type "全屋定制品牌" --target-audience "新客" --keywords "家居定制18元22元" --keyword-limit 1 --videos-per-keyword 1 --max-comment-pages 0 --cache-assets false --output "outputs/live-acceptance-douyin-keyword" --result-prefix DOUYIN_TREND_RESULT
```

验收标准：
- `家居定制18元22元` 应被规范成 `家居定制 18元 22元`，报告中的关注关键词也应显示规范化后的词。
- 如果上游返回 `社交平台接口请求错误` 或 5xx，工具应先自动换短关键词重试。
- 自动修复仍失败时，状态应为 `needs_keyword_fix`，不应出现充值链接。
- 只有 `needs_token`、`needs_recharge`、`needs_valid_token` 才展示充值/开通链接。

## 单点 VOC 记忆验收

```bash
node ".claude/plugins/voc-intelligence/mcp/src/tools/voc-problem-deep-dive-run.js" --issue "怎么选" --project "示例品牌A" --industry "家居定制" --scenario "线上获客" --audience "意向用户" --feedback "这个品牌不想做试用体验，更想先改评论区回复和案例展示" --assistant-message-only
```

验收标准：

- 输出有“优先级判断、老板视角影响、可执行解决动作、7 天验证计划、下轮验证指标”。
- “试用体验”只能出现在“已应用的使用记忆”，不能出现在“可执行解决动作”。
- 默认记忆文件按项目/行业/场景/人群隔离，不应污染其它行业或其它客户。