# 邀请与权益

TokST 邀请奖励是产品权益，不包含现金。每个账户都有一个邀请码和专属链接，可在 **控制台 → 设置 → 我的邀请** 查看。

## 有效邀请规则

1. 新用户通过 `https://tokst.com/ref/<code>` 注册。
2. 新用户完成邮箱验证。
3. 新用户在注册后 7 天内通过网页、CLI、MCP 或 REST API 创建一条有效且仍为活跃状态的记忆。

邀请人和受邀用户各获得 1 个月 Pro 权益，邀请奖励暂不设置月度上限。已有账户无法补填或修改邀请码，系统会拒绝自我邀请。

## 我的权益

邀请奖励会进入 **控制台 → 设置 → 我的权益** 的待使用列表。

- Free 和 Starter 用户手动启用一笔权益后立即获得 Pro；已有生效权益时，新权益会自动顺延。
- Pro 和 Max 用户保留现有套餐；启用后的邀请奖励会记录为未来续订抵扣。
- 每个月 Pro 权益为 30 天。待使用权益不设过期时间，已启用权益显示开始和结束时间。

控制台同时展示基础套餐和当前有效套餐。Pro 权益到期后，账户恢复基础套餐。

## 公测会员

迁移执行时已存在的云端账户会获得公测会员权益：

- Free、Starter、Pro 用户从迁移日开始获得 365 天 Pro。
- Max 用户保留 Max，并获得 12 个月 Pro 续订抵扣。

## REST API

认证后的客户端可使用以下接口读取和启用权益：

| 方法 | 接口 | 用途 |
|---|---|---|
| `GET` | `/v1/referrals/me` | 邀请码、统计和邀请明细 |
| `GET` | `/v1/benefits/me` | 权益台账、基础套餐和有效套餐 |
| `POST` | `/v1/benefits/:id/activate` | 启用一笔待使用 Pro 权益 |

CLI 和 MCP 无需新增邀请命令。它们创建的有效记忆会自动参与邀请激活判定。