Game Bug Fix

Overview

提供一套可复现、可定位、可验证的 BUG 修复流程，强调“定位根因 + 最小安全修复 + 回归验证”，避免补丁式改动。

项目适配：Parasite Slime

• •使用 references/parasite-slime.md 获取本项目的目录映射、NSFW 触发链与检查清单。
• •涉及第 3 章 NSFW / 条件 / 文案 / 图片问题时，优先按该参考执行定位流程。

Workflow Decision Tree

1) 读取描述并澄清

• •提取最小信息集：触发动作、期望结果、实际结果、发生频率、环境（平台/分辨率/版本）。
• •缺信息时先问 1~3 个关键问题，不要一次性询问过多。

2) 复现与最小化

• •复现优先：先确认问题存在，再进入定位。
• •通过最小步骤或最小数据集缩小范围，记录能稳定复现的路径。

3) 梳理触发逻辑链

按“输入 → 事件/回调 → 条件判断 → 数据读取/映射 → 逻辑计算 → 渲染/表现”顺序串起链路，标注每一步的关键文件/函数。

4) BUG 层级归类（可多层）

• •数据层：条件不成立、状态错、配置/表格错误、ID/资源映射错误。
• •引擎层：业务逻辑误判、系统规则不生效、生命周期顺序错误、期望效果未实现。
• •样式层：布局错乱、按钮挤压、适配断裂、移动端 UI 崩坏。

如涉及多层，优先从“数据 → 引擎 → 样式”顺序排查，避免用样式掩盖逻辑/数据错误。

5) 根因定位与证据

• •用日志/断点/临时可视化验证每一层的关键数据与分支。
• •找到最早出现偏差的节点作为根因，而不是只修复表面症状。

6) 修复设计（避免补丁式）

• •先小范围重构再修复：拆分复杂函数、提炼重复逻辑为工具函数。
• •保持单一职责与一致抽象层级，避免追加 if-else “临时挡枪”。
• •为关键判断提取常量或配置，避免魔法数字/字符串。
• •必要时补充简短注释，解释“为什么这样设计”。

7) 回归验证与风险控制

• •添加或运行最小回归检查：涉及条件/映射/布局的都要验证周边路径。
• •明确潜在影响范围与验证清单，避免二次伤害。

输出建议格式（回复用户时）

• •复现步骤（最小化）
• •触发逻辑链（入口到渲染）
• •层级判断（数据/引擎/样式，可多层）
• •根因与证据
• •修复方案与代码改动点
• •回归检查清单

常见定位抓手（可选）

• •由表现反推：UI 异常 → 查样式/布局 → 对应数据与逻辑来源。
• •由数据反推：配置/表格 → 查读取与映射 → 核对 ID 与资源。
• •由行为反推：条件分支 → 查状态/标记设置时机与作用域。