docs: 订正 pct 合并公式——必须按 combine 分支，inverse 用 1−(1−step)^n

spec §2.4 与计划 Task2 写的 merged = (1+step)^n − 1 只对 hybrid 成立（AttributeFormula 对 hybrid 用 f=1+v）。inverse 用的是 f=1−v，于是 cast_delay_mod 实际算成 f = 2−1.1^n 而非意图中的 0.9^n： n=2 应 0.81 实得 0.79；n=7 应 0.478 实得 0.0513 后果是该属性在第 7 次购买就撞 soft 封顶（设计意图约 22 次），可购买次数砍到 1/3、边际收益曲线整体错误，且零诊断。评审真机连续购买 7 次坐实。此为 spec 源头错误，非实现偏差。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-03 11:17:35 +08:00
parent 25bdc83c93
commit 68e3edbc7d
2 changed files with 12 additions and 3 deletions
@@ -371,8 +371,16 @@ func _apply_attr_purchases() -> void:
 			continue
 		var mode: String = String(sp.get("mode", "flat"))
 		var step: float = float(sp.get("step", 0.0))
-		# pct 合并：n 次 +step 在连乘下等价于单条 (1+step)^n − 1
-		var merged: float = (pow(1.0 + step, float(n)) - 1.0) if mode == "pct" else (step * float(n))
+		# pct 合并必须按属性的 combine 分支——AttributeFormula 对 hybrid 用 f=1+v、对 inverse 用 f=1-v，
+		# 故两者的等价单条值不同。写错会让 inverse 属性（cast_delay_mod）的曲线整体偏离且零诊断。
+		var combine: String = String(_attr_def.get(id, {}).get("combine", "hybrid"))
+		var merged: float = 0.0
+		if mode == "pct":
+			# hybrid: 需 f=(1+step)^n → merged=(1+step)^n−1
+			# inverse: 需 f=(1−step)^n → merged=1−(1−step)^n
+			merged = (1.0 - pow(1.0 - step, float(n))) if combine == "inverse" else (pow(1.0 + step, float(n)) - 1.0)
+		else:
+			merged = step * float(n)   # flat 线性可加，与 combine 无关
 		PlayerStats.add_modifier(id, mode, merged, MOD_SOURCE_SHOP_C)

 ## 存档：只存次数，加成是派生物（回读时经 _apply_attr_purchases 重建）