激活码

激活码用于把下载能力按"额度"分发给访客，适合付费分发、活动兑换等场景。管理后台 → 激活码 标签页进行管理。

工作方式

• 管理员批量生成激活码，每个码带独立流量额度与有效天数
• 访客在分享页右上角（或左上角）的浮动按钮中输入激活码绑定使用
• 每次下载从激活码额度中扣减流量；免费下载不受影响，激活码提供额外额度

码格式

R2PAN-XXXX-XXXX-XXXY

• 前缀 R2PAN-，主体 12 位随机字符
• 字符集剔除易混字符（0 O 1 I），手抄不出错
• 末位为 CRC-8 校验位，输错格式前端即时提示，节省数据库查询
• 校验不区分大小写，自动去首尾空格

额度模型

字段	说明
流量额度	该码可下载的总字节数；0 = 无限流量（纯时效码）
有效天数	首次使用时激活并起算；0 = 永不过期
自定义耗尽文案	额度用完时向访客展示的提示，留空用默认文案

状态流转：

unused（未使用）
  └─ 首次使用 → active（激活，开始计时）
       ├─ 流量扣完 → exhausted（已耗尽）
       ├─ 到达到期时间 → expired（已过期）
       └─ 管理员作废 → revoked（已作废）

• 扣减采用 SQL 条件原子更新（used + bytes <= total 才写入），并发下载不会超扣
• 耗尽的码自动切换状态，后台统计可按状态筛选

批量管理

• 批量生成：一次生成任意数量，同批次的码共享一个批次号（格式 B日期-随机码），可按批次查询 / 作废 / 导出
• 作废：随时将单个码或整批码置为 revoked，立即停止使用
• 剩余额度查询：访客输入码后可见剩余流量百分比、状态与到期时间

相关设置

设置项	位置	默认值
分享页浮动按钮开关	设置	开启
浮动按钮位置	设置	右上角（可选左上角）

每次使用激活码下载也会写入 Analytics Engine 数据点（含激活码标识），可在全球分布中联动分析，详见变量与密钥。