商店与商品刷新
商店承载每日精品、金币兑换及专用货币商店。抽奖与真实付费分别见抽奖及充值礼包。本文合并旧功能说明、《商店系统需求》全部有效规则与最新服务端静态实现;来源中的示意价格和布局不代表当前配置值。
入口与展示
商店位于主界面标签栏。资源栏金币“+”跳到金币购买区;钻石“+”的充值跳转受商店解锁和对应功能实际开放约束。未解锁时不执行跳转。来源中钻石充值区标记暂不开发,其充值首购奖励规则在商业化页集中维护,不能只因界面图存在就宣布可支付。
每日精品展示标题、下一次重置的时分秒倒计时、刷新操作、商品货架。来源规定八格:首格固定钻石,其余七格为按权重抽取的普通物品。金币购买区有三个档位。商品、价格和消耗货币均从配置读取。
每日精品
| 项目 | 设计规则 |
|---|---|
| 固定钻石 | 第一个格子固定,不参与手动刷新;每日首次免费,后续按广告次数领取,单次所得钻石固定 |
| 普通商品 | 按权重生成;商品组控制是否同时出现;配置产物 ID/数量、价格 ID/数量、权重、折扣和限购 |
| 购买 | 资源足够时点击商品购买,成功后展示奖励;普通商品每轮只可购买一次,之后灰化并显示售罄 |
| 不足 | 价格显示红色,点击给金币或钻石不足提示;金币获取弹窗与跳转入口需和当前主界面一致 |
| 折扣 | 图标左上显示折扣标签,价格显示折后价;不能对已配置价格重复折算 |
| 每日重置 | 凌晨零点刷新每日商品与购买状态;界面显示剩余时间 |
| 手动刷新 | 仅重随普通商品,恢复这些商品的可购买状态;成功后消耗一次刷新机会,机会耗尽时灰化 |
| 消耗膨胀 | 来源要求货架刷新时同步消耗膨胀系数;采用当前关卡/经济配置的计算口径,不在界面固定倍率 |
原来源开头只写广告刷新,后面的界面规则补充“先消耗每日免费刷新次数,再广告刷新,均有配置上限”。同份来源 2026-06-16 批注又注明广告暂未实装。这些是历史范围说明;最新服务端已有免费/广告次数字段,是否真实广告完成发奖仍需对应渠道环境证据。
金币购买
| 档位 | 规则 |
|---|---|
| 免费/广告金币 | 每日首次免费,之后看广告领取;次数有限,用尽灰化 |
| 小额钻石兑换 | 消耗配置钻石,获得配置金币,可带折扣 |
| 大额钻石兑换 | 与小额同类,消耗和产出独立配置 |
金币所得受膨胀系数影响。钻石不足时数字变红,点击提示不足。来源同时出现“广告获得金币却配置钻石消耗”的表述,不能将该行解释为观看广告还必需扣钻石;实际扣费以对应商品模式和服务端返回为依据,产品意图仍需确认。
红点和操作状态
有免费钻石、免费金币或尚可进行的广告领取时,对应商品与主界面商店入口提示红点,全部耗尽后消失。普通付费商品可购买不自动等于有免费奖励红点。
| 状态 | 表现与操作 |
|---|---|
| 常规 | 显示物品品质、图标、数量与售价 |
| 免费 | 显示免费,点击领取 |
| 广告 | 显示广告标识,完成有效广告流程后领取 |
| 售罄 | 灰化、售罄文案;禁止再次购买 |
| 折扣 | 显示折扣标识和已经折算的价格 |
下图保留每日商店、固定格、金币区的布局依据;文字规则和真实配置优先于图上的示意数值。


当前实现与边界
后端 88b24abec878dfbd269df5627ca2ce3d37513e12 的 service/role/model/shop/shop.go 按配置中存在的商店类型创建角色商店;跨天重置已经按类型区分:
| 类型 | 当前代码行为 |
|---|---|
| 普通商店 | 每日重建货架,按关卡和权重重新生成 |
| 水晶商店 | 每日清购买/广告次数 |
| 英雄招募兑换商店 | 每周一清购买/广告次数 |
| 竞技商店 | 当前每日清次数;源码明确注明这是缺少刷新周期配置时采用的假设 |
商品已经从配置下架时会重建货架。每日同时清免费/广告刷新计数。上述日期口径不能与礼包的“周日 UTC 重置”混用,二者属于不同业务。
购买需要服务端校验货币、格子状态、限购和广告条件;客户端收到新状态后更新货架和奖励。客户端 Features/Shop、ShopRedDotHandler 是展示接入定位。当前静态审计不能证明真实广告、膨胀产量或跨日界面刷新已经通过。
待确认差异
- 竞技商店每日重置是代码内明确假设,需要玩法决定;不能把它当已批准赛季规则。
- 飞书“钻石充值暂不开发”与当前商业化配置存在的关系,需要按实际入口和支付环境分开判断。
- 商品刷新时膨胀系数具体取值、显示折扣与计价字段语义需结合对应配置,不能照抄示意价格。
依据
旧 features/shop.md;飞书 Ft79bUhrRoPETEx2gdzccPh6nfb 的规则与界面需求两张有效工作表(第三张为空);后端上述固定提交的商店模型、gameconfig/shopcfg/shop.go 与购买处理入口。旧原文中的流程占位、重复图说明及历史任务状态不作为当前功能要求。