游戏内商店：橱窗、商品和价格

玩家看到什么

• 以标签页呈现的橱窗。 橱窗的第一个分区是轮播，其余是卡片网格。
• 免费的每日礼物，领取前一直高亮。
• 卡片上的计时器：“刷新倒计时”“开放倒计时”“已售罄”。
• 购买确认弹窗（在手机上是底部弹出面板）。
• “你获得了”动画：奖励飞向余额计数器。
• 有免费商品待领取时，商店标签页上的徽标。

商店的结构

商店是一棵树：橱窗 → 分区 → 槽位 → 商品。

• 商品：出售的东西，包括价格、奖励、限购、角标（“最划算”“x2”）。所有商品都放在同一个目录中。
• 槽位：橱窗货架上的一个位置。商品只能通过槽位购买：不在任何槽位中的商品根本不会出售。
• 轮换：槽位可以从一个商品池中展示商品，并按计划更换，就像每日商店。轮换由服务器计算，所以玩家在每台设备上看到的商店都一样。

价格

你可以显示划线的“原价”，折扣百分比由服务器计算。一个商品可以有多个价格选项，例如金币或宝石。

购买限制

• 终身：例如新手礼包只能买一次。
• 每天：在 UTC 午夜重置。
• 冷却：间隔一段时间后才能再次购买。
• 每个轮换时段：商品在货架上期间该槽位的限购。

“首购”和“已售罄”标记以及计时器由服务器为每位玩家计算。

开发者须知

商店通过 @idosgames/core 中的 client.store 工作。根据 getStorefront() 绘制界面：这是已经为当前玩家计算好的橱窗（轮换、限购、计时）。getDefinitions() 只是配置，对所有人都一样。

const res = await client.store.getStorefront()
if (!res.ok) return showError(res.error)

for (const store of res.data.Stores ?? [])
  for (const section of store.Sections ?? [])
    for (const slot of section.Slots ?? []) {
      // 空槽位会以 Offer === null 返回：绘制一个空框，避免货架跳动。
      if (!slot.Offer) continue
      drawCard(slot.Offer, slot.RefreshesAtUtc)
    }

const buy = await client.store.purchase(offer.OfferID, 1, {
  selectedOptionID: option.OptionID,
  slot: { storeID: store.StoreID, sectionID: section.SectionID, slotID: slot.SlotID },
})

• 如果购买返回 OFFER_NOT_IN_ROTATION，说明橱窗已变化：直接重新加载，不要显示错误。
• 请求进行中时禁用“购买”按钮：每次调用 purchase 都是一次单独的购买。
• 计时器从响应中的 ServerTimeUtc 开始倒数，而不是设备时钟。
• 剩余限购为 null 表示“不限”，0 表示“已售罄”。

每个字段都在技能 store-system 中有说明，由 SDK 的 MCP 服务器提供。