<title>渠道推广与佣金（商业版）</title>

# 渠道推广与佣金（商业版）

> **渠道现金佣金**是商业版功能，需向客服申请、由管理员审核开通后才能产生。「邀请中心」与邀请算力奖励（+38 算力）在开源版 / 商业版均可用，二者可并存、互不影响。

## 邀请中心（所有用户）

- 首页顶部点击**手机号 / 邮箱**打开「邀请中心」弹窗
- 展示：「我的邀请码」「专属邀请码」「已邀请（人数）」「获得算力（点数）」「复制邀请链接」
- 邀请奖励：「邀请好友，赚取算力 / 每成功邀请一个用户注册并登录，您将获得 38 算力奖励」
- 邀请奖励不进入渠道抽佣，可与现金佣金并存

## 渠道推广（商业版）

- 「邀请中心」弹窗内显示「申请开通渠道推广」按钮（商业版 + 非本地部署 + 未开通时显示）
- 点击后弹出「渠道推广合作 / 申请开通渠道推广」：「添加客服微信，由管理员审核开通渠道佣金。开通前，你的推广链接仅可获得算力奖励。」并附**客服微信二维码**
- 管理员审核并开通渠道等级后：「申请」按钮消失，邀请中心底部出现「佣金中心」
- 本地部署模式：不显示「申请开通」入口；注册时不提交邀请码

## 佣金中心（开通渠道后）

- **余额卡**：「可提现佣金」「累计 / 冻结 / 已提现」
- **月付佣金冻结**：订阅（委托代扣）产生的佣金自**产生之日起冻结 30 天**，「月付佣金冻结中：¥X（满 30 天自动可提现）」；直充佣金不受限
- **提现**：「申请全额提现」（满 ¥10 可提现），方式「支付宝 / 银行卡」，「确认提现」
- **佣金明细** / **提现记录**（状态：待审核 / 已打款 / 已驳回，驳回时展示驳回原因）
- **渠道佣金说明**卡片：「渠道（邀请）佣金按好友购买的档位固定发放（好友实付 → 你的单笔佣金）：」，分「订阅」「直充」两行列出各档位的单笔佣金（具体金额以页面展示为准），尾句「月付订阅的佣金自产生起满 30 天后方可提现。」
- 佣金比例**不可自调**（比例滑杆已移除），按档位固定金额发放

## 渠道等级（管理员侧）

| 等级 | 说明 |
|-|-|
| 0 | 未开通（默认）——邀请链接仅算力奖励 |
| 1 | 推广链接（仅算力奖励） |
| 2 | 渠道现金佣金——开通后，你邀请的好友充值 / 订阅将产生现金佣金 |

管理后台「用户管理」中通过「开佣金 / 关佣金」开关设置（等级 2 ↔ 0）。

## API 接口

### 用户侧（商业版，需登录）

```Plaintext
GET  /api/commission/summary     # 佣金汇总（channel_level / available / frozen / withdrawn / tiers）
GET  /api/commission/records     # 佣金明细（分页）
POST /api/commission/withdraw    # 申请全额提现（支付宝 / 银行卡）
GET  /api/commission/withdrawals # 我的提现单
```

### 管理端

```Plaintext
PUT /api/admin/users/{user_id}/channel-level   # 设置渠道等级（0/1/2）
GET /api/admin/users/{user_id}/channel-level   # 查询渠道等级
```

## 注意事项

1. **渠道现金佣金仅商业版**；开源版只有「邀请中心 + 邀请算力奖励」
2. 用户**不能自助开通**，需添加客服微信、由管理员审核开通
3. 月付（委托代扣）佣金有 **30 天提现冻结期**
4. 充值 / 订阅结算会按渠道等级对邀请人抽佣；无邀请人或等级 < 2 时不抽佣、全额到账
