# 黄金矿工 V1.5 接入记录（历史）

2026-09-30 校注：本文件记录阶段性变更。仓库最新协议为 [V1.7](../server/laf-cloud/functions/goldMiner/FRONTEND-API.md)，当前接入程度见 [接入说明](GoldMiner接入说明.md)。

- 补发改为 settlementId/periodId/rewards；reward 自带 taskId/grantId/items，不再按旧 _id/taskIds 对过期任务 claim。
- 保存金币后 confirm_settlement_delivery，传 settlementId/grantIds 并验证 confirmedGrantIds，不再调用 ack_settlement。
- 复用本地交付记录：saved 只补确认，结果不明不重复加币；总余额保存与确认仍不是同一事务。
- 接入 activityConfig/list，保留成功日程，失败不覆盖；通关原样使用有效服务端期 ID，包括临时期，不再自行计算周四 ID。
- 当时 settling 退出并重试的行为仍在客户端；V1.7 已要求继续可用游标扫描其他期，尚待对齐。
- 管理发布、初始化索引、支付回调仍属于后端，不加入玩家客户端。

离线脚本 check-api.cjs、check-api-v15.cjs 保留；旧测试面板及 check-test-tools.cjs 已删除。该记录不能作为线上支付、部署或 V1.7 全量验收证明。