首页活动日程接口

2026-10-10 本地更新：当前 providers = [cloudRiseActivities, goldMinerActivities, pyramidActivities]。金字塔已拆分日程和个人详情，本接口只返回日程；完整状态由 /pyramid/api action:info 返回。尚未部署。

POST /activityConfig/list，登录客户端请求体为 { "uid": "100004", "token": "<当前登录 token>" }。uid 使用 users.onlyId；鉴权后以 users._id 查询金字塔。匿名查询只返回公共日程，不返回私人状态；无效 uid/token 返回 code:0。

2026-10-10：金字塔个人详情从本接口移至 /pyramid/api action:info。列表顶层和活动条目均不再包含 pyramid、pyramidError、pyramidErrorMessage。剩余参与时间不足、画像不可用等资格校验由详情接口返回标准 errorCode 和中文 msg，不阻断公共日程查询；数据库或配置异常仍使列表查询失败。

金字塔门槛固定为通过第 50 关，即服务端 users.levelAmount >= 50、客户端 GM_INFO.level >= 50，日程返回 unlockLevel:50。未达门槛不返回金字塔日程。列表查询始终只读，不创建玩家进度或档位分配、不结算奖励。符合资格的首次详情查询才冻结本期档位并创建进度；下单不能绕过参与门槛。

audience: [] 表示全服开放；非空数组仅对所列 users._id 开放新参与，与账号注册时间无关。已有本期参与者仍使用冻结快照。

金字塔当前活动优先，否则返回未来七天内最近一期。已有玩家使用冻结快照，未参与玩家按当前配置开启状态、环境和 audience 筛选日程。已完成本期不返回该期入口；第六层尚未完成发奖时保留。配置晚于活动开始生效时，预告 startsAt 使用 effectiveFrom。前端按服务器校准时间、关卡门槛和已获取的本期个人完成状态计算入口，不从列表读取奖励内容。

本接口不再处理 pyramidPeriodId。历史个人状态改为通过 /pyramid/api 的 {action:"info",uid,token,periodId} 查询，其中 uid 使用 users._id；只允许查询本人历史记录，不新建历史参与进度。公共列表 uid 仍使用 users.onlyId。

返回内容

{
  "code": 1,
  "msg": "ok",
  "data": {
    "schemaVersion": 1,
    "serverNow": 1789885200000,
    "windowEndsAt": 1790490000000,
    "refreshAt": 1789885230000,
    "activities": [
      {
        "activityId": "cloudRise",
        "periodId": "cloudRise:100004:<随机期标识>",
        "configVersion": "cloudRiseTestV1",
        "startsAt": 1789833600000,
        "endsAt": 1789920000000,
        "unlockLevel": 100,
        "phase": "active"
      },
      {
        "activityId": "goldMiner",
        "periodId": "goldMiner:2026-09-24",
        "configVersion": "goldMinerTestV1",
        "startsAt": 1790179200000,
        "endsAt": 1790524800000,
        "unlockLevel": 41,
        "phase": "upcoming",
        "purchaseEnabled": true
      }
    ]
  }
}

示例用于说明结构，具体活动和版本以环境配置为准。所有时间均为 Unix 毫秒，边界采用 startsAt <= 当前时间 < endsAt。

字段	含义
schemaVersion	返回结构版本，目前为 1
serverNow	服务器生成本次日程的时间，用于客户端校准时钟
windowEndsAt	本次查询未来七天的右边界，不含该时刻；已开始但尚未结束的活动也返回
refreshAt	建议最晚重新查询的服务器时间：30 秒后或最近的开始/结束边界，取较早值
activities	每个 activityId 最多一条；优先当前活动，无当前活动则返回最近即将开始的一期
activityId	固定玩法标识，不能用它表示期号
periodId / configVersion	活动期次和适用的配置版本
startsAt / endsAt	各玩法活动窗口；百人赛为 HomeScene 请求创建的个人期，endsAt 同时是匹配后的挑战截止时间
unlockLevel	已通过主线关卡数门槛，不是当前待挑战关卡编号
phase	请求时刻的 active / upcoming；缓存后应根据服务器校准时间重新计算
purchaseEnabled	黄金矿工购买开关；false 不代表关闭活动，也不影响已购权益
openingRules	开期条件数组；已登录玩家会收到百人赛规则，即使 activities 中尚无已开启活动

百人赛当前开期规则示例（无历史期）：

{"activityId":"cloudRise","enabled":true,"unlockLevel":100,"cooldownMs":43200000,"lastEndedAt":null,"hasOpenPeriod":false}

lastEndedAt 为上次失败/完成的最终阶段结束时间，或自然超时的原截止时间；null 表示没有已结束活动。HomeScene 使用已通过关卡数 >= unlockLevel、hasOpenPeriod=false、lastEndedAt=null 或校准当前时间-lastEndedAt > cooldownMs，并检查 enabled=true，满足后才发送 cloudRise/index action=open_period。百人赛列表只提供事实，查询不会开启百人赛活动。成功回执后显示新个人期入口。

接口不返回 eligible / visible；金字塔状态查询使用 /pyramid/api action:info，抽奖、支付和发奖仍使用原业务接口。公共 enabled=false 只阻止新参与：百人赛已有个人期、黄金矿工已参与玩家和已分配付费权益仍按有效时间展示；黄金矿工需携带 uid/token 才能在关闭后返回本玩家的期次。匿名查询不会展示已关闭的黄金矿工期。百人赛挑战结束或到期后不再列出该个人期，后续由 HomeScene 按开期规则请求新期。待展示结算、未保存奖励和黄金矿工权益仍由对应玩法接口处理，不因列表缺少期次而丢弃。

