docs: 整理文档目录并对齐代码现状

- 将开发过程/归档文档迁至 docs_dev/(development_plan、certification_checklist、
  已废弃的 Cocos 架构草案 archived_cocos_architecture_draft),并修正全部跨引用
- 新增根 README.md(项目介绍,暂定名 Spellforge)与 docs_dev/README.md 索引
- 新增 docs_dev/doc_code_audit_2026-07-20.md:文档 vs 代码交叉审计报告(经 6
  路对抗性复核,零证伪),含「代码更优 / 文档更优 / 中性」判定汇总
- 在 docs/ 各设计·技术·机制文档就地加「实现现状 (2026-07-20)」callout:
  追认代码更优实现(纯 JSON 数据驱动、SpatialGrid-only 碰撞、MultiMesh 单档、
  存档选最新槽等),订正陈旧/矛盾内容(.tres→JSON、Boss HP/阈值/波次、EventID、
  StatusManager.apply 签名等),标记未实现功能(C# 热路径、Mana、元进展、
  Boss 阶段/抗性、Tutorial、轨迹/连锁/催化等)与 latent bug(CoreFeatureTag 位运算、
  pierce 空操作、MAX_OPS 不读 cpu_limit)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-07-20 14:35:55 +08:00
co-authored by Claude Opus 4.8
parent 7bcc0026e0
commit ad2f4c0bc6
20 changed files with 446 additions and 67 deletions
+2
View File
@@ -1,5 +1,7 @@
# 深度战斗机制扩展设计文档 (Advanced Combat Mechanics Design)
> **⚠️ 实现现状 (2026-07-20 审计)**:本文档的多个进阶维度**未实现**:① §2 连锁/弹跳(`visited_targets` 排除表、`pow(0.9, bounce)` 衰减)——`bounce_remaining` 字段从不被消费;② §3.0 StatusType 现从 `data/status_effects.json`JSON)加载而非 `res://resources/status_types/*.tres`,且 `can_catalyze`/`immune_faction_tags` 不解析;③ §3.3 催化/覆盖/免疫状态交互未实现;④ §4 伤害公式的 `(1-Res)` 抗性项虽存在于 `calc_damage`,但实战路径恒传 `resistance=0`(死维度)。已实现:DoT/伤害基础管线、DamageContext(含 `mult`,伤害计算在 EnemyManager/SRP)。详见 [审计报告](../../docs_dev/doc_code_audit_2026-07-20.md)。
为了支持 Roguelike 游戏中涌现式的玩法组合(如:闪电链、叠毒流、触发流),现有的简单"伤害+阵营"模型需要升级为多维度的**上下文感知 (Context-Aware)** 系统。
本文档详细定义了扩展战斗深度所需的关键维度和判断逻辑。