From 06e993bea72fb360fd5d005d001e67e5ad964fd5 Mon Sep 17 00:00:00 2001 From: Joywayer Date: Mon, 20 Jul 2026 16:34:58 +0800 Subject: [PATCH] =?UTF-8?q?docs(mana):=20Mana=20=E7=8E=B0=E7=8A=B6=20callo?= =?UTF-8?q?ut=20=E6=9B=B4=E6=96=B0=E4=B8=BA=E5=B7=B2=E5=AE=9E=E7=8E=B0(MVP?= =?UTF-8?q?)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/design/game_design.md | 2 +- docs_dev/doc_code_audit_2026-07-20.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/design/game_design.md b/docs/design/game_design.md index af4c3b1..d402706 100644 --- a/docs/design/game_design.md +++ b/docs/design/game_design.md @@ -132,7 +132,7 @@ ### 4.1 核心资源：魔力 (Mana) -> **⚠️ 实现现状 (2026-07-20 审计)**：**Mana 魔力系统完全未实现**——`PlayerStats` 无 mana 变量，法术无蓝耗/回蓝逻辑。作为设计文档声称的核心平衡阀，这是最大的功能缺口之一。当前施法仅受 `MAX_OPS` 与 `Cast Delay` 限制。详见 [审计报告](../../docs_dev/doc_code_audit_2026-07-20.md)。 +> **⚠️ 实现现状 (2026-07-20 审计 → MVP 已实现)**：Mana 精实 MVP 已落地——`PlayerStats` 蓝池（`mana`/`mana_max`/`mana_regen`）、`CoreDefinition.base_mana_max/regen`（cores.json）、每法术 `mana_cost`（numerical §2）、`SpellEvaluator` 逐节点扣蓝 + 蓝空停施、HUD 蓝条。**暂缺**：递增蓝耗、`infinite_spells` 扣血、全局+法杖取 Min、cast_delay。详见 `docs_dev/specs/2026-07-20-mana-system-mvp-design.md`。 为了防止无限“加特林核弹”，限制资源是 **魔力**。 * 强力修正器（如伤害+100）会有巨大的 **Delay (施法后摇)** 和 **Mana Cost (蓝耗)**。 diff --git a/docs_dev/doc_code_audit_2026-07-20.md b/docs_dev/doc_code_audit_2026-07-20.md index be3fbaa..b95667a 100644 --- a/docs_dev/doc_code_audit_2026-07-20.md +++ b/docs_dev/doc_code_audit_2026-07-20.md @@ -68,7 +68,7 @@ - **元进展全套** —— 以太碎片、局外解锁树、图鉴 Codex、成就、炼金日志。`scripts/` 下仅 1 个孤立的 `ACHIEVEMENT_UNLOCKED=18` 事件常量（无订阅方、无系统），其余 `aether/fragment/codex/unlock` 零命中。（`game_design §7`；无对应 autoload/字段） - **Boss 系统架构** —— `BossManager` Autoload、`BossPhaseDef` / 攻击模式注册表、场地机制（冰墙 / 场地收缩）、多阶段弹幕全部 0% 实现。Boss 是 `EnemyManager` SoA 里 `type=4/5` 的普通敌人，唯一"阶段行为"是进阶时召唤一批 FAST 杂兵。（整个 `boss_design.md`；`wave_manager.gd:85,94-117`） -- **Mana 魔力系统** —— 核心平衡资源，`player_stats.gd` 无 mana 变量。（`game_design §4.1`） +- **Mana 魔力系统** ✅ 已实现 MVP (2026-07-20) —— 原：核心平衡资源，`player_stats.gd` 无 mana 变量。（`game_design §4.1`）现已落地蓝池/蓝耗/回蓝/蓝空停施/HUD 蓝条，详见 `docs_dev/specs/2026-07-20-mana-system-mvp-design.md`。 - **里程碑 W5/W10/W15 / 练习模式 / Boss Rush / Endless 全局词条 / NG+ Phase4 / W20 通关演出 / GAME_CLEARED** —— 均未实现；游戏只能靠死亡结束。（`game_design §8`） - **TutorialManager + 情境提示 + 渐进解锁（局1-5）+ 靶场慢放 DPS 演示** —— 实际只有首启难度三选一弹窗。（`tutorial_design.md` 全文；`main_menu.gd:277-353`） - **战前 "The Lab" 独立准备界面 + 拖拽式背包** —— 改为商店内点击选中式插槽编辑器（功能等价，交互与入口偏离）。（`game_design §5.1`；`combat_s2.gd:532-662`） @@ -173,7 +173,7 @@ | `modifier_pierce_plus` 空操作（可购买无效果）| **Bug** ✅已修复(dc05eea)：接线 pierce 到 CastStats/_apply_modifier | | MAX_OPS 硬编码 `×5` 不读 cpu_limit | **Bug/缺口**：CPU 词条对施法预算无影响（未修）| | 战前无 Deck 防呆校验 | **缺口** ✅已修复(dc05eea)：has_castable_action() + 商店校验 | -| Mana 系统 / 元进展 / 属性词条(4/5) / Boss 阶段·抗性 / 商店 B·C 货架 / 5 个 Core 特性标签(4/5) / MATRIX 增压触发 / 连锁弹跳 / 轨迹修正 / 元素催化 / 里程碑·NG+·通关 / TutorialManager·渐进解锁·靶场 / 归航 / DamageNumber / LOD 剔除 | **功能待实现**（设计核心，非文档错误）| +| Mana 系统 ✅ 已实现 MVP (2026-07-20) / 元进展 / 属性词条(4/5) / Boss 阶段·抗性 / 商店 B·C 货架 / 5 个 Core 特性标签(4/5) / MATRIX 增压触发 / 连锁弹跳 / 轨迹修正 / 元素催化 / 里程碑·NG+·通关 / TutorialManager·渐进解锁·靶场 / 归航 / DamageNumber / LOD 剔除 | **功能待实现**（设计核心，非文档错误）| **🟡 中性 —— 纯陈旧或文档自相矛盾，改文档即可（不改代码）**