# 邀請與權益

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 無需新增邀請命令。它們建立的有效記憶會自動參與邀請啟用判定。