From 1aeae19187f0c483717b6e42ed88bd5326096d6a Mon Sep 17 00:00:00 2001 From: Joywayer Date: Fri, 31 Jul 2026 12:54:22 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=AE=A2=E6=AD=A3=20move=5Fspeed=20300?= =?UTF-8?q?=E2=86=92200=20=E4=B8=8E=20cpu=5Flimit=E3=80=8C=E4=BB=8E?= =?UTF-8?q?=E4=B8=8D=E8=AF=BB=E3=80=8D=E5=91=8A=E8=AD=A6=EF=BC=9B=E8=B7=AF?= =?UTF-8?q?=E7=BA=BF=E5=9B=BE=20E3-=E2=91=A0=20=E5=8B=BE=E9=99=A4=E5=B9=B6?= =?UTF-8?q?=E8=AE=A2=E6=AD=A3=E7=8E=B0=E7=8A=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit move_speed 300 从未被任何代码读取，是纸面孤值；200 自 S0 沿用并已围绕它调校 20 波内容与 Boss 弹幕密度，以既成事实为准。cpu_limit 行的「代码硬编码 40×5、 从不读 cpu_limit」告警随本次接线失效，改记生效值构成（玩家基准 0 + 法杖 3–8） 与 hard(50) 作用于加总后的总值；基准值一并由 5 改为 0，否则重蹈 move_speed 的 「纸面值与实现长期脱节」。 路线图 E3 现状原写「player_stats.gd 有 resistance 等占位属性（4/5 stats 未接线）」 与事实不符——权威属性表是 11 个，armor/resistance 根本不在表内，是实现先于设计的 孤儿字段。E3-① 勾除并标注实际范围（只做框架 + 三条死数据），attunement_×4 / luck / recharge_speed_mod 三项延后各附理由；顺带记 cast_delay_mod 的饱和区待人定。 E1 现状里「玩家侧抗性仍占位」一句同因失效，一并订正。 Co-Authored-By: Claude Opus 5 --- docs/design/numerical_design.md | 4 ++-- .../plans/2026-07-23-missing-features-roadmap.md | 13 ++++++++++--- 2 files changed, 12 insertions(+), 5 deletions(-) diff --git a/docs/design/numerical_design.md b/docs/design/numerical_design.md index 2532483..74a1a26 100644 --- a/docs/design/numerical_design.md +++ b/docs/design/numerical_design.md @@ -17,11 +17,11 @@ | :--- | :--- | :--- | :--- | :--- | :--- | | `hp_max` | 最大生命 | 100 | 2000 | - | | | `mana_max` | 最大魔力 | 100 | 1000 | - | 全局蓝条上限，法杖也有自己的上限，取 Min 值 | -| `move_speed` | 移动速度 | 300 | 600 | 800 | 像素/秒 | +| `move_speed` | 移动速度 | **200** | 600 | 800 | 像素/秒。⚠️ **2026-07-31 订正**：原写 300 从未被任何代码读取过，是纸面孤值；实际实现自 S0 起即为 200（`player_manager.gd` 的 `const MOVE_SPEED`，现已改为读 `data/attributes.json`），20 波内容、Boss 弹幕密度、无敌帧 0.5 s 均按此值调校。此处以既成事实为准 —— 改回 300 等于用未经验证的数字推翻一整轮已调校的内容。理由详见 `docs_dev/specs/2026-07-31-player-attributes-design.md` §2.2。 | | `cast_delay_mod` | 施法延迟修正 | 1.0 (100%) | 0.1 | 0.01 | 越低越快，乘算系数 | | `recharge_speed_mod` | 充能速度修正 | 1.0 (100%) | 5.0 | - | 越低越快 | | `luck` | 幸运 | 0 | 100 | - | 影响高阶法术掉率、暴击率 | -| `cpu_limit` | 运算力上限 | 5 | 20 | 50 | `SpellEvaluator` 实际 MAX_OPS = `cpu_limit × 40`（默认 5 → 200 步；软上限 20 → 800 步；硬上限 50 → 2000 步）。升级此属性可执行更复杂的法术链，与 `implementation_plan.md §2.2` 的 `MAX_OPS_PER_CPU = 40` 常量对应。 ⚠️**实现现状(2026-07-20)**：代码硬编码 `MAX_OPS = 40×5 = 200`，**从不读 cpu_limit**——升级此属性对施法预算无效（待修，本设计更优）。 | +| `cpu_limit` | 运算力上限 | **0**（玩家侧） | 20 | 50 | `SpellEvaluator` 实际 MAX_OPS = `生效 cpu_limit × 40`，与 `implementation_plan.md §2.2` 的 `MAX_OPS_PER_CPU = 40` 常量对应。**生效值 = 玩家侧基准 0 + 法杖份额（`cores.json` 逐杖 3–8，以 `source="core"` 的加成来源接入）+ 未来的玩家加成**；`hard`(50) 作用于**加总后的生效值**，故法杖份额也受硬上限约束。玩家侧基准取 0 而非 5 是刻意的：生效值已含法杖的 3–8，取 0 使小木法杖仍为 5 → 200 步（现有平衡零改动），取 5 会让所有法杖的执行预算翻倍；语义上玩家属性是"全局加成"，基准 0 正是纯加成语义。 ✅ **2026-07-31 已修复**（原 ⚠️「代码硬编码 MAX_OPS = 40×5 = 200，从不读 cpu_limit」现已失效）：`spell_evaluator.gd` 改读 `MAX_OPS_PER_CPU * maxi(PlayerStats.cpu_limit, 1)`，`cores.json` 逐杖配置的运算力自此生效（高速法杖 3 → 120 步、小木 5 → 200、矩阵板 8 → 320，运行时实测）。设计见 `docs_dev/specs/2026-07-31-player-attributes-design.md` §2.2。 | | `attunement_fire` | 火焰精通 | 0 | 50 | 100 | 每点：火焰伤害 +3%（乘算），火焰状态（点燃/爆燃）触发概率 +2%。影响 `damage_type=FIRE` 的所有投射物。 | | `attunement_ice` | 冰霜精通 | 0 | 50 | 100 | 每点：冰霜伤害 +3%，冰冻/减速触发概率 +2%。 | | `attunement_lightning` | 雷电精通 | 0 | 50 | 100 | 每点：雷电伤害 +3%，麻痹/连锁导电触发概率 +2%。 | diff --git a/docs_dev/plans/2026-07-23-missing-features-roadmap.md b/docs_dev/plans/2026-07-23-missing-features-roadmap.md index 2a22f5c..d44c7d3 100644 --- a/docs_dev/plans/2026-07-23-missing-features-roadmap.md +++ b/docs_dev/plans/2026-07-23-missing-features-roadmap.md @@ -40,7 +40,7 @@ E6-a 玩家无敌帧(i-frames) ← 先行小项：Boss 弹幕公平性前置， **目标**：让子弹的 pierce 以外的深度维度真正生效，使元素、抗性、轨迹类词条与核心特性产生行为差异。 **现状（代码复核 2026-07-23）**： -- ~~元素抗性~~ ✅ **完成**（2026-07-24，`feat/element-resistance`）：`apply_damage_from_context` 按 `ctx.damage_type` 查 `_RESIST` 表传入 `calc_damage(0, res)`；`enemies.json` 每型可选 `resistances{元素名:-0.9~0.9}`（支持负=弱点加伤）；设计器敌人页加 6×5 抗性网格。MCP 实测：抗火0.5→半伤、弱冰-0.5→1.5×、抗性+护甲叠加45。⚠️ **已知限制**：DOT 伤害（`status_manager.gd:116` 直调 `apply_damage`）暂不享元素抗性（架构上 DOT 不走 context，见 E2）。（`player_stats.gd:23 resistance` 玩家侧抗性仍占位。） +- ~~元素抗性~~ ✅ **完成**（2026-07-24，`feat/element-resistance`）：`apply_damage_from_context` 按 `ctx.damage_type` 查 `_RESIST` 表传入 `calc_damage(0, res)`；`enemies.json` 每型可选 `resistances{元素名:-0.9~0.9}`（支持负=弱点加伤）；设计器敌人页加 6×5 抗性网格。MCP 实测：抗火0.5→半伤、弱冰-0.5→1.5×、抗性+护甲叠加45。⚠️ **已知限制**：DOT 伤害（`status_manager.gd:116` 直调 `apply_damage`）暂不享元素抗性（架构上 DOT 不走 context，见 E2）。（~~`player_stats.gd:23 resistance` 玩家侧抗性仍占位~~ —— **2026-07-31 订正**：该字段零消费方且不在权威属性表内，属实现先于设计的残留，已随 E3-① 删除；玩家侧减伤真要做时按货架 C 属性词条立项，见 `docs_dev/specs/2026-07-31-player-attributes-design.md` §2.6。） - ~~连锁/弹跳~~ ✅ **完成**（2026-07-24，`feat/bullet-bounce`）：镜像 pierce 管线——`CastStats.bounce_add` → `_apply_modifier` 折叠 → `_push_projectile` 写冷数据 → `_check_collision` 命中转向最近未访问敌(`_find_nearest_unvisited`)、`damage_mult×decay` 递减、`visited_targets` 防回跳、命中循环跳过已访问防密集群重复命中。bounce 优先于 pierce（耗尽后落 pierce）。`modifier_bounce` 词条上架。MCP 实测：bounce=2→3 敌 100/90/81、速度重定向证明优先级、折叠 bounce_add=2。 - ~~归航~~ ✅ **完成**（2026-07-30，`feat/bullet-homing`）：镜像 bounce 管线——`CastStats.homing_add`(float) → `_apply_modifier` 折叠 → `_push_projectile` 写冷数据 `homing_strength/homing_range/homing_target_id` → `_gd_integrate` 在位置积分**之前**调 `_apply_homing`，用 `wrapf` 取最短转向、`clampf` 到 `strength*delta` 限角速度、`rotated()` 保速率。目标为**发射后锁定**：仅首帧与目标死亡时经 `_find_nearest_unvisited` 重选；bounce 命中重定向时改写 `homing_target_id`（bounce 选目标、homing 追上去）。`modifier_homing` 词条上架。MCP 实测见下方「⚠️ 有意偏离」与 spec §5。 - ⚠️ **有意偏离本文档原方案**：本行原写「`_gd_integrate` 消费 `_enemy_pos_snapshot`」，实现**没有**消费它，而是**删除**了 `_enemy_pos_snapshot` 及其唯一生产者 `EnemyManager.fill_pos_snapshot`。理由：最终设计采用**按 entity_id 锁定目标**（轨迹可读、目标死亡有明确判据 `get_pos_by_id` 哨兵），而该快照**按槽位存位置、不含 entity_id**，结构上支撑不了锁定语义；接上它反而要每帧 O(敌人数) 重扫最近点。净效果是**减少**一份每帧 O(敌人数) 开销。 @@ -81,14 +81,21 @@ E6-a 玩家无敌帧(i-frames) ← 先行小项：Boss 弹幕公平性前置， **目标**：把商店从"只卖法术"扩成完整 roguelite 经济：核心抽取、属性升级、出售退款，配合玩家属性成长系统。 -**现状（代码复核 2026-07-23）**：`shop_manager.gd` 无 shelf/sell/core/attr 任何字段（grep 零匹配）→ **仅货架 A（法术抽取）**。`player_stats.gd` 有 `resistance` 等占位属性（4/5 stats 未接线）。无出售退款（G5）。 +**现状（代码复核 2026-07-23；属性部分 2026-07-31 订正）**：`shop_manager.gd` 无 shelf/sell/core/attr 任何字段（grep 零匹配）→ **仅货架 A（法术抽取）**。无出售退款（G5）。 +- ⚠️ **2026-07-31 订正**：本行原写「`player_stats.gd` 有 `resistance` 等占位属性（4/5 stats 未接线）」，**与事实不符**。权威属性表（`docs/design/numerical_design.md` §1.1）是 **11 个属性**（`hp_max`/`mana_max`/`move_speed`/`cast_delay_mod`/`recharge_speed_mod`/`luck`/`cpu_limit`/`attunement_×4`），`armor`/`resistance` **根本不在表内** —— 它们是实现先于设计的孤儿字段（零消费方），已随子计划 ① 删除。真实缺口是：三条**死数据**（`cpu_limit`/`move_speed`/`cast_delay_mod`，消费方已存在只是没接上，子计划 ① 已修）+ 三类**未立项新机制**（`attunement_×4`/`luck`/`recharge_speed_mod`）。详见 `docs_dev/specs/2026-07-31-player-attributes-design.md` §0/§1。 **设计来源**：`docs/design/game_design.md §5`（三货架）、`numerical_design.md`（属性曲线、退款比例）。 **依赖**：货架 C 依赖「属性词条系统」先落地；核心抽取复用已有 `cores.json`/`make_core_by_id`。 **切分（建议 4 个子计划，属性词条优先）**： -1. **属性词条系统**：定义 4/5 缺失 player stats（如暴击/急速/范围/吸血/减伤）+ 数据驱动加成来源；PlayerStats 接线到伤害/射速/…；`attributes.json` + 设计器页。M。 +1. ~~**属性词条系统**~~ ✅ **完成**（2026-07-31，`feat/player-attributes`；spec/plan `docs_dev/{specs,plans}/2026-07-31-player-attributes*`）：`AttributeFormula` 纯静态公式模块（`hybrid` 连乘 / `inverse` 反向下限 / `add_int` 拒 `pct` + `pct` 越界钳 0）；`PlayerStats` 持 `_attr_def` + `_modifiers` 并把公式结果写回静态类型裸字段（读取端零开销）；`add_modifier` / `remove_modifiers_from(source)` 按来源增撤；`data/attributes.json` + 设计器「属性」页。**接线三条死数据**：`spell_evaluator` MAX_OPS 改读生效 `cpu_limit`（法杖份额以 `source="core"` 加成接入，运行时实测 3→120 / 5→200 / 8→320 步）、`player_manager` 删 `const MOVE_SPEED` 改读 `PlayerStats.move_speed`（实测 200→300 px/s）、`_handle_auto_cast` 开火时乘 `cast_delay_mod`。删孤儿字段 `armor`/`resistance`；`hp_max`/`cpu_limit` 移出存档（改为派生值）。 + - ⚠️ **实际范围小于原描述**：原写「定义 4/5 缺失 player stats（如暴击/急速/范围/吸血/减伤）」—— 那些属性名是拟稿推测，不存在于任何权威文档（见上方「现状」订正）。本期只做**框架 + 三条死数据**，明确延后三项，各有理由： + - `attunement_fire/ice/lightning/poison`（4 个元素精通）—— 属**新增玩法维度**而非断线，需接入元素伤害管线，独立立项。 + - `luck` —— 权威表定义它「影响暴击率」，而**暴击链目前是死的**（`bullet_manager.gd:81` 把 `is_crit` 硬编码为 `false`，`CastStats.crit_chance` 从未被掷判）；打通暴击链是其前置。 + - `recharge_speed_mod` —— 代码中**不存在充能系统**（全项目 grep `recharge` 零命中），属新增机制而非断线。 + - 另：`mana_max` 的「与法杖取 Min」语义（权威 §1.1）未迁入框架，现状是核心值直接覆盖玩家值；那是独立设计判断，记为已知遗留。 + - ⚠️ **`cast_delay_mod` 存在饱和区，`hard: 0.01` 承诺了循环交付不了的东西**（运行时实测，待人定）：`_handle_auto_cast` 用 `if` 而非 `while`，每物理帧至多一次施法 → 60 次/秒硬顶，且实际速率按**整帧量化**。小木法杖(0.5s) `mod ≤ 0.0333` 即饱和，`wand_fast`(0.25s) `mod ≤ 0.0667` 即饱和；从饱和点到 `hard`(0.01) 之间买不到任何东西。数字与两个处理选项见 `docs_dev/plans/2026-07-31-player-attributes.md` Task 5 Step 7b②。 2. **货架 C（属性购买）**：商店可购属性词条（消耗金币/以太），叠加到 PlayerStats。S~M。 3. **货架 B（核心抽取）**：商店提供 Core 抽取/更换（复用 `_CORE_ROSTER`），与现有换杖打通。S~M。 4. **出售退款 G5**：背包内法术/核心可出售，按 `numerical` 退款比例返还货币。S。