# VOC 技能套餐与充值入口说明

## 适用场景

本说明用于把 `apig-pay` 的课程套餐、Claude Code 技能包和 live 真实采集串成一个闭环：

```text
安装 VS Code Claude Code
-> 安装 VOC Intelligence 技能包
-> 购买/开通技能套餐
-> 复制并配置 session token
-> 运行小红书 live 真实采集
```

## 套餐入口

公开套餐总入口：

```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/29-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/499 | 隐藏直达，适合企业实训 |
| 情报官团队包 | https://app.fmode.cn/dev/apig-pay/#/workshop/699 | 公开入口，适合团队共用和复盘 |

## 数据余额入口

当前小红书 live 采集统一从当前用户 NewAPI 余额扣费。用户自助充值使用带 Session Token 的余额页：

```text
https://app.fmode.cn/dev/studio/balance/?token=USER_SESSION_TOKEN
```

如果 Agent 已经完成成本测算，也可以直接复用现有 `pay_code2` 链路返回支付二维码。课程和工作坊套餐链接仍只用于套餐购买，不作为数据余额不足时的默认入口。

## 技能包安装入口

推荐 VS Code Claude Code 工作区安装：

```powershell
npx @vocmarket/voc-skill@latest workspace --smoke
```

安装后会写入：

```text
.\.claude\plugins\voc-intelligence
.\.claude\skills\xiaohongshu-trend-intelligence\SKILL.md
.\.mcp.json
```

安装完成后重启当前 VS Code Claude Code 会话。

## Token 配置口径

支付页登录后会显示“复制 OpenClaw 授权命令”。学员复制后在目标工作区终端执行，把 session token 写入本机凭证文件。

技能包会按以下顺序读取 token：

```text
工具入参 vocToken（兼容 xiaohongshuToken / douyinToken）
workspace .env.local 的 VOC_TOKEN / VOC_SOCIAL_TOKEN
环境变量 VOC_TOKEN / VOC_SOCIAL_TOKEN
~/.claude/voc-credentials.json 的 vocToken / token
```

注意：

- 不要把 token 写入 Git 仓库。
- 不要把 token 放进讲义截图、报告或聊天输出。
- 真实采集失败时，优先区分“没有 token”“token 失效”“余额不足”三类问题。

## 课堂讲师话术

可以这样讲：

> 技能包负责告诉 Claude Code 怎么完成小红书趋势情报任务；套餐包负责给真实采集提供数据中台额度。先用 sample 模式让大家看懂流程，再让需要真实采集的学员购买套餐、配置 token，最后切到 live 模式。