# 黄金矿工（CoinMadness）文档入口

核对日期：2026-09-30。客户端基准：`codex/coin-madness` 的 `7e14f661`，已合入 main `44901f1e`。本次文档核对不代表线上部署或真机支付已验收。

## 阅读入口

| 内容 | 文档 | 定位 |
| --- | --- | --- |
| 客户端流程、代码位置、资源加载 | [活动实现说明](../assets/coin_madness/README.md) | 当前实际实现 |
| 环境、验证和协议差异 | [接入说明](GoldMiner接入说明.md) | 联调交接入口 |
| 后端字段和请求 | [后端接口 V1.7](../server/laf-cloud/functions/goldMiner/FRONTEND-API.md) | 仓库最新协议，不代表全部已接入 |
| 下单、查单、客服回退 | [支付约定](CoinMadness支付联调当前约定.md) | 客户端行为 |
| 需要前后端确认的事项 | [接口对齐清单](CoinMadness后端接口需求.md) | 替代早期模拟版需求 |
| 手工联调与集合下载 | [Postman 指南](黄金矿工-Postman操作指南.md) | 操作入口 |
| VIP 六档礼包 | [VIP 配置说明](../server/laf-cloud/functions/goldMiner/VIP-TIERS.md) | 后端配置，前端按返回值展示 |

## 当前状态

- 已接入真实活动查询、通关、支付、领奖和补发，不再是“模拟版待接入”。
- `assets/coin_madness` 是活动分包；Host、GoldMinerService、公共加载动画和 resources 入口图在分包外。
- 游戏测试包、活动测试面板、首页测试按钮和两个演示场景已删除。离线回归脚本与独立界面预览工具保留。
- 开发版/体验版选 testHttpip，其他版本选 httpip；当前两个地址相同，不能据版本名认定请求进入独立测试服。
- 未付费可累计进度，主线与无尽胜利使用服务端有效期 ID。任务按全期累计进度展示，已解锁且达标的未领取任务可选择领取，最终由后端授权。
- 客户端尚未完全对齐仓库 V1.7，详见接入说明；不能将协议新功能直接写成已交付。

## 历史资料

| 文件 | 用途 |
| --- | --- |
| [V1.3 协议副本](GoldMiner-FRONTEND-API-v1.3.md) | 历史字段参考，不能覆盖 V1.7 |
| [V1.5 接入记录](GoldMiner-API-v1.5-changes.md) | 补发授权、公共日程等阶段性变更 |
| [PRD V1.1](goldMiner-PRD.md)、[设计 V1.1](goldMiner-backend-design.md) | 原产品和设计记录，后续变更看当前协议与配置 |
| [原策划确认单](CoinMadness活动策划确认单.docx) | 保留原始确认记录，不作为当前规则或接口验收单 |

旧“付费后才计数、每段清零、只统计主线、必须依次领取、每 30 秒全量刷新”不适用于当前客户端。后续维护更新实现说明与接入差异，不再复制完整后端协议到 docs。