免费奖金任务已达标。
`），跌落后再达标不重复推；同一局同时触顶时只推既有的「已达最大值」toast。触顶 toast 行为不变 | 5. 【[免费注册奖金 · 作废](418_promotion_free_register_bonus.md#rules)】新增**到期 toast**：试玩中 / 已锁定倒计时归零作废时（惰性结算 / 定时兑底 / 游戏内下注回调任一触发）推【[实时提示](510_message.md#realtime)】`type=msg`（`icon=bonus`，文案 `免费奖金活动已到期，免费余额已失效，请充值后继续游戏。
`），每人一次；作废时 `free_money` 确有清零则同时推【[余额变动](510_message.md#realtime-balance-changed)】`balance_changed` **新标识 `void`**（含关闭救援时的输光作废），玩家端回源刷一次【[账户余额](200_finance.md#account_balance)】。同时**免费模式下注回调遇到期改为先作废再拒绝**（上游仍收到 `免费奖金已到期` 错误，不再等定时任务清零），接口契约无变化 | 6. 新增【[可选头像列表](500_site_content.md#avatars)】`GET /site_content/avatars`（免登录）：返回商户在后台「站点内容/头像配置」维护的启用中预设头像（`name` / `image_url` / `sort_order` / `is_active`，按后台摆放顺序）；新增【[选择头像](500_site_content.md#avatar_select)】`POST /site_content/avatar/select {image_url}`（需登录），服务端校验所选图片在启用列表内后写入 `head_portrait`，否则返回 `头像不存在或已停用` | 7. 【[注册](100_auth.md)】行为变化：商户配置了至少一张启用中的预设头像时，注册（含游客注册）会**随机分配一张**写入 `head_portrait`，不再为空串；未配置时行为不变，客户端仍需保留默认头像兑底 | 8. 新增【[投注统计](300_game.md#bet_stats)】`GET /game/bet/stats`（需登录）：返回当前玩家**终身**的 `bet_count`（总投注场数）/ `win_count`（总胜场数）/ `bet_amount`（总投注额），口径与商户后台报表一致，结果缓存 30s，供个人中心展示 | 9. 新增【[可领奖励项数](400_promotion.md#unclaimed_count)】`GET /promotion/unclaimed_count`（免登录，游客恒 `0`）：返回当前玩家在商户**全部已开启活动**中的可领奖励项数 `count`（不下发金额），供首页角标 / 个人中心入口展示；一“项”= 一次独立领取动作能领到的单元（宝箱逐个、救援金逐笔、累充逐阶梯、战令逐节点、VIP 升级礼金 / 周俸 / 月俸各 1 项，其余单项类与 `has_unclaimed` 一致，完整口径表见文档）。【[活动列表](400_promotion.md#list)】新增可选 Query `with_unclaimed=1`：传了才下发顶层 `unclaimed_count`（覆盖全部已开启 kind，含未开启列表展示的）与 `data[]` 行级 `unclaimed_count`；不传则响应与服务端开销**完全不变**。`has_unclaimed` 红点字段的判定逻辑与缓存未动，老客户端不受影响；注意部分 kind 的红点语义是「可参与」而非「有奖待领」（存款加赠类、拼多多），可能出现 `has_unclaimed=true` 而 `unclaimed_count=0`，新客户端做角标请以 `unclaimed_count` 为准 2026-09-20 | 1. 【[我的充值订单](200_finance.md#recharge_my)】新增 Query `start_time` / `end_time`（此前传入被忽略）：按订单创建时间筛选，`YYYY-MM-DD` 或 `YYYY-MM-DD HH:mm:ss`，按商户时区解析；`end_time` 传纯日期时包含当天整日 | 2. 【[批量活动详情](400_promotion.md#detail_batch)】**新增 `GET /promotion/detail_batch?kinds=k1,k2,...`**：一次请求合并返回多个 kind 的 `detail`，与逐个调用 `GET /promotion/{kind}/detail` 完全等价，**不受 [活动列表](400_promotion.md#list) 的 `show_in_list` 过滤影响**（该开关只影响 `/list` 的 `data[]`，不影响单个 kind 的 `detail`），供充值页等只是借用几个活动费率、自身不是活动列表的页面合并请求、减少并行数 | 3. 【[活动列表](400_promotion.md#list)】`data[]` / `triggered[]` **新增 `sort_order`**（展示排序，商户自定义优先、未配置回退平台默认），供客户端统一按该字段排序两个数组的卡片，不再各自维护固定顺序；`data[]` 新增可选 `payload`：`daily_deposit_bonus` / `deposit_first_n_bonus` 下发与各自 `detail.data` 同结构的摘要（含 `can_join`），**客户端应据此判断卡片是否可参与展示，不要再用 `is_active`**（`is_active` 只代表后台开关，未考虑今日已参与 / 次数用完）。`detail` 仍保留、结构不变，仅建议改为**点开详情 / 规则弹层时才请求**，不再作为列表显隐的判定来源 | 4. 【[损失救援](418_promotion_loss_rescue.md#detail)】**未登录也下发 `user_type`（恒 `new`）/ `max_rate`/ `window_hours` / `claim_expire_hours` / `tiers`**（按新用户档位），用于常驻营销卡展示最高返奖比例与完整费率表招徕游客；其余字段（`windows`/`in_progress`/`pending`）仍只在登录后返回 | 5. 【[活动列表](400_promotion.md#list)】`data[]` 的 `payload` 新增 `loss_rescue`：与 [活动详情](418_promotion_loss_rescue.md#detail) 的 `data` 完全同结构，客户端可直接用它渲染常驻卡/领取卡，不必再单独请求 `GET /promotion/loss_rescue/detail`（该接口仍保留，供懒加载详情/游戏列表弹层使用） | 6. ⚠️ 【[免费注册奖金 · 锁定](418_promotion_free_register_bonus.md#rules)】**首笔充值到账即把 `free_money` 全额转入 `record.total_amount` 并清零**（此前是冻结留在账户、拆笔时才清零）：`stage=locked` 起 `detail.free_money` / `triggered[].payload.free_money` 与【[账户余额](200_finance.md#account_balance)】`free_money` 均为 `"0.00"`；`reached_target` 在 `locked` 起**恒为 `true`**（锁定时未达标如 `30/50` 同样锁定，后续按 `30` 拆笔）。客户端：`stage=locked` 时进度条**直接画满格（100%），不再展示分子 / 分母数字**；`playing` 阶段渲染规则不变 2026-09-19 | 1. ⚠️ 【[打码任务](201_wager_tasks.md#task)】`WagerTask.status` 新增 **`not_started`（未开始）**：创建时默认该状态，**首次写入进度**时转 `pending`（进行中）。原「待完成」语义现由 `not_started` + `pending` 两个值共同承担，均占用打码额度、阻止提现并参与 FIFO / 整体放弃 / 低余额失效；【[我的打码任务](201_wager_tasks.md#list)】`status` 可分别传 `not_started` / `pending` 精确筛选，待完成页传新增虚拟值 **`status=active`** 一次取回两种状态（原 `status=pending` 的调用上线后会漏掉未开始任务，需改为 `active`）。存量数据已回刷：进度为 `0` 的 `pending` 任务改为 `not_started` | 2. 【[我的打码任务](201_wager_tasks.md#list)】列表排序改为 `created_at DESC, id DESC`（最新在前）；任务消耗顺序不变仍按 `sequence` FIFO | 3. 【[损失救援](418_promotion_loss_rescue.md)】开窗规则放宽：不再把「存在未过期待领取（`pending`）救援金」计入活跃窗口，**只有存在未结算的进行中窗口（`open`）才阻挡新窗口开启**；命中阶梯待领取但尚未 `claim` 的旧窗口，不影响下一笔达标存款开新窗，`in_progress` 与 `pending` 可同时下发 | 4. ⚠️ 【[损失救援](418_promotion_loss_rescue.md)】修复新/老用户身份判定漏洞：上一条放宽后，若第一个新用户窗口已结算命中（`pending`，尚未领取）时又开了第二个窗口，此前只在**实际点击领取**后才转老用户，会导致两个窗口都按新用户档位计算、变相领两次新用户奖励。现在**命中即锁定资格**——存在一条 `user_type=new` 且已结算命中的窗口（`pending`，含已过期未领取）即视为老用户，无需等真正领取；未命中（`miss`）不占用资格，仍可按新用户重试 | 5. ⚠️ 【[损失救援](418_promotion_loss_rescue.md#detail)】修复并发窗口下身份显示串号问题：`in_progress[]`/`pending[]` 每项新增 `user_type`/`max_rate`/`tiers`（该窗口自己开窗时身份的快照），客户端渲染常驻卡/领取卡时必须用这两个字段自己的值，**不能再用顶层 `max_rate`/`tiers`**（顶层仅表示玩家当前最新身份，并发窗口下与具体窗口身份可能不一致）；同时把 `isVeteran` 等派生字段的计算改到 `settleDue` 结算之后，避免本次请求刚结算命中却还返回结算前的旧身份 | 6. 【[免费注册奖金 · 作废](418_promotion_free_register_bonus.md#rules)】修复到期后免费余额残留：此前到期作废只在 `detail` / `launch_free` / 充值到账时惰性结算，玩家到期后不再进详情时 `/promotion/list` 已不返回入口、但【[账户余额](200_finance.md#account_balance)】`free_money` 仍显示旧值。现新增服务端定时兜底（每分钟扫描 `playing / locked` 且已到期的记录作废并清零 `free_money`），接口契约无变化 | 7. 【[免费注册奖金 · 活动详情](418_promotion_free_register_bonus.md#detail)】修复拆笔后仍下发倒计时：`detail` 顶层与 `triggered[].payload` 的 `expire_at` / `remaining_seconds` 此前在 `unlocking` 阶段仍透传领取时的快照值，导致卡片误渲染倒计时。现仅 `stage ∈ {playing, locked}` 下发，其余阶段固定 `null` / `0`（与「进入状态 3 后不再有时限」口径一致）；客户端仍应以 `remaining_seconds > 0` 作为是否渲染倒计时的判据 | 8. 【[实时提示 · 余额变动清单](510_message.md#realtime-balance-changed)】新增 `balance_changed` 标识 `rescue`：【[幸运救援](418_promotion_free_register_bonus.md#rescue)】补发到 `free_money` 后，与 `promotion_trigger`（弹窗）同时下发，玩家端据此回源刷一次【[账户余额](200_finance.md#account_balance)】（站点顶栏 / 进度卡；游戏内钱包已由游戏回调更新）。按既定约定 `reason` 为开放集，老客户端遇未知值照常刷新即可 2026-09-18 | 1. ⚠️ 【[免费注册奖金](418_promotion_free_register_bonus.md)】**状态机重做（按 PRD 09-18 版）**：锁定时机由「绑定转正」改为**任一笔充值到账**（余额冻结留在 `free_money`、不再可投注、在途派彩没收，`stage=locked`，`record.status=2`），拆笔时机改为**累计充值（实收）≥ `min_total_deposit` 的那笔到账**（`stage=unlocking`），**与是否绑定账号无关**——游客充满门槛同样拆笔，`gate=guest` 仅作提款前置。到期规则改为**试玩中 / 已锁定倒计时归零一律作废**（不再有「达标保留等转正」，移除 `stage=expired_locked`），试玩中某局结算后 `free_money < 0.1` 视为输光作废。首笔一律需打码（取消「转正时已达标首笔免打码」），打码口径改为与【[打码任务](201_wager_tasks.md)】同源的**有效投注**（同一笔投注双计），从拆笔时刻起算、超额不结转 | 2. 【[领取](418_promotion_free_register_bonus.md#rules)】领取只发生在【[游客注册](100_auth.md#guest_register)】，`launch_free` 不再惰性补发；领取时把达标金额 / 上限 / 充值门槛 / 到期时刻快照到账户，改配置或关活动对已领取用户不生效，拆分序列与倍数在拆笔时快照。新增后端防刷：每 IP 领取次数上限（`0` 不限）+ IP 白名单（IP / CIDR），超限时游客注册返回新错误 `当前网络领取免费奖金的次数已达上限`。新增 **`GET /free_register_bonus/eligibility`**（免登录）：`{claimable, reason(inactive/logged_in/ip_limit), bonus_amount}`，弹首访弹窗前调用；设备维度「登录过不再弹」由客户端本地控制 | 3. 【[活动详情](418_promotion_free_register_bonus.md#detail)】`stage` 枚举改为 `none / playing / locked / unlocking / finished / void`；顶层新增 `target_amount` / `min_total_deposit`（领取时快照，未领取为当前配置）；`free_money` 在 `locked` 为冻结值；`record` **自领取起即下发**（`status` 新增 `4` 试玩中 / `2` 已锁定 / `3` 已作废，新增 `locked_at` / `converted_at`，拆笔前 `chunks=[]`）。`gate` 语义：`progress` 仅 `stage=playing` 时出现；`guest` 任何阶段仍是游客即命中；`deposit_short` 前端改为「提示并直接跳转存款页」 | 4. ⚠️ 【[直接提款当前笔](418_promotion_free_register_bonus.md#withdraw)】`POST /free_register_bonus/withdraw` **改为与统一提款完全同一套校验**（最低额、一人一在途单、账户打码任务均生效，且占用普通提款在途名额）；金额低于渠道最低额时客户端应提示切换方式或走 `claim`「转入您的余额」（`claim` 不限金额）。提款单失败 / 取消时款项按普通流程退回真实余额，该笔份额**仍算已提取、不回滚** | 5. 【[免费账户启动游戏](300_game.md#launch_free)】**不再要求 `is_guest=true`**，锁定前游客与已绑定会员均可进；业务错误改为 `尚未领取免费奖金` / `已完成充值，免费账户不再可用` / `免费奖金已到期` / `免费账户余额不足`（余额 < `0.1`），移除 `仅游客账号可使用免费账户启动游戏` / `活动未开启`。【[绑定账号](100_auth.md#bind_account)】不再触碰免费账户。【[活动列表](400_promotion.md#list)】`triggered[]` 的 `free_register_bonus` 行现覆盖 `playing / locked / unlocking`，payload 含 `stage / gate / free_money / target_amount / reached_target / expire_at / remaining_seconds / has_deposit / total_deposit / min_total_deposit`（`locked`/`unlocking` 另带 `record` 摘要字段） | 6. 【[免费注册奖金 · 幸运救援奖金](418_promotion_free_register_bonus.md#rescue)】**新增试玩阶段兜底**：`stage=playing` 且未到期，免费模式一局派彩结算后 `free_money < rescue_threshold`（默认 `0.5`）即在同事务内补发 `rescue_amount`（默认 `10`，受 `free_money_cap` 约束）到免费账户，**次数不限、无需领取**，游戏回调返回的余额已含补发；倒计时不重置。入账后推【[实时提示](510_message.md#realtime-promotion-trigger)】`type=promotion_trigger` **新标识 `free_register_bonus_rescue`**，玩家端据此在游戏页上层弹「幸运救援奖金」弹窗（金额用 `detail.rescue_amount`，「Claim」/「✕」仅关闭，不调接口）。→ **作废口径变化**：开启救援时试玩中**只有倒计时归零一条作废路径**，「`free_money < 0.1` 输光作废」仅在商户将 `rescue_threshold` 配为 `0` 关闭救援时保留。【[活动详情](418_promotion_free_register_bonus.md#detail)】顶层新增 `rescue_threshold` / `rescue_amount`（领取时快照；未领取为当前配置），`config` 新增同名字段，`record` 新增 `rescue_count` / `rescue_total_amount`；`triggered[]` payload 同步带 `rescue_threshold` / `rescue_amount` | 7. 【[免费注册奖金 · 前端展示约定](418_promotion_free_register_bonus.md#rules)】首页 / 赌场常驻卡显示条件从「`stage ∈ {playing, locked}` 且 `reached_target=false`」改为 **`stage ∈ {playing, locked}` 期间一直显示**（达标后不消失，继续提醒充值），`reached_target` 只决定卡片两态样式；进入 `unlocking` 后常驻卡才消失。接口无变化 2026-09-17 | 1. ⚠️ 【[损失救援](418_promotion_loss_rescue.md)】**领取模型回退为两阶段（撤销 09-15 的“窗口期即领取期”修订）**：充值开窗后窗口期内**不可提前领取**，仅老虎机净损累计；窗口到期（`window_hours`）冻结净损结算，命中阶梯生成待领取救援金（金额固定），进入独立的领取有效期（`claim_expire_hours`，配置项重新参与新窗口生命周期）；超期作废。`pending[]` 只含已结算记录，不再随进行中窗口净损实时变化 | 2. 【[领取](418_promotion_loss_rescue.md#claim)】移除业务错误 `亏损金额未达到最低档位`（进行中窗口不再支持提前领取，该错误场景已不存在） | 3. 【[活动详情](418_promotion_loss_rescue.md#detail)】`data` 新增 `in_progress[]`：进行中窗口命中最低档位时的实时预估（`loss_amount`/`tier_index`/`amount`/`bet_multiple`/`window_end_at`），**仅供展示「待结算」金额，不可据此发起 `claim`**；未命中最低档时不下发。客户端用于「已充值待结算」卡片态，与营销卡（未充值）为同一卡片切换文案，不叠加展示；与 `pending[]`（已结算待领取）分属不同展示态，二者不会同时出现 2026-09-16 | 1. 【[提款配置](200_finance.md#withdraw_config)】`GET /finance/withdraw/config` 的 `method_list[].channels[]` **新增字段** `fee_rate`（string，手续费费率小数，如 `0.02`）与 `fee_fixed`（string，每笔固定手续费）。服务端手续费口径 `fee = round(amount × fee_rate + fee_fixed, 2)`（负数按 `0`、超过金额按金额夹紧）；客户端可用 `min_amount + (min_amount × fee_rate + fee_fixed)` 估算该渠道的提现门槛，在可用金额不足时给出提示。**完全向后兼容**，老客户端按「忽略未知字段」处理即可 | 2. ⚠️ 【[提款配置](200_finance.md#withdraw_config)】**`method_list` / `methods` 只包含至少有 1 个可用 `channels` 的提款方式**：商户后台未配置 / 未启用代付项的方式不再以空 `channels` 下发。客户端**不应再假定** USD 商户必然返回 3 条、BRL 商户必然返回 `pix`，一律以响应为准；`method_list` 为空表示当前无可用提款方式 | 3. ⚠️ 【[提款配置](200_finance.md#withdraw_config)】**方式顺序变化**：`method_list` 改为按商户后台代付项配置的排序（`sort_order`）下发，不再是固定的注册表顺序，**首项即默认选中的提款方式**；`methods` 与 `method_list` 顺序一致。请求 / 响应结构无其他变化 | 4. 【[提款配置](200_finance.md#withdraw_config)】商户后台代付项现按提款方式拆条配置（如 conapay USD 的 `card` / `cashapp` / `paypal` 各一条），因此**同一 `channel` 在不同 `method` 下的 `name` / `min_amount` / `max_amount` / `fee_rate` / `fee_fixed` 都可能不同**，客户端必须按 `method + channel` 组合取值，不要按 `channel` 缓存全局值；「`min_amount` / `max_amount` 为商户通道限额与提款方式限额的交集」仍然成立。「商户币种 → 下发的 methods」表改为「最多可能下发」口径。无新增 / 删除接口，无新增错误文案 2026-09-15 | 1. ⚠️ 【[损失救援](418_promotion_loss_rescue.md)】**领取模型修订：窗口期即领取期**——充值开窗后，窗口期内老虎机净损实时累计，**一旦命中最低档位即可随时领取**（`detail` 的 `pending[]` 实时下发进行中窗口的当前可领金额，`claim_expires_at` = 窗口结束时间）；领取时按「窗口开始 → 领取时刻」实时结算入账，窗口随即关闭；**窗口到期未领取即作废**（不再有「到期结算 → 领取有效期」两阶段），配置项「领取有效期」不再参与新窗口生命周期 | 2. 【[领取](418_promotion_loss_rescue.md#claim)】新增业务错误 `亏损金额未达到最低档位`（窗口内净损未命中最低档时领取）；`pending[]` 金额随亏损增长，前端刷新 `detail` 即可拿到最新可领金额 | 3. 【[损失救援](418_promotion_loss_rescue.md)】开窗规则修订：同一时间**最多一个活跃窗口**（存在进行中窗口时，新的达标存款不开新窗；领取成功或超期作废回退后需新的单笔达标存款重新触发） | 4. 【[活动详情](418_promotion_loss_rescue.md#detail)】`pending[]` 新增 `window_start_at`（窗口开始时间，供卡片「{日期} 损失救援」标题前缀）；「货币」框取值属充值/钱包域，由前端自行获取，活动接口不下发币种 | 5. 新增【[损失金额明细](418_promotion_loss_rescue.md#loss_detail)】（`GET /loss_rescue/loss_detail`，需登录）：按商户时区自然日返回每游戏老虎机净输明细 `items`、`total_loss`、当日已领奖励合计 `reward_amount` 与 `loss_amount`（= 游戏损失 − 所获奖金）；`date` 缺省或非法回退今天。日期导航仅为按天查历史，与滚动窗口结算无关 2026-09-15 | 1. 新增活动【[免费注册奖金](418_promotion_free_register_bonus.md)】（`kind=free_register_bonus`）：游客注册即发 `bonus_amount`（默认 30）到免费账户 `free_money`，`window_hours`（默认 48h，自 `granted_at` 起）窗口内免费游玩；进度 = `free_money`，目标 `target_amount`（默认 50），余额上限 `free_money_cap`（默认 100，派彩超出截断，**首次触顶推一条 `type=msg` toast** `免费奖金已达最大值 %s。
`）。到期余额 < 目标 → 作废（`stage=void`）；≥ 目标 → 保留等转正（`expired_locked`） | 2. 【[免费注册奖金 · 转正与解锁](418_promotion_free_register_bonus.md#rules)】：【[绑定账号](100_auth.md#bind_account)】转正时 `free_money` 快照转入活动记录并清零；拆笔按 `chunk_amounts` 序列（默认 `[20, 10]`，用完按末值继续）、末笔余数，每笔打码 = 笔金额 × `chunk_bet_multiple`（15），转正瞬间已达目标则首笔免打码。按 `current_index` 顺序解锁，当前笔进度 = 累计有效投注 − 上笔领取快照（与打码任务并行双计），达标且 `gate=ok` 才能 `claim`；领取直接入现金 `user_money`，**不新增打码任务** | 3. `GET /promotion/free_register_bonus/detail`（**免登录**，匿名也返回 `config` 供首访弹窗）字段：`kind` / `is_active` / `description` / `config{bonus_amount,target_amount,free_money_cap,window_hours,min_total_deposit,chunk_amounts,chunk_bet_multiple}` / `stage`（`none` / `playing` / `expired_locked` / `void` / `unlocking` / `finished`）/ `free_money` / `reached_target` / `cap_reached` / `granted_at` / `expire_at` / `remaining_seconds` / `gate` / `is_guest` / `has_deposit` / `total_deposit` / `record{total_amount,claimed_amount,claimed_count,current_index,status,chunks[{index,amount,bet_required,bet_progress,status}]}`。四层门禁 `gate` 按序：`progress`（游客未达标）/ `guest`（达标未转正）/ `no_deposit`（零充值，档位表复用【[首充奖励 detail](413_promotion_first_recharge_bonus.md#detail)】）/ `deposit_short`（累计充值 < `min_total_deposit` 49）/ `ok` | 4. `POST /promotion/free_register_bonus/claim`（需登录，无 body）领取当前笔到现金余额，输出 `amount` / `chunk_index` / `claimed_amount` / `total_amount` / `finished`；业务错误 `免费奖金进度未达标` / `请先绑定账号完成注册` / `请先完成充值后再解锁奖金` / `累计充值需达到 %s 才能解锁奖金` / `暂无可解锁的奖金` / `奖金已全部领取` / `当前奖金打码量未达标` / `领取冲突，请重试`。新增 `POST /free_register_bonus/withdraw`（需登录，`method` + `channel`）：解锁当前笔并**同事务**建提款单，**不受**最低提现额 / 一人一在途单 / 账户打码限制（且不占用普通提款的在途名额），单笔上限 / 每日限额 / 审核分流同普通提款，订单带后台审核标注「免费注册奖金提款」。常驻卡按商户「列表展示」开关出现在 `/promotion/list` 的 `data`，进行中另出现在 `triggered`（见第 5 条），红点 = 当前笔可领 | 5. 【[活动列表](400_promotion.md#list)】`GET /promotion/list` 响应顶层**新增 `triggered[]`**（会员名下已激活的限时 / 阶段性入口，每条记录一行，按 `expire_at` 升序、不限时在后，匿名为 `[]`），单项 `{kind, entry_id, banner_url, icon_url, expire_at, server_now, payload}`；**同一 kind 可同时出现在 `data` 与 `triggered`**（常驻卡 + 限时卡）。首批：`daily_bankrupt_pack`（当前有效 offer）、`free_register_bonus`（免费游玩中 / 到期保留 / 转正解锁中）。`data` 的内容、排序与字段**完全不变**，老客户端只读 `data` 即行为不变；新客户端把 `triggered` 渲染在 `data` 之前 | 6. 【[免费账户启动游戏](300_game.md#launch_free)】新增业务错误 `活动未开启` / `免费奖金已到期`；「免费账户语义」修订：额度 / 上限 / 目标 / 窗口由本活动配置决定，转正时余额**不再一律作废**，改为按上文规则转入拆笔记录（到期未达目标的仍作废） | 7. 新增【[免费账户启动游戏](300_game.md#launch_free)】（`POST /game/launch_free`，需登录，**仅游客 `is_guest=true` 可调**）：以游客的**免费账户余额（体验金）**启动游戏。输入与【[启动游戏](300_game.md#launch)】完全相同（`internal_code` 必填，`device_type` / `currency` / `return_url` / `lang` 可选）；输出在 `url` / `launch_url` / `session_id` / `session_token` 基础上**新增 `free_balance`**（string，启动时的免费账户余额）。由客户端判定「是游客且选择体验」后调用，真钱游戏仍调 `/game/launch`。首次调用若尚未发放且商户配置额度 > 0 会先发放再启动；余额为 `0` 仍可启动（游戏内下注失败提示），客户端应据 `free_balance` 提前引导绑定账号。目前**仅支持 365 平台游戏**。新增业务错误 `仅游客账号可使用免费账户启动游戏` / `该游戏不支持游客试玩`（非 365 平台或商户未配置免费试玩凭据，在发放额度前校验），其余同 `/game/launch` | 8. 【[账户余额](200_finance.md#account_balance)】新增字段 `free_money`（string，免费账户余额；与 `user_money` / `bonus_money` **完全隔离**，不可提现、不可转入真实余额、不计打码量，**不计入 `total`**；游客转正后清零为 `0`）与 `free_granted_at`（string，免费额度发放时间，未发放为 `null`）。**完全向后兼容**，老客户端按「忽略未知字段」处理即可 | 9. 免费账户语义：商户后台配置初始额度，游客注册时一次性发放（存量游客首次调 `/game/launch_free` 时补发），**用完不补**；免费投注不触发任何活动 / 奖励 / 返水 / VIP 经验，投注记录也**不进入**【[投注汇总](300_game.md#bet_summary)】等投注记录相关接口 | 10. 【[游客注册](100_auth.md#guest_register)】「游客账号特性」补充：拥有免费账户（体验金）；通过【[绑定账号](100_auth.md#bind_account)】转正时免费余额清零（去向见第 2 条），之后只能走真实账户与 `/game/launch` 2026-09-14 | 1. 新增活动【[损失救援](418_promotion_loss_rescue.md)】（`kind=loss_rescue`，走通用活动接口，无新增路由）：单笔存款达到开窗门槛后开启滚动结算窗口（新用户默认 24h / 老用户默认 120h，以 `detail` 下发的 `window_hours` 为准），窗口到期结算窗口期内老虎机净损，命中阶梯生成待领取救援金，须在领取有效期内领取（带打码倍数），超期作废；领取过一次新用户救援金后转为老用户；每笔达标存款各开一窗、可多窗口并存、逐笔领取 | 2. 【[活动详情](418_promotion_loss_rescue.md#detail)】`GET /promotion/loss_rescue/detail` 免登录，**未登录仅返回 `is_active` / `description` / `deposit_threshold`**；登录后按当前活动内身份下发 `user_type` / `max_rate` / `window_hours` / `claim_expire_hours` / `tiers`（新老配置独立，前端**按下发值动态渲染、不要写死默认值**），以及进行中窗口 `windows` 与待领取列表 `pending`（**只含未过期记录**） | 3. 【[领取](418_promotion_loss_rescue.md#claim)】`POST /promotion/loss_rescue/claim` 传 `{"id": "%s 奖励已到账：%s。
`（`args` = `[活动名, 金额]`，活动名同样由服务端翻译）；活动名未登记时退化为 `活动奖励已到账：%s。
`。站内信侧不受影响，仍照常落 `message_type=2` 记录 | 5. 【[签票频次限制](510_message.md#realtime-ticket-rate)】`POST /notify/ticket` 新增按会员限流：**固定窗口 1 分钟 / 30 次**，超限返回 `429`「操作过于频繁，请稍后再试」。**前端重连必须带退避**（起步不低于服务端下发的 `retry:` 值），否则网络抖动时会打满配额，把故障放大成「后续合法重连全被挡住」 | 6. 【[建立推送连接](510_message.md#realtime-stream)】补充两种「**刚连上就断**」的正常情形：① **服务端连接已满**（单实例硬上限 10000 条）；② **服务端正在停机**（滚动发布）。两者 HTTP 均已返回 `200`，服务端下发一次 `retry:` 帧后立即关闭，**不发 `event: closed`**，前端处理方式与网络故障一致（退避 → 重新签票 → 新建 `EventSource`），不要当异常上报。`event: closed` 的 `reason` **当前仍只有 `conn_limit` 一个取值** | 7. 【[建立推送连接](510_message.md#realtime-stream)】明确死链回收时延：关标签页 / 刷新 / `close()` 会被立即感知，但切网、飞行模式这类**不发 FIN** 的断开靠 TCP keepalive（空闲 30s + 3×10s 探测）**约 60 秒**才释放旧连接。前端行为不变（照常重新签票建连），仅需知晓这 60 秒内该会员在服务端可能多占一个连接名额（单实例 3 条软上限） | 8. 【[客户端接入规则](510_message.md#realtime-client-rules)】强制契约：登录后才建连；收到 toast 直接渲染**不发任何回源请求**；未知 `type` / 未知 key / 未知活动标识**静默丢弃**（不展示原始值、不弹错）；**不做降级轮询**；**重连必须带退避与次数上限**；容忍「刚连上就断」；`visibilitychange` 转 hidden 超 5min 主动 `close()`、转 visible 重建且**不补拉**断连期间的 toast；展示时长与叠加策略由前端自定；单会员单实例最多 3 条连接（超出踢最旧）。⚠️ **ticket 一次性**（服务端 `GETDEL` 消费），浏览器原生重连会复用已消费的 ticket 而必然 `401`，故恢复连接须走「**重新签发 ticket → 新建 `EventSource`**」 | 9. 【[常见坑](510_message.md#realtime-pitfalls)】本地开发经 Vite 代理走 HTTP/1.1，同域名 6 连接上限，多开标签页会耗尽连接导致其它请求挂起（生产经 CF 走 HTTP/2 无此问题）；ticket 不可复用、不可放进任何可重放的缓存；无退避重连会被 `429` 锁在门外 | 10. 【[事件格式](510_message.md#realtime-events)】**`type` 枚举最终定为 2 种**：`msg`（成品文案，直接展示）与 `promotion_trigger`（活动触发信号，需回源）。⚠️ **破坏性变更：活动奖励到账不再单独立类型**——它本就会落一条站内信，现与其它财务文案一样走 `msg` 下发同一份成品文案（活动名也已翻译），因此 `promotion` 类型**已取消**、原【活动标识清单】章节已删除，前端**无需再维护 `<活动>_claim` 到文案的映射**。新增的 `promotion_trigger`（见【[活动触发清单](510_message.md#realtime-promotion-trigger)】）表示玩家刚满足某活动触发条件，`content` 为**不带 `_claim` 后缀**的活动标识、**`args` 恒为 `[]`**，⚠️ **不得再假定 `args[0]` 一定存在** | 11. 【[每日幸运补偿](417_promotion_daily_bankrupt_pack.md#lifecycle)】触发时机从「仅在 `GET /site_content/config` 时惰性判定」扩展为兼容两种：**余额下降后约 3 秒无新变动即主动判定**，命中则即时生成礼包并推一条 `type=promotion_trigger` / `data.kind=daily_bankrupt_pack` 的 toast；原 `config` 惰性判定**保留为兵底**。**接口与字段无任何变化**，不接 SSE 的客户端行为完全不变；接了则玩家**无需刷新首页**即可看到弹窗。同一份礼包只推一次，但**必须按 `offer_id` 去重**（toast 与 config 响应可能几乎同时送达同一礼包） | 12. 【[事件格式](510_message.md#realtime-events)】⚠️ **破坏性变更：`type=msg` 的文案改由服务端翻译**。`content` 不再是 i18n key，而是**已按语言翻译并完成 `%s` 插值的成品文案**（口径与【[消息列表](510_message.md#list)】完全一致），前端**不要再查词典、不要再插值**，剥标签 / 转义后直接展示即可；`args` 仍原样下发，仅供做样式或埋点。仍按 key 渲染的客户端会展示出未翻译原文。语言取自【[签票请求](510_message.md#realtime-ticket)】的 `Accept-Language`，在建连时**固化到该条连接**上，因此 ① **签票请求必须带 `Accept-Language`**；② **玩家切换界面语言后必须 `close()` 并重新签票建连**，否则会继续收到旧语言文案。`promotion_trigger` 的 `content` 仍是**永不翻译**的英文活动标识，不受影响 | 13. 【[事件格式](510_message.md#realtime-events)】⚠️ **破坏性变更：toast 报文体重构为 `{type, data}`**，`content` / `args` 顶层字段**已移除**（本条覆盖第 10、12 条中的字段描述）。`data` 结构随 `type` 变化：`msg` → `{icon, content, show_time}`（`icon` 为展示分类 `recharge` / `withdraw` / `activity` / `bonus`，未知值按默认样式；`content` 仍是服务端翻好插好的成品文案；`show_time` 建议展示秒数，当前恒为 `0` = 前端自定）；`promotion_trigger` → `{kind}`（原 `content` 里的活动标识改放 `data.kind`）。`args` 不再下发（插值已在服务端完成，样式分流改用 `icon`） 2026-08-12 | 1. 【[首充奖励详情](413_promotion_first_recharge_bonus.md#detail)】新增 `bonus_type`（`fixed` 固定金额 / `percent` 按充值金额比例），`Tier` 新增 `bonus_percent`（加赠比例 %）。**前端须按 `bonus_type` 决定展示 `bonus` 还是 `bonus_percent`**；`percent` 模式下实际加赠 = 充值金额 × 比例（向下取整到分）。旧配置未设置 `bonus_type` 时按 `fixed` 处理，行为不变 | 2. 【[首充奖励详情](413_promotion_first_recharge_bonus.md#detail)】新增 `max_bonus`（加赠上限，`0` 为不限）。**`bonus_type=percent` 时展示预估加赠必须取 `min(充值金额 × 比例, max_bonus)`**，否则大额充值时展示值会高于实发金额 | 3. 【[每日幸运补偿](417_promotion_daily_bankrupt_pack.md#popup)】弹窗与[详情](417_promotion_daily_bankrupt_pack.md#detail)新增 `bonus_type`（`percent` 按档位门槛比例 / `fixed` 固定金额），商户可为各档配置固定加赠金额。**该字段仅影响文案展示**，各档实际加赠仍一律以 `bonus_amount` / `total_amount` 为准；旧配置未设置时按 `percent` 处理，行为不变 | 4. 【[每日幸运补偿](417_promotion_daily_bankrupt_pack.md#group)】支持按玩家**历史累计充值**分层：不同累充区间的玩家看到各自独立的礼包档位与上限。弹窗与详情新增 `group_index` / `group_min_recharge` / `group_max_recharge` / `total_deposit`。**`tiers`、`single_charge_max_bonus`、`recommended_tier_index` 仍是命中层的扁平值，前端无需改动**，也不要自行按累充金额选层；分层在礼包生成时即锁定，倒计时内充值升层不影响本笔发奖。历史累计充值未达最低层门槛的玩家不再生成礼包 2026-08-11 | 1. 活动更名（仅显示文案变更，接口路径与 `kind` 标识不变）：「每日破产礼包」→「[每日幸运补偿](417_promotion_daily_bankrupt_pack.md)」（`daily_bankrupt_pack`），`claim` 接口错误文案同步改为「幸运补偿由充值订单自动发放」 | 2. 【[首充奖励详情](413_promotion_first_recharge_bonus.md#detail)】新增 `is_active`（活动是否开启）与 `can_join`（当前玩家是否可参加）两个字段。**充值页只需读 `can_join`** 即可决定是否展示「参加首充活动」选项；详情接口本身免登录且不会因活动停用而报错 | 3. 【[首充奖励](413_promotion_first_recharge_bonus.md)】修复：商户将活动**停用**后，【[站点配置](500_site_content.md#config)】的 `popups` 仍会下发 `first_recharge_bonus` 的问题（现在停用即不再下发）。注意：这只约束**活动自动注入**的弹窗项（仅含 `kind` 字段）；商户在站点配置里**手工配的弹窗**（含 `title` / `image_url` / `url` 等字段）不受活动开关控制，仍按其自身 `is_active` 下发 2026-08-10 | 1. 新增【[每日破产礼包](417_promotion_daily_bankrupt_pack.md)】活动（`kind=daily_bankrupt_pack`）：余额跌破破产线且当日已充值达门槛时，服务端自动生成**限时礼包资格**，通过【[站点配置](500_site_content.md#config)】的 `popups` 下发（含 `offer_id` / `expire_at` / `server_now` / `today_deposit` / `seq` / `daily_max_offers` / `tiers` / `recommended_tier_index` / `single_charge_max_bonus` / `principal_bet_multiple` / `description`）。**无手动领取接口**（`POST /promotion/daily_bankrupt_pack/claim` 直接报错），加赠由充值订单异步自动入账，钱包流水 `action=daily_bankrupt_pack_claim`；倒计时须用 `expire_at` − `server_now` 计算，勿用本地时钟 | 2. 【[每日破产礼包](417_promotion_daily_bankrupt_pack.md#popup)】档位 `Tier` 下发**服务端算好的生效值**：新增 `bonus_amount`（实际加赠，已按单笔上限封顶）、`bonus_capped`（是否被截断）、`total_amount`（到手总额），`bet_multiple` 为已应用商户全局覆盖后的最终值。**展示金额一律以 `bonus_amount` / `total_amount` 为准**，不要用 `bonus_percent` 自行计算，否则会与实发金额不一致 | 3. 【[创建充值订单](200_finance.md#recharge_create)】`source` 枚举新增 `daily_bankrupt_pack`（每日破产礼包，需在礼包倒计时内下单）；不传或传错不会触发加赠 | 4. 【[首充奖励详情](413_promotion_first_recharge_bonus.md#detail)】参赛资格放宽：由「从未充值」改为「**只要未领取过首充奖励就可参加**」，**与历史充值金额无关**；玩家在充值下单时传 `source=first_recharge_bonus` 即表示参加，支付成功后按金额命中的最高档位自动发放。活动列表可见性与首充弹窗下发按同一口径判定，游客（未登录）始终可见 | 5. 【[首充奖励详情](413_promotion_first_recharge_bonus.md#detail)】`current_recharge` 不再是预留字段，现真实返回玩家累计充值金额（未登录为 `0`），仅供展示，**不再参与参赛资格判定** | 6. 【[首充奖励详情](413_promotion_first_recharge_bonus.md#detail)】新增 `recommended_tier_index`（弹窗默认选中档位下标，0-based，服务端已归一化越界值）字段；无新增接口与请求参数 | 7. 【[创建充值订单](200_finance.md#recharge_create)】补充 `source` 的两条既有行为说明（**非新增限制**）：① 只要 `source` 不是 `normal`，本单就不发放**充值套餐赠送**（活动加赠与套餐赠送互斥）；② 下单时**不校验活动资格**，不具备资格时订单照常创建入账、仅静默不发加赠，接口不报错，需玩家端自行前置判断 2026-08-08 | 1. 活动名称统一（仅显示文案变更，接口路径与 `kind` 标识不变）：「首充加赠」→「[首充奖励](413_promotion_first_recharge_bonus.md)」（`first_recharge_bonus`）、「大亨活动」→「[拼多多](405_promotion_magnate.md)」（`magnate`）、「充值狂欢」→「[充值大酬宾](414_promotion_recharge_bonanza.md)」（`recharge_bonanza`） 2026-07-28 | 1. 增加【[跑马灯](300_game.md#marquee)】（`GET /api/game/marquee/list`）：免登录返回展示用累计派彩金额（每秒 10.00~499.99 自增、触顶 1000 万回落 863126.80）与 50 条高额派彩滚动消息；消息含脱敏手机号、金额与游戏信息（`provider_game_code` 可直接启动游戏），按商户缓存 5 分钟，刷新时把近 20 分钟内派彩超 100 的真实注单随机插入列表 2026-07-25 | 1. 【[获取充值配置](200_finance.md#recharge_config)】**新增 `product_code` 与 `currency` 字段**：此前返回的 `code` 巴西与墨西哥同为通道代码 `pay4z`，玩家端**无法判断该支付项是 PIX 还是 SPEI**；现在每个支付项直接下发 `product_code`（`PIX` / `SPEI`）与 `currency`（`BRL` / `MXN`），与服务端代收下单口径一致 | 2. 【[创建充值订单](200_finance.md#recharge_create)】补齐三方下单响应字段 `pay_info` / `third_order_sn` / `raw`，并明确 **`pay_info` 需按上述 `product_code` 分支渲染**：`PIX` 为复制粘贴码（渲染二维码），`SPEI` 为收款账号信息文本（不可当二维码渲染） | 2. 新增【[金额与币种](200_finance.md#amount_currency)】通用说明：金额均为字符串十进制、单位为货币面额（非分），货币符号应按 `/finance/withdraw/config` 下发的 `currency`（`BRL` / `MXN`）动态渲染，不要写死 | 3. 修正【[获取账户余额](200_finance.md#account_balance)】响应字段：实际为 `user_money` / `bet_amount` / `total_bet_amount` / `first_deposit_amount`，此前文档误写的 `current_bet_amount` 不存在 | 4. 修正【[提现订单状态](200_finance.md#enums)】枚举 `7` 的说明：为「没收余额」（订单关闭、扣款不退回），此前误写为「强制失败」 | 5. 【[PIX 提现通道列表](200_finance.md#withdraw_pix_channels)】补充调用前置约束：**进入提现页必须先调【[提款配置](200_finance.md#withdraw_config)】**，不要直接调 channels 端点 | 6. **新增统一提现接口组**（见【[统一提现接口——迁移指引](200_finance.md#withdraw_unified)】）：以 `method`（`pix` / `bank_clabe`）为参数的一套通用端点，共 5 个 —— 【[获取收款资料](200_finance.md#withdraw_account_get)】（`GET /api/game/finance/withdraw/account`）、【[保存收款资料](200_finance.md#withdraw_account_save)】（`POST /api/game/finance/withdraw/account`）、【[删除收款资料](200_finance.md#withdraw_account_remove)】（`POST /api/game/finance/withdraw/account/remove`）、【[创建提现订单](200_finance.md#withdraw_create)】（`POST /api/game/finance/withdraw/create`）、【[我的提现订单](200_finance.md#withdraw_my)】（`GET /api/game/finance/withdraw/my`）。表单**自描述**：按 `extra_fields` 动态渲染收款资料表单，与 `/withdraw/account` 的 `fields` 对象 key 完全对称；`channels` 已按提款方式过滤，无需再调 `/withdraw-*/channels`；订单列表统一形状，收款信息收进 `account_extra`，历史记录已折叠。原按方式分裂的 PIX 旧端点（`/finance/pix/*`、`/finance/withdraw-pix/*`，共 7 个）**保留可用、行为不变**，但已标记「已废弃」，不再接收新特性（新接入的提款方式/新国家不会出现在旧端点），**建议玩家端迁移** | 7. 【[提款配置](200_finance.md#withdraw_config)】**新增 `data.method_list`**：每种提款方式一项，含 `method` / `name` / `currency` / `account_types` / `extra_fields` / `channels`（通道代码 key 为拼写正确的 `channel`，旧端点为 `channle`）。本接口成为提现页**唯一配置入口**，一次返回渲染整页所需的全部静态配置；原有 `data.currency` / `data.methods` 保留不变 | 8. 新增「**提现方式必须与商户币种匹配**」校验（`pix` ↔ `BRL`、`bank_clabe` ↔ `MXN`），对新旧提现下单端点**同时生效**；新增业务错误 `提现方式与商户币种不匹配` / `提现方式不可用` | 9. **下线 2026-07-24 新增的 7 个银行（CLABE）独立端点**（`/finance/bank/config`、`/finance/bank/index`、`/finance/bank/create`、`/finance/bank/remove`、`/finance/withdraw-bank/channels`、`/finance/withdraw-bank/create`、`/finance/withdraw-bank/my`）：这批端点从未上线使用，现统一由上述统一提现接口组承载，调用时传 `method=bank_clabe` 即可。**巴西 PIX 玩家端不受影响**（PIX 旧端点全部保留） 2026-07-24 | 1. 增加【[提款配置](200_finance.md#withdraw_config)】（`GET /api/game/finance/withdraw/config`）：下发商户币种与可用提款方式代码（`pix` / `bank_clabe`），客户端据此分流 PIX / CLABE（SPEI）提款页面，无需再打包写死 | 2. 增加墨西哥银行提现（CLABE）接口文档：银行提现通道列表 / 创建银行提现 / 我的银行提现订单 / 获取银行收款资料 / 银行账户类型枚举 / 保存银行收款资料 / 删除银行收款资料（**已于 2026-07-25 下线**，见上方第 9 条） | 3. 【[创建 PIX 提现](200_finance.md#withdraw_pix_create)】「无未完成提现单」校验口径说明更新：改为跨提现方式全局判定（此前仅同方式内判定）；接口 URL 与请求/响应结构均无变化 2026-07-16 | 1. 【[注册](100_auth.md#register)】`link_queries` 参数说明更新：应传落地页 URL 的完整 query string（可带 `?` 前缀，最长 1024）；其中 `fbclid` 会被服务端构造为 FB 点击 ID（`fb.1.{注册时刻毫秒}.{fbclid}`）用于 Facebook 广告归因上报（FB CAPI），投放场景务必透传 2026-07-13 | 1. 【[充值配置](200_finance.md#recharge_config)】响应结构调整：顶层新增 `data.bet_multiple`（本金打码倍数，商户级全局配置，原本金打码硬编码 ×1）；`packages[].bet_multiple` 语义仍为“赠送金额打码倍数”保持不变。历史订单不受影响 2026-07-11 | 1. 增加【[通用接口](050_common.md)】：新增玩家端预签名上传接口 `POST /api/game/common/get_upload_url`，客户端两步式直传 S3（先取 `upload_url` 再 `PUT` 二进制），内容哈希幂等判重、命中已上传对象时返回 `exists=true` 直接复用；【[修改用户资料](100_auth.md#update)】的 `head_portrait` 字段补充上传接口跳转链接 2026-07-08 | 1. 增加【[营销线索接口](700_marketing_lead.md)】：新增 `POST /api/game/marketing_lead/allocate`，每玩家每天固定分配 20 个明文手机号，幂等 + 历史去重，`is_registered` 实时刷新 | 2. 修正【[兑换码兑换](416_promotion_redeem_code.md#redeem)】文档路径为 `POST /api/game/promotion/redeem_code/claim`（走 promotion 框架统一入口 `/promotion/:kind/claim`），原写法 `/api/game/redeem_code/redeem` 未实际注册，会 404 2026-07-07 | 1. 【[邀请人列表](401_promotion_treasure_box.md#invitees)】新增可选参数 `only_valid`，`true` 时仅返回有效用户（`status ≠ 2`） | 2. 【[邀请人列表](401_promotion_treasure_box.md#invitees)】读取时顺带实时评估名下未达标邀请（达标即发箱 / 刷新累充累投快照），同一玩家 30 秒冷却 2026-07-02 | 1. 增加【[首充广告上报数据](200_finance.md#recharge_first_report)】（`GET /api/game/finance/recharge/first_report`）：供玩家端判断是否触发首充广告像素（Pixel）上报；命中过滤条件时服务端会自动标记 `is_ad_reported`，避免重复上报 | 2. 【[注册](100_auth.md#register)】新增可选参数 `area_code`（国家手机区号，纯数字字符串）；商户已配置区号后按对应正则校验 `username`（约定 `username` 即手机号），未配置商户零影响。新增业务错误 `手机区号与商户配置不一致` / `手机号格式不正确` 2026-07-01 | 1. 增加【[代理数据看板](412_promotion_agent_rebate.md#agent_stats)】（`GET /api/game/agent_rebate/agent_stats`）：一次性返回时段维度新下属统计 + 历史累计佣金/有效投注/下线树规模，`range` 支持 today / yesterday / this_week / last_week / this_month / last_month 2026-06-28 | 1. 新增玩家端 VIP 领取记录接口 `GET /api/game/vip_claim/list`，详见【[VIP 领取记录](415_promotion_vip.md#claim_list)】 | 2. 【[充值配置](200_finance.md#recharge_config)】`packages` 字段调整：移除 `is_active` / `sort_order` / `remark`，套餐改为配置化（列表中出现即为启用，顺序即排序）；`id` 语义变更为数组下标 | 2. 增加【[兑换码接口](416_promotion_redeem_code.md#redeem)】（`POST /api/game/promotion/redeem_code/claim`） | 3. 【[兑换码兑换](416_promotion_redeem_code.md#redeem)】补充业务错误 `兑换码领取人数已达上限`（对应后端 `max_claims` 配额上限） 2026-06-22 | 1. 【[VIP 领取](415_promotion_vip.md#claim)】新增 `kind=all` 一键领取所有可领奖励（升级礼金 / 周俸 / 月俸），不可领的项静默跳过 | 2. 【[VIP 详情](415_promotion_vip.md#detail)】新增 `pending_amount` 字段，返回当前所有可领奖励金额合计 2026-06-23 | 1. 【[创建充值订单](200_finance.md#recharge_create)】`action_type` 由必填改为可选（不传时自动选用 `sort_order` 最小的启用代收通道） | 2. 【[创建充值订单](200_finance.md#recharge_create)】补齐 `source` 字段说明及枚举值 `normal` / `first_recharge_bonus` / `recharge_bonanza`，明确与首充加赠 / 充值大酬宾促销的联动关系 | 3. 增加【[站内信接口](510_message.md)】（未读数 / 列表 / 单条已读 / 全部已读） 2026-06-18 | 1. 增加【[上报推送 token](111_pwa_push.md#subscribe)】与【[注销推送 token](111_pwa_push.md#unsubscribe)】接口 2026-06-17 | 1. 【[获取登录用户详情](100_auth.md#detail)】新增 `new_token` 字段，支持 JWT 自动续签 2026-06-16 | 1. 【[站点配置](500_site_content.md#config)】新增 `service_links`（客服链接）与 `social_manage`（社媒管理）两个列表字段 2026-06-15 | 1. 增加【[站点配置接口](500_site_content.md#config)】 | 2. 【[站点配置](500_site_content.md#config)】资源元素补充 `title` 字段；`popups` 支持 `source: "promotion"` 活动弹窗自动注入（带 `kind` / `payload`） 2026-06-13 | 1. 增加【[代理返佣接口](412_promotion_agent_rebate.md)】 | 2. 增加【[首充加赠接口](413_promotion_first_recharge_bonus.md)】 | 3. 增加【[充值大酬宾接口](414_promotion_recharge_bonanza.md)】 | 4. 增加【[VIP 接口](415_promotion_vip.md)】 | 5. 增加【[PWA manifest](110_pwa.md#manifest)】与【[PWA 免密登录](110_pwa.md#login_pwa)】接口 2026-06-11 | 1. 增加【[修改用户资料](100_auth.md#update)】接口 2026-06-09 | 1. 增加【[访客行为采集接口](600_stats.md)】 2026-06-04 | 1. 增加【[站点内容接口](500_site_content.md)】 2026-06-01 | 1. 完善接口说明 | 2. 增加【[用户认证接口](100_auth.md)】 | 3. 增加【[财务接口](200_finance.md)】 | 4. 增加【[游戏接口](300_game.md)】 | 5. 增加【[活动接口](400_promotion.md)】 | 6. 增加【[宝箱活动接口](401_promotion_treasure_box.md)】 | 7. 增加【[通行证活动接口](402_promotion_battle_pass.md)】 | 8. 增加【[累计充值活动接口](403_promotion_cumulative_recharge.md)】 | 9. 增加【[每日签到接口](404_promotion_daily_checkin.md)】 | 10. 增加【[大亨活动接口](405_promotion_magnate.md)】 | 11. 增加【[神秘奖金接口](406_promotion_mystery_bonus.md)】 | 12. 增加【[返水接口](407_promotion_rakeback.md)】 | 13. 增加【[红包雨接口](408_promotion_red_packet_rain.md)】 | 14. 增加【[救济金接口](409_promotion_rescue_bonus.md)】 | 15. 增加【[7日返现接口](410_promotion_weekly_cashback.md)】 | 16. 增加【[周救济金接口](411_promotion_weekly_rescue_bonus.md)】 2026-05-31 | 初稿