无活动返回 code:1、activities:[]。查询失败返回 code:0、data:null，不能当作成功空列表。客户端在请求期间及失败后保留当前账号尚在有效期内的日程，成功返回后才整体替换；缓存按测试/正式环境和玩家 uid 隔离，账号或登录 token 变化后等待新的列表，不恢复上一登录的缓存。

查询及版本规则

百人赛：读取当前用户 users.cloudRisePeriod，兼容上线前仍进行中的旧挑战。只返回未结束的个人期；创建逻辑仅在 HomeScene 显式请求 open_period。配置模板选择、个人计时和旧数据兼容见百人赛说明。
黄金矿工：复用 goldMiner/config.calendar 与 goldMiner/service.periodById，从北京时间 2026-10-01 00:00 起每 14 天一期，开放 7 天、冷却 7 天；此前保留周四起四天的历史窗口。使用该期开启前已发布的适用配置；不把配置发布时间当作周期开启时间。兼容迁移冻结配置和购买开关，查询不创建玩家记录。
每个玩法只返回一期：优先当前进行中的活动；没有当前活动时，返回查询窗口内 startsAt 最早的未来一期。重叠的当前期保留 startsAt 最新优先、periodId 升序的规则，黄金矿工正在开放的测试临时期继续优先于普通活动。最终列表按 activityId 排序。
refreshAt 仍检查所有候选期的时间边界，包括本次没有返回的期次，确保测试临时期开始时可以及时重新选期。到期后由下一次查询返回新的当前期或最近未来期。
activities 只输出日程字段，不输出金字塔奖励、商品、进度、参与错误或管理员配置。

按活动查询及后续扩展

接口按玩法显式注册查询函数，并通过 Promise.all 并发执行后合并结果：

const providers = [cloudRiseActivities, goldMinerActivities, pyramidActivities];

cloudRiseActivities：从已验证身份的 user 读取个人百人赛活动期；不扫描其他玩家，不创建或延长活动。
goldMinerActivities：通过 periodById 只读取 activityId: "goldMiner" 的配置及控制记录，保留活动日历、版本选择、迁移冻结配置和购买开关规则。
未注册的活动不会因为配置写入 activityConfigs 就出现在列表中，也不会影响 refreshAt。

新增玩法时，新增一个只查询该玩法 activityId 的函数，接受 (now, windowEndsAt, user)（不需要玩家信息的玩法可忽略第三个参数），返回 { activities: ActivityInfo[], openingRules: OpeningRule[] }（没有开期规则的玩法返回空 openingRules），并添加到 providers。函数负责本玩法的配置有效性、期次计算及版本选择；只返回当前开放或未来七天内开始且尚未结束的期次，允许读取本玩家活动状态以决定日程，但不写入玩家、订单或奖励记录。必须遵循公共 enabled 规则：先选版本再判断，新参与使用 store.latestEnabled 或 isEnabled，已有参与快照与权益按玩法保留；provider 与直接参与接口共用判断。函数执行失败时抛出错误，由接口统一返回失败，不能伪装成空列表。

新函数输出统一的 ActivityInfo 结构，客户端无需改变公共查询和缓存格式，但仍需接入新活动的图标、可见性和点击处理。部署新的查询函数及依赖后重新发布列表接口，活动才会返回。

前端接入时机与部署

登录后、回到首页或回到前台时查询公共日程；首页根据服务器校准时间和已知开始/结束边界本地更新入口，不按 refreshAt 轮询。金字塔个人详情与日程分别缓存：打开页面、首页恢复、抽奖、领奖和支付确认后通过 /pyramid/api action:info 刷新详情，不触发公共列表请求。

先发布 activityConfig/store、新增 cloudRise/periods，以及已有 goldMiner/config、goldMiner/service、goldMiner/testPeriods 和 Utils 依赖；再同步发布 login、cloudRise/index、activityConfig/list 及 YAML。配套客户端必须携带 uid/token。列表无需新集合或数据迁移，POST 空请求仅能验证公共日程。本地修改不会自动部署。此次金字塔改动需要配套更新 pyramid/api、activityConfig/list 和客户端；旧客户端依赖已移除的 action:list，不可与本次接口变更错版本发布。

本地验证：node --test laf-cloud/functions/activityConfig/tests/list.test.mjs。

黄金矿工测试临时期

测试服同时设置 PAYMENT_APP_ENV=test、GOLD_MINER_TEST_PERIODS_ENABLED=true 后，本接口包含已发布的 goldMiner:test:... 临时期。临时期正在开放时优先展示它，隐藏当前普通活动条目，与黄金矿工 info 保持一致；结束后恢复正式日历选期。没有当前活动且它是最近未来一期时，临时期按 upcoming 返回。客户端在开始/结束边界重新查询列表，不要自行推算期 ID。其他字段与正式活动一致，配置和联调步骤见临时期说明。

部署本次拆分时同步更新 pyramid/api、activityConfig/list 和客户端；不新增云函数。旧客户端依赖列表中的个人详情，不能单独升级后端。

金字塔详情失败示例：{code:0,data:null,errorCode:"PROFILE_UNAVAILABLE",msg:"付费资料正在同步，请稍后重试"}。列表不再嵌套此错误信息。

11 KiB Raw Blame History