2.7 KiB
2.7 KiB
黄金矿工（CoinMadness）文档入口
核对日期：2026-09-30。客户端基准：codex/coin-madness 的 7e14f661，已合入 main 44901f1e。本次文档核对不代表线上部署或真机支付已验收。
阅读入口
| 内容 | 文档 | 定位 |
|---|---|---|
| 客户端流程、代码位置、资源加载 | 活动实现说明 | 当前实际实现 |
| 环境、验证和协议差异 | 接入说明 | 联调交接入口 |
| 后端字段和请求 | 后端接口 V1.7 | 仓库最新协议，不代表全部已接入 |
| 下单、查单、客服回退 | 支付约定 | 客户端行为 |
| 需要前后端确认的事项 | 接口对齐清单 | 替代早期模拟版需求 |
| 手工联调与集合下载 | Postman 指南 | 操作入口 |
| VIP 六档礼包 | VIP 配置说明 | 后端配置，前端按返回值展示 |
当前状态
- 已接入真实活动查询、通关、支付、领奖和补发，不再是“模拟版待接入”。
assets/coin_madness是活动分包；Host、GoldMinerService、公共加载动画和 resources 入口图在分包外。- 游戏测试包、活动测试面板、首页测试按钮和两个演示场景已删除。离线回归脚本与独立界面预览工具保留。
- 开发版/体验版选 testHttpip，其他版本选 httpip；当前两个地址相同，不能据版本名认定请求进入独立测试服。
- 未付费可累计进度，主线与无尽胜利使用服务端有效期 ID。任务按全期累计进度展示，已解锁且达标的未领取任务可选择领取，最终由后端授权。
- 客户端尚未完全对齐仓库 V1.7，详见接入说明；不能将协议新功能直接写成已交付。
历史资料
| 文件 | 用途 |
|---|---|
| V1.3 协议副本 | 历史字段参考，不能覆盖 V1.7 |
| V1.5 接入记录 | 补发授权、公共日程等阶段性变更 |
| PRD V1.1、设计 V1.1 | 原产品和设计记录，后续变更看当前协议与配置 |
| 原策划确认单 | 保留原始确认记录，不作为当前规则或接口验收单 |
旧“付费后才计数、每段清零、只统计主线、必须依次领取、每 30 秒全量刷新”不适用于当前客户端。后续维护更新实现说明与接入差异，不再复制完整后端协议到 docs。