数据口径：包内默认配置（extracted/config/tables/*.json，表名即文件名）。线上可能被远端配置 / AB 覆盖。 标注：【确认】 = 配置值或代码（反编译 / ISIL）直接可见；【推断】 = 由字段名、数值关系或部分代码推出，未完全核实。 绘图数据：同目录 ch1-data.json（主链逐级 Price/EquivEnergy、ForceBlock 等级段、倍率、仓库价格、泡泡、Lucky 等）。

1.1 棋盘与新手初始盘

1.1.1 棋盘规格

• 【确认】7 列 × 9 行 = 63 格，常量 BlueMergeCorePlayGame.Width=7 / Height=9；初始盘表 MergeNewUserBoardConfig_Board 为 9 行 × Column1..7。
• 【确认】格子是一维下标，所有棋子同处一张持续存在的棋盘，没有关卡切换；进度靠玩家等级推进（等级来自家园剧情建造花金币）。
• 【确认】棋盘外的容量：仓库（2 级开放，见 1.7.2）、顶部礼物区 StorageGiftsService（奖励无空位时暂存）。

1.1.2 新手初始盘（MergeNewUserBoardConfig_Board）

初始 63 格全部有内容：60 格压在障碍下，开局只有 3 格可直接操作。

• 【确认】障碍定义 MergeNewUserBoardConfig_Blocker：

  BlockID	资源	类型	覆盖格数
  BlockerA_01 ~ A_05	SnowBox2A01~05（雪箱）	full（完全遮挡）	A_04:14、A_02:13、A_01:12、A_03:12、A_05:9
  BlockerB_01	BlockerTest02	half（半遮挡）	61 格（与 A 叠加）
  RewardBlocker_01~06	Yellow/TransparentBubble01	reward（奖励障碍）	初始盘未引用

• 每格的 BlockID 是列表，绝大多数格子同时挂 BlockerA_0x + BlockerB_01，即"雪箱在上、半遮挡在下"两层。
• 【确认】MergeNewUserBoardConfig_RewardBlocker 定义了 6 个奖励障碍的奖励：Energy_20 / 10 / 30 / GemChess04 / Energy_50 / Energy_100；初始盘所有格 ProgressRewardID=null，本版默认盘没有放置奖励障碍（这些配置供其他盘面或远端配置使用，【推断】）。
• 开局可用资源：2 个 FoodGenerator01 + 1 个 FoodGenerator02（都低于可用等级 04，需要先合成）、初始资产 Coin 66 / Energy 100 / Gem 30（MergeAssetInfoConfig_AssetInfo），1 级奖励直接给 FoodGenerator04 + Energy_100（MergeLevelConfig_LevelCostReward）。
• 盘面内容设计：障碍下压着的是各链 1~10 级棋子、5 条链的生成器碎片、金币/钻石棋子，解锁后直接成为可合成或可交付的资源（例如 FoodA10、FruitA10 埋在最下一行）。

1.2 生成器与产物链

1.2.1 链的总览（MergeChessConfig_CorePlayChessInfo 72 条链，..._CorePlayChessGenerateLink 10 条产物链）

• 【确认】CorePlayChessGenerateLink：A 链 MainChain=true，B 链 MainChain=false 且与 A 互为 SymbioticChain（共生链）；ClothingTrans 与 ClothingA 都标为主链、互为共生；Flower、Toy 无共生链。
• 【确认】MergeChessConfig_GeneratorSpaceChess 列出了各生成器 01~0x 碎片对应的"成品"等级（Food/Fruit→04，Clothing/Joy/Toy→05，Flower→06），与 MergeChessGeneratorInfo 中最低一条可用配置一致。生成器碎片收集功能 GeneratorSpaceSwitch=false（30 级解锁，本版关闭），碎片只能在棋盘上逐级合成。
• 其余链（56 条）为资源/道具：CoinChess 5 级、GemChess 4 级、EnergyChess 5 级、LevelUP/LevelDownChess、6 种 CardPack、约 30 种宝箱/礼包/通行证道具/ChainPack。

1.2.2 生成器参数（MergeChessConfig_MergeChessGeneratorInfo，43 行）

字段语义：ChessGenerateMax = 一轮可点次数；用完进入 CD ChessRecoverCD（秒）；ChessSpeedUPCost = 跳过 CD 钻石；StorageMax/StorageRecoverCD/StorageSpeeUPCost = 储存池上限/恢复/加速；BasicEnergyConsume = 单次基础耗能；AffectedByEnergyHelper = 是否吃体力倍率；GeneratorType 1=普通，2=转化器。

• 规律【确认】：StorageMax 恒为 ChessGenerateMax × 3（Flower 为 ×2）；Food/Fruit 的 CD 在 04/05 级很短（新手期几乎无 CD），06 级起统一 180 s。Food/Fruit 是"体力消耗主力"（80 次/轮），Joy/Toy/Clothing 次数少（26–42 次），产能受 CD 约束更明显。Flower 不耗体力，靠时间产出，加速费用高（55–234 钻）。
• 【确认】MergeChessConfig_Main：GeneratorChessSellSwitch=true（生成器可卖）、GeneratorSellConfirm / OrderChessSellConfirm / HarderChessSellConfirm=true（卖生成器、订单需要的棋子、难棋时二次确认）。

1.2.3 产出权重（Main / SecondGenerateWeight，ChessPower）

• 读法：生成器升级不改变次数和耗能，只把权重从 01 级挪向 02/03 级，同时出共生链。以 FoodGenerator 为例，B 链占比 ≈ 50/420 ≈ 12%；单次点击期望得到的 A 链"折合 A01 个数"从 05 级的 0.93 提高到 11 级的 1.12（A02 折 2 个、A03 折 4 个 A01；剩余概率出 B 链。按配置权重计算，未考虑 DDA/Lucky 修正）。
• 主/副权重如何合并抽取、倍率档位如何改变产物等级，见 1.4.3（代码确认部分）。

1.2.4 产物链数值（MergeChessConfig_CorePlayChessConfig，160 行）

主链逐级 Price / EquivEnergy 见 1.8；全量行（含 SellPrice、DiffScore、OrderUnlockLevel、SmileRewardChess）在 ch1-data.json → chains。要点【确认】：

• 01/02 级 Price=0、EquivEnergy=0：最低两级不能当订单需求（OrderChessWeight 从 03 级开始）。
• OrderUnlockLevel：FoodA 1 级、FruitA 3 级、Clothing 6 级起、Flower/Joy 9 级、Toy 10 级开始进入订单；每条链越高级解锁越晚（JoyA07 18 级、ToyA11 41 级）；FoodA12+/FruitA12+/ToyA12 为 100 = 不进普通订单（OrderChessWeight.DefaultWeight=0），这些是 InstantOrderChess 顶级件（见 1.5.8）。
• SellPrice：非常低（FoodA15 仅 11 金币，生成器 0–9 金币），卖出只是清格子用。

1.3 合成规则与特殊棋子

1.3.1 基本合成【确认，MergePlayGame.IsCanMerge / ExecuteMerge ISIL】

1. 同链（ChessChain）同级（ChessLevel）且未满级（< MaxChessLevel）才能合；结果 = 目标格等级 +1，源格消失。
2. 两格不能都在障碍下；被半遮挡（InObstaclePart）的棋子可以作为合成目标。
3. 普通宝箱已经点开过（NowClickCount>0）就不能再合。
4. 合成后 EnergyConsume 累加两者的体力消耗（记录这颗棋子"真实花了多少体力"），刷新时间戳。
5. 合成后依次：解障碍 BlockerUnLock → 泡泡判定（1.7.1）→ 资产泡泡 → 一次性补丁（如 isMerge8GiveCoin）。
6. 拖拽落点：仓库图标 → 存仓；可合成 → 合成；升/降级道具 → 道具逻辑；否则交换或弹回。支持"甩动"合成（_enableFlickMerge）。
7. 生成产物落点规则 GetGeneratorManualLandingRule：GeneratorCenter / SameChain / SameChessAndChain / Random（【确认】枚举；各生成器用哪条规则未细查）。

1.3.2 障碍解锁【确认 + 推断】

• 三种状态：InObstacleFull（雪箱，不可点/拖）、InObstaclePart（半遮挡，可作为合成目标）、InObstacleReward（奖励障碍，解开得 RewardBlocker.Reward）。
• 在障碍格（或相邻格，【推断】）上完成一次合成触发 ReduceBlocker：Full → Part → None 逐层剥离；每次解锁有埋点 ReportBoardSpaceUnlock / ReportRewardBlockerUnlock；奖励障碍的奖励进入 BlockerRewardService 待发队列，由弹窗流程发放。
• 初始盘双层设计（BlockerA full + BlockerB half）意味着同一格通常需要两次相关合成才能完全释放。

1.3.3 宝箱（MergeChestGachaConfig_ChestChessInfo 48 种，OrderRewardChest 3 种，TripleChoiceChestInfo 10 种）

• 机制【确认】：宝箱是棋盘上的一颗棋子。UnlockTime>0 的要先倒计时解锁（可花钻 UnlockSkipGemCost 跳过，全局 MergeChestGachaConfig_Main.UnlockSkipGemCost=1），之后点一次吐一个物品，共 MaxClick 次；RewardContent = 固定清单（按 Count 给），RewardBackContent = 加权池（按 Weight 抽）。
• 代表行：

• 三选一宝箱（TripleChoiceTreasure）：GeneratorChest01/02（三选一生成器碎片）、OrderChoiceChest01~04（订单级棋子 04~08 级）、PickChestA/B、FancyPickChestA/B（A 链 7/8 级或 Joy/Toy 5/6 级）。
• 订单奖励箱（OrderRewardTreasure）：OrderChestA01/B01/C01，内容为 Food/Fruit 04~07 级等权池。

1.3.4 升/降级道具（MergeChessConfig_LevelChess）

• 【确认】LevelUPChess（Feature=up）、LevelDownChess（Feature=down），各 1 级。拖到目标棋子上触发 TryHandleLevelChessEndDrag → ApplyLevelUp / ApplyLevelDown；满级不能升（IsMaxLevel）。
• 【确认】降级道具有自己的 Addon LevelDownChessData，子类 IsCanMerge 先判 IsLevelDownChessMerge。【推断】降级会把一颗 N 级拆成两颗 N-1 级（常见设计，降级可"复制"出订单需要的下级件），未在代码中逐行核实。

1.3.5 资源棋子（MergeChessConfig_AssetChessInfo）

点两次（选中 → 再点）即领取并销毁（OnClickUseAsset），同链可以合成升级：

• 合成溢价：两颗 N 级合成 N+1 级，金币 2→6→14→30→62 每级都"大于两倍"（+2 余量），体力 2→6→15→40→100 溢价更大（EnergyChess04→05 两颗 80 换 100）。【推断】这鼓励玩家先合再领，同时占格子。

1.3.6 卡包（MergeChessConfig_CardChess + ActivityCardCollection_*）

• 6 种卡包棋子：Green/Blue/Red/Yellow/Purple/Special，再点打开（TryOpenSelectedCardPack）。EnergyExchange 分别为 10/15/20/80/100/0（【推断】集卡活动未开时折算成体力）。
• 发放【确认】：订单提交后 CardCollectionInstance.GrantOrderCardPacks，按订单 DiffScore 区间发包（ActivityCardCollection_OrderCard）：DiffScore 9999–19999→Green，29999–39999→Blue，49999–59999→Red，69999–79999→Yellow，89999–99999→Purple，≥199999→Special。【推断】区间远高于单张订单 DiffScore（FoodA15 仅 3000），可能是按累计值或活动内另一套计分，需要另查。
• 星星兑换 StarChangeNum：2/4/6/16/24/30。

1.4 体力系统

1.4.1 上限与恢复【确认，MergeEnergyConfig_Main】

• 自然恢复上限 MaxEnergyRecovery=100；每 EnergyRecoveryInterval=120 秒回 EnergyRecoveryCount=1 点 → 每小时 30 点，0→100 需 200 分钟，一天理论自然恢复上限 720 点。
• 上限只限制自然恢复，宝箱、购买等途径可以把体力堆到 100 以上（×8 倍率要求体力 ≥400，说明设计上允许高于上限，【推断】）。
• 初始体力 100（MergeAssetInfoConfig_AssetInfo）。

1.4.2 倍率档位【确认，MergeEnergyConfig_EnergyBoost + GetEnergyConsume 反编译】

• 耗能公式 BasicEnergyConsume << (档位-1)（反编译确认）。只对 AffectedByEnergyHelper=true 的生成器生效（Flower 不受影响，转化器 ClothingTrans05 受影响）。
• 倍率由底栏 EnergyBetIconView 切换，记在存档 BlueMergeEnergyConsumeRatioKey。

（倍率对产出等级的影响见 1.4.3）

1.4.3 倍率与产出

一次点击的判定顺序【确认，BlueMergeCorePlayGame.TryResolveGeneratorProduceResult】： Lv5Patch（首次生成一次性替换）→ DDA 方向 → 高倍降级 DownLevel → 体力是否足够（不足弹购买）→ Fv 模型 → 普通产出（SpecialLucky → Lucky → 普通加权）

普通产出的两段抽取【确认，BlueMergeGameConfigLogic.GetGenerateSelectedChain / GetGenerateRealMetaByChain】：

1. 选链：主链权重 = Σ MainGenerateWeight；副链（共生链）权重 = Σ SecondGenerateWeight + max(0, 计数器 × makeUp)，两者在同一个池里加权随机。副链列表为空时直接出主链。
   • 计数器：全局一个（不分生成器），出副链清零，出主链就加上本次耗能（1/2/4/8）。即"越久没出共生链，共生链概率越高"。
   • makeUp 默认 SubChainMakeUp=1；DynamicMakeUpSwitch=true 时由动态补偿改写（DynamicGenerateCompensationLogic，MergeChessConfig_GeneratorMakeUp）：记录每个生成器最近 WindowPeriod=10 次产出的主链占比，占比 ≥ SubRng=0.8 且订单里副链有缺口 → makeUp=HighSubChainMakeUp=20；订单里副链没有缺口 → makeUp=LowSubChainMakeUp=0；其余保持 1。
   • 例（FoodGenerator06，主 370 / 副 50）：默认每耗 1 体力副链权重 +1；高补偿状态下每耗 1 体力 +20，约 15 次主链后副链权重翻到 350，与主链相当。
2. 选等级：在选中链的列表里按 ChessPower 加权；较高级候选的权重 = round(Power × criticalRatio) + CriticalMakeUp × 计数（CriticalMakeUp=0，criticalRatio 平时为 1、DDA Help 时为 1.5）。

倍率抬高产出等级【确认，GetNormalGenerateChessGenerate】：产出等级 = 抽中等级 + (档位 − 1)，超过满级则截到满级。

• 结论：倍率在体力价值上是等价交换（体力 ×2^n，产物也 ×2^n 个 01 当量），省的是点击次数和合成次数（以及格子），不省体力。Lucky 的产出也一样加 (档位−1)。
• 【推断】次数池按"点击"扣（一次点击扣 1 次 ChessGenerateMax），如果成立，高倍率下每轮能换出的总当量翻倍，CD 约束会相对变松。
• 高倍降级补偿 DownLevel【确认】：DownLevelGenerateCompensationSwitch=true 且档位 >1 时，从 L=1 到 档位−1 逐级检查"棋盘上该链 L 级数量 − 订单需求数量"，结果为奇数或负数（即缺一颗凑对 / 订单缺这一级）就改为产出 L 级。作用是避免高倍率下低级件凑不成对。降级产出时的扣费细节未确认。

次数池与储存池【推断】：ChessGenerateMax 为每轮次数，用完进入 ChessRecoverCD；StorageMax / StorageRecoverCD 为额外的储存次数，按 CD 回复；两者都可花钻加速（ChessSpeedUPCost / StorageSpeeUPCost）。广告位 GeneratorRecharge（5 级、每日 5 次）可看广告恢复生成器（AdConfig_Reward）。

1.4.4 体力来源汇总

1.5 订单系统

1.5.1 托盘数与解锁

• 【确认】MergeOrderConfig_Main.MaxTrayCount=6，MergeOrderConfig_TrayCount 各等级段均为 6：同屏最多 6 张订单。
• 托盘有 8 个（MergeOrderConfig_TrayStrategy），按 UnlockLevel ≤ 玩家等级 过滤后由权重排序填充（OrderConfigService.BuildStrategyFicationList）。新手期（1–8 级）改由 MergeTutorialConfig_TutorialTrayUnlock 指定可用托盘（BuildNewUserUnLockStrategyList）：

1.5.2 托盘策略串

执行方式【确认，BlueMergeCorePlayOrder.OrderFillStrategyFication】：

1. 托盘按 TrayWeight 降序（笑脸活动期间改用 SmileWeight）；跳过已有订单的托盘。
2. 策略串按 | 拆开，逐项检查是否可用：TutorialFixed 只在新手订单没发完时保留；Mole/NewMole 需要对应活动开启且并发未满；然后检查当日上限 GetTodayStrategyGenerateCount 和策略 CD GetStrategyCooldownRemain。
3. 第一个可用的策略出单：新手策略走 AddOrderByNewUser，其余走 AddOrderByLogic → GenerateOrderByOrderLevelRandom。
4. 订单提交时 StartOrderStrategyCooldown(strategyID) 开始该策略的刷新 CD。

• 【推断】策略串不是"完成 N 次后切换"，而是"前面的不可用就落到后面"：新手单发完后固定落到 Mole/Main/Daily；鼹鼠单当天出过 1 单或活动没开就落到常规策略。

1.5.3 订单策略（MergeOrderConfig_OrderStrategy 25 个）

另有两类代码内置策略【确认】：Special999（合成出顶级件时即时生成，见 1.5.8）、Overlimit998（超限棋子回收单，OverlimitChessRecoverySwitch=false 关闭）。

1.5.4 订单生成算法（BlueMergeOrderGenerateLogic.GenerateOrderByOrderLevelRandom）【确认】

步骤 1：取难度状态值 StateValue。 MergeOrderDiffStateConfig_Main.StateValueType=1 → 直接取状态量 10013（今日累计完成订单的 DiffScore 之和）。类型为其他值时用分子 ÷ 分母两个状态量。

步骤 2：匹配 OrderLevelRandom 行。 按（策略 × 玩家等级段 × StateValue 区间）找到一行，得到第 1/2/3 个棋子的 DiffLevel 区间（注意不是 ChessLevel；DiffLevel 与棋子等级基本对应，共生链/Clothing/Flower 有偏移，见 CorePlayChessConfig.DiffLevel）。共 89 行，代表行：

读法：第 1 件是"主菜"，难度随等级抬升（6→10/11）；第 2、3 件始终在 3–7 低难度区间。StateValue 只在 16 级以上的 Main/Daily 行有分段，当日完成的难度越高（≥4501），第 1 件上限 +1。

步骤 3：订单包含几种棋子。 GetOrderChessCount 使用"洗牌袋"：袋里 1 种 ×3、2 种 ×3、3 种 ×4（MergeOrderConfig_OrderChessCount，各等级段相同），共 10 张，每次不放回抽一张，抽空重装（存档 BlueMergeOrderChessCountNumKey）。所以每 10 单里正好 3 单 1 件、3 单 2 件、4 单 3 件。

步骤 4：每个位置的难度随机游走（难度状态机）。 每个"策略 × 位置"记住上一单的 DiffLevel（BlueMergeOrderLevelRandomHistoryKey）：

• 没有历史，或历史值不在本次区间内 → 在 [Min, Max] 内均匀随机；
• 有历史 → 按 PKeep 40 / PDown 45 / PUp 15（MergeOrderConfig_Main）决定保持、降 1 级或升 1 级；已在 Max 时"升"的概率并入"降"；已在 Min 时"降"的概率归给"升"；结果限制在 [Min, Max]。
• 效果：下降概率（45%）大于上升（15%），难度会向区间下沿回落；出现过高难度单后，后续倾向于给更容易的单。

步骤 5：选择具体棋子。 候选条件：玩家拥有该链的生成器、玩家等级 ≥ OrderUnlockLevel、DiffLevel 落在本位区间、OrderChessWeight.DefaultWeight>0（74 行，Clothing 默认 200，其他 100，顶级件 0）。权重乘子（OrderContentWeightModel=1，按 MergeOrderConfig_OrderContentWeight 等级段取值）：

• OrderChessWeightChooseType=0：取最高权重，并列时随机一个；非 0 时加权随机。
• Flower 订单同时最多 1 张（FlowerOrderMaxConcurrentNum=1）。
• 各乘子的精确组合方式为【推断】，因子名称、数值和读取函数为【确认】。

步骤 6：数量与奖励。 订单中每种棋子要求 1 颗（【推断】，OrderData.orderChessInfos 是逐颗列表）；金币 rewardCoin = Σ 各棋子 CorePlayChessConfig.Price，在生成时写入并存档，提交时 GainAsset("Coin", rewardCoin, "order_submit") 原值发放。【确认，07 笔记反编译】4 处 OrderData 构造都只是累加，没有倍率。

1.5.5 OrderStateFactor 的实际作用

• 配置：MergeOrderDiffStateConfig_OrderStateFactor Normal(StateValue≥0)=0.7、High(≥2500)=1.0、SuperHigh(≥4500)=1.3。
• 【确认】托管代码里没有任何业务代码引用这张表的 Meta 类型（只有 ConfigMeta 自身和 MessagePack 格式化器）；OrderConfigService 也不加载它。因此 本版本中它既不影响金币，也不影响难度。
• 不确定性：只能排除客户端使用，不能排除服务端或远端配置下发的新版本代码使用。它的阈值（2500/4500）与 OrderLevelRandom 的 StateValue 分段（2000/4500）接近，【推断】为同一套"当日难度"设计的遗留或预留。

1.5.6 笑脸订单（Smile）

• 【确认】SmileOrderOpenLevel=4、SmileOrderSwitch=true。代码实际读的是 ActivitySmileOrder_* 表（不是 MergeOrderConfig_SmileReward）：
  • 笑脸分要求 SmileScoreRequirement：[6,6,6,6,8,8,8,8,10,10,10,10,12]（按轮次递增）；
  • 分数 → 奖励档 RewardScore：1→12 … 6→75、8→125、10→180、12→250（缺省 200）；
  • 等价体力返还率 SmileEquivEnergyReturnRate：3–15 级 0.25、16–25 级 0.20、26–40 级 0.15、41+ 级 0.10（MergeOrderConfig_SmileReward 里 3–15 级写的是 0.35，代码不读）；
  • 奖励物品 8–12 个。
• 【确认】奖励物品通过 SmileOrderChooseLogic.CalculateGlobalReward 按"当前订单缺口"挑选，只从 SmileRewardChess=1 的棋子中选（各链 03~11 级）。
• 托盘字段 SmileWeight（1001–1008）在笑脸期间替换排序权重；SmileOrderNum / SmileScoreNum / SmileBackup 【推断】表示托盘能出几张笑脸单、每单记几分、是否备选。

1.5.7 鼹鼠单（Mole / NewMole）

• 【确认】旧版 Mole：需要 MoleChestOrderInstance.IsOpen（MoleChestOrder 活动），并发 < CurMoleOrderMax=2。
• 【确认】NewMole：NewMoleChestOrderInstance.TryRollStrategy，参数 ActivityNewMoleChestOrder_Strategy：

并发上限 2；奖励 ActivityMoleChestOrder_Reward（88 行，ReturnRate 0.6，返还 5~12 颗棋子，备选 EnergyChess01）。鼹鼠单的难度行（Mole03/04 第 1 件 9–11）普遍高于同期 Main。

1.5.8 即时订单、新手订单与"难棋"

• 即时订单（Special999）【确认，AddOrderByMerge】：合成出 InstantOrderChess（各链顶级：FoodA15、FoodB07、FruitA14、FruitB07、JoyA11、JoyB07、ClothingA10、ToyA12、FlowerA07），且它不在现有订单中时，立刻生成一张只要这一颗的订单，奖励 = 它的 Price（如 FoodA15 = 612 金币）。顶级件因此不会卡在棋盘上。
• 新手订单【确认】：MergeTutorialConfig_TutorialOrderFlow 共 111 单，覆盖 1–8 级（每级 4/6/14/15/15/16/19/22 单），其中 1 件 60 单、2 件 45 单、3 件 6 单；第 1 单 FoodA03，第 2 单 FoodA08，最后一单 FruitA07。金币同样是 Σ Price。
• 难棋 HarderChess【确认】：BlueMergeGameConfigLogic.GetChessIsHard(EquivEnergy, 玩家等级)：1–8 级 EquivEnergy ≥30（FoodA06 起）、9 级以上 ≥100（FoodA08 起）视为难棋。订单生成不调用它；【推断】只用于卖出时的二次确认（HarderChessSellConfirm=true）。
• OrangeOrderInterval=5、ChainReturnRate=0.6、MaxGapChainReturnRate=0.8：没有找到订单生成里的读取点。ChainReturnRate=0.6、RandomChessRewardNum 2–5 同时出现在 ActivitySmileOrder_Main/SmileReward 中（【推断】用于笑脸奖励"同链返还比例"）。

1.6 DDA 与 Lucky 产出

1.6.0 默认开关一览（重要）

【确认】这些开关值都来自包内默认配置；DDA 与 FV 需要远端配置或 AB 打开才会启用。

1.6.1 DDA 方向判定（BlueMergeCorePlayGame.ResolveGeneratorDda）【确认】

方向枚举：None / Help / Block / ForceHelp / ForceBlock（Block 在判定函数中未见赋值）。

1. 玩家处于 HeySession（"兴奋期"，MergeHeyStatusConfig_* 判定，9 级开放、窗口 7 天、付费 30 等参数）→ Help。
2. 否则尝试"差一点完成"（NearlySuccess）逻辑：开关打开、等级 ≥ NearlySuccessUnlockLevel=3、通过每日门槛，且存在一张"差一点完成"、缺口在副链上的订单 → 建立一条 NearlySuccess 记录，目标体力 TargetEnergy 取自 ForceBlockRange=[20,40]（【推断】区间内随机）：
   • 记录建立后累计耗能 ≤ TargetEnergy：ForceBlock，强制只出主链，不给订单缺的副链件；
   • 超过 TargetEnergy：ForceHelp，直接指定产出目标链。
   • 即"先卡 20~40 体力，再给"，制造"差一点 → 终于出了"的体验。
3. 都不满足 → None（普通产出）。

1.6.2 ForceBlock 每日门槛（MergeGeneratorDDAConfig_Factor）【确认】

进入条件：当日 ForceBlock 已消耗体力 < DailyForceBlockEnergyLimit，且距上次进入 ≥ DailyForceBlockInterval 秒。

等级越高，每天允许被"卡"的体力越多、间隔越短。（默认开关关闭，见 1.6.0。）

1.6.3 Help 与 SpecialLucky【确认】

• Help / ForceHelp 时：
  • 计算主、副链的订单缺口（CalculateGeneratorChainGap，HelpChainTargetModel=2），缺口链在选链时权重 ×HelpChainWeightBoostRatio=5；两条链都没有缺口时回到普通选链。
  • 高级候选权重 ×CriticalWeightBoostRatio=1.5；Lucky 基础概率 ×LuckyChanceBoostRatio=1.2。
• SpecialLucky（只在 Help 方向生效，SpecialLuckySwitch=true、SpecialLuckyTargetModel=2）：直接产出一颗未完成订单需要的棋子。频率限制 MergeGeneratorDDAConfig_SpecialLucky：1–9 级间隔 300 s、10 级以上 600 s，每日最多 5 次。

1.6.4 Lucky 幸运产出（MergeLuckyProduceConfig_*）【确认，objdump 核对公式】

• 门槛：LPSwitch=true、等级 ≥ LPOpenLevel=4、过 CD。CD 按当次触发序号取 LPCD=[60,60,60,120,180,240] 秒，超出取最后一项（越触发越慢；计数何时重置未核实）。
• 概率： P = LuckyChance1x × r + (LuckyChanceMax − LuckyChance1x) × (1 − (gap+1)^(−K))，截到 [0,1]
  • gap = max(0, Σ 相关链[订单需求等价体力 − 棋盘现有等价体力])（SearchEqPower；相关链见 LuckyGenerateChain：Food→FoodA/B、Fruit→FruitA/B、Joy→JoyA/B、ClothingTrans→ClothingA、Toy→ToyA）；
  • LuckyChanceMax=0.05，K=0.1，r 平时为 1、Help 时 1.2。
• 基础概率与保底（29 个生成器）：

• 概率随缺口变化（Food，r=1）：

• 保底：每条链累计"上次 Lucky 以来的耗能"（每次加 1/2/4/8），超过 PityEnergyCost（80/90/100）必定触发。实际体感约为"每 80~100 体力至少一次幸运"。
• 产物：在 LuckyProduceWeight 中加权抽取，权重再乘订单相关系数：订单正好需要该链该级 → TargetFactor=1；订单需要该链更高级 → ValidFactor=1；与订单无关 → InvalidFactor=0（排除）。等级同样 + (档位−1)。产物比普通产出高 3~6 级（等价 4~32 个 01）。

1.6.5 13 个状态量（MergeGameStateConfig_StateInfo，BlueMergeIPlayerDataRecord.GetMergeGameStateValueByStateID）

未实现的 ID 走 "Not_Support_StateID" 分支，记错误日志并返回 0【确认】。当前唯一在用的是 10013（订单难度，1.5.4）。

1.6.6 Koilab FV 模型（FvGeneratorService，Tuyoo.Koilab.Fv.Runtime）

• 开关与参数【确认，Report_Koi_Main】：KoiSDKSwitch=false（默认关闭）、KoiSDKInitLevel=9（9 级前不初始化）、KoiInferenceMode=Hybrid（另有 LocalOnly）、KoiProtocol=Http、云端预测服务地址已配置、KoiExperimentID 为空、ValueControlAlpha/Beta=1.19/1.09。
• 输入【确认，PopulateGameState】：体力倍率、当前金币/钻石/体力、棋盘占用率与碎片率、解锁格数与空格数、订单等价体力、棋盘/订单/奖励/合成列表/活动状态等序列化信息。
• 本地模型【确认】：config/fv_state_sequence.onnx；输入 state_features[191]、piece_sequence[63×2]、sequence_lengths；输出 retention（留存）与 ad（广告）两个预测分；版本 local.20260918，阈值类型 p85，lucky_target_rate 0.02；每个生成器有 normal / lucky / candidate_pool 配置（threshold、crit、cap、whitelist）。
• 决策【确认】：在 DownLevel 之后、普通产出之前调用 TryGetFvProduceResult；返回物品属于本生成器链才采用（来源记为 FvLocal/Cloud），否则回退到普通产出（"fallback to original generator"）。
• 【推断】在候选物中，选留存/广告预测分超过 p85 阈值的给出；ValueControl 用 α≥β≥1 在滑动窗口里限制"产出价值/体力"，超限时硬/软降级（字段 HardDowngrade/SoftDowngrade）。lucky_target_rate 0.02 与 Lucky 概率区间（0.65%~5%）同一量级。

1.7 泡泡、仓库、商店直购

1.7.1 泡泡（MergeBubbleConfig_Main + BubbleStrategy 74 行）

• 【确认】开关与限制：4 级开放；泡泡显示 BubbleShowTime=60 秒后破裂；棋盘同时最多 4 个；至少保留 1 个空格才会出；OrderOneAwayBubbleSwitch=false。
• 【确认】泡泡是"合成结果的复制品"：合成出 X 后按概率在空格生成一个被泡泡包住的 X，60 秒内花 BubblePrice 钻买下即得到 X；超时破裂给 BubbleRewardID（全部是 CoinChess01）。
• 概率【确认 + 推断】：OnMergeEnd 里 p = BubbleChance + ProbabilityConstant(0.01) × 计数，计数存在 BlueMergeBubblePatchKey，【推断】为"连续未出泡次数"，即每次没出泡概率 +1%，出泡后清零；到达开放等级后的首次合成有一次性必出（GamePatchData 标记）。
• 代表行（BubbleChance / 价格钻）：FoodA04 3%/2、A06 8%/7、A08 15%/25、A10 33%/89、A15 33%/2210；ClothingA10 33%/2040；ToyA12 40%/1840。高级棋子出泡概率更高、价格≈ 商店直购价（两表价格一致）。
• 合成奖励 MergeRewardSwitch：10 级开放，MergeRewardChance 1%~10%，奖励 CoinChess01。
• 广告买泡泡：AdConfig_Main.BubbleBuyMaxGem=11，价格 ≤11 钻的泡泡可以看广告买（BubbleBuy 广告位每日 5 次）【推断】。

1.7.2 仓库扩格（MergeInventoryConfig_*）

• 【确认】2 级开放，共 32 格，前 5 格免费；之后逐格花钻解锁：

• 累计：开到 10 格 350 钻、15 格 1,425 钻、20 格 5,215 钻、26 格 18,675 钻、32 格 42,465 钻。前段每格增幅 10%~30%，后段约 1.1~1.4 倍跳涨，27 格起封顶。
• 只有 IsCanEnterWareHouse() 为真的棋子能存（【推断】生成器/宝箱等有限制，未细查）；仓库里的棋子也能直接交付订单（TryConsumeByOrder）。

1.7.3 商店棋子直购（MergeShopPageConfig_*，只列合成相关）

• 【确认】3 级开放；刷新 20 钻，CD 15（单位未确认）；每日特价 3 格：CoinChest01 25 钻、EnergyChest01 10 钻、DailyChest01 免费（付费/默认两版相同）。
• ShopChessConfig 96 行，按格位分档：格 1–3 低级（03~07 级，1–13 钻）、格 4–5 中级（08~10 级，25–140 钻）、格 6 高级/稀有（11 级、生成器碎片 01 级 40–80 钻、ShopWeight=0 的顶级件不上架）。每次上架数量 ShopCount：棋子 5 个、生成器碎片 1 个。
• 主链价格：FoodA03 1 → A05 4 → A08 25 → A10 89 → A11 170 钻（≈每级 ×1.9）。生成器碎片：Food/Fruit 40、Flower/Joy/Toy 45、Clothing 80 钻。

1.8 单位体力 → 金币估算

口径：EquivEnergy（配置里的"等价体力"）≈ 从 01 级合到该级平均要花的体力；Price = 订单交付这颗棋子得到的金币（订单金币 = Σ Price，已确认）。比值 = 金币/体力。表值全部来自 MergeChessConfig_CorePlayChessConfig。

1.8.1 主链 1→满级

共生链 FoodB（03–07）：8/37/0.22、14/75/0.19、24/149/0.16、38/299/0.13、58/597/0.10；FruitB 基本相同。

1.8.2 规律【确认（数值）+ 推断（解释）】

• 越高级越不划算：EquivEnergy 每级约 ×2（与"两颗合一颗"一致），Price 每级只涨约 ×1.5（FoodA：2→4→8→12→20→32→50→78→118→178→270→406→612）。所以金币/体力从低级的约 0.5 一路降到满级 0.04，FoodA15 每点体力的金币只有 FoodA05 的 7%。
• 例外：Food/Fruit 03~05 级比值持平（0.50~0.53），是最"划算"的区间。
• Joy/Toy 每点体力的金币是 Food/Fruit 的 3~4 倍（03 级 2.0 vs 0.5），因为这两条链 EquivEnergy 低但 Price 高。代价是生成器每轮只能点 36/42 次（Food/Fruit 80 次）、开放晚（订单 9/10 级起）；【推断】这两条链用 CD 而不是体力来限制产出。
• ClothingA 曲线不是 2 倍规律（A02=16、A03=18、A04=21），【推断】是把"生成器 → Trans01~05 → 转化器 12 次"这段固定成本平摊进了前几级。
• FlowerA 不耗体力（自动生成），EquivEnergy 只是折算值，实际限制是时间（1~2.7 小时一轮）。
• 订单对玩家的意义：订单需要哪一级是系统定的（1.5），玩家不能自选"划算等级"；高等级订单需要更多体力，每点体力换到的金币却更少，所以等级越高，单位体力的金币产出自然下降。
• 体力倍率不改变上表比值：×2^n 档位耗能 ×2^n、产物高 n 级（1.4.3），等价体力对价不变。Lucky（期望每 80~100 体力至少一次、产物高 3~6 级）会让实际金币/体力略高于表值。
• 对照钻石价值：商店直购 FoodA08 = 25 钻 ≈ 123 体力（0.20 钻/体力），钻石买体力第 1 档 10 钻/100 体力（0.10 钻/体力），第 3 档起 0.4 钻/体力以上；【推断】低档买体力比直购棋子划算，高档反过来。

对象：Frost Valley（com.liteorange.hometopia v1.12.0）。数据来自包内默认配置（extracted/config/tables/*.json），线上远程配置可能覆盖这些值。 标注：【确认】 表示配置表或代码签名、反汇编里直接能看到；【推断】 表示根据命名、结构或数值关系推出来的。 画图数据在 ch2-data.json：建造花费分段、逐点花费、每章花费、200 级曲线、等级解锁时间轴、建造奖励分布。

2.0 一句话概括

家园不是自由装修，而是章节式的"花金币修房子 + 看剧情"。每章是一个场景，场景里有 16 个建造点。玩家在合成棋盘交订单赚金币，再到剧情页花金币点亮建造点。每点亮一个点，播放建造动画，可能触发对话，可能发额外奖励，同时给玩家等级加进度。玩家等级只靠剧情建造增长，而大量系统和活动按等级解锁，所以剧情建造是全游戏的进度主轴。【确认：LevelSys.GrantStoryBuildProgress 是等级唯一的进度入口；TryCommitBuild 扣 "Coin"】

2.1 章节结构

2.1.1 规模

全部章节都打完后，显示 story_all_finish_coming_soon（"Coming Soon"）；下一章资源没准备好时，提示 story_next_not_ready_toast【确认：语言表 key】。

2.1.2 播放顺序（默认序列，Switch=true，按 StorySort 排序）

中段依次是 1018 → 1016 → 1019 → 1023 → 1024 → 1025 → 1030 → 1027 → 1036 → 1032 → 1048 → 1037 → 1046 → 1035 → 1040 → 1043 → 1058 → 1067 → 1057 → 1042 → 1051 → 1052 → 1034 → 1062 → 1066 → 1059 → 1064 → 1041 → 1060 → 1063 → 1085 → 1086 → 1044 → 1065 → 1073 → 1049 → 1061 → 1021 → 1076 → 1068 → 1071 → 1055 → 1075。

结尾：…第 64 章 1079_S_1 → 第 65 章 2001_S_1（Key=1000，StorySort=670，插在 Key 66 和 Key 67 之间）→ 1083_S_1 → 1070_S_1 → 1087_S_1 → 1084_S_1 → 1088_S_1 → 第 71 章 1089_S_1。

• 原表里 Key 14 是 1007、Key 21 是 1013，两章都关闭。因此按开启后的序号算，原 Key 66 的 1079 实际是第 64 章，2001 是第 65 章。
• 章节 ID 不按数字顺序排。前期主要放 1053/1056/1047/1050 这类 _S_3 资源，带完整对话资源的 1002、1011、1012、1009、1010、1004、1015 排在第 11–17 章。

2.1.3 AB 测试章节（StoryIndex_StoryIndexTest）

• 【确认：代码结构】ChapterProvider.DetermineMetaForPosition 和 BuildFullSequence 遇到测试位置时，先调用 BuildTestCandidate(testRes, playedIds)，再调用 PickDeterministicTestRes(storyIndex, ratio, round, candidates)。后者用 StableHash 加用户种子 _userSeedKey 做确定性挑选。
• 【推断】第 3 章的位置上有 30% 用户被分进测试组，从候选里确定性地拿到一个资源；已经玩过的章节会被 BuildTestCandidate 排除。改 TestRound（现在是第 11 轮）就会重新分组。
• 候选覆盖 11 个不同章节。其中 1056_S_3 就是对照组本身；1087、1084 原本是第 68、69 章的末尾内容。同一章同时有 _S_1 和 _S_2 两个版本，说明测试的是"把哪一章、哪一版美术放到第 3 章"。

2.1.4 特殊章与 _S_n 变体

• _S_n 变体：同一 StoryId 在 StoryPackage 里最多有 9 个场景版本（1001 有 9 个，1002 有 7 个，多数章 1–3 个）。StoryContent_BuildInfo 只按 StoryId 定义建造点，不区分 _n，所以各变体共用同一套 16 个点和前置关系，区别只在场景美术和表现【确认：表结构；"只换美术"是推断】。线上第一章用 1001_S_9，APK 里内置的也正是这个版本。
• 2001 章：11 个点，点位类型是 mg2_window / mg2_fireplace / mg2_chandelier / babycare / table / broom / wrench / paint / hammer / carpet / clothes，AnimationType 全空。点与点严格线性串联（第 n 个点以前 n−1 个点为前置）。StoryMergeMinigame_Bottom53 里有对应的 mg2_window53 / mg2_fireplace53 / mg2_chandelier53 三套 5×3 底部小游戏棋盘，语言表也有 build_story_2001_1_window（"太冷了！我得赶紧修好这扇窗户！"）、build_story_2001_4_baby。【推断】2001 是按"新手第一章"标准做的第二套剧情和小游戏方案（mg2 = minigame 2），资源有 2001_S_1 和 2001_S_2 两版，目前作为普通章节排在第 65 章。它的 MergeMinigame 字段为空，所以在默认配置下不会弹小游戏【确认：字段为空】。
• 9001 章 = 序章：StoryInteraction_Main.PrologueStoryRes=9001_S_1，序章视频 PrologueVideoRes=9001_chebeizi，PrologueStorySwitch=false，默认关闭【确认】。

2.1.5 章节主题

配置里没有章节标题字段（两张语言表都没有 chapter 名），只能从角色表 StoryCharacterContent_Character（51 个角色，分属 9 章和一个万圣节活动）和对话标题（*_D_n_title）归纳主题：

所有题材都是"女性或家庭遭遇困境，然后反击"的短剧风格，配合"冰天雪地里修房子"的求助式引导文案（"我们冷得要命，有没有好心人可以帮帮我们？"）。

2.2 建造点

2.2.1 类型分布

BuildPointType（39 种，决定图标；StoryInteraction_BuildPointType 配了 42 种图标，特效和音效全部是 common）：

AnimationType（建造时角色或道具的动作）：

另有 210 个点配了 AnimationOffset（如 -50|0），用来微调动画的落点位置。

2.2.2 前置条件结构

• Condition 列出前置建造点的 ID，用 | 分隔。前置点全部完成后，这个点才可建造【确认：字段】。
• 每章入口点（无前置）的数量：1 个的有 37 章，2 个的 17 章，3 个的 12 章，4 个的 4 章，6–7 个的 3 章。
• 每章依赖链的最大深度从 2 到 12 不等，最常见的是 5、7、10。因此有的章接近线性推进，有的章前期能同时开好几个点。
• 同一时刻最多显示 3 个可建造图标（BuildPointShowMaxCount=3）。未解锁的点显示为灰色（BuildPointGrayScaleSwitch=true）；点击灰点的处理方式由 GreyBuildPointClickType=2 决定，具体行为未确认【确认：配置；表现是推断】。
• ID 尾号 ≥80 的点有 236 个（如 1001_90、1001_80），多是 none 动画或特殊表现点（第一章的急救、面包、衣服、画）【推断】。
• 配置瑕疵：1030 章有 29 处前置 ID 带空格（如 "1030_1 "）。代码如果不做 trim，这些前置会匹配不上【确认：数据；影响是推断】。

第一章（1001）16 个点的顺序：急救（medicine 小游戏）→ 门（wooddoor 小游戏）→ 窗（window 小游戏）→ 面包 → 吊灯 → 椅子 → 婴儿用品 → 地毯 → 锤子 → 衣服 → 照片 → 玩具（sweep）→ 锤子 → 植物 → 桌子 → 画。几乎是线性的。

2.2.3 合成小游戏挂载点

• 只有 3 个点挂了 MergeMinigame，全在第一章的前 3 个点：1001_90→medicine、1001_2→wooddoor、1001_1→window【确认】。代码常量 MiniGameChapterIndex=1、FirstChapterMiniGameBuildCount=3 与此对应【确认】。
• 小游戏类型由 StoryMinigameType 决定，取值 DefaultMinigame=0 / BottomMinigame=1，当前配置是 DefaultMinigame【确认】。棋盘数据：
  • ChessBoardInfo33：3×3 棋盘，medicine33 / wooddoor33 / window33 各 3 行；
  • Bottom53：5 列 × 3 行的底部棋盘，有 medicine53 / wooddoor53 / window53 和 mg2 系列 3 套，带 BottomBlocker 遮挡；
  • StoryChessBoardInfo：4 列棋盘，32 种类型（对应 BuildPointType）；
  • PrologueChess：56 种小游戏棋子，最高 3–4 级，棋盘尺寸 44。
• 【推断】Default 模式用 3×3 或 4×4 弹窗棋盘，Bottom 模式用剧情页底部的 5×3 条带棋盘。玩家在小游戏里把物品合成到指定等级才算完成，之后进入扣费和建造。小游戏引导（build_bottom_minigame_click/submit_01–03）在建造 5 次后停止（StoryMergeMinigameGuaidStopBuildCount=5）。

2.2.4 建造花费曲线（StoryStrategy_LTProgress.CoinCost）

计价规则【确认：07 笔记反汇编】：建造货币是 "Coin"。某个点的价格 = LT 表[本章开始时的生涯已建点数 + 该点在章内的 Sort 序号]。花费按生涯累计序号查表，与是哪一章无关。进入章节时，本章所有点的价格会冻结写进存档（chapterPointCostMap），之后配置变化不影响已开章节。找不到对应行时价格为 1。

全表：1163 个点，合计 371,722 金币；单点最低 16（第 1 个点），最高 600（第 1135 个点起）。按默认序列打完 1131 个点需要 357,622 金币。

每 50 个点分段（逐点数据见 ch2-data.json → build_cost_by_index）：

节奏特征【确认：数值】：

• 第 1–2 章是"压价期"：单点 16–60，前 5 个点几乎都是 25。
• 第 3 章起，每章的 16 个点分成低、中、高三档价格，点数比例 6 : 5 : 5，三档混排。例如第 3 章是 30/60/90，第 10 章 70/130/200，第 15 章 120/270/390，第 30 章 225/375/525，第 64–71 章 280/430/580。
• 第 15 章（序号 225 附近）有一次明显跳价：单章总花费从 2,295 跳到 4,170。
• 第 30–40 章、第 50–60 章、第 61–71 章三段，每章总价基本不变（分别约 5,850、6,570、6,730），属于平台期。

每章总花费（默认序列）：

后段每章 6,090–6,780 金币。71 章全部数据见 ch2-data.json → chapter_costs。由于价格跟着生涯序号走，被分进 AB 组或少玩一章，后续章节的价格都会整体平移【推断】。

2.2.5 额外奖励（250 个点）

StoryStrategy_LTProgress.RewardItems1/2 有值的点共 250 个，约占 21.5%；其中 67 个点同时发两件。奖励在建造完成后由进度奖励流程发放（AppendPendingProgressRewardItems 支持断点恢复）【确认】。

分布（每 100 个点里有奖励的点数）：24 / 28 / 33 / 20 / 19 / 18 / 23 / 18 / 18 / 20 / 18 / 11（最后一段只有 63 个点）。第 201–300 个点（第 13–19 章）最密。相邻奖励点多相隔 3–6 个点。第一个奖励在第 6 个点（FoodB02），前 32 个点里集中发了 FoodGenerator01、FlowerGenerator01/02/03 等生成器，作用是给新手扩充生产线【推断】。

2.3 等级系统

2.3.1 规则

• 【确认】MergeLevelConfig_Main.CostType=2，即金币模式；LevelExpPerBuildPoint=15。LevelSys 有两种模式：CostTypeExp=1 读 ExpCost，CostTypeCoin=2 读 CoinCost。切换模式时由 MigrateProgressIfCostTypeChanged 换算已有进度。
• 【确认】等级进度只来自剧情建造：LevelHelper.GrantBuildProgress(exp, coinCost) → LevelSys.GrantStoryBuildProgress。金币模式下，每次建造花掉的金币直接计入升级进度。
• 【推断】Level=N 那一行的 CoinCost 是从 N 级升到 N+1 级所需的金币；奖励在升级时由 GetLevelReward 发放，弹出升级弹窗 LevelPopupHelper.ShowLevelUpPopup。
• 200 级合计：CoinCost 1,965,242，ExpCost 46,200。

2.3.2 200 级曲线（每 10 级一段）

2.3.3 金币模式与建造花费的对齐

• 【确认：数值】前 63 级（另有第 68、74 级）的累计 CoinCost，正好等于某个建造点的累计花费。也就是说，每次升级都刚好落在一次建造完成的瞬间，不会出现"差几个金币才升级"的情况。例子：
  • 1 级 116 = 第 1–5 个点（16+25+25+25+25）；
  • 2 级累计 214 = 前 8 个点；3 级 342 = 前 12 个点；
  • 4 级累计 506 = 前 16 个点 = 第一章总花费，所以打完第一章正好升到 5 级；
  • 10 级累计 2,616 = 前 54 个点；20 级 12,184 = 前 145 个点；30 级 32,887 = 前 263 个点；50 级 125,602 = 前 554 个点；63 级 = 前 762 个点。
• 每级需要的建造次数：1–4 级依次是 5/3/4/4 次；之后逐步增加，5 级 5 次、8 级 7 次、17 级 10 次、25 级 12 次、38 级 15 次，50–63 级每级 16 次，相当于一级一章。
• 【确认：数值】经验模式（ExpCost/15）和金币模式在 1–63 级给出的升级时点完全一致：前 3 个点各给 5 经验，第 16 个点给 30 经验，正好补齐差额。两种模式切换时节奏不变。
• 上限：默认序列的 1131 个点能升到 83 级；全表 1163 个点能升到 85 级。85 级以后要等新章节上线【推断】。

2.3.4 每级奖励

31–200 级全部是"宝箱 + EnergyChest01"：RedChest01 + EnergyChest01 共 88 级，GreenChest01 + EnergyChest01 共 82 级，没有例外。生成器奖励集中在 1–20 级：Food/Fruit/Clothing/Flower 04–05 级、Joy05、Toy05。

此外 2–10 级还有新手升级奖励（见 2.6.4），升级时作为弹窗单独发放。

2.3.5 按等级解锁时间轴

"建造数 / 章"是按金币模式换算出来的：达到该等级需要的生涯建造数，以及它落在默认序列的第几章【推断换算】。⊘ 表示包内默认配置关闭。

另有两项按建造次数（不是等级）触发：SnowstormRush01 和 StoryLuckyRiver_01（即 CozyRenovation），都是 TriggerType=buildpoint, Trigger=10【确认：ActivityManageConfig_ActivityLifetime】。

节奏：第一章 16 个点内就开放了仓库、商店、泡泡、笑脸订单、新手礼包、激励广告，共 4 次升级；第 2–3 章（第 17–47 个点）开放大部分常规周期活动；第 6 章开放体力倍率 ×2；第 16 章开放 ×4/×8。

2.4 单个建造的完整流程

【确认：ChapterContentController.RunBuildFlowAsync 等的 ISIL 调用顺序；扣费步骤见 07 笔记反汇编】

1. 点击图标 HandleIconClicked：场景上最多同时显示 3 个可建造图标，未解锁的显示灰色。图标上显示价格：金币足够时显示 出发 🪙{cost}，不够时显示 🪙{have}/{cost}（story_popup_coin_enough / not_enough）。点击时关闭当前引导，并上报 ReportStoryBuildClick。
2. 建造前对话 ShowBuildStartDialogueAsync → DialogueController.TryShowDialog(BuildStart)：按（章、时机、已建数）查 StoryContent_DialogueRes。
3. 合成小游戏（仅第一章前 3 个点）：TryRunBuildMinigameAsync / RunBottomMinigameAsync，配有 click/submit 两步引导。
4. 提交和扣费 TryCommitBuild：
   • 校验该点未完成，且 GetAssetCount("Coin") ≥ Cost；任一不满足就判失败，走"金币不足"分支；
   • 冻结顶栏金币显示（TopAssetHelper），为后面的飞币动画做准备；
   • ConsumeAssetCount("Coin", cost, "story_build") → AssetMgr.ConsumeAsset；
   • MarkBuildPointCompleted，生涯建造数加 1，上报 ReportStoryBuildFinish(pointId, cost)。
5. 建造动画 PlayBuildingAnim → PlayPreBuildAndBuildAnimAsync：先放预建造动画（PreBuildAnimationSwitch=true，锤子飞向点位），再播点位的 Spine、视频或特效，点位状态 BeforeBuild → Building → AfterBuild。飞币数量分档 FlyAssetNumber="30-3;80-5;160-7;450-9"【推断：花费 ≤30 飞 3 枚，≤80 飞 5 枚，依此类推】。动画速度倍率是 1.0。
6. 收尾 CompleteBuildPresentationAsync → TryShowDialog(BuildEnd) → ResolveBuildMode（Standard 或 Focus 镜头模式）。
7. 奖励 AfterBuild → TryPlayGrantRewardAnim：发 LTProgress 额外奖励；刷新可建造图标；尝试显示下一条引导。
8. 经验和外部联动（TestHome 注入的回调）：
   • LevelHelper.GrantBuildProgress(exp, coinCost)，升级时弹出升级弹窗；
   • StoryBuildPointFinishFlow.Execute(isLevelUp)，执行建造后弹窗队列（见 2.7.2）；
   • ActivityMgr.TryTriggerLifetime / OnStoryBuild、HeartbeatService.OnStoryBuild：建造计数驱动活动任务（如"在故事中建造 {0} 个点"）和 Lifetime 活动触发。
9. 章节完成：HandleChapterCompleted → ShowNextChapterIntro → StoryNextChapter 弹窗（"新剧情已解锁"）→ TryEnterNextChapter，按需下载新章节资源后切章。

金币不足的引导【确认：签名和配置；表现细节是推断】：

• OnInsufficientAssets → StoryMainView.HandleInsufficientAssetsAsync → ShowInsufficientAssetsInteractionAsync。
• 弹出 NotEnoughCoinPopup（ShortagePage，ShortagePageUiType=1，ShortagePageJumpType=1）。弹窗有三行说明，对应语言表 story_how_to_play_step1–3："完成订单 → 获得金币 → 花费金币助一臂之力"，标题是"玩法说明"。下方按钮"Go to Merge"（story_htp_dialogue_button）点击后以 StoryExitType.NotEnoughEnterGame 退出剧情，进入合成棋盘。
• 首次金币不足时，还可能先播一段玩法说明对话 StoryHTPDialogueRes=1001_D_900（标题 "Bread For Luna"，5 句），由 ShouldShowHTPDialogue 控制。

2.5 叙事内容量

【推断】对话文本已经写好约 3,400 句，但默认配置只把第一章接入了触发表，其他章是否显示对话取决于远程配置。另一种可能是线上已经把多数章节改成"只有建造、没有对话"，以缩短单点建造时长。1001 有 D_1–30、D_31–45、D_46–52、D_61–75、D_76–80 多套版本，和 1001_S_1…S_9 多个场景版本相互对应，说明第一章做过多轮 AB 和迭代。

2.6 新手期

2.6.1 首启流程

【确认：TestHome.RunStartupAsync 的 ISIL 调用顺序】

1. 初始化服务和剧情（StoryLauncher.InitializeStory，下载或显示第一章）。
2. 首启视频 FirstLaunchVideoPlayer.TryPrepare/TryPlay，播放 1001_cheating_2，不可跳过。
3. 初始化弹窗流程和引导（InitFlowAndGuide）。
4. 决定首页：ShouldEnterStoryDirectly 基于 StoryLauncher.IsFirstChapterFirstThreePointsFinished。【推断】第一章前 3 个点（三个小游戏点）完成之前，冷启动直接进剧情页；之后进 Home 页，并启动 HomeFlow 弹窗队列。
5. HomeFlow 结束后，按 IsLTFirstPointFinished 选择引导：TryShowGuideLTFirstEnterStory（引导去剧情）或 TryShowGuideFirstEnterCorePlay（引导去合成）。
6. 前 3 个点完成后，首次进入合成的交互是 FirstCoreplayEnterInteractionType=1，播放对话 1001_D_900（"Bread For Luna"），配套视频 1001_V_900_1。

• 新手初始棋盘 MergeNewUserBoardConfig_Board 是 9 行 × 7 列，大部分格子被雪块（Blocker）覆盖；清掉部分奖励格各得 Energy_10–30【确认】。

2.6.2 强引导规模

2.6.3 强引导主要步骤

【推断：执行顺序根据表顺序、文案和解锁等级排列；文案为语言表原文，部分只有英文】

2.6.4 新手奖励（MergeTutorialConfig_NewUserReward）

升到 10 级累计 Gem 120、Energy 180，外加 1 个 StarterChest01。发放渠道是 HomeFlow 的 newUserRewardFlow 和建造后队列的 LevelUp_NewUserReward。

2.7 弹窗队列

2.7.1 首页 HomeFlow（FlowScene "HomePage"）

排序规则【确认：反汇编】：FlowPriorityConfig.Apply 把配置权重换算成 Priority = 10000 − FlowWeight；FlowExecutor.Start 先过滤出 ShouldExecute 为真的单元，再按 Priority 升序排序，逐个串行执行。所以 FlowWeight 越大越先弹。RateAlert 不在配置表里，代码写死 Priority=999,999,999，永远排最后。弹窗关闭（UIMgr.PopupDidClose）后，HomeFlow.TryStart 会继续执行后面的单元。配置表名叫 FlowChance，但只有权重，没有概率字段；是否弹出完全由各单元自己的 ShouldExecute 条件决定。

顺序是：账号和奖励补发 → 升级 → 补偿和新手奖励 → 活动结算 → 礼包 → 活动开场 → 评分。权重相同的单元用 List.Sort 排序，这种排序不稳定，先后顺序不保证【推断】。

2.7.2 建造后和升级时的队列（FlowScene "StoryBuildPointFinish"，权重表 MergeFlowChanceConfig_LevelUpFlow）

每次建造完成后，调用 StoryBuildPointFinishFlow.Execute(isLevelUp)，在剧情页内依次检查：

升级时，先通过 LevelHelper 回调弹出升级奖励弹窗（LevelPopupHelper.ShowLevelUpPopup，"等级提升 / 领取"），再执行上表的队列。如果当时不在首页，回到首页时 HomeFlow 的 LevelUp（9991）单元会补弹【推断】。

2.8 元系统

2.8.1 用户资料（MergeProfileConfig_*，UserProfileService）

• 字段：昵称、头像、头像框、昵称特效、徽章。存档 key 是 UserProfile.Data【确认】。
• 头像 9 个（Avatar001–009），全部免费；默认 Avatar001。
• 头像框 6 个（Blue/Orange/Purple/Red/Silver/White），全部免费；默认 FrameSilver（权重最高，1100）。
• 徽章 4 个，全部来自活动：卡牌收集 FluffyCollection 给"愤怒小猫·黄金/钻石"，Halloween2026 给"黄金南瓜 / 钻石幽灵"（MergeProfileConfig_RewardConfig 按 CalendarID 绑定）。机器人不会使用徽章（RobotAvailable=false）。
• 头像和头像框带 RobotAvailable 与 Weight，供 Tournament、RoundDuel 等 PvP 活动生成机器人对手时按权重抽取【推断】。
• 昵称最长 15 个字形单位，有本地敏感词库；改名失败时提示"请确保未使用任何不支持的字符"【确认】。界面分 Avatar / Frame / Badge / Name 四个页签。

2.8.2 邮件（Inbox）

【确认：签名和常量，见 03 笔记 §5.2】邮件来自服务端，每页 10 封。类型分通知和奖励，状态分未读、已读、过期。每封奖励最多 4 件，并支持负数资产（运营扣回）。刷新时机：冷启动进首页、进入合成、打开收件箱、热启动。奖励邮件通过 HomeFlow 第 3 顺位的 InboxMail 自动弹出；通知邮件要点首页的邮件按钮查看，有红点提示。界面上显示"{0} 天后过期"。

2.8.3 本地推送

多条推送时间冲突时，按 Weight 保留一条（ResolveCollision）；每次回到前台重新排期【确认】。

2.8.4 评分弹窗（MergeRateAlertConfig_Main）

• 开启；只在 9–20 级 之间弹出；终身最多 3 次；两次间隔 7（单位推断为天）；RateAlertFiveStarsSwitch=true。
• 在 HomeFlow 中排最后（Priority 999,999,999）。文案"Having Fun? / Show your love by giving us 5 Stars!"，有 0–5 星选项（Not Fun … Excellent）。
• 【推断】选 5 星才跳转商店评分（项目集成了 Google Play Review），低星不跳转。

附：证据速查

版本：Frost Valley（com.liteorange.hometopia）v1.12.0，数据取自 APK 内置配置（extracted/config/tables/）。远程配置可能覆盖这些值。 标记：【配】 表示配置表或代码里能直接看到的值；【推】 表示根据字段名、表结构或调用关系推出来的结论。证据写在括号里，给出表名或类名。 时间：周循环表的 StartTime/Duration 单位是小时【配：WeeklyTask 168=7 天、BattlePass 672=28 天】。

3.1 活动框架

3.1.1 开启条件（三道闸）

33 个活动中，内置配置里 25 个开、8 个关。关闭的是：MoleChestOrder、DailyRewards、SnowstormRush、EnergyBattlePass、OrderInterstitialAD、StorySeasonMerge、CoinDash、LadderOrder。

解锁等级分布：3 级（CozyRenovation、MoonlitStories、SnowstormRush）→ 4 级（SmileOrder、BeginnerPack）→ 5 级（CardCollection）→ 6 级（WeeklyTask、24hTask、StorySeasonMerge）→ 7 级（PinataScore、MonopolyLike、ThemeGiftPack、DailyRewards）→ 8 级（ScoreStage、CoinPve、CoinRace、MergeSingleBoard、MergeMultiBoard、MergeBattlePass、CoinDash、LadderOrder）→ 9 级（Tournament、EndlessTreasure、EnergyBattlePass）→ 10 级（BattlePass）→ 12 级（LevelUpPackage、MoleChestOrder、NewMoleChestOrder）→ 16 级（PenguinSki、Escape）→ 18 级（RoundDuel）→ 20 级（OrderInterstitialAD）→ 35 级（FlamingFrenzy）。

3.1.2 四种档期类型（ActivityLoopType）

Lifetime 触发表【配：ActivityManageConfig_ActivityLifetime】：

3.1.3 28 天循环的锚点

【配：伪C WeeklyLoopResolver..cctor，与 ActivityMgr.ReCalculate28DayCycleWeekAndDay 共用同一个静态值】锚点是 new DateTime(2025,12,8,0,0,0,Utc)。第 1 天 = 锚点 + 28k 天，固定是周一 UTC 0 点；WeekIndex = 天/7+1，DayOfWeek = 天%7+1。因此 StartDay 1/8/15/22 都是周一，5/12/19/26 都是周五。全服统一按 UTC 切日，不按本地时区。

• 例：2026-10-20 是本轮第 9 天，本轮第 1 天是 2026-10-12。日历档 CardCollectionHalloween2026 的结束日 20261207 恰好是新一轮的第 1 天。

3.1.4 状态机

ActivityStatus【配】：Expired=0 → Signup=10 → Running=20 → Settling=30。

(等级/开关满足 且 时间窗命中)
      │  TryResolveNextWindow → 新建 ActivityBaseData → EnsureResReady
      ▼
  Signup ──IsAutoSignup 或 TryMarkEnrollSuccess──▶ Running ──到期/TryMarkSettling──▶ Settling ──领完/CanExitSettling──▶ Expired
      ▲                                                                                              │
      └──────────────────────────── 下一个窗口（LoopID 不同 = 新实例） ◀──────────────────────────────┘

• 【配】主玩法事件只会分发给 GetEffectiveStatus()==Running 的活动（ActivityMgr.OnXxx）。
• 【推】Signup 用于需要玩家确认的活动，例如 Escape 先选难度（EscapePhase.NeedSignup、EscapeDifficulty Easy/Normal/Hard）。其余多数活动自动报名。
• 【推】Settling 是结算展示和领奖阶段，例如 Tournament 的排名奖励弹窗 Tournament_RewardPopup。
• 结束补发【配：ActivityInstanceBase.DoActEndAction】：活动结束时，未领取的奖励写入 ForceRewardSaveKey，由首页流程 HomeFlow.ActivityEndAction 统一补发，随后删除记录。弹窗优先级：_ForceReward=9950【配：MergeFlowChanceConfig_HomeFlow】。合成棋盘类活动结束时，棋盘和待发放队列里的棋子按 Recycle 表折算成资源（CollectForceRecycleRewards，见 3.4）。主棋盘上残留的活动棋子由 IActivityChessCleanupProvider 清理（PinataScore）。
• 状态以 Activity.BaseData.<name> 为键存到本地（MessagePack），排行和机器人也在本地模拟，活动程序集里没有网络请求。

3.1.5 Leader / Follower

【配】MergeBattlePassInstance.IsFollower=true，通过 BindLeader / SyncStatusWithLeader 跟随 leader。ActivityMergeBattlePass_Main 只有两个键 MergeSingleBoard、MergeMultiBoard（值都是商品 bpmsb_399）。因此 MergeBattlePass 虽然配成常驻（LoopType=1），实际窗口与当周的合成棋盘活动同开同关。

3.1.6 入口位置与权重

ActivityInfo 有 4 个字段：HomeLocation / CorePlayLocation / OrderLocation / LocationWeight。

• 【配：伪C ActivityUiService.GetHomeIconInfos/GetCorePlayIconInfos 的插入谓词】图标先按 Location 升序分组，同组内按 LocationWeight 降序排（权重大的排在前）。首页用 HomeLocation，局内用 CorePlayLocation。
• 取值分布与含义：

3.1.7 资源预下载

【配：ActivityPreDownloadScheduler、ActivityResConst】

• 资源包是 ActivityPackage（YooAsset），CDN 目录 .../ActivityRes，锁定版本 activity-1.12.0。共 1091 个 bundle，其中 303 个随包，其余按需下载。
• 每次 Refresh 结束时调度预下载：挑出即将开启的窗口；用 ActivityLevelEtaTable.LevelEtaHours 估算玩家还要多少小时到达解锁等级（MaxLevel=30），只预下 ETA ≤ 48h 的活动；玩家等级要 ≥3；单任务超时 60s、冷却 60s、失败重试 1 次；每次只下载队头一个。
• 活动开启时资源没准备好的话，EnsureResReady 失败，隔 5000ms 重试；资源就绪前活动不会进入运行。结束后调用 UnloadUnusedActivityAssetsAsync 卸载。
• 【推】随包的是新手期和常驻活动：WeeklyTask、BattlePass、BeginnerPack、Pinata、MoonlitStories、CozyRenovation、NewUserReward。周循环和日历类活动靠预下载，体积较大的有 CardCollection 每套主题约 26MB、StorySeasonMerge 约 18.6MB。

3.2 28 天活动日历

数据：ActivityManageConfig_ActivityLoop（101 行）对照 ActivityInfo。■ = 档期开始日，□ = 档期延续日。跨过第 28 天的档期回绕到下一轮第 1 天：RoundDuel 第 28 天开的 48h 档会延续到下一轮第 1 天。完整数据见 ch3-data.json。

此外每天都在线、但受等级、触发或 CD 限制的活动：常驻 6 个（SmileOrder、PenguinSki、LevelUpPackage、NewMoleChestOrder、MergeBattlePass、FlamingFrenzy）；日历档的 CardCollection；Lifetime 类的 MoonlitStories、CozyRenovation、BeginnerPack。高等级玩家同一时刻一般有 13–15 个活动入口。【配】计数口径：某天任一时刻在线即计入。

周节奏（每周相同骨架）【配】

• 周一：WeeklyTask（整周）、合成棋盘活动（周一 02:00 起 166h，到周日 24:00 结束）、PinataScore 72h、EndlessTreasure 96h
• 周二：ScoreStage 24h
• 周三：Tournament 第 1 场 48h
• 周四：24hTask 与 Escape 同日，各 24h
• 周五：MonopolyLike 24h、ThemeGiftPack 72h；第 1、3 周加 CoinRace 72h，第 2、4 周加 CoinPve 72h
• 周六：Tournament 第 2 场 48h
• 周日：RoundDuel 48h（跨到下周一）
• 整轮：BattlePass 28 天

_Ignore 档期与主题轮换

• 【配】7 个虚拟活动名 ScoreStage_Ignore / CoinPve_Ignore / CoinRace_Ignore / MergeSingleBoard_Ignore / MergeMultiBoard_Ignore / 24hTask_Ignore / CoinDash_Ignore 共 27 行，都匹配不到 ActivityInfo，因此不生效。【推】这是"保留行、改名停用"的排期方式：把 ActivityName 改回真名就恢复档期。例如 ScoreStage 原来每周二、五各一场，现在只保留周二；24hTask 原来周四、六，现在只保留周四。
• 主题由 LoopID 前缀决定（ActivityHelper.GetWrapperWithLoopId 切分 LoopID）【配】。当前轮换的合成棋盘：第 1 周 SurfsideTreasures（SurfsideTreasures_01）→ 第 2 周 CozyKitchen（_02）→ 第 3 周 MuseumQuest（_03）→ 第 4 周 MergeMultiBoard LatteHaze（_04）。每个主题 4 个 LoopID 里只启用 1 个，其余 3 个标成 _Ignore。【推】调整排期时只需在 4 行之间挪动 _Ignore 标记。
• 其他活动在 v1.12.0 只有一个主题（如 Tournament=CookieFest、CoinRace=BankHeist），LoopID 序号只用来区分实例。

3.3 逐活动详解

3.3.0 通用积分源：棋子积分表

很多活动的分数来自同一张表 ActivityManageConfig_ActivityChessTicketRate【配】（160 行，每颗主线棋子一行）。每个活动在自己的 Main 表里用 TicketSource 指定取哪几列（ActivityTicketScoreType 共 10 种）：

各活动使用的积分源【配：各 *_Main】：

OrderScoreB 和 E 没有活动引用。ActivityOrderTicketRate（Deco1 一类 8 档：订单 Diffscore 0/47/197/314/498/791/1258/1998 → Token 20…200）只在 Meta 类里出现，代码中没有读取它的地方【配】。【推】这张表在 v1.12.0 未使用。

A. 任务类

WeeklyTask（7 日任务）｜开｜6 级｜每周一 0 点，168h｜pve

• 规则【配：ActivityWeeklyTask_Weekly 28 行 = 4 周 × 7 天】：每天 5 个任务。第 N 天的任务组 WeeklyTaskX_N 第 1 个固定是 login_day_N（累计登录 N 天）。【推】第 N 天解锁当天的任务组，之前的任务组可以补做。第 3 周的 DiffDes=hard 只是标签，任务内容与其他周相同。
• 积分来源【配：ActivityWeeklyTask_TaskPool 61 行】：每个任务完成后给固定 Score，另有一份小奖励（多为 Energy_5～50 或能量棋子）。代表行：

任务池里另有 deco_token_get 和 iap_times 两类，但没有排进任何一天。

• 每天的可得分：70 / 100 / 90 / 175 / 145 / 200 / 210，合计 990。
• 阶段奖励【配：ActivityWeeklyTask_Reward，4 周相同】：100 → Energy_75；220 → EnergyChest01；530 → Energy_125；750 → Gem_30；920 → Energy_250 + Gem_50 + CardPackYellow01。全部完成的额外奖励 StarReward = GreenChest01 + Gem_100 + Energy_300（【推】达成全部阶段后发放）。

24hTask（DiscoParty）｜开｜6 级｜每周四，24h｜pve

• 【配：Activity24hTask_DiscoTaskList 10 个任务 + DiscoTaskPool】依次为：得金币 200 / 350 / 500，花钻 5，合成 100，交单 10，笑脸 8 / 20，交单 30，耗体 1000。每个任务给一份小奖励：Energy_10、BoxOfFries01、GemChess03、PicnicBasket01、GemChess02、DrinkCarrier01、JoyGift01、Energy_15、PotOfSeafood01 等。
• 10 个全部完成后领 DiscoPartyFinalReward = Energy_50 + Gem_10 + SimpleChest01。【推】任务按 TaskIndex 顺序逐个出现。

SnowstormRush｜关｜3 级｜Lifetime：建造点 10 触发，Duration 30｜pve

• 【配：ActivitySnowstormRush_TaskInfo】只有 2 个任务：交单 16、建造 8。全部完成奖励 CoinChest01 + GemChest01。结束前 10 分钟推送（ApproachingEndPush=10）。首页、建造页、局内都有表现开关，另有冰冻和风声 BGM 开关。

B. 积分 / 阶段类

ScoreStage（SpringtimeBonus）｜开｜8 级｜每周二 24h（另有日历档 2026-01-05～02-05）｜pve

• 积分：MergeScore + OrderScoreA + BubblePurchaseScore。
• 【配：ActivityScoreStage_SpringtimeBonus 20 档】每档需要的分数是增量（序列不单调，所以是逐档追加），合计 5150 分。代表档：50 → Energy_10；200 → EnergyChess04；300 → OrderChestA01；500 → Gem_15；第 20 档 600 → OrderChestB01。奖励在 Energy_10、OrderChoiceChest01、EnergyChess04、OrderChest 之间交替。

MoonlitStories（表名 LTStoreStage）｜开｜3 级｜Lifetime：3 级触发，不限时｜pve

• 积分源同 ScoreStage【配：ActivityLTStoreStage_Main.MoonlitStories_01】。
• 【配：ActivityLTStoreStage_Bonus】20 个节点，增量需求 30→300。前 12 个节点的 LifetimeID=MoonlitStories_01，需求合计 880，奖励是 Energy_10、EnergyChess01/02/04、Coin_10、OrderChoiceChest01。后 8 个节点 LifetimeID="none"（需求 100～300，奖励含 OrderChestA01/B01、Gem_15），【推】当前不生效，留给后续轮次。这是新手期的积分引导活动。

CozyRenovation（StoryLuckyRiver）｜开｜3 级｜Lifetime：建造点 10 触发，不限时｜story

• 积分：家园剧情建造 OnStoryBuild，【推】每次建造得 1 分。
• 【配：ActivityStoryLuckyRiver_NewBonus】10 档，增量需求 1,1,1,2,2,2,2,3,3,3（合计 20 次建造）。奖励是 Coin_10/20/30、Energy_10/20，最后一档 DailyChest02。

CoinPve（ShinyCoinParade，NPC Vivian）｜开｜8 级｜第 12、26 天（周五）72h｜pve

• 积分：主线获得金币 OnCoinGet。
• 【配：ActivityCoinPve_ShinyCoinParade】11 个节点，增量金币需求 50→1000，合计 4550 金币。每个节点有 Vivian 对话（VivianDialogueContent）。奖励偏宝箱和卡包：节点 1 DailyChest01 + CardPackGreen01；节点 4 GeneratorChest01 + DailyChest01 + CardPackGreen01；节点 10 GeneratorChest01 + DailyChest02 + CardPackRed01；节点 11 GeneratorChest01 + OrderChestA01 + OrderChestB01。

PinataScore（BeachEscape，NPC Luna）｜开｜7 级｜每周一 72h｜pve

• 规则【配：ActivityPinataScore_*；PinataScoreInstance.TryGrantTicketChess → GiveActivityChessRewards】：
  1. 交单得到 OrderScoreA ticket。
  2. 按 ChessTicket 把 ticket 换成"贝壳"活动棋子并放到主棋盘：Lv1=5、Lv2=10、Lv3=20、Lv4=40、Lv5=80 ticket。每单最多 5 颗（MaxOrderChessNum=5）。
  3. 贝壳可以在主棋盘上合成（链 PinataScoreChess 最高 5 级）。点击收集得 PinataScore 分：Lv1→4、Lv2→8、Lv3→16、Lv4→35、Lv5→72（PinataAssetInfo）。只有 4、5 级合成后有溢价（2×16=32<35，2×35=70<72）。
  4. 积分推进 11 个阶段。
• 阶段【配：ActivityPinataScore_Stage】：增量 30,90,120,225,90,165,270,180,360,600,600，合计 2730。奖励结构与 CoinPve 基本一致（最后一档 GeneratorChest01 + OrderChestA01 + OrderChestB01）。
• 结束时清理主棋盘上残留的贝壳（IActivityChessCleanupProvider）。

PenguinSki（PenguinReward）｜开｜16 级｜常驻，自带开启条件和 CD｜pve

• 开启【配：ActivityPenguinSki_Main】：OpenRequirementType=1，FixedEnergyUseRequirement=100，FixedEnergyLeftRequirement=50。【推】累计耗体 100 且剩余体力 ≤50 时触发一轮。每轮持续 Duration=360（【推】分钟，即 6h），轮间 CD=24（【配：PenguinSkiInstance 用 AddHours】小时）。
• 积分：OnEnergyUse 与 OnGenerateChessToEdge。【推】ActivityPenguinSki_RewardChess（15 行）给出生成指定棋子时的得分，如 FoodA04=6、FoodA05=12、FoodB03=15、ClothingA04=15。
• 3 个阶段 350 / 850 / 1400 分。达成后按 RewardScore 175 / 245 / 280 发奖：从 ActivityLoopRewardGeneralConfig_RewardChess 里 PenguinStageNAvailable=true 的 50 种棋子中，按棋子 Score 凑够这个预算（【推】预算制随机组合）。棋子 Score 示例：FoodA03=3、A08=96、FoodB06=128、GemChess03=70。

FlamingFrenzy｜开｜35 级｜常驻，Duration 840 / CD 120（【配：FlamingFrenzyActivity 用 FromMinutes】分钟）｜pve

• 【配：ActivityFlamingFrenzy_Stage】按玩家等级分 3 段（1–45 / 46–80 / 81+），每段 3 个阶段：

  • 1–45 级：600 / 1400 / 2400
  • 46–80 级：700 / 1600 / 2700
  • 81 级以上：800 / 1800 / 3000

  三个阶段的返还率 ReturnRate 分别为 15% / 25% / 35%。

• 【推】玩法由局内的 BlueMergeGame/FlamingFrenzyActivity 实现：积累火热值升阶，阶段越高，交单时附带的奖励棋子越多（按订单价值 × ReturnRate）。订单上有火焰标记（OrderIconRes），交单后有金币收集动效（PrepareFlamingFrenzyCoinCollect）。

C. 竞速 / PvP 机器人类

机器人通用模型

• 表结构【配：Activity*_Robot】：DiffType（Top/Strong/Upper/Medium/Weak）、Number（人数）、InitialScoreBase、RatioLowLimit/HighLimit、OffsetValue[min,max]、UpdateInterval、ExceedScoreAdd[]、StandbyRatio、StandbyRatioNoPlayer。
• 更新逻辑【推，依据伪C RobotHandler.OnUpdateScore / GetCurrentCap / GetRandomOffset / GetRandomExceedAdd】：
  • 每个机器人有一个 [Low,High] 区间内的随机比例。每过 UpdateInterval，目标分 ≈ 玩家当前分 × 比例 + 随机 Offset，再乘以本轮的 RoundRatio，四舍五入。
  • 已经超过玩家的机器人，从 ExceedScoreAdd 数组中随机取一个值作为增量（数组里多是 0，所以超过玩家后基本停住）。
  • 机器人分数不超过当前 Cap。Tournament 的 Cap 按"开赛后第几天"取（day0=2000，day1=3800）。
  • 回到前台时（OnEnterForeground）按 StandbyRatio 补算离线期间的增长；玩家没有参与时用 StandbyRatioNoPlayer。
  • UpdateInterval 与 Time.time 比较，【推】单位是秒。
• 名字池：ActivityRobot_Name 600 个（如 Alex、CalebSky）；Tournament 另用 ActivityTournament_RobotName 60 个（LunaM、JakeR…）。

Tournament（CookieFest 锦标赛）｜开｜9 级｜每周三、周六各 48h｜pvp

• 积分：OrderScoreC（只计交单）。
• 30 人榜：玩家 + 29 个机器人【配：ActivityTournament_Robot】：

Cap=[2000,3800]。RoundRatio=[0.8,1.1,1.0,1.2,0.9,1.2]（【推】按场次取用，6 个值对应 8 场时循环使用）。Top 机器人的比例上限 1.3 > 1，所以玩家要拿第一，需要在 Cap 限制下拉开差距。

• 排名奖励【配：ActivityTournament_Reward】：第 1 名 Gem_20 + Energy_100 + DailyChest01；第 2 名 Gem_15 + Energy_80；第 3 名 Gem_10 + Energy_50；4–10 名 Energy_50；11–20 名 Energy_20；21–30 名无奖励。

CoinRace（BankHeist）｜开｜8 级｜第 5、19 天（周五）72h｜pvp

• 积分：获得金币。5 人赛：玩家 + 4 个机器人（Weak 档 Number=0）。
• 机器人【配：ActivityCoinRace_Robot】：

初始分都是 0；无玩家时待机比为 0，即玩家不在线时机器人不涨分。

• 关卡【配：ActivityCoinRace_BankHeist】：12 轮，RoundCap（本轮目标金币）为 250, 300, 400, 500, 500, 500, 650, 650, 650, 800, 800, 1000，合计 7000。RoundRatio=[0.8,1,1,1.2,0.8,1.2] 调节每轮机器人强度。【推】先到 RoundCap 的前 3 名获奖，然后进入下一轮。
• 奖励示例：第 1 轮第 1 名 DailyChest01 + Energy_15 + Energy_10；第 3 名 DailyChest01 + CardPackGreen01。第 4、8、12 轮另有里程碑奖：Energy_25 + DailyChest01 + OrderChestA01 → Energy_50 + DailyChest02 + OrderChestB01 → Energy_100 + DailyChest03 + OrderChestC01。

CoinDash（IslandClash）｜关｜8 级｜第 12 天 72h（其余 3 档 _Ignore）｜pvp

• 机器人表、RoundRatio、12 轮 RoundCap 和里程碑与 CoinRace 完全相同【配：ActivityCoinDash_Robot / RewardInfo】。区别只在奖励：第 2、3 名不含卡包。【推】这是 CoinRace 的换皮版本（赛跑 RacerView 表现），目前停用。

RoundDuel（GooseDuel，与"鹅"对决）｜开｜18 级｜每周日 48h｜pvp

• 积分：MergeScore + OrderScoreA。每轮 1v1，对手是 1 个 Upper 机器人【配：ActivityRoundDuel_Robot】：比例 0.65–0.95，Offset 0–4，间隔 1，StandbyRatio=1.0（离线时照常增长），无玩家时 0。
• 轮次【配：ActivityRoundDuel_Task 113 轮】：前 8 轮 RoundCap 为 120,150,180,200,250,300,350,400，之后按 300/350/400 循环，合计 38700。【推】先到 RoundCap 的一方赢下本轮，玩家赢才进入下一轮。RoundRatio 有 12 个值：0.7,0.8,1.0,0.8,0.8,1.0,1.0,1.0,1.2,1.0,1.5,2.0，机器人逐轮变强。【推】超过 12 轮后沿用最后一个值。
• 每轮奖励 SingleReward：Energy_15、PicnicBasket01 + CardPackGreen01、LevelDownChess01、各链 ChainPack、LevelUPChess01（第 113 轮）等。里程碑 Gacha 在第 2、5、8 轮，之后每 6 轮一次（12、18…108）：GachaRoundDuel01 = Energy_25 + Gem_10；02 = Energy_35 + OrderChoiceChest01；03 = Energy_50 + RoyalChestA01【配：MergeChestGachaConfig_MixedGacha】。

Escape（DungeonEscape，地牢逃脱）｜开｜16 级｜每周四 24h｜pvp

• 报名：先选难度 Easy / Normal / Hard（EscapePhase.NeedSignup）。积分：OrderScoreA + MergeScoreRace + ShopPurchaseScore + BubblePurchaseScore。
• 关卡【配：ActivityEscape_DungeonEscape，3 难度 × 10 关】：

• 机器人抢名额模型【配：伪C EscapeArrivalPressure；参数来自 ActivityEscape_Main】：
  • 压力值 p += GrowthPerMin × 经过分钟 × 关卡机器人速度。在线时 ActiveGrowthPerMin=0.004，离线时 OfflineGrowthPerMin=0.008（离线涨得更快）；关卡机器人速度在 RobotSpeedLimit 0.85–1.05 之间随机。
  • 已被机器人占掉的名额 = floor(p × WinnerNum)，p 最大为 1。
  • GetMaxPressureReservingLastSlot = (N−0.5)/N：最后 1 个名额始终留给玩家。【推】玩家不会因为机器人占满名额而失败，失败只来自时间。
  • 每关限时 StageFinishTimeLimit=60（StageFinishTimeLimitMin，分钟）。【推】60 分钟内达到目标即进入下一关，超时判负。
  • 以 Easy 第 1 关为例：在线 60 分钟，p ≈ 0.24，约有 24/100 个名额被占。

D. 订单改造类

SmileOrder（笑脸订单）｜开｜4 级｜常驻｜pve

• 【配：ActivitySmileOrder_*；玩法在局内的 BlueMergeGame/Smile/SmileActivity】部分订单附带笑脸，交单得笑脸。累计到 SmileScoreRequirement 后开一次奖励，需求序列为 [6,6,6,6,8,8,8,8,10,10,10,10,12]，【推】第 13 次之后保持 12。
• 每次开奖的预算：笑脸数 → RewardScore（1→12、6→75、8→125、12→250）。按预算从 RewardChess 池里（SmileRewardAvailable 的 50 种）组合出 2–5 颗随机棋子，奖励物品数 8–12。体力等价返还率随等级递减：3–15 级 25%，16–25 级 20%，26–40 级 15%，41 级以上 10%。

NewMoleChestOrder（新鼹鼠订单）｜开｜12 级｜常驻｜pve

• 【配】同时最多 2 单（CurNewMoleOrderMax=2）。交单后按策略掷骰（OnOrderSubmitted）决定是否出现鼹鼠宝箱订单：

【推】CD 单位为秒。奖励按预算从 RewardChess 池的 NewMoleNNAvailable 子集里组合；Mole01 只能出 9 种（Score 6–70）。

• 旧版 MoleChestOrder（关）：每周 12 档、各 24h；同时 2 单，返还率 60%，返还 5–12 颗棋子；ActivityMoleChestOrder_Reward 有 88 行，记录每种棋子的 EquivEnergy 和单次上限。

LadderOrder（SweetTiers，阶梯订单）｜关｜8 级｜每周二 24h，ActivityDuration=30｜pve

• 【配：ActivityLadderOrder_OrderManage】一串 5 张订单，每张 2 颗棋子，用主棋盘或仓库里的棋子提交（LadderOrderBoardAdapter.TryConsume）。每张给笑脸 1/1/2/2/2，体力返还 5%→25%。全部完成大奖 CardPackPurple01。交单会经 ActivityMgr.OnActivityOrderSubmit 再分发给其他活动。

OrderInterstitialAD（EnergyRush）｜关｜20 级｜常驻｜pve

• 【配】每完成 7 单（OrderRequirement=7）弹一次：基础奖励 Energy_10；看激励视频 ×3（RVRewardRatio=3）。

MonopolyLike（CandyCargo，糖果大富翁）｜开｜7 级｜每周五 24h｜pve

• 骰子票：交单按 OrderScoreD 得票（每颗棋子 1–5 票），开局送 5 票【配：ActivityMonopolyLike_Main】。
• 棋盘：24 格环形【配：ActivityMonopolyLike_BoardInfo】，按"Bonus、1、2、x2、5、10"的 6 格周期重复 4 次。骰子 1–6；倍注 [1,5,10,20,50]，每次掷骰消耗 BaseCost(1) × 倍注 张票，【推】得分 × 倍注。
  • 格子类型：Normal 格给格子面值；x2 格固定 25 分；Bonus 格基础 50 分，SuperBonus ×2。
  • 落点加权（【推】用于控制掷骰结果）：Normal 300 / x2 400 / Bonus 400，补偿权重 50 / 50。
• 进度【配：ActivityMonopolyLike_Reward 35 档 = 7 组 × 5 档】：每组内累计需求递增，如第 1 组 200/400/600/1000/2800，第 7 组 8500/12000/15000/18000/25000。奖励交替为卡包（Green→Blue→Red→Yellow→Purple 逐组升级）、OrderChoiceChest、GeneratorChest、CoreplayChest。每组最后一档是大奖：CoinChest01、EnergyChest01、GemChest01、Joy/Flower/Toy ChainPack，最后是 CardPackPurple01。

E. 独立合成棋盘类（详见 3.4）

F. 通行证类

BattlePass（PrizePath）｜开｜10 级｜第 1 天起 672h（整轮 28 天）｜iap

• 积分任务【配：IAPBattlePass_Task，【推】每满 RequireNum 计一次分，可重复】：

• 曲线【配：IAPBattlePass_Reward 46 行】：阶段 1=0 分，2=300，3=800，之后每阶段 +100，第 45 阶段=5000。第 46 行是无尽宝箱：满级后每 1000 分开一次，只有付费线有奖励（Premium1st=OrderChestB01）。【推】按 28 天平均，每天约需 180 分。
• 付费【配：IAPBattlePass_Main】：
  • VIP bp499（$4.99）：额外 +3000 分、+100 体力。
  • Deluxe bp799（$7.99）：额外 +3000 分、+150 体力，此后积分 ×1.5。
  • VIP 升级到 Deluxe：bp399（$3.99）。
  • 活动过期后仍可以购买 VIP（RequestExpiredPurchaseVIP）。
  • 【推】VIP 解锁 Premium1st 列，Deluxe 解锁 Premium1st/2nd/3rd 三列。
• 代表档位：

MergeBattlePass（棋盘通行证，follower）｜开｜8 级｜跟随当周的 MSB/MMB｜iap

• 推进方式【配：ActivityMergeBattlePass_MergeSingleBoard/MergeMultiBoard 各 13 阶】：没有积分，第一次合成出 ChessUnlock 指定的棋子（图鉴解锁）就推进一阶（SynchronizeBookProgress）。
  • MSB：MainChess02→…→MainChess11、SideChess07、MainChess12、SideChess08。
  • MMB：从 MainChess03 起，到 MainChess13、SideChess08。
• 免费线：前期给 MainChess01/02（1→8 颗，反哺棋盘），后期 Gem_20、Energy_150。
• 付费线 bpmsb_399（$3.99）：
  • MSB：Energy_100、EnergyChest01、Gem_50、OrderChoiceChest03、OrderChestB01/C01、Gem_100 等。
  • MMB：付费线改成卡包为主（CardPackBlue/Red/Yellow/Purple）。

EnergyBattlePass（EnergyStorm）｜关｜9 级｜每周五 72h，仅 Silence 分群｜iap

• 【配：IAPEnergyBattlePass_TaskList】15 档，按累计获得金币 250→5500 解锁体力奖励（50 为主，第 5、10 档 100，第 15 档 200，合计 1050 体力）。
• 付费【配：IAPEnergyBattlePass_UserSeg 13 档】：energybp01_99～energybp13_4999，Ratio 1.0–12.1（【推】奖励倍数），ValueRate 220–400（展示性价比）。DynamicBundlePricing="up"。默认商品 energybp01_99。3 个分群表与默认表相同。【推】要购买后才能领取体力。

G. 付费礼包类

付费点汇总：BattlePass（$4.99 / $7.99 / 升级 $3.99）、MergeBattlePass（$3.99）、StorySeasonMerge 通行证（bpseason_merge_399，$3.99）及其无尽礼包（$0.99–39.99）、EndlessTreasure、ThemeGiftPack、LevelUpPackage、BeginnerPack、EnergyBattlePass。

H. 个人触发类（Lifetime）

BeginnerPack（G）、MoonlitStories、CozyRenovation（B）、SnowstormRush（A）。触发与时长见 3.1.2。触发点：ActivityMgr.OnLevelChanged → TryTriggerLifetime（升级）和 TestHome 的建造点回调（BuildPoint）【配】。

I. 集卡：CardCollection（详见 3.5）

3.4 独立合成棋盘活动

三个活动共用 ActivityMergeGame 程序集（MergeActivityPlayGame + ActivityMergeBoard），通过 ActivityMergeEnterParams 复用主线的合成规则【配】。

3.4.1 对比总表

障碍【推】：BlockerA/B 是两层遮挡，格子下面预置了棋子（如 MainChess07）。逐层解开后棋子才能使用，相当于棋盘上的"宝藏"。

3.4.2 Ticket 兑换率（主线交单 → 活动棋子）

【配：*_ChessTicket】【推：MergeSingleBoardInstance.GetRewardChessInfoWithScore 对按 TicketScore 升序的表取不超过分数的最高一档，换出的棋子进入待发放队列 WaitToGrant，玩家在棋盘上逐颗领取】

换算示例【配：OrderScoreA】：一单含 FoodA07（15）+ FruitA06（10），ticket 为 25：MSB 换 1 颗 MainChess03（24），MMB 换 1 颗 MainChess02（20），StorySeason 换 MainChess02（6）。高价值订单，如含 FoodA10（116），在 MSB 能直接换到 MainChess05（96）。因为 ticket 档位按 ×2 设计，与合成的 2 合 1 等价，所以玩家直接拿高级棋子和拿多颗低级棋子再合成，得到的价值相同。

3.4.3 生成器与产出

• 【配：*_AutoGeneratorInfo / ChessGeneratorInfo；GenerateType=1、SpreadType=1】没有点击式生成器。【推】合成出某级 Main/Side 棋子时，按 SpreadWeight 列表向周围喷出资源棋子（名称_数量）。例：
  • MSB 合出 MainChess05：喷 ActivityCoinChess03 ×2。
  • MSB 合出 MainChess12：喷 Coin06×7、Energy06×2、Energy05×3、Energy04×1、Gem04×7、Gem03×1、SideChess01×3。
  • MMB 合出 SideChess07 / 08：额外喷 ActivityLevelDownChess01 / ActivityLevelUPChess01。
  • StorySeason 每级都喷 GreenExpChess，作为赛季经验来源。
• 宝箱棋子【配：ActivityMergeBoardGeneraConfig_GeneratorInfo】：
  • ActivityMainChest01：点 9 次，产出 MainChess02/03/04 和 Energy03/04。
  • ActivityCoinChest01 / EnergyChest01：各点 5 次，产出 Lv4–7（权重 40/30/20/10）。
  • ActivityGemChest01：点 3 次。
• 资源棋子收集【配：*_Asset】：Coin04–08 → 金币 2/6/14/30/62；Gem04–07 → 钻石 1/3/7/15；Energy04–08 → 体力 2/6/15/40/100（约每级 ×2.3）。
• 反哺主线【配：CoreplayReward】：ActivityLevelUPChess01 / LevelDownChess01 收集后变成主线的 LevelUPChess01 / LevelDownChess01（升级 / 降级道具）。

3.4.4 回收（Recycle，活动结束清算）

【配：*_Recycle；CollectForceRecycleRewards】活动结束时，棋盘和待发放队列里的棋子折算成资源：

• MSB：MainChess03→1 体力，然后每级 ×2，MainChess11→256 体力；MainChess12（终点）→0。SideChess01→1 … 07→64，08→0。资源棋子按 Asset 表的值折算。
• MMB：从 MainChess04 起算（1 体力），MainChess12→256，MainChess13→0。另有宝箱：CoinChest→50 金币、GemChest→10 钻、EnergyChest→50 体力、MainChest→10 体力。
• StorySeason：Main、Side、经验链全部按 0 回收，只有资源链有回收值。

3.4.5 MergeMultiBoard 专有

• BoardUnlock【配】4 个阶段，对应 UnlockMainChess 9 / 11 / 12 / 13。【推】合成出该级 MainChess 时解锁下一块棋盘或终局。
• 传送门【推】：棋子拖到 Portal 上会转移到另一块棋盘（BoardTransferPopup、PortalUnlockPopup）。
• 第 2–4 块棋盘的下半区预铺了整片资源棋子：第 2 块 15 格 Coin04，第 3 块约 20 格 Energy04，第 4 块约 16 格 Gem03。

3.4.6 StorySeasonMerge 专有（关闭中）

• 赛季等级【配：_Level 10 级】：Exp 0,80,120,200,300,500,700,900,1200,1500，奖励从 Energy_30 到 Energy_200 + Gem_80 + Coin_100 + DailyChest02 + OrderChoiceChest03。【推】经验来自收集 GreenExpChess。
• 奖杯【配：_Trophy】：
  • Halloween26_01_1：MainChess 解锁到 6/8/10/12/15 级，奖励 Energy_100 + Gem_20。
  • Halloween26_01_2：解锁到 13 级，奖励 Energy_50。
• 剧情节点【配：_StoryNodeRes】：开局播视频和对话，之后合出 MainChess 7/9/11/13/14/15 时各播一段对话，共 7 个节点（通过 PlayDialogueVideoAsync 调用主线剧情系统）。
• 通行证 16 阶：用 MainChess02–15、SideChess07/08 的解锁推进。免费线 MainChess01/02 ×1～8；付费线 Energy、Gem、OrderChest。
• 无尽礼包【配：_Package】：结构同 EndlessTreasure，但奖励全是 MainChess01（免费格 1–2 颗，付费格 2/4/6 颗）。

3.5 集卡 CardCollection

• 档期【配】：Calendar 类型，解锁 5 级。FluffyCollection 2026-08-20～10-22，Halloween2026 2026-10-23～12-07，两期首尾相接。活动开始送 InitialCardPackReward=CardPackBlue01。
• 卡册【配：CardGroup 15 组、CardInfo 135 张，每组 9 张】：
  • 每组集齐的奖励随组号递增：组 1–4 Energy_60，5 Energy_70，6 Energy_80，7–9 Energy_100，10–12 Energy_120，13–14 Energy_200，15 Energy_400。
  • 全册集齐：第 1 次、第 2 次和之后每次都是 Energy_600 + Gem_200 + LevelUPChess01（First/Second/OtherCollectionReward）。
• 稀有度【配：CardType】：

前几组以低星卡为主，组 13–15 集中了金卡（各 3 张）。

• 卡包【配：CardPack；伪C CardCollectionDropLogic.GetCardCount / CanDropGold】：

• 保底与权重【配：CardCollectionDropLogic 常量与伪C】：
  • 每张卡先按稀有度权重抽类型，再在该类型内抽具体卡。
  • 某组只剩最后一张未收集时，该卡权重 ×1.8。
  • Yellow 包第 3 / 4 次开（统计值 = 2 / 3）时，未收集卡权重 ×1.33 / ×1.66。
  • 强制出新卡：Yellow 在统计值 >3 时、Purple 在 >1 时（ShouldForceMissing）。【推】统计值是连续未出新卡的开包次数。
  • Special 包有 50% 概率只从未收集卡中抽。
  • 高星保底 HighStarMinNum=3：【推】部分卡包至少出 1 张 3 星及以上的卡，必要时替换掉重复卡或低星卡（FindDuplicateReplaceIndex / FindLowStarReplaceIndex）。
• 订单掉卡【配：ActivityCardCollection_OrderCard；伪C BlueMergeCorePlayGameManager.FinishOrderEvent → CardCollectionOrderCardResolver.Resolve(OrderData.basicOrderDifficulty)】：交单时当订单的 basicOrderDifficulty 落在 [Min,Max] 区间内就掉对应卡包：

区间之间留有空档，落在空档里不掉包。【推】单颗棋子的 DiffScore 最高只有 3000，普通订单很难达到这些阈值，所以卡包主要来自其他活动的奖励。

• 卡包的其他来源【配：全表检索】：RoundDuel（48 处，最多）、BattlePass（25）、MonopolyLike（15）、Escape（18）、CoinRace（16）、CoinPve、Pinata、MergeBattlePass(MMB)、WeeklyTask（每周 Yellow）、LadderOrder（Purple）、星星宝箱。
• 星星【配：CardCollectionDataService.GetStarNum(cardType)、ConsumeDuplicateCardStars、ExchangeRoundResourcesForStars】：
  • 卡的星数取 CardType 末尾数字（1–5）。
  • 重复卡转成对应星数的星星。【推】
  • 一期结束时，手上没开的卡包按 StarChangeNum 换成星星。
  • 星星宝箱【配：StarChest + MixedGacha】：100 星 → GachaStarChest01（Energy_30 + CardPackBlue01），200 星 → 02（Energy_50 + CardPackYellow01），400 星 → 03（Energy_100 + CardPackPurple01）。宝箱会再开出卡包，形成"重复卡 → 星星 → 卡包"的循环。
• 弹窗优先级：CardCollection_OpenAndCollect 15000（仅次于账号和 Gacha），CardCollection_Start 9905【配：MergeFlowChanceConfig_HomeFlow】。

3.6 活动与主玩法的耦合点

【配：各 *Instance.cs 中覆写的 OnXxx 钩子与实现的接口；调用方见 RecordHelper、OtherMgrModule、TestHome、ShopService、BlueMergeCorePlayGameManager】

附：配置确认与推断对照

适用版本：Frost Valley（com.liteorange.hometopia）v1.12.0，包内默认配置。线上可被 AB 实验 / 远程配置整表覆盖（见第 05 笔记 §6.1），本章数值只代表出包默认值。

标记约定：【配】 配置表直接读到；【码】 C# 签名或伪 C 里能确认的逻辑；【推】 推断（附依据）。证据只写表名 / 函数名。价格单位：配置里 USDPrice 以美分存（199 = $1.99），下文统一写美元。

图表数据：notes/design/ch4-data.json（价格带分布、钻石档每美元钻石、仓库扩格曲线、各礼包每美元货币量、体力通行证各档）。

4.1 货币体系

游戏有三种硬通货：金币 Coin、钻石 Gem、体力 Energy。另有活动代币（如季节活动的 MainChess）不在本章范围。初始持有 Coin 66 / Energy 100 / Gem 30【配】MergeAssetInfoConfig_AssetInfo。

4.1.1 金币（Coin）——建造货币，不能直接买

4.1.2 钻石（Gem）——付费主货币

4.1.3 体力（Energy）——行动力

4.2 IAP 商品：122 个 SKU 全表

【配】IAPInfo_PurchaseInfo 共 122 行，只有 6 个钻石档的 RewardInfo 直接写了内容，其余为空，内容由各礼包表按 PurchaseID 提供。

4.2.1 类别总览

4.2.2 价格带分布

共 29 个价位。图表数据见 ch4-data.json → price_band。

• ≤$9.99：59 个（48%）；$10–39.99：36 个；≥$44.99：27 个。$44.99 以上只有“无尽宝藏 / 季节无尽宝藏 / 体力通行证 / gem7450”。
• $1.99 最密集（11 个），其中 5 个是升级包变体。

4.2.3 钻石档

【配】IAPInfo_PurchaseInfo、MergeShopPageConfig_GemPurchase（6 档对应图标 shop_gem01–06）。每美元钻石从首档到 $39.99 单调上升，$99.99 档反而低于 $39.99 档（74.5 < 83.8）。

4.2.4 新手包（10 个）

【配】IAPBeginnerPackConfig_PurchaseInfo；默认售卖 SKU 写在 IAPBeginnerPackConfig_Main.PurchaseID = beginnerpack01_99，其余 9 个 SKU 默认配置不会被选中，【推】留给 AB 替换。

默认的 $0.99 包是全游戏每美元钻石最高的商品（101 钻/$，约为 gem100 的 2 倍），另送 300 体力。

4.2.5 升级包（21 个）

【配】IAPLevelUpPackageConfig_RewardInfo（ValueRate 是界面上的“超值倍数”，PackageWeight 用于同价位择优，见 4.3.3）。

货币部分整条线都是 50 钻/$；体力从 $1.99 档的 150/$（_2 变体）降到 $9.99 起的 100/$。

4.2.6 主题礼包（17 个，活动名 ThemeGiftPack，界面包装 MerryGoRound）

【配】IAPThemeGiftPack_RewardInfo（TaskID 1–17 按价格升序）。

4.2.7 无尽宝藏（25 个，活动名 EndlessTreasure，包装 MailboxTreasure）

SKU：endlesstreasure01_99 / 02_199 / 03_299 / 04_499 / 05_799 / 06_999 / 07_1299 / 08_1599 / 09_1999 / 10_2499 / 11_2999 / 12_3499 / 13_3999 / 14_4499 / 15_4999 / 16_5499 / 17_5999 / 18_6499 / 19_6999 / 20_7499 / 21_7999 / 22_8499 / 23_8999 / 24_9499 / 25_9999（$0.99–$99.99，07 起每档 +$5 左右）。

【配】IAPEndlessTreasure_RewardInfo 是一条 57 格的奖励链：第 1–3 格为一次性免费格（Energy_10、Gem_3、OrderChoiceChest01），第 4–57 格 IsLoop=T 循环。循环段每 6 格一个付费格，共 9 个付费格，默认只引用 9 个 SKU：

• 付费格之间夹 5 个免费格：棋子（FoodA05、FruitA05、ClothingA04、ToyA03…）、体力 15→55、钻石 5→28、宝箱 / 链包（DrinkCarrier01、FoodChainPack01、FreshPass01、RedChest01、GreenChest01 等）。
• 一轮循环付费合计 $110.91，得 Gem 3,300 + Energy 5,250；免费格合计 Gem 143 + Energy 315 + 棋子 / 宝箱。
• 【推】玩法为“买下当前付费格才能继续领后面的免费格”的链式礼包（从 TaskID 顺序和 IsLoop 推出，未逐指令确认）。

4.2.8 通行证类

BattlePass 本体【配】IAPBattlePass_Reward / _Task：

• 46 档，积分门槛 0, 300, 800, 900, 1000 … 5000（步长 100）；第 46 档门槛 1000，【推】为满级后的循环档。
• 奖励分 Basic + Premium1st / 2nd / 3rd。Basic 轨合计 Energy 790；Premium1st 合计 Gem 145 + Energy 175，其余为宝箱、棋子、卡包。【推】VIP 解锁 Premium1st，Deluxe 解锁 2nd / 3rd。
• 积分任务：登录 30、合成 100 次 10、提交 5 单 100、获得 100 金币 50、建造 2 次 60、获得 2 笑脸 20、消耗 5 钻 30。

4.2.9 体力通行证（13 个，活动名 EnergyBattlePass，默认关闭）

【配】IAPEnergyBattlePass_UserSeg + _TaskList。机制：活动期间累计赚取金币达到 250→5,500（15 档），每档领体力，基础合计 1,000。买哪一档决定体力倍率 Ratio。

“体力合计 = 基础 1,000 × Ratio”是【推】，依据 EnergyBattlePassConfig.ScaleTaskEnergyReward / ScaleInt / NormalizeRatio 的签名。Ratio 不随价格单调（$12.99 和 $39.99 档回落），原因未确认。

4.2.10 季节无尽宝藏（25 个）

SKU：endless_season_merge01_99 … endless_season_merge25_9999，价位与 4.2.7 一一对应。【配】ActivityStorySeasonMerge_Package 与无尽宝藏同构（57 格，付费格同为第 4/10/16/22/28/34/40/46/52 格，同样只引用 9 个 SKU），奖励换成季节活动代币 MainChess01（付费格 ×2→×6）+ 体力 / 钻石等。

4.3 礼包触发与投放节奏

4.3.1 活动框架

【配】ActivityManageConfig_ActivityInfo 把礼包也当“活动”管理（ActivityType=iap），用 LoopType 区分投放方式：1 = 常驻 / 条件触发，2 = 按循环档期，3 = 日历档期，4 = 生命周期（一次性）。【推】循环档期以 28 天为一个周期（BattlePass 一期 672h = 28 天，其他循环活动的 StartDay 都在 1–28 之间）。

证据：【配】ActivityManageConfig_ActivityInfo / _ActivityLoop / _ActivityLifetime / _ActivityCalendar。

4.3.2 各礼包规则

新手包

• 【配】IAPBeginnerPackConfig_Main：售卖 SKU beginnerpack01_99，Duration=2880（48h），PopUpType=2。
• 【配】Lifetime 有两条：Icebreak01（Trigger = -1）和 CozyHearth_01（Trigger = 4）。【码】BeginnerPack 里两者是不同包装（Icebreak = NewBeginnerPackage，CozyHearth = CozyHearth 弹窗 / 首页图标 / 商店横幅）。【推】Trigger = -1 表示默认不触发，实际生效的是 4 级的 CozyHearth。
• 【配】IAPBannerConfig_Banner：商店顶部挂 BeginnerPack 横幅（权重 100）。

升级包

• 【配】IAPLevelUpPackageConfig_PurchaseInfo 194 行：触发等级 7–200 各对应一个 SKU，并给出 ValueRate。
• 【配】Duration=3600（1 小时限时），DynamicBundlePricing=down。
• 【码】LevelUpPackageInstance 维护 ActivePackages 列表（每个包有 TriggerLevel、EndTimeTicks、PopupAutoShown）以及已消费 ID，有 ActivatePendingPackages。【推】7–11 级攒下的触发会等活动在 12 级解锁后再激活；同时可能挂着多个未过期的包，按触发等级倒序排（SortActivePackagesDescending）。

主题礼包

• 【配】IAPThemeGiftPack_Main：首页每天最多自动弹 1 次（MainPagePopMaxNum=1），每日购买次数不限（DailyBuyMaxCount=-1），起始 SKU theme_gift_pack_99，DisplayDuration=240（4h），定价 30day_avg_auto。
• 【码】ThemeGiftPackUserData 记录当前档位 TaskID / PurchaseID / USDPrice / BundleStartUtcTicks / PendingNextBundle、按日购买次数、当日弹窗次数；常量 MaxBuyCountDays=8。【推】每个包展示 4 小时，过期或买下后切下一个包（重新定价），72 小时档期内可滚动出多个包。