# live 模式接入说明

## 原则

P0 阶段先用 sample 模式跑通流程。

当用户明确要真实采集时，再切 live 模式。

## 采集默认值

live 模式默认保持小规模：

- `keywordLimit = 1`
- `notesPerKeyword = 1`
- `maxCommentPages = 1`

这样可以先验证流程，不会一上来就把运行成本拉高。

## token 处理

请求入参仍然保持简单：

- `xiaohongshuToken`
- `vocToken`

系统也会尝试从本机环境读取 token。

如果没有 token，或者余额不足，不要直接把底层报错甩给用户，应该返回：

- 充值链接
- 下一步操作

不要把 `403`、授权失败文案、原始响应体直接暴露给用户。

## 可访问链接

小红书原帖链接优先使用：

1. `mini_program_info.webpage_url`
2. `share_info.link`

保留 `xsec_token`，否则网页端可能打不开。

## 充值入口

常见充值入口示例：

```text
https://app.fmode.cn/dev/apig-pay/#/workshop
https://app.fmode.cn/dev/apig-pay/#/workshop/19-9
https://app.fmode.cn/dev/apig-pay/#/workshop/99
https://app.fmode.cn/dev/apig-pay/#/workshop/299
https://app.fmode.cn/dev/apig-pay/#/workshop/699
```

如果只是 VOC 数据服务余额，也可以用：

```text
https://app.fmode.cn/dev/apig-pay/?apigid=Vo3ROWEvDy&fun_id=HOkkX72PMF
```

## 结论

live 模式不是为了替代 sample，而是为了在 sample 已经校准过后，接上真实数据继续迭代。