if/claude.md

Claude Project Memory

1. 项目定位（长期不变）

• 项目类型：魔塔Like（固定地图探索 + 数值驱动 + 剧情导向 + 解谜）。
• 目标体量：按原定体量推进，不主动缩减世界观与章节目标。
• 开发模式：代码主力由 AI 完成；人工主要负责美工、地图、剧情、体验验收与方向裁决。
• 当前基础：塔的基础结构已完成，支持正常战斗与可视化地图修改。

2. 当前开发优先级（默认顺序）

1. 地图回合时轴（Map Turn）剩余接线与稳定性。
2. 回档系统（状态继承、存读档一致性）。
3. 敌人可相互战斗与伤害。
4. 玩家多角色（队友/阵容）系统。

未经明确指令，不要跳级并行实现高风险模块。

3. 规则来源与冲突处理

• 机制规则唯一口径：docs/map-turn-spec.md
• 代码落地状态台账：docs/map-turn-implementation-status.md
• 协作与开发边界：本文件 claude.md
• 若规则冲突：先列出冲突点与影响，不擅自改规则，等待用户裁决。

4. 开发硬约束（来自 DEVELOPMENT_RULES 共识）

1. 新功能默认写在 project/plugins.js。
2. 优先使用 _docs/api.md 中的样板接口实现需求。
3. 所有绘制基于 core.createCanvas 体系。
4. 所有异步流程基于 core.insertAction（含 function/async 事件流）。
5. 使用非样板接口时，必须就地注释：用途、原因、风险。
6. 不直接改动 libs/ 与 main.js 等核心底层文件，除非用户明确授权。
7. 不直接破坏核心运行态结构（如整体替换 core.status / core.material）。

5. Map Turn 专项原则（必须遵守）

• 单一时间总线：时间推进统一走 consumeTime(deltaTime, reason)。
• 单 tick 语义：deltaTime = n 必须触发恰好 n 次 advanceMapTurnOne。
• 规则优先级：死亡流程优先、战后成功再扣层、状态技能 timeCost=0 不推进时间。
• 耗时规则：battleFinalTimeCost = max(baseBattleTimeCost, statusBattleTimeCostMax)。
• 性能底线：每 tick 禁止全图扫描；敌方调度仅遍历 activeEnemiesByFloor 缓存。
• 存档一致：flags.mapTurnState 与 flags.skillState 保持可序列化并可恢复。
• 缓存策略：activeEnemiesByFloor 作为派生缓存，读档或换层后允许重建。

6. AI 输出与执行格式

每次任务默认按以下顺序输出：

1. 先给结论（本次做什么/不做什么）。
2. 给改动范围（文件与模块）。
3. 对齐到规则（引用 map-turn-spec.md / 台账条目）。
4. 给最小验证步骤（可复现、可回归）。
5. 若有风险，给 1-2 条可选方案并标出推荐项。

7. 验收偏好

• 优先级：正确性与可验证性 > 写法优雅。
• 关键机制必须可回归验证（如 consumeTime(3) 的 3 tick 断言、战后扣层、读档连续、timeCost=0 过滤）。
• 遇到不确定行为，先加可观测日志/断言，再做进一步改动。

8. Git 与协作习惯

• 已使用 Git；改动应保持小步、可读、可回退。
• 未经明确要求，不做破坏性历史操作（如强推、硬重置）。
• 不覆盖与当前任务无关的既有改动。

9. 调用短语约定

当用户说“按 claude 执行”时，AI 必须默认执行：

1. 先复述目标与当前阶段优先级。
2. 明确本次任务对应哪个优先级模块。
3. 检查是否违反第 4、5 节约束。
4. 输出最小可执行步骤，再开始实现。

当用户说“先讨论不改代码”时，AI 只给方案，不做实现。