挂机收益与快速收益

本页于 2026-10-15 整合现有功能稿、飞书内容及客户端 origin/develop@7f0636c9 的功能资料。原 draft/unknown 不因整理自动变为批准；设计规则、源配置与运行结果分别说明。本次只做文档及源码审阅，没有执行游戏功能测试。

入口、前提与状态

从主界面挂机收益按钮查看当前已通关主线关卡的奖励效率、累计时间与金币/道具预览。领取普通累计收益或消耗体力换取快速收益，奖励状态由服务端返回。

完整规则、配置与界面

Sheet1

挂机收益功能

• 挂机获得的奖励，根据玩家通关的关卡进度来

• 挂机奖励主要分2类，金币奖励和道具奖励

• 关卡进度越高，每小时获得的金币奖励越高

• 关卡进度越高，每小时获得的道具奖励越多

• 可一次性领取n小时（配置）的挂机奖励

• 每日次数：3（配置），每日重置

• 领取一次-1，次数没用完，每日0点也重置为3

• 次数用完后，本日不可再快速领取

• 每次消耗体力：10（配置）

• 同时满足需消耗的体力，且有次数时，可领取

UI界面

• 一、入口按钮：主界面挂机收益按钮打开界面

• 二、已有功能不变

• 1关卡名：取当前最新的已通关的主线关名字

• 2挂机奖励效率：取当前关配置的值显示

• 3挂机倒计时

• 4已获得的奖励预览

• 当挂机时间<挂机最小领取时间时，奖励预览区域显示【请稍后再来。。】

• 当挂机时间>=挂机最小领取时间时，奖励预览区域显示奖励物品图标和数量

• 5点击图标打开道具tips，领取成功则弹出奖励界面

• 三、领取区域按钮改动

• 1、增加快速收益领取按钮

• 当有次数且消耗体力数足够时，点击按钮一次性获取n小时的挂机收益，弹出奖励展示界面

• 2、显示每日快速收益次数（配置），快速按钮，消耗体力

• 每日次数：当日有次数时正常显示，每领取一次-1，用完后显示为：本次次数已用完。0点重置。

• 消耗体力显示：已有体力数/每次消耗体力数，已有体力数不足时显示红色，已有体力=>消耗体力时，正常显示

• 次数不足时，点击按钮文本提示：快速收益次数已用完

• 体力不足时，点击按钮弹出体力购买弹窗

• 3、红点提示

• 当有可领取的挂机奖励时（挂机时间满足可领），入口按钮出红点，领取后，红点消失

快速收益次数：3次
领取
快速收益
领取按钮区域

实现证据、差异与未知

当前边界

普通金币按时间计算，随机道具按种子/权重；最大累计时长、最小领取时间和快速收益折算小时数来源没有明确统一数值，不能把“沿用领主”当可执行规格。快速收益设计例每日3次、每次10体力，均以配置为准，0点清余次数重置。体力不足打开购买弹窗，次数不足提示，正常领取达到最短时间时亮红点。

旧feature_key保留以维持功能身份，但科技不是挂机收益的已实现子流程：科技升级需服务端校验消耗和效果；领地科技当前EntryModel标为未实现。科技的树、前置、等级/效果与独立入口未有足够资料，不能凭key中的science宣称完整。

原型与图示

来源

旧home-idle-reward-science；飞书QPjlbMyGZoHdqHxkPrFcbpkcnUB的正文、表格、图示与UI标注；客户端HomeMain/frontend-brief.md。当前源码边界不等同运行验收。

后端实现证据（88b24abe）

handler/build/build.go普通/快速Harvest都累计HistoryAfkRewardCount及OfflineReward任务；快速IsAfk另扣AFKRewardCostPhysical，并计OfflineRewardFast与PhysicalCost，普通不计Fast。这是源码调用核实，不代表运行验收。