spellforge

190 Commits 1 Branch 0 Tags

3 Commits

Include renames

Author	SHA1	Message	Date
joywayerandClaude Opus 5	622da4a18e	feat(shop): 货架 C 状态与购买——shop 段驱动可售集合，唯一写入点重建加成可售集合纯数据驱动：attributes.json 的 shop 段缺失即不可售，将来解除 7 个被阻塞属性的前置后只需加一段 JSON，零代码。 PlayerStats 新增通用生效值访问器 get_attr_value(attr_id)，消除商店/UI 侧本应出现的三处硬编码 match attr_id；_attr_effective 与裸字段在同一处（_recompute_attrs）更新，避免两者不同步导致显示值与生效值脱节。 _attr_purchases 只存次数；每属性至多一条 _modifiers、value 为合并值（pct 下 n 次 +step 等价于单条 (1+step)^n − 1）。这样出售退款只需次数减一后重算，不必给 PlayerStats 新增按条撤销的 API。所有改动次数的路径都收在 _apply_attr_purchases()——两份状态不同步会产生「显示买了 3 次但加成只有 2 次」且无任何诊断，收敛写入点是唯一防线。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-08-03 11:11:08 +08:00
joywayerandClaude Opus 5	ba7c885291	fix(attr): cast_delay_mod 硬上限 0.01 → 0.05，消掉两把主力杖的射速无效区间 _handle_auto_cast 用 if 而非 while，每物理帧至多施法一次，故本属性存在饱和点 = (1/60) / 法杖基准间隔：wand_basic(0.5s) ≈ 0.033、wand_fast(0.25s) ≈ 0.05。原 hard: 0.01 在两把主力杖上都深深落在饱和区内——玩家把 cast_delay_mod 从 0.033 一路买到 0.01，射速一点没变，属"承诺了循环交付不了的东西"。取 0.05 使 wand_fast 恰在硬上限处饱和、wand_basic 全程无无效区间。边界实测（同一套 _physics_process 帧距扫描）：wand_fast@0.05 = 1 帧/次(60/s)、 wand_basic@0.05 = 2 帧/次(30/s)、请求 0.01 被 maxf(hard,…) 钳回 0.05 后帧距不变、 soft(0.1) 对照仍 3 帧/次(20/s)、circuit_fork@0.05 = 2 帧/次。未加任何代码钳制：下限已由 attributes.json + AttributeFormula 的 maxf(hard,…) 强制，代码里再加一个会形成重复权威，设计师调 hard 时立刻脱同步。 spec 新增 §2.2b 收录完整实测数据集（饱和点公式与三把杖的值、soft→hard 是台阶而非曲线、周期恒为 ceil(T×60) 且整帧倍数多花一帧故实际射速恒 ≤ 名义值）—— 结论易得而数据难得，故一并留档。circuit_fork 的饱和点 0.0278 标注为公式推导。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-07-31 13:18:46 +08:00
joywayerandClaude Opus 5	a4a4f613f4	feat(attr): attributes.json + PlayerStats 属性框架；删孤儿字段 armor/resistance PlayerStats 只负责加载定义、持有加成列表、把公式结果写进静态类型裸字段，不含任何公式（公式在 AttributeFormula）。读取端零开销以满足热路径纪律（move_speed 每物理帧被 player_manager 读）。 armor/resistance 零消费方且不在 numerical_design §1.1 权威属性表内，属实现先于设计的残留，删除；真要做玩家侧减伤时按货架 C 属性词条立项（见 spec §2.6）。 hp_max/cpu_limit 现为派生值，从存档字段移除——回读会覆盖公式结果。旧存档相应键忽略即可，无需提升 schema 版本（hp_max 全项目从无写入方、 cpu_limit 从未被读取）。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-07-31 11:07:59 +08:00

Author

SHA1

Message

Date

joywayerandClaude Opus 5

622da4a18e

feat(shop): 货架 C 状态与购买——shop 段驱动可售集合，唯一写入点重建加成

可售集合纯数据驱动：attributes.json 的 shop 段缺失即不可售，将来解除 7 个
被阻塞属性的前置后只需加一段 JSON，零代码。

PlayerStats 新增通用生效值访问器 get_attr_value(attr_id)，消除商店/UI 侧
本应出现的三处硬编码 match attr_id；_attr_effective 与裸字段在同一处
（_recompute_attrs）更新，避免两者不同步导致显示值与生效值脱节。

_attr_purchases 只存次数；每属性至多一条 _modifiers、value 为合并值
（pct 下 n 次 +step 等价于单条 (1+step)^n − 1）。这样出售退款只需次数减一后
重算，不必给 PlayerStats 新增按条撤销的 API。

所有改动次数的路径都收在 _apply_attr_purchases()——两份状态不同步会产生
「显示买了 3 次但加成只有 2 次」且无任何诊断，收敛写入点是唯一防线。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-08-03 11:11:08 +08:00

joywayerandClaude Opus 5

ba7c885291

fix(attr): cast_delay_mod 硬上限 0.01 → 0.05，消掉两把主力杖的射速无效区间

_handle_auto_cast 用 if 而非 while，每物理帧至多施法一次，故本属性存在饱和点
= (1/60) / 法杖基准间隔：wand_basic(0.5s) ≈ 0.033、wand_fast(0.25s) ≈ 0.05。
原 hard: 0.01 在两把主力杖上都深深落在饱和区内——玩家把 cast_delay_mod 从
0.033 一路买到 0.01，射速一点没变，属"承诺了循环交付不了的东西"。

取 0.05 使 wand_fast 恰在硬上限处饱和、wand_basic 全程无无效区间。
边界实测（同一套 _physics_process 帧距扫描）：wand_fast@0.05 = 1 帧/次(60/s)、
wand_basic@0.05 = 2 帧/次(30/s)、请求 0.01 被 maxf(hard,…) 钳回 0.05 后帧距不变、
soft(0.1) 对照仍 3 帧/次(20/s)、circuit_fork@0.05 = 2 帧/次。

未加任何代码钳制：下限已由 attributes.json + AttributeFormula 的 maxf(hard,…)
强制，代码里再加一个会形成重复权威，设计师调 hard 时立刻脱同步。

spec 新增 §2.2b 收录完整实测数据集（饱和点公式与三把杖的值、soft→hard 是台阶
而非曲线、周期恒为 ceil(T×60) 且整帧倍数多花一帧故实际射速恒 ≤ 名义值）——
结论易得而数据难得，故一并留档。circuit_fork 的饱和点 0.0278 标注为公式推导。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-07-31 13:18:46 +08:00

joywayerandClaude Opus 5

a4a4f613f4

feat(attr): attributes.json + PlayerStats 属性框架；删孤儿字段 armor/resistance

PlayerStats 只负责加载定义、持有加成列表、把公式结果写进静态类型裸字段，
不含任何公式（公式在 AttributeFormula）。读取端零开销以满足热路径纪律
（move_speed 每物理帧被 player_manager 读）。

armor/resistance 零消费方且不在 numerical_design §1.1 权威属性表内，属实现
先于设计的残留，删除；真要做玩家侧减伤时按货架 C 属性词条立项（见 spec §2.6）。

hp_max/cpu_limit 现为派生值，从存档字段移除——回读会覆盖公式结果。
旧存档相应键忽略即可，无需提升 schema 版本（hp_max 全项目从无写入方、
cpu_limit 从未被读取）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-07-31 11:07:59 +08:00