live-manual-acceptance-checklist.md 3.5 KB

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/studio/balance/?token=USER_SESSION_TOKEN

小红书 live 最小验收

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

验收标准:

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

抖音 live 最小验收

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

验收标准:

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

抖音搜索错误快速验收

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

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_tokenneeds_rechargeneeds_valid_token 才展示充值/开通链接。

单点 VOC 记忆验收

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 天验证计划、下轮验证指标”。
  • “试用体验”只能出现在“已应用的使用记忆”,不能出现在“可执行解决动作”。
  • 默认记忆文件按项目/行业/场景/人群隔离,不应污染其它行业或其它客户。