🎫 代理商开通 · 发卡全流程

本文档介绍代理商账户从 开通 → 充值余额 → 生成卡密 → 发卡兑换 的完整操作链路。

一、找管理员开通代理权限

二、代理登录后的界面变化

✅ 新增可见项：

左侧导航栏出现 🎫 代理中心 入口
仪表盘顶部多出代理身份卡片
可以生成和查看自己名下的卡密

❌ 不变项：

普通用户功能全部保留（绑定、自助授权、操作日志等）
群内原有指令不受影响

三、代理中心面板详解

📍 入口：左侧导航栏 → 代理中心

3.1 代理身份三要素

进入代理中心首先看到的是三个核心指标：

┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│  代理等级    │ │  代理余额    │ │  代理折扣    │
│  初级代理商  │ │  20.00 元   │ │  7.5 折     │
└─────────────┘ └─────────────┘ └─────────────┘

代理等级：当前身份标签，由管理员分配
代理余额：可用于发卡的可用资金（单位：元）
代理折扣：生成卡密时按套餐原价的折扣计算扣费

3.2 生成 AGEN 卡密

这是代理的核心操作，每生成一张卡密就扣除对应代理余额。

操作步骤

① 选择"授权套餐"
   → 下拉菜单自动列出平台所有已启用的套餐
   → 格式：套餐名 · 授权天数 · 原价

② 输入"生成数量"
   → 最少 1 张，最多 100 张
   → 实时联动更新扣费预估

③ 点击"扣除余额并生成"
   → 系统自动按折扣计算总价
   → 余额不足时会直接报错

扣费计算公式

单次扣费 = 套餐原价 × 折扣 ÷ 10 × 生成数量

实例演示

假设你是一名 7.5 折的初级代理商：

场景	计算	扣费
10 元套餐 × 1 张	10 × 7.5 ÷ 10 × 1	7.5 元
10 元套餐 × 10 张	10 × 7.5 ÷ 10 × 10	75.0 元
30 元套餐 × 5 张	30 × 7.5 ÷ 10 × 5	112.5 元

卡密格式

代理生成的卡密前缀固定为 AGEN-：

AGEN-XK9A-2F8P-MN4Q
AGEN-7D2R-BY5T-ZH1W
AGEN-3L6C-VR9J-KE0B

3.3 我生成的卡密列表

代理中心下方展示当前代理名下所有卡密：

列	说明
卡密编号	系统内部 ID
卡密代码	完整卡密字符串，可一键复制
关联 QQ 群	兑换后的群号（未兑换则显示 —）
状态	未使用 / 兑换中 / 已使用
生成时间	精确到秒
操作	📋 复制 / 🗑️ 删除（仅未使用卡密可删）

删除未使用卡密

删除未使用卡密会自动退回对应代理余额：

点击卡密行右侧 🗑️ 图标 → 确认删除 → 余额实时退回

⚠️ 已使用或兑换中的卡密不允许删除。

四、客户兑换代理卡密

代理把 AGEN- 卡密代码发给客户后，客户通过以下方式完成授权：

方式 A：网站自助兑换（推荐）

① 客户登录平台 https://ycbot.dmadr.cn
② 左侧导航 → 卡密兑换
③ 输入完整卡密（支持 AGEN- 和 BBOS- 两种前缀）
④ 选择要授权的 QQ 群
⑤ 提交 → 授权生效

方式 B：QQ 群内机器人兑换

在已绑定的 QQ 群内发送卡密，机器人自动识别并兑换：

发送：AGEN-XK9A-2F8P-MN4Q
机器人回复：✅ 授权成功，群 [XXXXXXXXX] 已开通 30 天授权

五、完整流程图

┌─────────────────────────────────────────────────────────────────┐
│                    完整发卡交易链路                               │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  作者                                                           │
│  ┌──────────┐                                                   │
│  │ 开通代理  │── 设置等级/折扣/初始余额 ──▶ 创建代理账号          │
│  └──────────┘                                                   │
│       ▼                                                         │
│  代理商                                                         │
│  ┌────────────────────┐                                        │
│  │ 1. 登录平台         │                                        │
│  │ 2. 进入代理中心     │                                        │
│  │ 3. 选择套餐 + 数量  │                                        │
│  │ 4. 扣除余额生成卡密 │                                        │
│  └─────────┬──────────┘                                        │
│            │ 得到 AGEN-XXXX-XXXX-XXXX                            │
│            ▼                                                     │
│  客户                                                           │
│  ┌────────────────────┐                                        │
│  │ 收到卡密            │                                        │
│  │ 网站 / 群内兑换     │                                        │
│  │ QQ 群获得预存授权   │                                        │
│  └────────────────────┘                                        │
│                                                                 │
│  📊 系统自动记录：                                               │
│    · 代理发卡量 / 消耗余额                                       │
│    · 卡密来源 / 兑换目标群                                       │
│    · 所有操作进入平台审计日志                                     │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

六、常见问题

Q1：生成卡密时提示「余额不足」怎么办？

联系平台管理员为你的代理账户 追加代理余额。

Q2：生成的卡密可以卖给自己管理的群吗？

✅ 完全可以。代理本人就是某个群的预存管理员的话，可以直接用自己生成的卡密给那个群开通授权。

Q3：删掉未使用卡密，代理余额会退回吗？

✅ 自动退回。删除后立即加到代理余额上，可再次用于生成。

Q4：代理可以看其他代理生成的卡密吗？

❌ 不可以。每个代理只能看到自己名下的 AGEN 卡密列表。

Q5：折扣数值怎么理解？

折扣字段是一个 10 分制浮点数：
10.0 = 原价（不打折）
7.5 = 7.5 折
5.5 = 5.5 折
3.0 = 3 折
实际扣费 = 原价 × 折扣 ÷ 10

Q6：可以同时是多个群的预存管理员又做代理吗？

✅ 可以叠加。代理权限和群内的预存管理员/助手身份互不冲突，一个账号可以同时拥有。

Q8：如果代理作弊生成了很多卡密但客户没人用？

这正是代理模式的风控设计：
每生成一张卡密就立刻从代理余额扣钱
没用掉的卡密可以删掉退回余额
客户兑换成功才算完成一笔真实交易