# 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 | 公开入口，适合团队共用和复盘 |

## 单 APIG 补额度入口

当前小红书 live 采集走 VOC 社媒数据中台：

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

如果用户只是社媒数据中台余额不足，可以使用这个入口补额度。课程和工作坊场景优先引导用户买技能套餐，因为技能套餐会同时给社媒数据中台和电商数据中台分配额度。

## 技能包安装入口

推荐 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 模式。